Configurar el flujo de trabajo de aprobación
El flujo de trabajo de aprobación, si está habilitado, está configurado para ejecutarse en un calendario específico y extrae automáticamente las calificaciones aprobadas. Para acceder a la configuración de extracción de calificación para el flujo de trabajo de aprobación:
Acceda al Panel del administrador.
Seleccione Extensiones de plataforma desde Gestión en la nube.
Elige Editar Configuración en el menú Exportar de calificación v2.
Elige la lupa en la columna Configurar en la fila FLUJO_DE_TRABAJO_DE_APROBACIÓN.
Esto le dará acceso a la pestaña Configuración de Extracción de Calificaciones.. Esta pestaña tiene siete secciones ampliables.
Configuración general—establecer el tipo de formato de integración, habilitar el extracto, establecer el calendario e indicar calificaciones válidas
Filtro de períodos—indica qué períodos se incluirán en el extracto
Filtro de columnas—indica qué columnas de calificación se mostrarán en el flujo de trabajo de aprobación
Mapeo de columnas—establecer el mapeo de nombres de campos con los Blackboard datos que se extraerán
Extraer Configuración de Rol del Curso—Habilitar el flujo de trabajo del remitente y asignar roles que puedan aprobar, extraer o enviar calificaciones
Configuración de transferencia de resultados—introduzca la ubicación de la institución donde se entregarán los archivos de extracción
Configuración de aprobación de calificaciones y transferencias—establece las opciones de flujo de trabajo de aprobación, la visualización de calificaciones, las opciones de solo lectura y la ubicación LTI
Escenarios generales
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
El calendario CRON determina con qué frecuencia se extrae el archivo de calificaciones aprobadas. Active el ¿Habilitado? para alternar si desea que el proceso se ejecute según el horario CRON indicado, luego introduzca la expresión CRON para especificar la frecuencia de la extracción.
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.
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").
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.
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
Activa el interruptor Activado para filtrar el extracto por período.
Seleccione AÑADIR o ELIMINAR para añadir o eliminar filas.
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.
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 columna
El filtro de columna se utiliza para determinar qué columnas de calificación se muestran a los evaluadores para su aprobación. Solo una opción de filtro puede estar activa a la vez.
Filtro de columnas Rellene esta casilla si desea mostrar solo columnas específicas a los evaluadores 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.
Solo columna de calificación externa (Original) o Calificación general (Ultra) Seleccione esta casilla de verificación si desea mostrar solo la columna de calificación externa (en los cursos Original) o la calificación general (en los cursos Ultra) a los calificadores. Esta configuración tiene prioridad sobre la configuración de Filtro de Columna y la configuración de Provisión Habilitada.
Aprovisionamiento habilitado Seleccione esta casilla si desea mostrar solo las columnas de calificación importadas como parte de los elementos gradables provisionados desde el Sistema de información del estudiante a los evaluadores. Esta configuración tiene prioridad sobre la configuración del Filtro de columna.
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 esta caja queda vacía, 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.
Extraer Configuración de Rol del Curso
Activa el botón Activar el Flujo de Trabajo del Enviado para añadir un paso adicional al flujo de trabajo donde las calificaciones se envían a un aprobador (por ejemplo, un asistente de enseñanza envía las calificaciones para que el profesor las apruebe).
Para Roles Obligatorios para Aprobar, especifica los roles de los cursos que serán necesarios para que un Usuario pueda iniciar el proceso de aprobación para aprobar las calificaciones (como Profesor). Si lo deseas, también especifica cualquier Rol Institucional adicional que deba aprobar las calificaciones (como Aprobador de Calificaciones). Un usuario con cualquiera de estos roles podrá aprobar las calificaciones.
Para Roles que deben enviar, especifica los roles de asignatura que serán necesarios para que un usuario pueda iniciar el proceso de aprobación para enviar las calificaciones (como Asistente de Enseñanza). Si lo deseas, también especifica cualquier rol institucional adicional que requiera presentar calificaciones (como Remitente de Calificaciones). Un usuario con cualquiera de estos roles podrá enviar calificaciones.
Nota
Esta configuración solo se mostrará si el flujo de trabajo del submitente está habilitado.
El mensaje de acceso denegado no debería rellenarse aquí; el mensaje personalizado de acceso denegado se introduce ahora en la pantalla Configurar roles.
Configuración de transferencia de resultados
Opción de integración NORMAL
Configuración de transferencia de resultados
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.
Elige el método Transferencia. SFTP es el método transferencia más común y sus configuraciones se describen en estos pasos.
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
Nota
Un extracto manual generará un archivo de extracto específico para cada curso.
Active Use Windows EOL si esto se procesará en un entorno Windows que requiera Windows EOL.
Introduzca la URL o IP del servidor SFTP en el campo Servidor .
Introduzca el puerto del servidor SFTP (normalmente 22) en el campo Puerto .
Introduce el nombre de usuario SFTP en el campo Nombre de usuario .
Introduce la contraseña SFTP en el campo contraseña.
Introduzca la ruta de los archivos de extracción en el campo Ruta .
Formato de archivo de extracción
Introduzca el delimitador de Campo para utilizar en el archivo extract. El valor predeterminado es una tubería ( | ).
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
Especifica el punto final para las calificaciones que se publicarán en el campo Endpoint de servicio web de publicación.
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
Grades Journ hará una solicitud al endpoint configurado por 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".
Rellena los siguientes campos:
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.
Aprobación de calificaciones y ajustes de transferencia
Aprobación de notas y ajustes de transferencia
Activar Aprobación de Calificación Requerida para habilitar la aprobación de calificaciones en la columna o nivel de calificación. Si esto no está habilitado, las calificaciones solo pueden ser aprobadas a nivel de curso.
Seleccione Botón de Extraer Calificaciones Activado para que el botón Extraer Calificaciones aparezca para los Aprobadores. Los clasificadores podrán hacer el extracto inmediatamente. Para una integración NORMAL, la extracción solo se generará y enviará cuando el Tipo de Transferencia esté configurado en Cada Archivo.
Nota
El botón Extraer Calificaciones siempre aparecerá para los usuarios de Administrador de Aprobadores de Calificaciones.
Seleccione Botón de enviar notas activado? para que el botón Enviar Calificaciones aparezca para los remitentes.
Nota
Si el flujo de trabajo del remitente no está habilitado, esta casilla quedará oculta.
El botón Enviar Calificaciones siempre aparecerá para los usuarios de Administrador de Aprobadores de Calificaciones si el flujo de trabajo del remitente está activado.
Seleccione Solo permite aprobaciones para las notas enviadas para evitar que las calificaciones con un estado diferente al enviado sean aprobadas o no aprobadas.
Nota
Si el flujo de trabajo del remitente no está habilitado, esta casilla quedará oculta.
Select Only allow extract for approved grades? to prevent grades that are not in the Approved status from being extracted. If a grader tries to manually extract grades that are not in the Approved status, they will receive an error message.
Seleccione Habilitar los comentarios del profesor si la columna de Comentarios del Profesor debe estar disponible para los profesores en el área de Aprobación de Calificaciones sobre las calificaciones asociadas a columnas calculadas y manuales.
Seleccione ¿Permitir la búsqueda de cursos para aprobadores de calificaciones? si el enlace de Búsqueda Avanzada debe ser visible para los profesores en el área de Aprobación de Calificaciones para que puedan buscar un curso diferente al que están asignados.
¿Está seleccionada la opción Aprobar calificaciones activado? hará que el botón Aprobar Calificaciones aparezca para los aprobadores.
Nota
El botón Aprobar Calificaciones siempre aparecerá para los usuarios de Administrador de Aprobadores de Calificaciones.
Seleccione ¿Solo permitir desaprobaciones con mensaje de motivo? para evitar que las calificaciones sean aprobadas en la herramienta de Aprobación y Transferencia de Calificaciones si no se ha introducido una razón.
Nota
Si el flujo de trabajo del remitente no está habilitado, la casilla quedará oculta.
Seleccione Limitar el acceso a cursos infantiles solo a quienes presentan o aprueban para limitar a los que presentan o aprueban solo a estudiantes del mismo nivel educativo de los cursos infantiles a los que están asignados.
Seleccione Restringir las operaciones al nivel de calificación para evitar todas las acciones de aprobación de calificaciones en el nivel de curso y columna de calificaciones. Los remitentes y aprobadores solo podrán actuar a nivel de calificación.
La opción Lanzar directamente al nivel de calificación es para una función próxima en el flujo de trabajo de aprobación y no debe seleccionarse.
Seleccione Incluir Calificaciones No Publicadas para incluir las calificaciones que no hayan sido publicadas en el extracto de calificaciones. Esto no incluye columnas manuales ni columnas donde las calificaciones han sido anuladas pero aún no publicadas.
Select Validate Grades to prevent invalid grades from being submitted, approved, or extracted, based on the valid grades that are configured in the General Settings section. If a grader tries to submit, approve, or extract invalid grades, they will receive an error message.
Configuración de valores de visualización de calificaciones
Establece el valor de la calificación para que se muestre en el flujo de trabajo de Aprobación:
Letra de calificación: si el valor del esquema es una letra, entonces devuelve una calificación de letra; de lo contrario, devolverá una cadena vacía
Valor de esquema: devuelve la columna de calificación Visualización primaria
Puntuación porcentual: devuelve la puntuación porcentual calculada
Valor de esquema secundario: devuelve la columna de calificación Visualización secundaria (solo se aplica a los cursos originales)
Valor de puntuación: devuelve el valor de puntuación
Centro de Calificaciones Solo Lectura (Original)
Las siguientes opciones se aplican únicamente a la experiencia de la estructura del curso original. Las opciones disponibles para la experiencia de la estructura del curso Ultra se explican en la sección siguiente.
Puede bloquear el centro de calificaciones del curso y redirigir a los usuarios que intentan acceder a las calificaciones a una página de solo lectura. Para Bloquear la aprobación, elige una de tres opciones:
Inmediatamente al aprobar: bloquea el centro de calificaciones inmediatamente después de que el aprobador apruebe la calificación de ese curso
Después de la fecha de entrega de la columna de calificaciones: bloquee el centro de calificaciones una vez alcanzada la fecha de entrega de la columna seleccionada.
Nota
Si esta opción está seleccionada, debe habilitar las Funciones de Solo Lectura Mejoradas e introducir el nombre de la columna de calificación cuya fecha de entrega se usará para determinar cuándo el centro de calificación quedará bloqueado en la casilla Bloquear nombre de la columna de calificación.
Deshabilitado: no bloquees el centro de calificaciones.
Activa el interruptor Funciones de Solo Lectura Mejoradas para configurar funciones adicionales de solo lectura para los cursos Originales.
Título de la página: introduzca un título de página para la página de solo lectura
Bloquear nombre de la columna de calificación: introduzca el nombre de la columna de calificación cuya fecha de entrega se utilizará para determinar cuándo se bloqueará el centro de calificaciones
Hora de bloquear el curso: opcionalmente, introduce un tiempo para que se ejecute el trabajo de bloqueo. Si no se introduce el tiempo, el trabajo se ejecutará a medianoche.
Tiempo para mantener los cursos desbloqueados manualmente (Horas): opcionalmente introduce un valor para cuánto tiempo (en horas) permanecerá un curso desbloqueado manualmente antes de ser bloqueado automáticamente de nuevo
Tiempo para bloquear automáticamente el Centro de Calificaciones (Horas): opcionalmente introduzca un valor para cuánto tiempo (en horas) debe estar bloqueado el centro de calificaciones tras el evento de aprobación de calificaciones
Excepción de Aprobación de Bloqueo (Horas): opcionalmente introduzca un valor para cuánto tiempo (en horas) un rol con privilegios de Aprobador puede seguir accediendo al centro de calificaciones tras el evento de bloqueo
Excepción de Desaprobación de Bloqueo (Horas): opcionalmente introduce un valor para cuánto tiempo (en horas) puede un rol con privilegios de Remitente acceder al centro de calificaciones tras el bloqueo, incluso si existen calificaciones no aprobadas
Rol del curso no afectado por bloqueo: seleccione el rol del curso que no será redirigido a la página de solo lectura del centro de calificaciones y que aún podrá acceder a la página completa de Transferencia y Aprobación de Calificaciones incluso si está bloqueada.
Nota
El único puesto de Administrador de Sistemas es el único que siempre podrá acceder a la página completa de Transferencia y Aprobación de Calificaciones.
Centro de Calificaciones Solo Lectura (Ultra)
Las siguientes opciones solo se aplican a la experiencia del curso Ultra. Las opciones disponibles para la experiencia del curso original se explican en la sección anterior.
Puede bloquear el centro de calificaciones del curso y redirigir a los usuarios que intentan acceder a las calificaciones a una página de solo lectura. Para Bloqueo de aprobación, tiene las siguientes opciones:
Inmediatamente al aprobar: esta opción no se aplica a la vista de solo lectura Ultra
Después de la fecha de entrega de la columna de calificaciones: bloquee el centro de calificaciones una vez alcanzada la fecha de entrega de la columna seleccionada.
Nota
Si esta opción está seleccionada, debe habilitar las Funciones de Solo Lectura Mejoradas e introducir el nombre de la columna de calificación cuya fecha de entrega se usará para determinar cuándo el centro de calificación quedará bloqueado en la casilla Bloquear nombre de la columna de calificación.
Nota
Puede desbloquear el curso temporalmente si es necesario una vez completado el trabajo de bloqueo.
Deshabilitado: no bloquees el centro de calificaciones.
Activa el interruptor Funciones de Solo Lectura Mejoradas para configurar el nombre de la columna de Bloqueo y el tiempo para bloquear el curso para los cursos Ultra.
Bloquear nombre de la columna de calificación: introduzca el nombre de la columna de calificación cuya fecha de entrega se utilizará para determinar cuándo se bloqueará el centro de calificaciones
Hora de bloquear el curso: opcionalmente, introduce un tiempo para que se ejecute el trabajo de bloqueo. Si no se introduce el tiempo, el trabajo se ejecutará a medianoche.
Nota
Ninguna de las otras funciones de solo lectura mejorada se aplicará a los cursos Ultra.
Seleccione una o más ubicaciones
Especifique las colocaciones LTI que se utilizarán para ejecutar la herramienta de Aprobación de Calificaciones y Transferencia de cursos Original y Ultra. La Herramienta de Profesor y la Herramienta de Administrador son plazas obligatorias. Seleccione Iniciar en una ventana nueva para que el LTI se abra en una ventana separada.
Seleccione Enviar para guardar todas sus opciones.