迁移手册

本参考手册适用于希望将现有 LMS 迁移到 Adobe Learning Manager LMS 的集成管理员

使用场景 usagescenario

大型企业通常都有内部自有或由其他供应商提供的旧版学习管理系统。 这些 LMS 中通常包含相关企业的培训内容和培训数据。 企业在购买 Adobe Learning Manager 时，可能希望将现有的 LMS 内容和数据移至 Adobe Learning Manager，从而既不丢失公司的旧数据，又能充分利用现代直观的 LMS 的优势。

Adobe Learning Manager 提供了各种必要的工具和规范，可供公司的集成管理员设置并执行相关迁移任务。

即日起，企业管理员可以联系 Adobe 支持团队来访问 Adobe Learning Manager 的迁移功能。 要为帐户启用迁移功能，请联系 Adobe Learning Manager 支持团队。

迁移过程 apidescription

本节中对有关迁移的先决条件、迁移过程中的关键步骤、迁移 Sprint、规范、数据和内容迁移步骤等信息说明如下：

重要迁移建议

您应了解，迁移时间轴在很大程度上取决于数据的质量和大小。 如果您在登入期间需要迁移，请提前计划此活动，并与Adobe Learning Manager登入团队紧密合作以避免延迟。

先决条件 prerequisites

Adobe Learning Manager 团队希望公司的集成管理员在进行迁移之前先执行以下任务：

Adobe Learning Manager 建议，在将数据和内容迁移到 Adobe Learning Manager 生产环境之前，管理员可以先在试用帐户中测试一下迁移过程。

迁移过程中的关键步骤 keystepsofmigrationprocess

将内容和数据从现有 LMS 迁移到 Adobe Learning Manager 时需要完成以下关键步骤：

公司现在即可在 Adobe Learning Manager LMS 中使用旧版内容了。

迁移对象的范围 scopeofmigrationobjects

只能迁移以下学习对象的内容：

迁移的关键概念 keyconceptsofmigration

以下简要介绍了 Adobe Learning Manager 迁移过程的一些关键概念，仅供参考：

迁移项目

在 Adobe Learning Manager 中，迁移项目由一个或多个 Sprint 组成。 您的帐户可以拥有多个迁移项目。 Adobe Learning Manager 的迁移过程从创建迁移项目开始。

Sprint

在 Adobe Learning Manager 迁移过程中，Sprint 用于定义已被选中从现有 LMS 迁移的一组迁移项。 迁移项可以是课程模块、学习者记录或一组课程。 一个 Sprint 可以包含多个学习数据项。 您可以通过每个 Sprint 执行所需的迁移作业。

Sprint 运行

“Sprint 运行”是指开始 Sprint 迁移作业的过程。 您可以在“Sprint运行”的任何时间点停止“运行”。

Sprint 重新运行

您可以在迁移 Sprint 完成后的任何时间点重新执行迁移 Sprint。 如果需要在某个 Sprint 项中附加更多数据并将其再次迁移，或者需要更正 CSV 中的错误，便可重新执行或重新运行 Sprint。

CSV 规范

Adobe Learning Manager 提供了一套标准的 CSV 规范。 最佳做法是，在迁移之前先完整了解这些 CSV 规范。 公司的集成管理员可对现有的数据格式进行分析和映射，以便与 Adobe Learning Manager 提供的 CSV 模板项相匹配。

迁移项目标签

Adobe Systems 建议使用一组关键字作为标签，以便在 Adobe Learning Manager 应用程序中轻松识别迁移项目。 您可以通过这些标签，在任何时间点在 Adobe Learning Manager 应用程序内部识别您的项目。

无内容模块

Adobe Learning Manager 允许上传无内容的模块。 Adobe Systems 会将其视为 Adobe Learning Manager 中的无内容模块。 如果需要从现有 LMS 迁移某些旧数据而不需要其内容，您可以上传不含任何 URL 引用的 module_version.csv 文件。

CSV 规范和示例 CSV csv

