Skip to main content

Configurar un extracto de libro de calificaciones

Los extractos del libro de calificaciones son extractos totalmente automatizados que no requieren que se aprueben calificaciones para incluirse en el extracto. Para acceder a los ajustes de extracto de calificaciones para un extracto de libro de calificaciones:

  1. Acceda al Panel del administrador.

  2. Seleccione Extensiones de plataforma desde Gestión en la nube.

  3. Elige Editar Configuración en el menú Exportación de calificaciones v2.

  4. Elija la lupa en la columna Configurar en la fila GRADEBOOK_EXTRACT que desee configurar.

Esto le dará acceso a la pestaña de Configuración de Extracción de Calificaciones. Esta pestaña tiene seis secciones ampliables.

Escenarios generales

  1. Elige el tipo de integración.

    • Integración NORMAL: formato de archivo delimitado

    • Integración REST: formato JSON específico de Grades Journey

    • Integración de banners heredados: formato de API REST de banners heredados

  2. El Calendario CRON determina con qué frecuencia se extrae el archivo de calificaciones aprobadas. Introduce una expresión CRON válida para especificar la frecuencia del extracto.

  3. En el campo Decimales introduzca el número de dígitos que se mostrarán después del decimal para obtener los valores de puntuación. El valor está truncado, no redondeado, y el valor por defecto es cinco.

  4. Introduce el valor nulo que se devuelve para elementos o campos sin calificar y sin marcar que no tienen valor almacenado en el campo Extraer Valor para Evaluaciones No Marcadas (por ejemplo, "0" o "noValor").

  5. Especifica una lista separada por comas de calificaciones que se considerarán valores válidos en el campo Calificaciones Válidas. Estas deberían ser calificaciones por letra, no números. Si un valor de calificación no es válido, no se incluye en el extracto y se activa una notificación por correo electrónico. Los registros que se excluyen del extracto por ser inválidos se añaden a un archivo adjunto a la notificación por correo electrónico.

    Nota

    Si deja esta casilla en blanco, todas las calificaciones se considerarán válidas.

  6. Introduce una máscara de formato de fecha válida en el campo Formato para fecha columna. Este formato se utilizará para cualquier valor de fecha incluido en el extracto. Utilice Java SimpleDateFormat.

Filtro de períodos

  1. Activa el interruptor Activado para filtrar el extracto por período.

  2. Seleccione AÑADIR o ELIMINAR para añadir o eliminar filas.

  3. En la columna TERM, seleccione los periodos por los que desea filtrar la extracción. Asegúrese de que solo los cursos asociados a los períodos seleccionados se incluyan en el extracto.

  4. Introduce una fecha de entrada en vigor y una fecha de parada en las columnas correspondientes. Los datos se extraerán de los cursos asociados al período dado si la fecha actual está entre la fecha de entrada en vigor y la fecha de finalización. Las fechas pueden dejarse en blanco y el extracto no estará limitado por fechas.

Filtro de Curso

Los cursos que se incluyan en el extracto deben cumplir todos los criterios configurados.

  1. Activa el interruptor de Solo Cursos Disponibles para incluir solo datos de los cursos disponibles en el extracto del libro de calificaciones.

  2. Busca los cursos que se incluirán en el extracto de calificaciones. Introduzca sus parámetros de búsqueda y se incluirán los cursos que se devuelvan. Puede buscar basándote en:

    • UID de lote

    • ID del curso

    • Nombre del curso

    • Clave de origen de datos

    • Período

    • Fecha de creación del curso

    • Rango de fechas del curso

  3. Ingrese una lista de ID de curso separados por comas que no desea incluir en la extracción del registro de calificaciones en el cuadro Lista de exclusión de cursos.

Filtro de columna

El filtro de columna se utiliza para determinar qué columnas de calificación se extraen.

  • Filtro de columnas Rellene esta casilla si desea extraer solo columnas específicas cuando el provisionamiento esté deshabilitado. Introduce las columnas en una lista separada por comas de nombres de columnas. El propósito de esta configuración es permitir que el extracto contenga solo aquellas columnas que deben ser reportadas.

  • Columna de calificaciones externas (Original) o Solo nota general (Ultra) Seleccione esta casilla si desea extraer solo la columna de calificaciones externa (en cursos Originales) o la nota general (en cursos Ultra). Esta configuración tiene prioridad sobre la configuración de Filtro de Columna y la configuración de Provisión Habilitada. Si tiene esta opción seleccionada, es la única columna de calificación que se extraerá.

  • Aprovisionamiento habilitado Seleccione esta casilla si desea extraer solo las columnas de calificación importadas como parte de los elementos gradables provisionados desde el SIS o Sistema de Información del Estudiante. Esta configuración tiene prioridad sobre la configuración del Filtro de columna.

  • Incluya solo filas desde la última ejecución Seleccione esta casilla si solo quiere incluir registros de columna de calificación donde el valor de calificación haya cambiado desde la última extracción.

  • Excluya 'Todas' las columnas calculadas Seleccione esta casilla en combinación con el filtro de columna anterior para evitar que las columnas calculadas se incluyan en el extracto de calificación cuando el valor de la columna cambie.

  • Excluya 'Todos' los registros con calificaciones vacías Seleccione esta casilla para evitar que los registros sin valor de calificación se incluyan en el extracto del libro de calificaciones.

  • Validación de metadatos de columna Si elige Provisión habilitada, aparecerá un cuadro de Validación de Metadatos en columna. Opcionalmente, introduce un conjunto de pares clave/valor y su número esperado de ocurrencias en los metadatos de la columna de calificaciones para determinar si el curso puede extraerse. Si no se cumplen estos parámetros, el sistema devolverá un error y los datos del curso no se extraerán.

