Configurar la integración de LinkedIn Learning

Esta integración permite a los administradores del sitio y a los creadores de contenido explorar e importar contenido de LinkedIn Learning a un sitio de Totara. Los usuarios pueden navegar y acceder sin problemas a los cursos de LinkedIn Learning desde Totara, y la finalización y el seguimiento de este aprendizaje están integrados en los informes de Totara.

Requisitos previos

Requisitos previos para usar la integración de Totara/LinkedIn Learning:  

• Totara 15 (y superior) Aprender
• Suscripción a Professional LinkedIn Learning

Configuración de la integración

Antes de configurar la integración en Totara, primero necesitarás obtener tu ID de cliente y el secreto de cliente de LinkedIn.

1. Como administrador, navega hasta la interfaz de administrador de LinkedIn Learning.
2. Pase el cursor sobre mí en la esquina superior derecha y luego seleccione Integrar. 
3. Seleccione la pestaña Acceder a contenido e informes a través de API.
   
4. Expandir la sección Generar la aplicación API REST de LinkedIn Learning.
5. Haga clic en Añadir aplicación.
6. Completa el formulario, explicando cómo se utilizará la integración y haciendo referencia a tu sitio de Totara.
7. Selecciona Contenido para la opción Elegir teclas.
8. Haz clic en Siguiente. Una vez que hayas guardado la aplicación, podrás copiar y pegar el ID del Cliente y el secreto del Cliente.

Para comenzar a configurar la integración de LinkedIn Learning en Totara, sigue estos pasos:

1. Navegar al menú de acceso rápido > Contenido Mercados. 
2. Haz clic en Configurar junto a LinkedIn Learning y luego selecciona Habilitar.
3. Haz clic en el ícono de engranaje () junto a LinkedIn Learning.
   
4. Ingresa tu ID de Cliente y el secreto de Cliente de LinkedIn Learning.
5. Haga clic en Guardar cambios.

Puedes editar estos ajustes haciendo clic en el ícono de engranaje () junto a LinkedIn Learning, o puedes deshabilitar la integración haciendo clic en el ícono del ojo ().

Habilitar el seguimiento del progreso y la finalización del evento de aprendizaje

A continuación, debes configurar la integración para permitir el seguimiento del progreso y la finalización del aprendizaje.

1. Ir al menú de acceso rápido Detalles del proveedor del > servidor > OAuth 2 > OAuth 2.
2. Haga clic en Añadir proveedor.
3. Darle al proveedor un nombre (p. ej., 'LinkedIn Learning') y Descripción, luego haga clic en Añadir proveedor.
4. Toma nota de los detalles en la nueva sección (LinkedIn Learning , o el nombre que proporcionaste en el paso 2), o deja esta pestaña abierta.
5. En LinkedIn Learning, ve a Configurar integraciones de informes.
   
6. Expanda la sección Configurar xAPI.
7. Seleccione Añadir integración.
8. Elija un nombre de integración y establezca el tipo de usuario en Correo electrónico.
9. Ingresa las URL, la ID del Cliente y el secreto del Cliente del paso 4.
10. Haga clic en Habilitar.

Para asegurarte de que los resultados de finalización del usuario se reflejen correctamente en Totara, debes haber completado los siguientes pasos:

1. Configuración completa dentro del administrador de LinkedIn Learning.
2. La dirección de correo electrónico del usuario de Totara debe coincidir exactamente con la dirección de correo electrónico del usuario de LinkedIn Learning que completó un curso.
3. La dirección de correo electrónico del usuario no debe ser utilizada por varios usuarios diferentes en el sitio de Totara (el correo electrónico debe identificar a un usuario de manera única).
4. El usuario de Totara debe estar inscrito en el curso en Totara.

Capacidad del proveedor OAuth

Es posible que desees asignar un usuario para administrar los proveedores OAuth de tu sitio (como LinkedIn Learning), sin darles capacidades y privilegios de administrador más amplios. Si es necesario, puede proporcionar a usuarios específicos la totara/oauth2:manageproviders capacidad a nivel del sistema. Un usuario con esta capacidad en el contexto del sistema podrá ver la lista de proveedores de OAuth2, crear nuevos y eliminar los existentes.

Para añadir esta capacidad a un rol, sigue estos pasos:

1. Navegar al menú de acceso rápido > Permisos > Definir roles.
2. Edite el rol para el que desea agregar la capacidad o cree un nuevo rol si es necesario.
3. Desplácese hacia abajo y marque la casilla Permitir para Administrar proveedores OAuth 2 (totara/oauth2:manageproviders).
4. Desplácese hacia abajo y haga clic en Guardar cambios.
5. Asigne el rol a los usuarios a los que desea administrar proveedores OAuth.

Detección de problemas

La configuración inicial de Totara y LinkedIn para respaldar esta integración implica algunos pasos diferentes. Te recomendamos seguir estos pasos y, si aún necesitas ayuda, crea un ticket de soporte (incluidos los detalles relevantes y las capturas de pantalla, como se describe a continuación).

Para que la finalización de LinkedIn Learning funcione, hay una serie de requisitos previos. 

En primer lugar, el sitio debe estar en Internet pública (para que LinkedIn pueda comunicarse con él). Si el sitio está detrás de un firewall, al menos las siguientes URL deben ser de acceso público:

• SITE_URL/totara/oauth2/token.php
• SITE_URL/totara/xapi/receiver.php

