迁移手册

上次更新日期： 2024年1月24日

注意：

Adobe Learning Manager 中“学习计划”更名为“学习路径”。 2021 年 10 月之后的版本会立即体现此变化，“学习路径”这一术语适用于所有角色。

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

概述

Adobe Learning Manager 是一款基于云端、以学习者为中心的自助式学习管理解决方案。Adobe 能让企业将现有学习管理系统 (LMS) 中的培训数据与培训内容迁移到 Adobe Learning Manager LMS 应用程序。

使用场景

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

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

注意:

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

迁移过程

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

先决条件

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

集成管理员提取现有 LMS 中的数据和内容，并将其转换为 Adobe Learning Manager 定义的文件格式。
Adobe Learning Manager 不支持在迁移时导入任何用户，并希望公司使用连接器导入用户。Adobe Systems 希望在迁移之前先配置好这些连接器。有关更多信息，请参阅 Adobe Learning Manager 连接器帮助。

注意:

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

迁移过程中的关键步骤

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

集成管理员或合作伙伴应对需要迁移的现有 LMS 数据和内容进行评估。
集成管理员应对 Adobe Learning Manager 提供的用于引入数据和内容的工具和规范进行评估。
集成管理员应根据旧版 LMS 的功能编写相应的导出代码或手动从旧版 LMS 导出培训数据和内容。
在导出相关培训数据和内容后，集成管理员应对这些数据和内容进行分析和映射，以符合 Adobe Learning Manager 迁移规范。
集成管理员应使用 Adobe Learning Manager 提供的工具按以下顺序进行迁移：
1. 将学习者迁移到 Adobe Learning Manager
2. 将培训内容迁移到 Adobe Learning Manager 并
3. 最后，将培训数据迁移到 Adobe Learning Manager。

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

迁移对象的范围

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

模块
徽章
课程
模块版本
课程实例
课程模块
技能
技能级别
技能课程
认证
认证课程
认证提交
学习计划
学习计划课程
学习计划实例
学习计划课程实例
工作辅助
工作辅助版本
工作辅助课程
工作辅助技能
注册
认证注册
学习计划注册
工作辅助注册
用户课程等级

迁移的关键概念

以下简要介绍了 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 文件完成多语言迁移，该文件会使用额外的列来支持其他语言。

先决条件

以集成管理员身份创建迁移项目，然后与 ALM 支持团队共享迁移项目 ID，以便从后端启用多区域设置标志。

对区域迁移对象的范围

模块
课程
模块版本
认证
学习计划
工作辅助
工作辅助版本

CSV 规范

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

对多区域设置支持的更改

module_version.csv 和 course_module.csv 不支持 module_version 列。
无法在同一运行中更新 module_version（在同一运行中，模块无法迁移带有同一模块的两个版本）。
将内容或元数据更新视作 module_version csv 中的模块版本更新。
无法通过 job_aid_version.csv 支持 Job_Aid_Version 更新

CSV 规范和示例 CSV

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

序号	文件名	内容描述	备注
1	module.xlsx	module.csv 的元数据
2	badge.xlsx	badge.xlsx 的元数据
3	course.xlsx	course.csv 的元数据	对每个课程提及一个作者姓名，因为许多作者姓名在迁移后的应用程序中有时无法正确显示。已删除 courseCreationDate 字段。
4	module_version.xlsx	module_version.csv 的元数据	确保提供用于存放上传内容的 Box 帐户文件夹的 URL 路径。
5	course_instance.xlsx	course_instance.csv 的元数据
6	session.xlsx	session.csv 的元数据	确保会话 csv 中的每个条目至少与一个“课堂/虚拟课堂”模块相关联
7	course_module.xlsx	course_module.csv 的元数据
8	skill.xlsx	skill.csv 的元数据
9	skill_level.xlsx	skill_level.csv 的元数据
10	skill_course.xlsx	skill_course.csv 的元数据
11	certification.xlsx	Certification.csv 的元数据	已删除 certificationCreationDate 字段。
12	certification_course.xlsx	certification_course.csv 的元数据
13	certification_commit.xlsx	certification_commit.csv 的元数据
14	learning_program.xlsx	learning_program.csv 的元数据	已删除 dateAdded 字段。
15	learning_program_course.xls	learning_program_course.csv 的元数据
16	learning_program_instance.xlsx	learning_program_instance.csv 的元数据
17	learning_program_instance_course_instance.xlsx	learning_program_instance_course_instance.csv 的元数据
18	job_aid.xlsx	job_aid.csv 的元数据	所迁移的每个 job_aid 均需拥有一个或多个 job_aid 版本。
19	Job_aid_version.xlsx	job_aid_version.csv 的元数据
20	job_aid_course.xlsx	job_aid_course.csv 的元数据
21	job_aid_skills.xlsx	job_aid_skills.csv 的元数据
22	enrollments.xlsx	enrollments.csv 的元数据
23	certification_enrollement.xlsx	certification_enrollement.csv 的元数据
24	learning_program_enrollment.xlsx	learning_program_enrollment.csv 的元数据
25	job_aid_enrollment.xlsx	job_aid_enrollment.csv 的元数据
26	user_course_grade.xlsx	user_course_grade.csv 的元数据	在 .csv 文件中提供所需的学习者记录数据（即使这些并非必需数据）。如果没有此数据，即使对该 .csv 进行了迁移处理，Adobe Learning Manager 应用程序也可能无法呈现任何数据。sample-csvs.zip 文件中包含 7 个 .csv 文件，其命名约定同上。

