Paquete de sitios de referencia de Adobe Learning Manager (sitios de referencia de ALM) para AEM Sites

Adobe Learning Manager (ALM) se integra con los sitios de Adobe Experience Manager (AEM). Esto le permite crear su propio sitio web e interfaces móviles interactivas para Adobe Learning Manager con un esfuerzo de codificación mínimo. Con esta integración, puede crear experiencias de aprendizaje personalizadas para los usuarios.

Para crear esta experiencia, ALM proporciona un paquete de sitios de referencia de Adobe Learning Manager (paquete de sitios de referencia de ALM) para AEM Sites en forma de archivo ZIP que puede instalar en la instancia de AEM Sites.

El paquete incluye plantillas de página web y componentes de sitio web de AEM Sites, junto con widgets incrustables, como, por ejemplo, catálogos de aprendizaje, calendarios, etc.

Después de instalar el paquete de sitios de referencia de ALM, puede comenzar a crear un sitio web para Adobe Learning Manager que puede alojar en la instancia de AEM Sites. Los usuarios pueden arrastrar y soltar los componentes en el sitio web.

Instalar paquete de sitios de referencia de ALM

Requisitos previos

• Licencias para AEM Sites y Adobe Commerce

• AEM local 6.5 o Adobe Experience Manager - Cloud Service
  

• Adobe Commerce 2.4.3

Después de proteger el entorno de AEM Sites, debe instalar el paquete de sitios de referencia de ALM. Este paquete incluye componentes de sitios web y páginas web de AEM que ayudan a crear la plataforma de aprendizaje.

El paquete de sitios de referencia se aloja en el repositorio de GitHub.

Para obtener más información, consulte el archivo README (Léame).

Crear una aplicación en Adobe Learning Manager

Después de instalar el paquete de sitios de AEM, debe configurar una aplicación de ALM para conectar el portal de aprendizaje con el sitio de AEM.

Esta situación se da cuando se utiliza AEM con Adobe Learning Manager.

Siga los pasos indicados a continuación:

1. Como administrador de integración, haga clic en Aplicaciones.
2. Para crear una nueva aplicación, en la esquina superior derecha de la página, haga clic en Registrar.
3. En la pantalla Registrar una nueva aplicación, introduzca la siguiente información:
   1. Nombre de la aplicación: el nombre de la aplicación que está creando.
   2. URL: la dirección URL de su organización.
   3. Dominios de redirección: los dominios de alojamiento del sitio web de AEM. También puede especificar caracteres comodín.
   4. Descripción: la descripción de la aplicación.
   5. Ámbitos: seleccione las opciones de acceso de lectura y escritura para la función de alumno.
   6. ¿Solo para esta cuenta?: seleccione Sí a fin de utilizar la aplicación para la cuenta de ALM existente.
4. Después de realizar los cambios, haga clic en Guardar.

Anote las credenciales de la aplicación que aparecen en la pantalla.

Para aprobar la aplicación, haga clic en Aprobar.

Obtener tokens

Configurar la cuenta de ALM en AEM

Proceso de inicio de sesión (Adobe Learning Manager, AEM y Adobe Commerce)

• Adobe Commerce solo admite nombre de usuario y contraseña y no admite ningún SSO basado en Saml de forma inmediata.
• La implementación del sitio de referencia de Adobe Learning Manager para AEM funciona con el nombre de usuario y la contraseña de Adobe Commerce.
• Una vez que obtengamos el token de Adobe Commerce, se compartirá con AEM backend de AEM js de cliente. AEM backend utilizará este token para obtener el correo electrónico del usuario poniéndose en contacto con Adobe Commerce. Con el correo electrónico y el token de actualización de administrador de ALM ya configurado, el token de acceso de ALM se generará para el alumno y se enviará a AEM Js de cliente para procesar los componentes de aprendizaje.

Proceso de inicio de sesión (Adobe Learning Manager y Adobe Commerce)

