Microaplicaciones

Integrar Blackboard Learn

Implemente la integración de Blackboard Learn para registrarse en un nuevo curso y ver este y sus detalles como estudiante, además de como instructor para crear un anuncio del curso y ver los miembros del curso y sus calificaciones.

Nota:

¡Su opinión nos interesa! Proporcione comentarios sobre esta plantilla de integración a medida que la utiliza. Para cualquier problema, nuestro equipo también supervisará el foro dedicado a diario.

Para obtener información detallada sobre las microaplicaciones de uso inmediato para Blackboard Learn, consulte Usar microaplicaciones de Blackboard Learn.

Revisar requisitos previos

Necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace:

  • URL base: https://{host_name}.com
  • URL de autorización: https://{host_name}.com/learn/api/public/v1/oauth2/authorizationcode
  • URL del token: https://{host_name}.com/learn/api/public/v1/oauth2/token
  • ID de cliente: El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Obtendrá esta clave de aplicación al configurar el servidor de OAuth.
  • Secreto: El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino. Obtendrá este secreto al configurar el cliente de OAuth.

Nota:

Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

Configure Citrix Gateway para que admita Single Sign-On, de modo que, una vez que los usuarios hayan iniciado sesión, no tengan que volver a introducir sus credenciales para registrarse. Para obtener más información acerca de la configuración de SSO, consulte Citrix Gateway Servicehttps://docs.citrix.com/en-us/citrix-gateway-service/.

Crear cuenta de usuario

La integración requiere un acceso periódico a su instancia de Blackboard. Recomendamos crear una cuenta de usuario dedicada: Cuenta de socio de Blackboard https://docs.blackboard.com/partners/become-a-partner.

Se requieren los siguientes permisos: Privilegios de administrador total.

Acceso a API

Las API de Blackboard están habilitadas de forma predeterminada; para acceder a las API, se necesita la AMI de desarrollador de Blackboard o la cuenta de socio de Blackboard. El número de solicitudes de API que se pueden realizar a recursos específicos es limitado. Recomendamos revisar la siguiente información: https://docs.blackboard.com/learn/rest/admin/groups-quotas-rates

Importante

El límite de paginación se establece en 100. Los administradores pueden ampliar este límite hasta 200, en función de las API.

El servidor para desarrolladores de Blackboard Learn admite hasta 10 000 llamadas de API por sitio en un período de 24 horas.

El servidor de producción de Blackboard Learn admite hasta 75 000 llamadas de API por sitio en un período de 24 horas.

Debido al límite en las llamadas de API, la sincronización incremental se configura para retener solo las afiliaciones a cursos y los anuncios de cursos. Los dispositivos de punto final restantes se desencadenarán como parte de la sincronización completa.

Configurar el servidor de OAuth

Configure el servidor de OAuth para que lea los datos a través de la integración de Blackboard Learn.

  1. Inicie sesión en https://developer.blackboard.com/.
  2. Seleccione My Apps y, a continuación, el icono + para crear una nueva aplicación. Como alternativa, vaya a: https://developer.blackboard.com/portal/applications/create.
  3. Complete los campos requeridos y seleccione Register application and generate API key.
  4. Copie y guarde el ID de la aplicación, la clave de aplicación y el secreto que se muestran en la pantalla. Utilice estos detalles para la autenticación de servicio mientras configura la integración.
  5. Inicie sesión en la aplicación Blackboard Learn como administrador.
  6. Vaya a System Admin.
  7. En la tabla Integrations, seleccione REST API Integrations.
  8. Seleccione Create Integration.
  9. Complete los campos obligatorios:

    1. Pegue el ID de aplicación que seleccionó en el paso 4 anterior.
    2. Introduzca el nombre de usuario de administrador en el campo Learn User.
    3. Seleccione Yes en End User Access y en Authorized To Act As User.

Configurar cliente de OAuth

