Implementar Grades Journey mediante la integración SITS

  1. En Administración del sistema, en Blackboard Building, seleccione Building Blocks.
  2. Seleccione Herramientas instaladas.
  3. Ubique Servicio de Blackboard Grade Journey para LIS y seleccione Ajustes.
  4. Usando las siguientes secciones, configure las propiedades de cada grupo de ajustes.

Ajustes de las columnas de actividades y calificaciones (datos entrantes)

Configure las siguientes propiedades:

  • Programar trabajo
    • Establecer estado del trabajo: seleccione Desactivado.
    • Programación CRON: N/D.
    • Aprovisionar el área de contenidos: elija la carpeta predeterminada en la que se crearán los elementos calificables, a menos que sean anulados en la transacción.
    • Verificación del aprovisionamiento del área de contenidos: este ajuste define la regla de coincidencia para los elementos del contenido aprovisionados. Tiene estas opciones:
      • Sin restricción: los elementos de la fuente se agregan siempre como elementos del contenido nuevos.
      • Única vez: se agrega cualquier elemento determinado por única vez (se utiliza para LIS).
      • Actualizar las coincidencias por nombre: los elementos se agregan en el primer paso, y en las importaciones posteriores las actualizaciones se añaden en función de la coincidencia por título del elemento del contenido.
    • Verificación del aprovisionamiento de elementos calificables: este ajuste define la regla de coincidencia para las columnas de calificaciones manuales proporcionadas o las columnas de calificaciones creadas como consecuencia de los elementos del contenido aprovisionados. Tiene estas opciones:
      • Actualizar las coincidencias por nombre: los elementos se agregan en el primer paso y se actualizan en las importaciones posteriores en función de la coincidencia por título del elemento del contenido.
      • Actualizar las coincidencias por metadatos: Los elementos se agregan en el primer paso y se actualizan en las importaciones posteriores en función de la coincidencia del valor almacenado en un atributo de metadatos denominado "Tipo" que se incluye en la lista de datos opcional del registro de datos de entradas del elemento.
  • Los valores de Ajustes de transferencia resultante, Formato de archivo y Ajustes de columna de calificaciones no se aplican a REST.

Al finalizar, seleccione Enviar.

Ajustes de la extracción de calificaciones (datos salientes)

Configure las siguientes propiedades:

  • Integración
    • Tipo de integración: seleccione Integración SITS. Resultados de la integración SITS en tres archivos salientes: un resumen, un archivo de evaluación y un archivo de reevaluación.
    • Programa CRON: elija qué tan seguido tienen lugar las extracciones en segundo plano. Por ejemplo, las extracciones ocurren cada hora con este valor configurado en 0 0/60 * 1/1 * ? *
    • Número de redondeo: elija la cantidad máxima de dígitos fraccionales para un puntaje.
    • Valor de extracción para las evaluaciones no marcadas: elija el valor nulo que desea que devuelvan los elementos no marcados o no calificados.
    • Filtro de columna: elija esta opción si la lista de columnas de aprobación y extracción debe limitarse a una lista específica delimitada por comas de los nombres de la columna de calificaciones cuando se desactiva el aprovisionamiento. Este ajuste está diseñado para permitir que extracción incluya solo aquellas columnas que se deben informar.
    • Solo la columna de calificaciones externa: elija esta opción si la lista de columnas de aprobación y extracción debe limitarse a una columna de calificaciones externa del curso, es decir, la columna en el centro de calificaciones que está marcada como Calificación externa.

      Este ajuste tiene prioridad respecto de Filtro de columna.

    • Aprovisionamiento activado: seleccione este ajuste si la lista de columnas de aprobación y extracción debe limitarse a aquellas importadas como parte del elemento de contenidos y el elemento calificable que SIS proporciona.
    • Asignación de columna: introduzca una lista de pares de nombres/valores separados por una barra vertical para identificar los campos de datos de la columna de calificaciones que se deben incluir in cada registro del informe. Si se deja en blanco, se incluirá una lista de campos predeterminada en el informe:
      EXTERNAL_COURSE_KEY|STUDENT_ID|BATCH_UID|TITLE|MARK|GRADE|EXTENDED_DATA
  • Requisito de rol del curso para la extracción
    • Roles de curso: especifique el rol de curso requerido para que un usuario pueda aprobar calificaciones (es decir, profesor).
    • Roles institucionales: especifique el rol institucional requerido para que un usuario pueda aprobar calificaciones (es decir, aprobador de calificaciones).
    • Mensaje de acceso denegado: ingrese un mensaje para los usuarios que intenten extraer calificaciones, pero no cuentan con el permiso correspondiente.
  • Ajustes de transferencia resultante
    • Extremo de PostWebservice: especifique el extremo para la publicación de calificaciones.
    • Extremo de TestingRestWebservice: ignore esta configuración (normalmente).
  • Ajustes de seguridad de REST (saliente)
    • Activar API de REST segura: active esta configuración si el extremo implementará la seguridad. Si está activada, también configure lo siguiente:
      • Secreto compartido: ingrese la clave compartida.
      • Clave API: ingrese la clave API.
      • Intervalo de marca de tiempo: no configure este valor.
      • Parámetro de marca de tiempo: ingrese el parámetro para la marca de tiempo.
      • Parámetro de MAC: ingrese el parámetro de MAC.
      • Parámetro de clave API: ingrese el parámetro clave API.
  • Configuración de aprobación y transferencia de calificaciones
    • Aprobación de calificaciones necesaria: active esta configuración si desea que las calificaciones se aprueben a nivel de columna o de calificación.
    • ¿Mostrar página de historial? : establezca esta configuración si no desea aprobación a nivel de calificación y desea que la página de historial se muestre cuando realiza una extracción del curso.
    • ¿Botón Realizar extracción activado? : establezca esta configuración para permitir que los calificadores ejecuten la extracción de manera inmediata.
    • ¿Botón Programar extracción activado? : establezca esta configuración para permitir que los calificadores programen/aprueben la extracción.
    • ¿Bloquear la aprobación? : active esta configuración para cambiar el centro de calificaciones a solo lectura para que no se puedan modificar las calificaciones después de su extracción.