注意:

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

下载

获取文件

sample-csvs.zip

获取文件

CSV-Specifications.zip

多语言迁移

对于平台中支持的所有类型的内容和培训（课程、学习路径、模块、认证和工作辅助），系统支持通过 CSV 文件完成多语言迁移，该文件会使用额外的列来支持其他语言。

您可下载以下 zip 文件，了解会在迁移中用到的 CSV 示例规范。

下载

获取文件

迁移多个区域设置

注意:

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

module_version.csv 依赖于 module.csv
course_instance.csv 依赖于 course.csv
course_module.csv 依赖于 course.csv、module.csv 和 module_version.csv
course_instance.csv 依赖于 course.csv
session.csv 依赖于 course.csv 和 module.csv
enrollment.csv 依赖于 course.csv
user_course_grade.csv 依赖于 course.csv 和 module.csv
skill_course.csv 依赖于 course.csv
skill_level.csv 依赖于 skill.csv
learning_program_instance.csv 依赖于 learning_program 和 learning_program_course.csv
learning_program_course.csv 依赖于 learning_program.csv
learning_program_enrollment.csv 依赖于 learning_program 和 learning_program_instance.csv
learning_program_instance_course_instance.csv 依赖于 learning_program.csv、learning_program_instance.csv 和 course_instance.csv
certification_course.csv 依赖于 certification.csv 和 course.csv
certification_commit.csv 依赖于 certification.csv 和 certification_course.csv
certification_enrollment.csv 依赖于 certification.csv、certification_course.csv 和 certification_enrollment.csv

迁移程序

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

在任何时间点，每个帐户只能有一个活动的迁移项目。在任何时间点，每个项目只能有一个活动的 Sprint。
正在迁移的“运行”无法撤消。然而，您可以使用 Adobe Learning Manager 各项功能中的删除选项来撤消对相关数据或内容的迁移。
迁移项目一旦开启，即会进入“迁移中”状态。在迁移期间，除集成管理员角色之外，其他任何角色均无法登录 Adobe Learning Manager。

创建 FTP 和 Box 帐户

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

创建 FTP 帐户

单击“请求 CSV FTP 文件夹”。此时会弹出一个对话框，提示您输入电子邮件 ID。仔细阅读在线说明并创建 Exavault FTP 帐户。创建帐户后，即可在 Exavault FTP 中查看迁移项目和 Sprint 项目文件夹。

以下是 ExaVault 中的项目文件和文件夹示例快照，仅供参考。

创建 Box 帐户

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

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

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

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

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

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

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

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

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

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

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

数据和内容迁移程序

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

注意:

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

以集成管理员身份登录 Adobe Learning Manager 应用程序，然后单击左侧窗格中的“迁移”。

此时会显示“迁移项目”主页。如果公司已经创建了迁移项目，则可以在此页面中查看所有迁移项目的列表。
单击页面右上角的“新建”可创建迁移项目。或者，您也可以单击页面中的“创建迁移项目”链接来创建迁移项目。此时会显示“创建迁移项目”页面。

注意:

如果尚未创建 FTP 文件夹，系统会提示您创建一个 FTP文件夹 Exavault 帐户。在创建迁移项目之前，必须先完成这一步。

创建新迁移项目

提供迁移项目的项目名称、项目标签、课程目录和描述。单击“创建”。

迁移数据项将通过此“迁移项目标签”进行识别。如果没有特定的课程目录，请从下拉列表中选择默认目录。您使用迁移项目所迁移的所有课程均包含在您此时选择的目录中。如果不选择任何目录，则迁移的所有课程均会包含在默认目录中。

下载

获取文件
目录标签迁移