Mapeo de columnas

Introduzca una lista de pares nombre/valor separados por un símbolo de tubería para identificar los campos de datos de la columna de calificación para incluir en cada registro del informe. Si este campo queda vacío, se pasará una lista predeterminada de campos en el extracto.

Un ejemplo de mapeo es:

external_course_key=Course.getBatchUid|External_person_key.=User.getBatchUid|student_id=User.getStudentId|column=Item.getDisplayColumnName|grade=Grade.getSchemaValue

Mapeo adicional de columnas

Active el botón de Habilitar para cada uno de los siguientes campos de Datos Adicionales si desea incluirlos en el extracto:

  • Última fecha de asistencia La última fecha en la que se ha creado un trabajo o un intento de evaluación. El valor de la cabecera puede modificarse actualizando el campo EXTRACTION KEY. El valor predeterminado es last_attendance_date.

  • Comentarios del profesor El comentario proporcionado por el profesor o el aprobador sobre una columna de calificaciones calculadas. El valor de la cabecera puede modificarse actualizando el campo EXTRACTION KEY. El valor predeterminado es instructor_comment. Esta configuración normalmente no se aplicará al extracto del libro de calificaciones, dado que los comentarios del profesor se proporcionan dentro del flujo de trabajo de aprobación.

Configuración de transferencia de resultados

Opción de integración NORMAL

Configuración de transferencia de resultados

  1. En el campo Máscara de nombres de archivo, establece el patrón para el nombre de extracción del archivo. Cuando el Tipo de Transferencia se configura como Archivo Combinado, se añade "combined_" al inicio del nombre del archivo.

  2. Elige el método Transferencia. SFTP es el método transferencia más común y sus configuraciones se describen en estos pasos.

  3. Elige el tipo de transferencia.

    • Cada archivo resulta en transferir individualmente un único archivo de extracción por curso

    • Resultados combinados de archivo en un solo archivo aprobarán todas las filas para todos los cursos

  4. Active Use Windows EOL si esto se procesará en un entorno Windows que requiera Windows EOL.

  5. Introduzca la URL o IP del servidor SFTP en el campo Servidor .

  6. Introduzca el puerto del servidor SFTP (normalmente 22) en el campo Puerto .

  7. Introduce el nombre de usuario SFTP en el campo Nombre de usuario .

  8. Introduce la contraseña SFTP en el campo contraseña.

  9. Introduzca la ruta de los archivos de extracción en el campo Ruta .

Formato de archivo de extracción

  1. Introduzca el delimitador de Campo para utilizar en el archivo extract. El valor predeterminado es una tubería ( | ).

  2. Aquí entra en el Clasificatorio de Campo. Este es el carácter que debe usar si los datos extraídos contienen el delimitador. El valor por defecto es una doble comilla ( " ).

Opción de integración con REST

Configuración de transferencia de resultados

  1. Especifica el punto final para las calificaciones que se publicarán en el campo Endpoint de servicio web de publicación.

  2. Introduce el número máximo de registros que se incluirán en una transacción en el campo Registros máximo de descanso.

Opciones de seguridad de descanso (saliente)

Seleccione Sí para Habilitar la API REST segura. Si está activado, también establece un mecanismo de seguridad.

OAuth 1.0

  • Secreto compartido: entra en el secreto compartido OAuth

  • Clave API: introduzca la clave API OAuth

Seguridad MAC

Infórmate más sobre seguridad MAC.

  • Secreto compartido: entrar en el secreto compartido

  • API Key: introduce la clave API

  • Parámetro de marca de tiempo: introduzca el parámetro que indicará el valor de la marca de tiempo en la cadena de consulta

  • Parámetro MAC: introduce el parámetro que indicará el valor MAC en la cadena de consulta

  • Parámetro clave API: introduzca el parámetro que indicará el valor MAC en la cadena de consulta

OAuth 2.0

La exportación de calificaciones hará una solicitud al endpoint configurado de la URL del token REST. La autorización se enviará como un encabezado de solicitud. El tipo de concesión será client_credentials y se enviará en el cuerpo de la solicitud: grant_type: "client_credentials".

  • Clave REST: Introduzca la clave que se utilizará para acceder a la API.

  • REST Secret: Introduzca el secreto que se utilizará para acceder a la API.

  • URL del token REST: Introduzca la URL que se utilizará para solicitar un token de acceso.

Seleccione Enviar para guardar sus opciones.