Saltar al contenido principal
pdf?stylesheet=default
Blackboard Help

Implementación de servicios Web RESTful

Implemente Grades Journey mediante el uso de servicios Web RESTful:

  1. En Administración del sistema, en Blackboard Building, seleccione Building Blocks.
  2. Haga clic en 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 columnas de actividades y calificaciones (datos entrantes)

Configure las siguientes propiedades:

  • ​Programar trabajo
    • Establecer estado del trabajo: seleccione Desactivado.
    • Programación CRON: N/D.
    • Área de contenido de suministro: elija la carpeta predeterminada en la que se crearán los elementos calificables, a menos que sean anulados en la transacción.
    • Comprobación de suministro de elemento calificable: elija una opción:
      • Actualizar coincidencias: si desea que el suministro actualice la fecha de vencimiento y el punto posible para cualquier elemento que coincida.
      • Única vez: si desea suministrar un curso una única vez.
      • Sin restricciones: si desea que no hayan restricciones para los suministros.
  • Los valores de Ajustes de transferencia resultante, Formato de archivo y Ajustes de columna de calificaciones no se aplican a REST.

Al terminar, haga clic en Enviar.

Ajustes de extracción de calificaciones (datos salientes)

Configure las siguientes propiedades:

  • Integración
    • Tipo de integración: seleccione Integración REST.
    • 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 evaluaciones no marcadas: elija el valor nulo que desea que devuelvan los elementos no marcados o no calificados.
  • Requisito de rol de curso para 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 terminar, haga clic en Enviar.

Configuración de notificaciones

Si lo desea, regrese al menú Ajustes y modifique la configuración de notificacionesTools Roles and Notification Settings.

Ajustes de seguridad de API de REST (seguridad de 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 terminar, haga clic en Enviar.

Niveles de inicio de sesión

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. Navegue hasta Administración del sistema > Ajustes de extracción de calificaciones (datos salientes).
  2. Actualice el extremo de PostWebservice en <su URL de servidor>/webapps/bbgs-GradeJourney-BBLEARN/app/admin/apitest/receiveRestGradeExtract.
  3. Haga clic en Enviar.
  4. Si está utilizando un certificado autofirmado, necesitará exportar el certificado y cargarlo en el almacén de claves JDK en <jdk home>/jre/lib/security y reiniciar el sistema.
  5. Cree un curso de forma manual y agregue algunas inscripciones. Asegúrese de que el profesor tenga los roles requeridos para aprobar calificaciones.
  6. Cree una columna de calificaciones manual en el curso mediante el uso de una herramienta para publicar la transacción de REST. Puede utilizar herramientas tales como cURL o la interfaz de usuario de SOAP. También existe una herramienta en el sistema llamada Evaluador de la API de REST de Grades Journey.
  7. Marque la columna con Extract=Y.
  8. Inicie sesión en Learn como profesor y vaya al curso.
  9. Navegue hasta el centro de calificaciones. La nueva columna de calificaciones ponderada debe aparecer allí.
  10. Cree una actividad y asígnela al 100% a la columna ponderada.
  11. Ingrese las calificaciones de las inscripciones.
  12. En el menú Administrar, seleccione Aprobación y transferencia de calificaciones.
  13. Si la extracción se realizó correctamente, la transacción se registra en el archivo de registro ubicado en <bb home>/logs/custom/bbgs-GradeJourney.log. El estado de las calificaciones, las columnas y el curso debería decir extraído.
  14. Si la extracción no se realizó correctamente, consulte este mismo registro.