Luego, para que se realice un seguimiento de un evento de finalización, lo siguiente debe ser verdadero en el momento en que ocurrió el evento de finalización en LinkedIn Learning:

• La organización debe haber configurado el seguimiento del progreso y la finalización del evento de aprendizaje .
• La dirección de correo electrónico del usuario que completa el contenido en LinkedIn Learning debe coincidir con la dirección de correo electrónico del usuario de Totara. Ten en cuenta que debe ser la dirección de correo electrónico de la cuenta de LinkedIn Learning, no cualquier cuenta de LinkedIn asociada con la cuenta de LinkedIn Learning.
• La dirección de correo electrónico no debe ser utilizada por varios usuarios diferentes en el sitio de Totara (el correo electrónico debe identificar de manera única a un usuario de Totara).
• El usuario de Totara debe estar activo (no suspendido ni eliminado).
• Debe existir un curso de Totara que contenga la parte asociada del contenido de LinkedIn Learning en el sitio de Totara.
• La finalización del curso y la actividad deben estar habilitadas y configuradas correctamente en ese curso (este será el caso si la actividad se importó a través de LinkedIn Learning).
• El usuario de Totara con la dirección de correo electrónico coincidente debe estar inscrito en el curso de Totara que contiene la actividad de LinkedIn Learning.

Si todo lo anterior es verdadero, el evento de finalización debe ser enviado y procesado por el sitio de Totara y se debe recibir la finalización.

Pasos adicionales para la resolución de problemas

Hay algunas situaciones adicionales en las que la finalización de Totara puede ocurrir después de la finalización en LinkedIn. Considera un ejemplo en el que un usuario trabaja a través del contenido de LinkedIn Learning que luego se agrega a Totara:

1. La integración de LinkedIn Learning ya ha sido configurada.
2. El progreso o la finalización ocurre en una parte del contenido de LinkedIn Learning.
3. Ese contenido se importa a Totara.
4. El usuario con la misma dirección de correo electrónico se inscribe más adelante en ese curso.
5. A partir de Totara 16, la finalización se marcará en el momento de la inscripción.

Para que el sitio reciba “declaraciones de progreso” (es decir, finalización parcial como porcentaje en lugar de solo cuando se completa el contenido), la cuenta de LinkedIn Learning de la organización debe estar configurada para tener esta función habilitada. Por favor, comunícate con tu representante de LinkedIn Learning y pide que se activen los eventos de progreso de xAPI para tu cuenta.

Recomendamos revisar y proporcionar las siguientes capturas de pantalla al equipo de soporte de Totara:

• La página de detalles del proveedor OAuth2 en el lado de Totara (Menú de acceso rápido > Servidor > OAuth2 > Detalles del proveedor Oauth2 ) El cliente específico debe expandirse, pero la ID y el secreto del cliente pueden ser desdibujados.
• La configuración xAPI en el lado de LinkedIn (Me > Integrate > Configure reporting integrations > Configure xAPI expanded , luego haga clic en el ícono de edición junto a la integración específica y tome una captura de pantalla del diálogo.
• La página del historial de aprendizaje del usuario de LinkedIn (Mi aprendizaje > Historial de aprendizaje ) que muestra el curso que está completo.
• La página de actividad en Totara que muestra el mismo contenido que no está completo, incluida la página completa para que podamos ver quién ha iniciado sesión en la esquina superior derecha.
• El perfil del usuario de Totara, mostrando su dirección de correo electrónico de Totara.
• La página de perfil del usuario de LinkedIn Learning, que muestra su dirección de correo electrónico de LinkedIn Learning. Se puede acceder a esta opción dirigiéndose a LinkedIn Learning Admin > People > Users , y luego haciendo clic en el nombre del usuario.
• La página de inscripción al curso de Totara, que muestra que el usuario está inscrito (con fecha de inscripción si es posible).

Proporcionar apoyo adicional e identificar problemas adicionales

Si la integración parece estar configurada correctamente y aún no se reciben nuevas finalizaciones, necesitaremos información adicional para investigar lo que está sucediendo.

Necesitaremos el acceso HTTP y los registros de errores para los cinco minutos alrededor de la hora en que ocurrió un evento de finalización en LinkedIn, junto con la hora exacta en que ocurrió la finalización de LinkedIn. Buscaremos la existencia y el código de estado HTTP de las solicitudes del formato:

• POST SITE_URL/totara/oauth2/token.php
• POST SITE_URL/totara/xapi/receiver.php

Si estas solicitudes no existen, esto sugiere que hay un problema en el lado de LinkedIn Learning, ya sea con la configuración de la integración o un problema temporal de LinkedIn Learning.

Si las solicitudes existen pero tienen códigos de estado HTTP distintos de 200, eso sugiere que hay un problema al recibir los datos. Deberás habilitar la depuración y enviarnos los seguimientos completos de la pila de solicitudes fallidas para esos archivos.

Si las solicitudes existen y tienen códigos de estado HTTP de 200, eso sugiere que los datos se recibieron correctamente. Esto indica un problema de configuración con la finalización del curso o algún otro problema local dentro del sitio. Para depurar que necesitaremos acceso a una copia de estas tablas de base de datos (o al menos las filas de alrededor de la hora de los eventos exitosos descritos anteriormente):

• totara_xapi_statement
• marketplace_linkedin_user_progress

Próximos pasos

• Configurar usuarios en LinkedIn Learning
• Importar contenido de LinkedIn Learning