Configure el cliente de OAuth para reescritura de datos a través de la integración de Blackboard Learn.

  1. Inicie sesión en https://developer.blackboard.com/.
  2. Seleccione My Apps y, a continuación, el icono + para crear una nueva aplicación. Como alternativa, vaya a: https://developer.blackboard.com/portal/applications/create.
  3. Complete los campos requeridos y seleccione Register application and generate API key.
  4. Copie y guarde el ID de la aplicación, la clave de aplicación y el secreto que se muestran en la pantalla. Utilice estos detalles para la autenticación de acciones de servicio mientras configura la integración.
  5. Inicie sesión en la aplicación Blackboard Learn como administrador.
  6. Vaya a System Admin.
  7. En la tabla Integrations, seleccione REST API Integrations.
  8. Seleccione Create Integration.
  9. Complete los campos obligatorios:

    1. Pegue el ID de aplicación que seleccionó en el paso 4 anterior.
    2. Introduzca el nombre de usuario de administrador en el campo Learn User.
    3. Seleccione Yes en End User Access y en Authorized To Act As User.

Agregar la integración a las microaplicaciones de Citrix Workspace

Agregue la integración de Blackboard Learn a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.

Siga estos pasos:

  1. En la página Integraciones de microaplicaciones, seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
  2. Elija el mosaico de Blackboard Learn.
  3. En el campo Nombre de la integración, introduzca un nombre para la misma.
  4. Introduzca los parámetros del conector.
    • Introduzca la URL base de la instancia:
    • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado.
  5. En Autenticación de servicio, seleccione OAuth 2.0 en el menú Método de autenticación y complete los detalles correspondientes. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Utilice el protocolo de seguridad de OAuth 2.0 para generar tokens de solicitud/autorización para el acceso delegado. Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

    1. En el menú Tipo de concesión, seleccione Credenciales del cliente.
    2. Seleccione el Encabezado de la autorización en el menú Autorización de token.
    3. La URL del token se rellena automáticamente: https://{host_name}.com/learn/api/public/v1/oauth2/token
    4. Compruebe que se ha introducido lo siguiente para el ámbito: read
    5. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Obtendrá esta clave de aplicación al configurar el servidor de OAuth.
    6. Introduzca su Secreto del cliente. El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino. Obtendrá este secreto al configurar el servidor de OAuth.
  6. En Autenticación de acciones de servicio, habilite la opción Usar autenticación de usuario independiente en Acciones. La autenticación de acciones de servicio autentica en el nivel de acción de servicio. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso.

    1. En el menú Método de autenticación, seleccione OAuth 2.0 y complete los detalles de autenticación.
    2. Seleccione el Encabezado de la autorización en el menú Autorización de token.
    3. La URL de autorización se rellena automáticamente: https://{host_name}.com/learn/api/public/v1/oauth2/authorizationcode
    4. La URL del token se rellena automáticamente: https://{host_name}.com/learn/api/public/v1/oauth2/token
    5. Compruebe que se ha introducido lo siguiente para el ámbito: write
    6. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Obtendrá esta clave de aplicación al configurar el cliente de OAuth.
    7. Introduzca su Secreto del cliente. El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino. Obtendrá este secreto al configurar el cliente de OAuth.
  7. La opción Habilitar la limitación del índice de solicitudes está habilitada. Deje 60 como Cantidad de solicitudes y 1 minuto como Intervalo de tiempo.
  8. El valor de Tiempo de espera de solicitud se establece en 120 de forma predeterminada.
  9. (Optativo) Habilite la opción Registro para conservar un registro de 24 horas con fines de asistencia.
  10. Seleccione Guardar para continuar.

Configurar los parámetros de las acciones de servicio

Después de configurar la plantilla de integración anterior, debe configurar la acción de servicio correctamente. Para la microaplicación Mis calificaciones, actualice host_name en el botón Ver en Blackboard de la página Mis calificaciones.

Siga estos pasos:

  1. En la página Integraciones de microaplicaciones, vaya a la integración de Blackboard Learn y seleccione la microaplicación Mis calificaciones.
  2. Seleccione Páginas y, a continuación, la página Mis calificaciones.
  3. En el generador de páginas, seleccione el elemento de botón Ver en Blackboard y, a continuación, la ficha Acciones en el panel derecho.
  4. En Acciones, seleccione Ir a URL.
  5. En el campo de plantilla URL, sustituya host_name por el nombre de host de la instancia. Se usa este formulario: https://{host_name}/webapps/bb-social-learning-BBLEARN/execute/mybb?cmd=display&toolId=MyGradesOnMyBb_____MyGradesTool

    Cuando termine, salga de la pantalla. Los cambios se guardan automáticamente para el generador.

Modificar atributos de tabla

Para finalizar la configuración de la integración, debe cambiar el tipo de datos de los dispositivos de punto final que se indican a continuación.

