Manual de migración

Manual de referencia para los administradores de integración que desean migrar un LMS existente al LMS de Learning Manager

Escenario de uso usagescenario

En general, las grandes empresas tienen su LMS interno u otros sistemas de gestión de aprendizaje heredados suministrados por un proveedor. El LMS incluye datos y contenido de formación de la empresa. Como empresa, cuando adquiere Learning Manager, es posible que desee transferir los datos y el contenido de su LMS a Learning Manager para aprovechar las ventajas del LMS avanzado e intuitivo sin perder los datos antiguos de su empresa.

Learning Manager ofrece las especificaciones y las herramientas necesarias para que el administrador de integración de su empresa pueda configurar y realizar las tareas de migración.

A partir de hoy, los administradores de una empresa pueden acceder a la función Migración en Learning Manager poniéndose en contacto con el equipo de asistencia de Adobe. Para activar la función Migración en su cuenta, puede ponerse en contacto con el equipo de asistencia de Adobe Learning Manager.

Proceso de migración apidescription

En esta sección se describen los requisitos previos para la migración, los pasos clave del proceso de migración, los sprints de migración, las especificaciones y los pasos para la migración de contenido y datos:

Aviso importante sobre migración

Debe tener en cuenta que los plazos de migración dependen en gran medida de la calidad y el tamaño de los datos. Si necesita migrar durante la incorporación, planifique esta actividad con mucha antelación y colabore estrechamente con el equipo de incorporación de Adobe Learning Manager para evitar retrasos.

Requisitos previos prerequisites

El equipo de Learning Manager espera que los administradores de la integración de su empresa realicen las tareas siguientes antes de emprender el proceso de migración:

Learning Manager recomienda que los administradores prueben el proceso de migración en una cuenta para tal efecto antes de migrar los datos y el contenido al entorno de producción de Learning Manager.

Pasos clave del proceso de migración keystepsofmigrationprocess

Los pasos clave que conlleva la migración de contenido y datos de un LMS a Learning Manager son los siguientes:

La empresa puede empezar a utilizar el LMS de Learning Manager junto con el contenido heredado.

Alcance de los objetos de la migración scopeofmigrationobjects

Puede migrar contenido solo para los siguientes objetos de aprendizaje:

Conceptos clave de la migración keyconceptsofmigration

A continuación se describen brevemente algunos de los conceptos clave del proceso de migración de Learning Manager a fin de poderlos consultar si lo necesita en algún momento:

Proyecto de migración

En Learning Manager, un proyecto de migración consiste en uno o más sprints. También puede tener varios proyectos de migración para su cuenta. El proceso de migración en Learning Manager comienza con la creación de un proyecto de migración.

Sprint

En el proceso de migración de Learning Manager, un sprint se define como un conjunto de elementos de migración que ha decidido migrar desde el LMS actual. Un elemento de migración puede ser un módulo de curso, registros de alumnos o un conjunto de cursos. Puede tener varios elementos de datos de aprendizaje en un sprint. En cada sprint, es posible ejecutar trabajos de migración.

Ejecuciones de sprint

Una ejecución de sprint es el proceso de iniciar un trabajo de migración de sprint. La ejecución de sprint en cualquier momento del proceso.

Nuevas ejecuciones de sprint

Puede volver a ejecutar un sprint de migración después de su finalización en cualquier momento. Esta situación de nueva ejecución o repetición de un sprint ocurre cuando desea agregar datos en un elemento de sprint y volverlo a migrar a la aplicación nuevamente o corregir los errores en CSV.

Especificación en CSV

Learning Manager proporciona un conjunto de especificaciones CSV estándar. El procedimiento recomendado es revisar estas especificaciones CSV antes de comenzar con el proceso de migración. El administrador de integración de su empresa puede analizar los formatos de datos y asignarlos para que coincidan con los elementos de la plantilla CSV proporcionados por Learning Manager.

Etiquetas del proyecto de migración

Adobe Systems recomienda utilizar un conjunto de palabras clave como etiquetas para identificar fácilmente sus proyectos de migración dentro de la aplicación Learning Manager. Estas etiquetas le permiten identificar sus proyectos internamente en la aplicación Learning Manager en cualquier momento.

Módulo sin contenido

Learning Manager le permite cargar un módulo sin contenido. Adobe Systems lo considera un módulo sin contenido en Learning Manager. En un escenario en el que desee migrar algunos de los datos heredados de su LMS sin necesidad de ningún contenido, puede cargar el archivo module_version.csv sin referencia a la URL.