Al finalizar, seleccione Enviar.

Configuración de las notificaciones

Si lo desea, vuelva al menú Ajustes y edite la configuración de las notificaciones.

Ajustes de seguridad de la API de REST (seguridad de los datos entrantes)

Configure las siguientes propiedades:

  • Ajustes de seguridad saliente de REST
    • Activar API de REST segura: active esta configuración si los extremos entrantes implementarán la seguridad.
    • Filtro de IP: active el filtro para cualquier IP entrante. Si esta opción está activada, también configure lo siguiente:
      • Secreto compartido: ingrese la clave compartida.
      • Clave API: ingrese la clave API.
      • Intervalo de marca de tiempo: no configure este valor.
      • Parámetro de marca de tiempo: ingrese el parámetro para la marca de tiempo.
      • Parámetro de MAC: ingrese el parámetro de MAC.
      • Parámetro de clave API: ingrese el parámetro clave API.

Al finalizar, seleccione Enviar.

Niveles del registro

Configure las siguientes propiedades:

  • Configuración de inicio de sesión
    • Nivel de detalle de registro: establezca esta configuración para determinar el nivel de inicio de sesión para el archivo /logs/custom/bbc-GradeyJourney.log. El valor predeterminado es INFO, pero es posible que desee agregar DEBUG con fines de solución de problemas. La configuración de producción debería ser INFO, a menos que se esté llevando a cabo una depuración.

Ejecutar una prueba de validación

  1. Vaya a Admin. del sistema > Ajustes de extracción de las calificaciones (datos salientes).
  2. Actualice el método de transferencia a Local y establezca la ruta a una carpeta local que se pueda leer, actualizar y eliminar del usuario que ejecuta Blackboard Learn. Elija la Integración SITS según sus necesidades. Seleccionar Enviar.
  3. En Ajustes, seleccione Ajuste de las columnas de actividades y calificaciones (datos entrantes).
  4. Actualice el ajuste Recibir los archivos de entrada mediante FTP a Desactivado y establezca la ruta a una carpeta local que se pueda leer, actualizar y eliminar del usuario que ejecuta Blackboard Learn. Haga clic en Enviar.
  5. Cree una columna de calificaciones ponderada en el curso mediante el uso de un archivo sin formato. Cree los archivos de usuarios para las inscripciones.
  6. Inicie sesión en Learn como instructor y vaya al curso.
  7. Navegue hasta el centro de calificaciones. La nueva columna de calificaciones ponderada debe aparecer allí.
  8. Cree una actividad y asígnela al 100% a la columna ponderada.
  9. Ingrese las calificaciones de las inscripciones.
  10. En el menú Administrar, seleccione Aprobación y transferencia de las calificaciones.
  11. Haga clic en el botón Extraer y programar en el curso, la columna de calificaciones o el nivel de calificación.
  12. Si la extracción se realizó correctamente, los archivos aparecerán en la carpeta de extracción.
  13. De lo contrario, consulte el registro en <bb home>/custom/log/bbgs-GradeJourney.log.