Siga estos pasos:

  1. En la página Integraciones de microaplicaciones, seleccione el menú situado junto a la integración de Blackboard Learn y, a continuación, Modificar. Se abrirá la pantalla Carga de datos. De lo contrario, seleccione Carga de datos en la columna de navegación del lado izquierdo.
  2. Para cada Dispositivo de punto final enumerado en la tabla siguiente, debe cambiar el Tipo de datos en el menú del Atributo correspondiente.

    Dispositivo de punto final Atributo Cambio del tipo de datos
    Anuncios de cursos Cuerpo Binario
    Calificaciones de usuarios Mostrar puntuación Doble
    Puntuación de calificación Puntuación posible Doble
  3. Para cada dispositivo de punto final, seleccione el menú situado junto al mismo y Modificar.
  4. En la pantalla Modificar dispositivo de punto final de datos, desplácese hasta la parte inferior de la página. En la tabla que aparece bajo Estructura de datos, seleccione el icono de lápiz para modificar la tabla.
  5. En la pantalla Modificar atributos de tabla, seleccione un nuevo valor en el menú para cambiar el tipo de datos. Con cada cambio realizado para cada dispositivo de punto final, seleccione Guardar y, a continuación, Aplicar.
  6. Repita el procedimiento para los demás dispositivos de punto final de datos.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.

Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Blackboard Learn.

Notas

El límite de paginación se establece en 100. Los administradores pueden ampliar este límite hasta 200, en función de las API.

Debido al límite en las llamadas de API, la sincronización incremental se configura para retener solo las afiliaciones a cursos y los anuncios de cursos. Los dispositivos de punto final restantes se desencadenarán como parte de la sincronización completa.

Usar microaplicaciones de Blackboard Learn

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Nota

Para la microaplicación Mis calificaciones, un administrador debe actualizar “host_name” en el botón Ver en Blackboard de la página Mis calificaciones. Para obtener información completa sobre los pasos, consulte Configurar los parámetros de las acciones de servicio.

Inscripción en el curso: Permite inscribirse en un curso.

Notificación o página Flujos de trabajo por caso de uso
Notificación Inscripción en un nuevo curso Cuando un estudiante se inscribe en un curso, recibe una notificación.
Página Detalles de inscripción en el curso Proporciona una vista de solo lectura de los cursos en que está inscrito, con detalles del curso y del profesor.
Página Lista de cursos Proporciona una lista de cursos disponibles.
Página Detalles del curso Permite ver los detalles del curso y del profesor, e incluye una opción de Inscripción rápida.

Crear anuncio sobre curso: Permite a los profesores crear un anuncio sobre un curso.

Notificación o página Flujos de trabajo por caso de uso
Página Crear anuncio sobre curso Proporciona un formulario para crear un anuncio sobre un curso, con los siguientes detalles: Curso (menú desplegable Cursos), Título, Mensaje y Fecha de publicación.

Vista del profesor: Permite a los instructores ver los miembros y calificaciones del curso.

Notificación o página Flujos de trabajo por caso de uso
Página Detalles del curso Permite al profesor ver una lista de cursos disponibles.
Página Detalles del miembro Permite al profesor ver una lista de los miembros inscritos en un curso.
Página Detalles de la calificación Permite al profesor ver las calificaciones de los miembros del curso específico.

Mis cursos: Permite ver anuncios de cursos y datos adjuntos de un curso

Notificación o página Flujos de trabajo por caso de uso
Notificación Nuevos anuncios del curso Cuando hay un nuevo anuncio, los estudiantes inscritos en el curso reciben una notificación.
Página Detalles del anuncio del curso Proporciona una vista de solo lectura de los nuevos anuncios sobre un curso con detalles.
Página Mis Cursos Proporciona una lista de cursos en los que el usuario está inscrito.
Página Detalles del curso Proporciona una lista de anuncios y datos adjuntos de un curso.
Página Detalles del anuncio Permite ver el anuncio de un curso y sus detalles.
Página Detalles de los datos adjuntos Permite ver y descargar los datos adjuntos.

Mis calificaciones: Permite a los estudiantes ver las calificaciones de los cursos.

Notificación o página Flujos de trabajo por caso de uso
Notificación Nuevas calificaciones Cuando se publican nuevas calificaciones, los estudiantes inscritos en el curso reciben una notificación.
Página Mis calificaciones Permita a los estudiantes ver las calificaciones al seleccionar el curso.