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 en Gestión en la nube.
Elija Editar configuración en el menú de Grade Export 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
Asignación de columnas — establezca la asignación de los nombres de los campos a los datos de Blackboard que se extraerán
Configuración de extracción de roles 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 y transferencia de calificaciones- establezca las opciones del flujo de aprobación, la visualización de calificaciones, las opciones de solo lectura y la ubicación de LTI
Configuración general
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
La programación CRON determina la frecuencia con la que se extrae el archivo de calificaciones aprobadas. Active el interruptor ¿Habilitado? si desea que el proceso se ejecute según la programación CRON indicada y, a continuación, 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.
Introduzca una máscara de formato de fecha válida en el campo Formato de la columna de fecha. Este formato se utilizará para cualquier valor de fecha incluido en la extracción. 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 columnas se utiliza para determinar qué columnas de calificaciones se muestran a los evaluadores para su aprobación. Solo puede haber una opción de filtro activa a la vez.
Filtro de columnas Rellene este campo si desea mostrar únicamente columnas específicas a los evaluadores cuando el aprovisionamiento esté desactivado. Introduzca las columnas en una lista de nombres de columnas separada por comas. El objetivo de esta configuración es permitir que la extracción contenga solo las columnas que deben notificarse.
Solo columna de calificación externa (Original) o calificación general (Ultra) Seleccione esta casilla si desea mostrar a los evaluadores únicamente la columna de calificación externa (en cursos Original) o la calificación general (en cursos Ultra). Esta configuración tiene prioridad sobre la del Filtro de columnas y la de Aprovisionamiento habilitado.
Aprovisionamiento habilitado Seleccione esta casilla si desea mostrar a los evaluadores únicamente las columnas de calificaciones importadas como parte de los elementos calificables aprovisionados desde el SIS. Esta configuración tiene prioridad sobre la del Filtro de columnas.
Validación de metadatos de columna Si elige Aprovisionamiento habilitado, aparecerá un cuadro de Validación de metadatos de columnas. De forma opcional, introduzca un conjunto de pares clave/valor y el número esperado de sus apariciones en los metadatos de las columnas de calificaciones para determinar si el curso puede extraerse. Si no se cumplen estos parámetros, el sistema devolverá un error y no se extraerán los datos del curso.
Asignación de columnas
Introduzca una lista de pares nombre/valor separados por el símbolo de barra vertical para identificar los campos de datos de las columnas de calificaciones que se incluirán para cada registro en el informe. Si este campo se deja vacío, se incluirá en la extracción una lista predeterminada de campos.
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
Asignación 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.
Configuración de extracción de roles 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 nombre de archivo, establezca el patrón para el nombre del archivo de extracción. Cuando el Tipo de transferencia se establece en Archivo combinado, se agrega "combined_" al comienzo 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.
Elija el Tipo de transferencia.
Cada archivo genera un único archivo de extracción por curso, que se transfiere de forma individual.
El archivo combinado genera un único archivo que contiene todas las filas aprobadas de todos los cursos.
Nota
Una extracción manual generará un archivo de extracción específico del curso.
Active Usar Windows EOL si esto se va a 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 .
Introduzca el nombre de usuario de SFTP en el campo Nombre de usuario.
Introduzca la contraseña de 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 que se utilizará para el archivo de extracción. El valor predeterminado es una barra vertical ( | ).
Ingrese el Calificador de campo. Este es el carácter que se utilizará si los datos extraídos contienen el delimitador. El valor predeterminado es una comilla doble ( " ).
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 para acceder a la API
Secreto REST: Introduzca el secreto para acceder a la API
URL del token REST: Introduzca la URL que se utilizará para solicitar un token de acceso
Configuración de aprobación y transferencia de calificaciones
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.
Seleccione ¿Permitir solo la extracción para calificaciones aprobadas? para evitar que se extraigan calificaciones que no tienen el estado Aprobado. Si un evaluador intenta extraer manualmente las calificaciones que no están en estado Aprobado, recibirá un mensaje de error.
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.
Seleccione ¿Habilitar el botón Aprobar calificaciones? para 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 Iniciar directamente al nivel de columna para lanzar la Herramienta de Aprobación y Transferencia de Calificaciones directamente al nivel de columna, omitiendo la pantalla de aprobación a nivel de curso.
Nota
Si elige tanto la opción Lanzar directamente al nivel de grado como la opción Lanzar directamente al nivel de columna, la herramienta de Aprobación y Transferencia de Calificaciones se lanzará al nivel de columna.
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.
Seleccione Validar Calificaciones para evitar que se envíen, aprueben o extraigan calificaciones no válidas, según las calificaciones válidas que están configuradas en la sección Configuración General. Si un evaluador intenta enviar, aprobar o extraer calificaciones inválidas, recibirá un mensaje de error.
Configuración del valor de visualización de la calificación
Configure el valor de calificación que se mostrará en el flujo 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 intenten acceder a las calificaciones a una página de solo lectura. En Bloqueo al aprobar, elija una de las tres opciones siguientes:
Inmediatamente tras la aprobación: bloquee 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 cuando se alcance la fecha de entrega de la columna seleccionada.
Nota
Si se selecciona esta opción, debe habilitar las Funciones de Solo Lectura Mejoradas e introducir el nombre de la columna de calificación cuya fecha de entrega se utilizará para determinar cuándo se bloqueará el Centro de calificaciones, en el campo Nombre de la columna de calificación para bloqueo.
Deshabilitado: no bloquee 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
Tiempo para bloquear el curso: opcionalmente, introduzca un tiempo para que se ejecute el trabajo de bloqueo. Si no se especifica ninguna hora, el trabajo se ejecutará a medianoche.
Tiempo para mantener desbloqueados los cursos desbloqueados manualmente (Horas): opcionalmente introduzca un valor para el tiempo (en horas) que un curso desbloqueado manualmente permanecerá desbloqueado antes de volver a bloquearse automáticamente
Tiempo para bloquear automáticamente el Centro de Calificaciones (horas): introduzca de forma opcional un valor que indique durante cuánto tiempo (en horas) el Centro de Calificaciones debe permanecer bloqueado después de que se produzca el evento de aprobación de calificaciones.
Excepción de bloqueo de aprobación (horas): introduzca de forma opcional un valor que indique durante cuánto tiempo (en horas) un rol con privilegios de Aprobador puede seguir accediendo al Centro de Calificaciones después del 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 los roles del curso que no serán redirigidos a la página de vista de solo lectura del Centro de Calificaciones y que seguirán pudiendo acceder a la página completa de Transferencia y Aprobación de Calificaciones, incluso si está bloqueada
Nota
El rol de Administrador del sistema 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 cuando se alcance la fecha de entrega de la columna seleccionada.
Nota
Si se selecciona esta opción, debe habilitar las Funciones de Solo Lectura Mejoradas e introducir el nombre de la columna de calificación cuya fecha de entrega se utilizará para determinar cuándo se bloqueará el Centro de calificaciones, en el campo Nombre de la columna de calificación para bloqueo.
Nota
Puede desbloquear el curso temporalmente si es necesario una vez completado el trabajo de bloqueo.
Deshabilitado: no bloquee 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
Tiempo para bloquear el curso: opcionalmente, introduzca un tiempo para que se ejecute el trabajo de bloqueo. Si no se especifica ninguna hora, 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.