标准的 CSV 规范如下所示，可用于映射现有的 LMS 迁移数据。 单击 csv-specifications 和 sample-csvs 以下载 zip 文件。 下载的csv-specifications.zip包含七个Excel工作表文件。 这些 excel 工作表文件是带有说明的规范，便于您了解 .csv 文件的填写方法。 相应的 .csv 文件中应包含各个字段的数据，而这些数据应符合这些 .xlsx 文件中所述的规定格式。

Adobe Learning Manager 仅支持 UTF 8 和 32 位格式的日期和时间值。 如果您在CSV文件中提及的日期超出范围（例如2038-07-17T08:53:21.000Z或1980-04-17T08:13:25.322Z），则在迁移期间可能会出错。

在导入期间，您需要了解 CSV 文件的以下依赖关系：

迁移CSV文件中的学习计划课程顺序

在迁移规范的早期版本中，learning_program_course.csv文件包含顺序列，建议您在迁移期间控制学习计划中的课程顺序。

Adobe Learning Manager不再使用此列。 学习计划中的课程顺序无法通过迁移CSV进行控制，即使您将​ orderEnforced ​设置为True，系统也会忽略“顺序”列中提供的任何值。

为避免混淆，已从官方CSV规范中删除了订单列。 如果您已有脚本或工具仍在生成此列，则可放心将其删除；这不会影响学习计划的创建或显示方式。

迁移程序 migrationprocedure

在迁移之前，请务必注意以下几点：

创建 FTP 和 Box 帐户 creatingftpandboxaccounts

迁移项目规划非常重要。 建议将项目分解为多个 Sprint，并明确界定各个 Sprint 中需要迁移的内容。 建议在每个 Sprint 完成后，进行一些数据验证，确保该 Sprint 中迁移的数据准确无误，而不要留到整个项目结束时进行一次大规模验证。 在开始迁移项目 Sprint 之前，您需要分别向 FTP 和 Box 服务器上传相关的数据和内容 CSV 文件。 如果您没有自定义FTP和Box的帐户，则可以创建它们。

创建 Box 帐户

内容上传文件夹的创建与 FTP 文件夹相似，具体如下。 单击左侧窗格中的“迁移”，然后在随后显示的页面底部单击“请求内容上传文件夹”。

您会收到 Box 的电子邮件，其中包含指向该共享文件夹的链接。 如果没有 Box 帐户，请单击“注册”创建一个。 相关登录说明会发送到集成管理员的电子邮件 ID。

将数据（.csv 文件）上传到 FTP 文件夹或 Box 文件夹

创建 FTP 或 Box 帐户是创建迁移项目的先决条件。 因此，在此阶段，您可以在Learning Manager应用程序中创建迁移项目和Sprint。 请参阅本页​ “数据和内容迁移程序” ​部分来创建迁移项目。

在 FTP 或 Box 帐户中，单击项目文件夹名称，然后单击 Sprint 名称。 在 Sprint 文件夹中，您可以上传需要迁移的 .csv 数据文件。 要上传，请单击FTP或Box服务器顶部的“上传文件”按钮，然后删除.csv文件。 上传到FTP后的示例快照如下所示，供您参考。

您可以返回Learning Manager迁移项目，单击​ 刷新 ​并查看迁移Sprint中列出的所有.csv数据类型。

将培训内容上传到内容文件夹

将现有 LMS 中的培训内容上传到 Box 帐户。 如果已创建了“迁移”项目和 Sprint，则 Box 帐户将会填充相应的“迁移”项目和 Sprint 名称。 您可以按同一路径上传内容。 请参阅本页​ “数据和内容迁移程序” ​部分来创建迁移项目。

您可以拖放内容文件，也可以单击​ “上传” ​并选择计算机中的文件。 如果内容文件过大，在上传时可能会出现一些延迟。 根据文件大小不同，上传到 Box 帐户所需的时间会有所不同。

以下是将内容上传到 Box 帐户后的示例快照，仅供参考：

Box帐户中的文件

将文件上传到 Box 帐户后，请确保在 module_version.csv 文件中提供此 Box 内容文件的相对路径。 这是指示模块内容路径的必需步骤。

登录 FTP 和 Box 服务器并上传内容后，Adobe Learning Manager 中即会显示相应的 CSV 位置（如以下快照所示）。