获取文件
目录标签 csv
此时会显示 Sprint 配置页面（如以下快照所示）。您需要为迁移项目创建一个 Sprint。选择 Sprint 名称并提供简要描述。如果需要使用此 Sprint 进行内容迁移，则选择“是”。单击“下一步”。

选中“自上次运行后已添加或修改的用户”复选框，以便将用户列表与 Adobe Learning Manager 应用程序同步。如果要向 Adobe Learning Manager 应用程序迁移内容和数据，则可能无需此操作。然而，如果先前迁移的 Sprint 与最新的 Sprint 之间存在时间差，则最好选择同步用户列表。此步骤可让 Adobe Learning Manager 数据库与您的 LMS 用户保持同步。

注意:

建议在迁移 enrollment.csv 和 user_course_grade.csv 时执行此同步步骤。此步骤可让 Adobe Learning Manager 数据库与您的迁移数据库保持同步，并确保所有通过 Sprint 迁移其记录的用户在迁移数据库中处于可用状态。
您可以对已上传的数据和内容开始 Sprint 迁移了。在开始“Sprint 运行”之前，单击“刷新”链接，将 FTP 和内容文件夹与 Adobe Learning Manager 应用程序同步。

Sprint迁移

单击页面右上角的“开始”。在 Sprint 迁移过程中的任何时间点，单击“停止”即可中止 Sprint 迁移。

每个 Sprint 数据项和内容均会显示各自的迁移状态。在迁移 Sprint 运行过程中，检查迁移的成功项和失败项数量。

注意:

如果要上传模块内容，请确保在 module_version.csv 中提供相应内容文件夹的路径。如未执行此步骤，在迁移期间则可能会出错。例如，如果要上传自学模块内容（例如视频），则需要在 module_version.csv 中指定 Box URL 的相对路径。对于活动模块内容，可以指定 URL 名称。

以下是进度对话框示例快照，仅供参考。如快照所示，您可以查看每个迁移数据项的已处理记录数以及成功和失败项状态。单击失败项对应的“下载错误记录”即可下载和查看错误日志。您可以修复 CSV 中的问题并再次通过 FTP 上传。

进度对话框

如果要查看迁移项目的所有 Sprint 列表，请单击左侧窗格中的 Sprint 列表。如以下示例快照所示，您可以查看所有 Sprint 列表、每个 Sprint 的运行次数、开始日期、持续时间和完成状态。

Sprint设置
上传完最新的 CSV 后，您可以单击页面右上角的“重新运行”。“重新运行”会再次处理所有数据项，并忽略未做任何更改的项。如果对 Sprint 的数据项迁移结果感到满意，可单击页面顶部的按钮将该 Sprint 迁移标记为“完成”。稍后可以对更多数据项执行新的 Sprint。将 Sprint 标记为“完成”后，则无法“重新运行”。同样，一个迁移项目中可拥有任意数量的 Sprint。如果对所有 Sprint 的迁移结果感到满意，可以单击“Sprint 列表”页面上的标记项目完成链接将整个迁移项目标记为“完成”。

注意:

在将迁移项目标记为“完成”之前，必须确保该项目的所有 Sprint 均已完成。将迁移项目标记为“完成”后，将无法返回该项目并在其中创建任何 Sprint 或对该项目进行任何修改。您必须另外创建一个迁移项目，然后再向其中添加 Sprint。

迁移验证

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

在迁移时翻新

此集成功能可让您将旧版学习管理系统中学习对象的历史数据更新到 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

解决迁移问题

单击此处了解集成管理员在向 Adobe Learning Manager 应用程序迁移现有 LMS 数据和内容时所遇问题的解决方法/解决方案。

用户管理提示

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

Adobe Learning Manager ID

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

电子邮件 ID
UUID（通用唯一 ID）

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

公司中 UUID 的使用场景

请考虑一个场景：员工 A 以合同工身份加入名为 Adobe Learning Manager 的公司。在合同期内，Adobe Learning Manager 公司可能不会为其提供公司邮箱 ID A@adobelearningmanager.com.com，而可能只考虑该员工的个人邮箱帐户，例如 A@gmail.com。在 6 个月合同期满后，如果同一员工 A 以全职员工身份加入 Adobe Learning Manager，则 Adobe Learning Manager 可能希望将其邮箱 ID 更改为其公司邮箱 ID：A@adobelearningmanager.com。

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

个人用户识别

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

如果个人用户是通过用户界面 (UI) 或 API 加入的，您可以通过 UI 或 API 删除此类个人用户。
您可以通过 CSV 上传过程进行个人用户更新，但要记住，这些个人用户会被视为 CSV 用户，且 CSV 工作流程适用于此类用户。

分配“经理”角色

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

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

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

更快、更轻松地获得帮助

新用户？