• De forma predeterminada, como Commerce no ofrece compatibilidad predeterminada con SSO, el usuario debe iniciar sesión dos veces, una en ALM y otra en Commerce.
• Sin embargo, si en el lado del comercio, si cualquiera de los SSO compatibles con ALM está habilitado (a través de extensiones o codificación personalizada) - basado en SAML 2.0, inicios de sesión en redes sociales como Facebook, Twitter, Linkedin, Microsoft o ID de Adobe, entonces el mismo IDP puede usarse para ALM y Commerce y puede evitar introducir las credenciales de inicio de sesión dos veces.

AEM + Adobe Learning Manager (usuarios que han iniciado sesión o que no)

Adobe Learning Manager le permite ahora mostrar su producto y cursos de formación a sus clientes y socios actuales y potenciales sin necesidad de crear una cuenta o iniciar sesión. Esta función le ayudará a impulsar la adopción del producto y la formación ofreciendo a los alumnos una vista previa rápida y sencilla de los cursos de formación, lo que ayuda a destacar y promocionar las características del producto. Por lo tanto, puede mostrar sus productos y ofertas, sobre todo, a clientes y socios potenciales, lo que aumentará el conocimiento de los productos. La facilidad de acceso y una mayor disponibilidad aumentan el interés, lo que ayuda a impulsar las inscripciones en cursos de formación y la adopción del aprendizaje. 

Con este flujo de trabajo, un alumno puede previsualizar un curso, acceder la información de formación o buscar un curso sin necesidad de iniciar sesión en Adobe Learning Manager. Este flujo de trabajo no es aplicable a la interfaz nativa de Learning Manager (aplicable SOLO para AEM Sites y otras interfaces descentralizadas).

Configurar y activar el conector de la plataforma de aprendizaje

En esta sección, se destacan los pasos necesarios para configurar y activar el siguiente conector:

Training Data Access

Este conector permite que la interfaz de usuario descentralizada basada en AEM Sites u otra personalizada recupere y procese información de formación para los alumnos y realice una búsqueda perfecta de información de formación antes o después de que el alumno inicie sesión. 

Este conector solo es necesario si utiliza interfaces basadas en AEM Sites u otras interfaces descentralizadas. 

El conector exporta los metadatos de formación a un almacén de datos y una solución de recuperación, así como a un sistema de activación de búsqueda. Por lo tanto, puede configurar la interfaz de usuario descentralizada basada en AEM Sites u otra personalizada para utilizar estos dos servicios con el fin de recuperar datos de formación, procesar páginas web y proporcionar a los alumnos una función de búsqueda de formación optimizada. Por ejemplo, una interfaz basada en AEM Sites que no tenga iniciada una sesión puede utilizar los metadatos exportados para ayudar al alumno a buscar y examinar páginas que muestren información de formación o acceder a ellas. 

Active este conector para crear y procesar páginas web basadas en AEM Sites y ofrecer experiencias personalizadas a los alumnos antes y después de iniciar sesión. Active este conector para crear y procesar páginas web basadas en AEM Sites y ofrecer experiencias personalizadas a los alumnos antes y después de iniciar sesión.

• URL base de cdn de Adobe Learning Manager: introduzca la dirección URL base de la ruta de servicio de CDN de recuperación de datos desde la página de conexión de Training Data Access.
  
• Token de actualización del administrador: introduzca el token de actualización determinado en la sección anterior. 
  
• URL base de metadatos de formación: introduzca la dirección URL base de la ruta de servicio de activación de búsqueda y recuperación de datos de búsqueda desde la página de conexión de Training Data Access.
• URL de registro de Adobe Learning Manager: introduzca la URL de registro automático generada por el administrador de integración para la cuenta, que utilizan los alumnos para inscribirse en cursos de formación.

AEM + Adobe Learning Manager + Adobe Commerce (usuarios que han iniciado sesión o que no)

Adobe Learning Manager ahora proporciona soluciones que le ayudan a integrar perfectamente la plataforma de aprendizaje con Adobe Commerce. Esta versión le permitirá conectar fácilmente las interfaces nativas basadas en sitios de AEM u otras interfaces de Learning Manager descentralizadas a Adobe Commerce. Esta integración le permite desarrollar las funciones de comercio electrónico en la plataforma de aprendizaje. Ahora puede ofrecer formación de pago a sus clientes y socios comerciales, así como permitir compras de formación fácilmente en interfaces de Learning Manager nativas y no nativas. Un alumno también puede previsualizar un curso, acceder la información de formación o buscar un curso sin necesidad de iniciar sesión en Adobe Learning Manager.