Especificaciones y ejemplos de CSV csv

A continuación, encontrará las especificaciones de CSV estándar que puede usar para correlacionar con los datos de migración de LMS. Haga clic en csv-specifications y sample-csvs para descargar los archivos zip. El archivo csv-specifications.zip descargado contiene siete archivos de hojas cálculo de Excel. Dichos archivos son especificaciones con descripciones para que comprenda cómo rellenar los archivos .csv. Los archivos .csv correspondientes deben contener los datos de cada campo en el formato prescrito tal como se explica en estos archivos .xlsx.

Learning Manager admite valores de fecha y hora solo en formato UTF 8 y de 32 bits. Es posible que aparezcan errores durante la migración si menciona la fecha en archivos CSV con una fecha fuera de rango, como 2038-07-17T08:53:21.000Z o 1980-04-17T08:13:25.322Z.

Debe tener en cuenta las siguientes dependencias en los archivos .csv durante la importación:

Orden del curso del programa de aprendizaje en archivos CSV de migración

En versiones anteriores de las especificaciones de migración, el archivo learning_program_course.csv incluía una columna de orden, lo que sugiere que se pueda controlar la secuencia de cursos dentro de un programa de aprendizaje durante la migración.

Adobe Learning Manager ya no utiliza esta columna. El orden de los cursos en un programa de aprendizaje no se puede controlar mediante archivos CSV de migración y el sistema omite los valores proporcionados en la columna del orden, aunque se haya establecido orderEnforced en true.

Para evitar confusiones, la columna de orden se ha eliminado de las especificaciones oficiales del archivo CSV. Si ya dispone de scripts o herramientas que aún generan esta columna, puede eliminarla de forma segura; esto no afecta a la forma en que se crean o muestran los programas de aprendizaje.

Proceso de migración migrationprocedure

Antes de comenzar el procedimiento de migración, es importante tener en cuenta los siguientes puntos:

Crear cuentas de FTP y Box creatingftpandboxaccounts

Es muy importante planificar el proyecto de migración. Se recomienda dividir los proyectos en varios sprints e identificar claramente lo que se desea migrar en cada sprint. Incluso puede ser buena idea hacer una validación después de cada sprint para tener seguridad sobre los datos migrados en ese sprint, en lugar de una validación a gran escala al final del proyecto. Antes de comenzar el sprint como parte del proyecto de migración, debe cargar archivos CSV de datos y contenido en servidores de FTP y Box, respectivamente. Si no tiene cuentas para FTP y Box personalizados, puede crearlas.

Crear una cuenta de Box

Cree una carpeta de carga de contenido en un proceso similar al de la creación de la carpeta FTP. Haga clic en Migración en el panel izquierdo; a continuación, haga clic en Solicitar una carpeta de carga de contenido en la parte inferior de la página que se abre.

Recibirá un correo de Box con un vínculo a la carpeta compartida. Si no tiene ninguna cuenta de Box, haga clic en Registrar y cree una. Las instrucciones de inicio de sesión se envían al ID de correo electrónico del administrador de la integración.

Cargar datos (archivos .csv) en carpetas de FTP o de Box

Crear una cuenta de FTP o de Box es un requisito previo para la creación de un proyecto de migración. Por lo tanto, en esta fase puede crear un proyecto de migración y un sprint en la aplicación Learning Manager. Consulte la sección  Procedimiento de migración de datos y contenido  en esta página para crear el proyecto de migración.

En la cuenta de FTP o de Box, haga clic en el nombre de la carpeta del proyecto y haga clic en el nombre del sprint. Dentro de la carpeta de sprints, puede cargar los archivos de datos .csv que desea migrar. Para cargar, haga clic en el botón Cargar archivos en la parte superior del servidor FTP o Box y suelte los archivos .csv. A continuación se muestra una captura de pantalla de ejemplo después de cargarla en FTP como referencia.

Puede volver al proyecto de migración de Learning Manager, hacer clic en Actualizar y ver todos los tipos de datos .csv que se enumeran para el sprint de migración.

Cargar contenido de formación en las carpetas de contenido

Suba el contenido de formación del LMS a su cuenta de Box. Si ya ha creado el proyecto de migración y el sprint, la cuenta de Box rellena el proyecto de migración y el nombre de sprint. Puede cargar el contenido en la misma ruta. Consulte la sección  Procedimiento de migración de datos y contenido  en esta página para crear el proyecto de migración.