Box帐户中的CSV位置

替代项和等效项的迁移

概述

本主题概述了在系统中引入学习对象(LO)等价性的基于CSV的数据模型和迁移行为。

现有CSV文件（上下文）

这些CSV已存在于平台中，可提供主要学习对象、模块和完成上下文（非详尽列表）：

这些文件将继续按原样使用，并且不会因新的对等功能而改变，但它们构成了对等操作将基于的基础数据。

替代项的新CSV文件

引入了两个新的CSV以支持学习对象替代关系和相关用户完成。

1. equivalence_relationships.csv

定义源学习对象（可以是课程，也可以是学习路径，即LP）与目标学习对象（即LO）之间的等价映射。

架构：

目的：

equivalence_user_completion.csv

捕获等效学习对象的用户级完成信息，这些信息与equivalence_relationship.csv中定义的关系一致。

架构：

目的：

迁移规则和行为语义

​1. 不支持新等效项CSV

这意味着：

​2. 没有来自迁移关系的追溯完成/不完成

通过迁移（即通过equivality_relationships.csv）引入等价关系时：

含义：

​3. 迁移后新完成时的行为

如果：

然后：

关键区别：

​4. 对高阶学习对象的影响

通过CSV传入的替代完成（即通过equivalence_user_completion.csv）将触发重新计算高阶学习对象。

高阶学习对象可能包括：

技术含义：

替代的Webhook

当学习者通过替代注册或关系完成课程时，Adobe Learning Manager会生成专用的Webhook事件，与标准课程完成Webhook不同，允许集成对替代完成应用不同的处理逻辑。 系统还会生成Webhook事件以用于追溯完成和追溯完成，涵盖课程状态的历史更改，包括那些由关系更新驱动的更改，以便外部系统与学习者的当前完成状态保持同步。

有关替代的Webhook的信息，请查看替代的Webhook

数据和内容迁移程序 dataandcontentmigrationprocedure

将企业 LMS 数据和内容迁移到 Adobe Learning Manager 的程序如下：

在开始迁移之前，应详细了解迁移过程的先决条件。 请参阅本页“CSV 规范和示例 CSV”部分，并准备进行数据和内容迁移所需的 CSV 文件。

迁移验证 registration

在对公司旧 LMS 系统的学习数据和内容完成迁移后，您可使用各种学习对象功能对导入的数据和内容进行验证。 例如，您可以管理员身份登录 Adobe Learning Manager 应用程序，然后对导入的模块及课程数据和内容进行可用性验证。

使用API迁移

Adobe Learning Manager (ALM)提供了从外部系统摄取数据或内容的迁移功能，主要用于从旧版LMS平台迁移。

但是，某些组织可能要求此流程定期运行（例如，每夜或每周），而不是作为一次性导入运行。

例如，您将看到一个虚构的客户(NovaFX)如何与一个虚构的外部提供商(SquareCorp)集成并自动化计划的迁移。 该集成允许：

集成要求

SquareCorp必须提供：

关键定义

自动执行Sprint

生成可按计划执行以下操作的应用程序或脚本：

API详细信息

启动迁移运行

终结点： POST/primeapi/v2/bulkimport/startrun

参数：

检查是否可以开始同步

确保内容可以同步到Sprint文件夹。 除非此API返回成功的响应对象，否则请勿将内容或元数据文件复制到FTP文件夹。

终结点： GET/primeapi/v2/bulkimport/cansync

参数：

响应成功

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

响应成功

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

可能的API响应

集成流程示例

限制

迁移API不提供在执行Sprint后直接在输出CSV文件中检查迁移相关错误的功能。 但是，通过在Sprint运行后访问集成管理员用户界面，可将这些错误作为CSV文件中的行进行审阅。

通过API进行迁移验证

迁移API runStatus允许集成管理员跟踪通过API触发的迁移运行的进度。

runStatus API还提供了一个直接链接，可用于以CSV格式下载已完成运行的错误日志。 下载链接将保持活动状态七天，日志将保留一个月。

卷曲示例

端点

GET /bulkimport/runStatus

参数

响应

{
  "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
    }
  ]
}