Un usuario puede utilizar la aplicación ya AEM y aprobarla en lugar de crear una.

• URL base de cdn de Adobe Learning Manager: introduzca la dirección URL base de la ruta de servicio de CDN de recuperación de datos desde la página de conexión de Adobe Commerce.
  
• URL de Adobe Commerce: introduzca la dirección URL de la instancia de Adobe Commerce que está utilizando. 
  
• Ruta de proxy de GraphQL: los componentes de Learning Manager del cliente acceden directamente al punto final de Adobe Commerce GraphQL y, por lo tanto, puede producirse un error de CORS. Para evitar este error, todas las llamadas deben servirse desde el mismo punto final que AEM o a través de un proxy que añada encabezados CORS.
  
• Nombre de almacén de Adobe Commerce: introduzca el nombre de almacén de Adobe Commerce determinado en la sección anterior. 
  
• Duración del token de cliente de Adobe Commerce (en segundos): introduzca la duración del token de cliente, que indica el periodo predeterminado para una sesión de inicio de sesión. 
  
• Token de actualización del administrador: introduzca el token de actualización determinado en la sección anterior.

Personalizar páginas web

Personalice sus páginas web mediante el sitio de referencias de AEM y los widgets disponibles. 

Crear páginas web

Además de las plantillas que puede utilizar que proporciona el paquete de sitios de referencia, también puede crear páginas web basadas en las plantillas de AEM.

Crear un sitio a partir de un modelo

El paquete del sitio de referencia de ALM proporciona un "Modelo del sitio de aprendizaje", que le permite crear un sitio web para su plataforma de aprendizaje. Los modelos de AEM le permiten crear páginas web directamente a partir de componentes de AEM Sites. No es necesario utilizar una plantilla. 

Codificar el sitio web

Además de utilizar las plantillas integradas y crear el sitio web desde cero mediante los componentes WYSIWYG, también puede escribir el código y crear el sitio.

El código se encuentra en el repositorio de GitHub del sitio de referencia para que pueda empezar.

Las partes principales de la plantilla son las siguientes: 

• núcleo: paquete de Java que contiene toda la funcionalidad del núcleo, como los servicios OSGi, las escuchas o los programadores, así como el código Java relacionado con los componentes, como los servlets o los filtros de solicitudes.
  
• ui.apps: contiene las partes /apps (y /etc) del proyecto, es decir, componentes, plantillas y bibliotecas de clientes JS&CSS.
  
• ui.content: incluye contenido de muestra mediante los componentes de ui.apps.
  
• ui.frontend: contiene componentes React.

Todo el código se encuentra en el repositorio para que pueda empezar a trabajar. 

Importar y añadir componentes de Learning Manager a una plantilla o una página web existentes

La instalación del paquete de sitios de referencia de AEM añade los componentes de Learning Manager a la instancia de AEM Sites. De forma predeterminada, puede añadir estos componentes al sitio de aprendizaje del proyecto web (sitio web) que proporcionamos listo para su uso. Estos componentes también están disponibles en el sitio web que cree a partir del modelo del sitio de aprendizaje.

Sin embargo, si desea utilizar estos componentes de Learning Manager recién añadidos a su proyecto o sitio web existentes, debe importarlos mediante el siguiente procedimiento.

El siguiente procedimiento permite que la plantilla cumpla las dependencias de bibliotecas de clientes de los componentes de Learning Manager importados.

Las páginas web que incluyen estos componentes deben cargar estas bibliotecas para procesar y utilizar correctamente los componentes.

1. En el editor de páginas de plantilla, haga clic en Información de página y, a continuación, en Política de página.
2. En la página de políticas, desplácese a Propiedades > Bibliotecas de clientes y añada estas a la página de plantilla:
   1. learning.site
   2. learning.ui
   3. learning.commerce

Después de guardar esta plantilla, puede añadir los componentes de Learning Manager en todas las páginas web derivadas de esta plantilla.