Puede arrastrar y soltar los archivos de contenido, o bien hacer clic en Cargar y seleccionar los archivos en el escritorio. Si el tamaño del archivo de su contenido es muy grande, puede experimentar algún retraso en la carga de los archivos. El tiempo necesario para cargar los archivos en la cuenta de Box varía según el tamaño que tenga el archivo.

A continuación se muestra una captura de pantalla de la cuenta de Box después de subir contenido:

Archivos en la cuenta de Box

Una vez que los archivos se cargan en su cuenta de Box, asegúrese de mencionar la ruta relativa de este archivo de contenido de Box en el archivo module_version.csv. Es un paso obligatorio para que indique la ruta del contenido del módulo.

Después de iniciar sesión en los servidores de FTP y Box y de cargar el contenido, las ubicaciones de CSV aparecen como se muestra en la captura siguiente en Learning Manager.

Ubicaciones CSV en la cuenta de Box

Migración de alternativas y equivalentes

Información general

En este tema se describe el modelo de datos basado en CSV y el comportamiento de la migración para introducir la equivalencia de objetos de aprendizaje (LO) en el sistema.

Archivos CSV existentes (contexto)

Estos archivos CSV ya existen en la plataforma y proporcionan el objeto de aprendizaje principal, el módulo y el contexto de finalización (lista no exhaustiva):

Estos archivos se siguen utilizando tal cual y no se modifican con la nueva función de equivalencia, sino que forman los datos subyacentes sobre los que funcionará la equivalencia.

Nuevos archivos CSV para alternativas

Se han introducido dos nuevos archivos CSV para admitir las relaciones de alternativas de objetos de aprendizaje y las finalizaciones de usuarios relacionadas.

​1. equivalence_relations.csv

Define asignaciones de equivalencia entre objetos de aprendizaje (LO) de origen y destino, que pueden ser cursos o rutas de aprendizaje (LP).

Esquema:

Propósito:

equivalence_user_completed.csv

Captura la información de finalización a nivel de usuario para objetos de aprendizaje equivalentes, alineados con las relaciones definidas en equivalence_relations.csv.

Esquema:

Propósito:

Reglas de migración y semántica del comportamiento

​1. No hay compatibilidad de reconversión para archivos CSV nuevos equivalentes

Esto significa:

​2. Sin finalizaciones o infinalizaciones retroactivas de relaciones migradas

Cuando se introduce una relación de equivalencia mediante migración (es decir, mediante equivalence_relations.csv):

Implicación:

​3. Comportamiento para las nuevas finalizaciones después de la migración

Si:

a continuación:

Distinción de clave:

​4. Incidencia en objetos de aprendizaje de orden superior

Las finalizaciones alternativas que se reciben a través de CSV (es decir, a través de equivalence_user_completed.csv) activarán el nuevo cálculo de los objetos de aprendizaje de orden superior.

Los objetos de aprendizaje de orden superior pueden incluir:

Implicación técnica:

Webhooks para alternativos

Cuando un alumno finaliza un curso mediante una inscripción alternativa o una relación, Adobe Learning Manager genera un evento webhook dedicado que es distinto del webhook de finalización del curso estándar, lo que permite a las integraciones aplicar una lógica de gestión diferente para finalizaciones alternativas. Los eventos Webhook también se generan para la finalización retroactiva y la finalización retroactiva, y cubren los cambios históricos en el estado del curso, incluidos los que se derivan de las actualizaciones de las relaciones, de modo que los sistemas externos permanecen sincronizados con el estado de finalización actual del alumno.

Para obtener información sobre webhooks para alternativas, vea Webhooks para alternativas

Procedimiento de migración de datos y contenido dataandcontentmigrationprocedure

El procedimiento para migrar los datos y el contenido de LMS de su empresa a Learning Manager se explica a continuación:

Revise los requisitos previos del proceso de migración antes de comenzar con la migración. Consulte la sección Especificaciones y ejemplos de CSV en esta página, y prepare los archivos .csv para la migración de datos y contenido.

Verificación de la migración registration

Después de migrar los datos y el contenido de aprendizaje del LMS heredado de la empresa, puede verificar dichos datos y contenido importados utilizando diferentes funciones de los objetos de aprendizaje. Por ejemplo, puede iniciar sesión en la aplicación Learning Manager como administrador y verificar la disponibilidad de los datos y el contenido de los cursos y módulos importados.