此外，startRun API响应现在包括迁移项目ID、Sprint ID和Sprint运行ID，这些都是查询新状态终结点所必需的。

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

生成以下响应。 响应包含：

响应

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

在迁移时翻新 retrofittinginmigration

此集成功能可让您将旧版学习管理系统中学习对象的历史数据更新到 Adobe Learning Manager 所创建的活动课程中。

标准的 CSV 规范如下所示，可用于映射现有的 LMS 迁移数据。 单击 csv-specifications 和 sample-csvs 以下载 zip 文件。 下载的 csv-specifications.zip 中包含 4 个 Excel 工作表文件。 这些 excel 工作表文件是带有说明的规范，便于您了解 .csv 文件的填写方法。 相应的 .csv 文件中应包含各个字段的数据，而这些数据应符合这些 .xlsx 文件中所述的规定格式。

1-enrollment.xlsx 中包含对 retrofit_enrollment.csv 文件所需元数据的描述。

2-certification_enrollment.xlsx 中包含对 retrofit_certification_enrollment.csv 文件所需元数据的描述。

3-learning_program_enrollment.xlsx 中包含对 retrofit_learning_program_enrollment.csv 文件所需元数据的描述。

4-user_course_grades.xlsx 中包含对 retrofit_user_course_grades.csv 文件所需元数据的描述。
csv-specifications.zip

解决迁移问题 troubleshootingmigrationissues

请参阅此文章，了解集成管理员在将数据和内容从其现有LMS迁移到Learning Manager应用程序时所面临的问题的解决方法/解决方案。

用户管理提示 usermanagement

在本主题中，您可以了解有关在 Adobe Learning Manager 中进行用户管理的方法提示。 这些概念可帮助您在使用 CSV、连接器和 Adobe Learning Manager 的迁移功能时更好地管理用户。

Adobe Learning Manager ID captivateprimeids

Adobe Learning Manager 为用户提供两种类型的唯一 ID：

Adobe Learning Manager 支持 UUID，方便公司对用户帐户进行灵活控制。 作为管理员，如果拥有某个帐户中用户的 UUID，则可以修改该帐户中用户的电子邮件 ID。

公司中 UUID 的使用场景

考虑员工A加入名为Learning Manager的公司作为承包商的情况。 在合同期内，Learning Manager公司不得将公司电子邮件ID提供为A@example.com，而是可以仅考虑员工的个人电子邮件帐户，例如A@gmail.com。 在完成6个月的合同期后，如果同一名员工A加入Learning Manager成为全职员工，则Learning Manager可能希望将他的电子邮件ID更改为公司电子邮件ID： A@example.com。

在上述场景中，拥有对用户帐户的 UUID 访问权将使 Adobe Learning Manager 公司受益。 Adobe Learning Manager 公司可轻松使用公司邮箱 ID 替换员工 A 的个人邮箱 ID。 与此帐户相关的员工记录则不受此更改的影响。

个人用户识别 singleuseridentification

Adobe Learning Manager 会识别并记住个人用户的加入方式，例如：通过自助注册、通过 CSV 上传、或者通过用户界面或 API 添加。

分配“经理”角色 assigningmanagerrole

您无法在 Adobe Learning Manager 中将“经理”角色直接分配给任何用户。 只有在您将该帐户中的某个用户（例如 Y）的“经理”属性设置为 X 时，用户 X 才能成为 Adobe Learning Manager 的“经理”。

如果 X 是其他用户（例如 A、B 和 C）的“经理”，则在 X 从公司离职时，您需要确保将 A、B 和 C 的“经理”属性设置为新“经理”。 或者，您也可以暂时将这些用户的“经理”属性设置为“ROOT”，稍后再分配新的“经理”姓名。

有关此主题的更多信息，请参阅以下帮助内容：

API 更改

2026年4月版Adobe Learning Manager在替代项和对等项、时间窗口内容访问、内容驱动测验尝试、未登录学习者体验和工作辅助管理等领域对公共API进行了有针对性的增强。 这些更新旨在很大程度上保持向后兼容，同时实现更精确和更可扩展的集成模式。

对于API更改，请查看API更改。