Migración mediante API

Adobe Learning Manager (ALM) proporciona una función de migración para ingestar datos o contenido de sistemas externos, utilizada principalmente para migrar desde plataformas de LMS anteriores.

Sin embargo, algunas organizaciones pueden requerir que este proceso se ejecute de forma regular (por ejemplo, de forma nocturna o semanal), en lugar de realizar una importación única.

Como ejemplo, verás cómo un cliente ficticio (NovaFX) se integra con un proveedor externo ficticio (SquareCorp) y automatiza las migraciones programadas. La integración permite:

Requisitos de integración

SquareCorp debe proporcionar:

Definiciones clave

Automatizar la ejecución del sprint

Cree una aplicación o script que realice lo siguiente según una programación:

Detalles de API

Iniciar una ejecución de migración

Extremo: POST /primeapi/v2/bulkimport/startrun

Parámetros:

Comprobar si puede comenzar la sincronización

Asegúrese de que el contenido se pueda sincronizar con la carpeta de sprint. No copie archivos de contenido o metadatos en la carpeta FTP a menos que esta API devuelva un objeto de respuesta correcto.

Extremo: GET /primeapi/v2/bulkimport/cansync

Parámetros:

Respuesta correcta

{
    "status": "OK",
    "title": "BULKIMPORT_CAN_SYNC_NOW",
    "source": {
        "info": "Yes"
    }
}

Respuesta correcta

{
    "status": "BAD_REQUEST",
    "title": "BULKIMPORT_ERROR_CANNOT_SYNC",
    "source": {
        "info": "Error, No active projects"
    }
}

Posibles respuestas de API

Ejemplo de flujo de integración

limitaciones

Las API de migración no proporcionan funcionalidad para comprobar los errores relacionados con la migración directamente en el archivo CSV de salida después de la ejecución del sprint. Sin embargo, estos errores se pueden revisar como filas dentro del archivo CSV accediendo a la interfaz de usuario del administrador de integración después de una ejecución de sprint.

Verificación de la migración mediante API

La API de migración, runStatus, permite a los administradores de integración realizar un seguimiento del progreso de las ejecuciones de migración desencadenadas a través de la API.

La API runStatus también proporciona un vínculo directo para descargar registros de errores en formato CSV para las ejecuciones completadas. El vínculo de descarga permanece activo durante siete días y los registros se conservan durante un mes.

Curl de muestra

Punto final

GET /bulkimport/runStatus

Parámetros

Respuesta

{
  "sprintId": 2510080,
  "sprintRunId": 2740845,
  "migrationProjectId": 2509173,
  "startTime": 1746524711052,
  "endTime": 1746524711052,
  [
    {
      "id": 2609923,
      "lastHeartbeatTime": 1746524711052,
      "objectName": "content",
      "jobState": "COMPLETED",
      "errorCsvLink": "",
      "errorLogLink": "migration/5830/2509173/2510080/2740845/content_err.csv",
      "sequenceNumber": 1
    },
    {
      "id": 2609922,
      "lastHeartbeatTime": 1746524713577,
      "objectName": "course",
      "jobState": "WAITING_IN_QUEUE",
      "errorCsvLink": "",
      "errorLogLink": null,
      "sequenceNumber": 2
    }
  ]
}

Además, la respuesta de API startRun ahora incluye el id. del proyecto de migración, el id. de sprint y el id. de ejecución de sprint, que son necesarios para consultar el nuevo extremo de estado.

curl -X GET --header 'Accept: text/html' 'https://learningmanager.adobe.com/primeapi/v2/bulkimport/runStatus?migrationProjectId=001&sprintId=10001&sprintRunId=7'

Produce la siguiente respuesta. La respuesta contiene:

Respuesta

{
  "status": "OK",
  "title": "BULKIMPORT_RUN_INITIATED_SUCCESSFULLY",
  "source": {
    "info": "Success",
    "migrationInfo": {
      "migrationProjectId": "001",
      "sprintId": "10001",
      "sprintRunId": "7"
    }
  }
}

Readaptación de la migración retrofittinginmigration

Esta función de integración le permite adaptar datos históricos para un objeto de aprendizaje de un sistema de gestión de aprendizaje antiguo a un curso activo que se crea en Learning Manager.

A continuación, encontrará las especificaciones de CSV estándar que puede usar para correlacionar con los datos de migración de LMS. Haga clic en csv-specifications y sample-csvs para descargar los archivos zip. El archivo csv-specifications.zip descargado contiene cuarto archivos de hojas de cálculo de Excel. Dichos archivos son especificaciones con descripciones para que comprenda cómo rellenar los archivos .csv. Los archivos .csv correspondientes deben contener los datos de cada campo en el formato prescrito tal como se explica en estos archivos .xlsx.

1-enrollment.xlsx-contiene descripciones de los metadatos requeridos para el archivo retrofit_enrollment.csv.

2-certification_enrollment.xlsx-contiene descripciones de los metadatos requeridos para el archivo retrofit_certification_enrollment.csv.

3-learning_program_enrollment.xlsx-contiene descripciones de los metadatos requeridos para el archivo retrofit_learning_program_enrollment.csv.

4-user_course_grades.xlsx-contiene descripciones de los metadatos requeridos para el archivo retrofit_user_course_grades.csv.
csv-specifications.zip

Solución de problemas de migración troubleshootingmigrationissues

Consulte este artículo para obtener información sobre la solución a los problemas a los que se enfrentan los administradores de integración al migrar datos y contenido de su LMS existente a la aplicación Learning Manager.

Consejos para la administración de usuarios usermanagement

En este tema, encontrará algunos consejos para comprender cómo se consideran y administran los usuarios en Learning Manager. Estos conceptos le ayudarán a administrar mejor los usuarios utilizando la importación de CSV, los conectores y las funciones de migración de Learning Manager.

ID de Learning Manager captivateprimeids

Learning Manager proporciona dos tipos de ID únicos para los usuarios:

Learning Manager admite UUID para ofrecer flexibilidad a las empresas en el control de las cuentas de usuarios. Como administrador, si tiene UUID de usuarios en una cuenta, puede modificar los ID de correo electrónico de los usuarios de esa cuenta.

Escenario de uso de UUID en una empresa

Supongamos que un empleado A se une a una empresa denominada Learning Manager como contratista. Durante el período de contrato, es posible que la empresa de Learning Manager no proporcione el ID de correo electrónico de la empresa como A@example.com. En su lugar, la empresa puede considerar solo la cuenta de correo electrónico personal del empleado, por ejemplo, A@gmail.com. Después de completar 6 meses del período de contrato, si el mismo empleado A se une a Learning Manager como empleado a tiempo completo, es posible que Learning Manager desee cambiar su ID de correo electrónico a su ID de correo electrónico de empresa: A@example.com.

Tener acceso UUID a la cuenta de usuario beneficiará a la empresa Learning Manager en la hipótesis mencionada anteriormente. La empresa Learning Manager puede reemplazar fácilmente la identificación de correo electrónico personal del empleado A con una identificación de correo electrónico oficial. Este cambio no afectará a los registros del empleado correspondientes a esta cuenta.

Identificación de usuario único singleuseridentification

Learning Manager identifica y recuerda cómo se le añade un usuario único, por ejemplo mediante el registro automático, cargando un archivo .csv o añadiendo un solo usuario mediante la interfaz de usuario o una API.

Asignar la función de responsable assigningmanagerrole

No puede asignar una función de responsable directamente a ningún usuario en Learning Manager. Un usuario X puede convertirse en responsable de Learning Manager solo cuando establece un atributo de responsable de cualquier usuario (por ejemplo, Y) en esa cuenta como X.

En el supuesto de que X es el responsable de los usuarios, por ejemplo A, B y C, si X abandona la empresa, debe asegurarse de que el atributo Responsable de A, B y C esté configurado en el nuevo responsable. Una alternativa es establecer el atributo Responsable de estos usuarios como ROOT temporalmente y asignar el nuevo nombre de responsable más adelante.

Para obtener más información sobre este tema, consulte el siguiente contenido de la Ayuda:

Cambios en la API

La versión de abril de 2026 de Adobe Learning Manager ofrece mejoras específicas en la API pública en las áreas de alternativas y equivalentes, acceso a contenido con ventana de tiempo, intentos de cuestionario basados en contenido, experiencias de alumno sin sesión iniciada y administración de ayudas de trabajo. Estas actualizaciones están diseñadas para seguir siendo en gran medida compatibles con versiones anteriores, al tiempo que permiten patrones de integración más precisos y ampliables.

Para ver los cambios de la API, vea Cambios de la API.