迁移 AEM Forms 资产和文档 migrate-aem-forms-assets-and-documents
迁移实用程序将 自适应Forms资产, 云配置和 通信管理资产 从早期版本中使用的格式到AEM 6.4 Forms中使用的格式。 运行迁移实用程序时，将迁移以下内容：
- 自适应表单的自定义组件
- 自适应表单和通信管理模板
- 云配置
- 通信管理和自适应表单资产
迁移方法 approach-to-migration
您可以 升级 从AEM Forms 6.3或6.2升级到最新版本的AEM Forms 6.4，或执行全新安装。 根据您是升级了之前的安装还是执行了全新安装，您需要执行以下操作之一：
在就地升级时
如果您执行就地升级，则已升级的实例已具有资产和文档。 但是，在使用资产和文档之前，您需要先安装 AEMFD兼容包 （包括通信管理兼容包）
然后，您需要通过 运行迁移实用程序.
如果安装不当
如果安装位置不正确（全新），则需要先安装资产和文档，然后才能使用 AEMFD兼容包 （包括通信管理兼容包）。
然后，您需要在新设置中导入资产包（zip或cmp），然后通过 运行迁移实用程序. 原因 向后兼容性相关 更改后，crx-repository中一些文件夹的位置会发生更改。 手动将依赖项（自定义库和资产）从以前的设置导出到新环境。
继续迁移前请阅读 prerequisites
对于通信管理资产：
- 对于从之前的平台导入的资产，将添加一个资产： fd:version=1.0.
- 自AEM 6.1 Forms以来，无法开箱即用地添加评论。 之前添加的评论可在资产中使用，但不会自动在界面中显示。 您需要在AEM Forms用户界面中自定义extendedProperties属性，以使注释可见。
- 在以前的某些版本(如LiveCycleES4)中，使用Flex RichTextEditor编辑文本，但自AEM 6.1 Forms起，便使用HTML编辑器。 由于字体的呈现和外观，字体大小和字体边距可能与创作用户界面中的先前版本不同。 但是，这些字母在呈现时看起来是相同的。
- 文本模块中的列表已得到改进，现在呈现方式有所不同。 可能存在视觉差异。 我们建议您渲染并查看在文本模块中使用列表的字母。
- 由于图像内容模块已转换为DAM资产，并且布局和片段在迁移期间添加到表单，因此这些模块的更新方式属性将更改为管理员。
- 资产的版本历史记录不会迁移，且在迁移后不可用。 迁移后将维护后续版本历史记录。
- 自AEM 6.1 Forms起，“准备发布”状态即已弃用，因此“准备发布”状态中的所有资产都将更改为“已修改”状态。
- 由于用户界面在AEM Forms 6.3中进行了更新，因此执行自定义的步骤也有所不同。 如果您从6.3之前的版本迁移，则需要重做自定义设置。
- 布局片段从/content/apps/cm/layouts/fragmentlayouts/1001移动到/content/apps/cm/modules/fragmentlayout。 资产中的数据字典引用显示数据字典的路径，而不是其名称。
- 需要调整文本模块中用于对齐的任何制表符空格。 有关更多信息，请参阅 通信管理 — 使用制表符间距排列文本.
- 资产编辑器配置更改为通信管理配置。
- 资产会移动到名称为“现有文本”和“现有列表”的文件夹下。
使用迁移实用程序 using-the-migration-utility
运行迁移实用程序 runningmigrationutility
在对资产进行任何更改或创建资产之前，请运行迁移实用程序。 我们建议您在进行任何更改或创建资产后，不要运行该实用程序。 确保在迁移过程运行时，通信管理或自适应Forms Assets用户界面未打开。
首次运行迁移实用程序时，将创建具有以下路径和名称的日志： \[aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log. 此日志会不断更新通信管理和自适应Forms迁移信息，如移动资产。
-
在浏览器会话中，以管理员身份登录AEM创作实例。
-
在浏览器中打开以下URL:
https://[主机名]:[端口]/[context_path]/libs/fd/foundation/gui/content/migration.html
浏览器显示四个选项：
- AEM Forms 资产迁移
- 自适应Forms自定义组件迁移
- 自适应Forms模板迁移
- AEM Forms 云配置迁移
-
执行以下操作以执行迁移：
-
迁移 资产，点按AEM Forms Assets迁移，然后在下一个屏幕中，点按 开始迁移. 迁移了以下内容：
- 自适应表单
- 文档片段
- 主题
- 书信
- 数据字典
note note NOTE 在资产迁移期间，您可能会看到一些警告消息，如“为……发现冲突”。 这些消息表明无法迁移自适应表单中某些组件的规则。 例如，如果组件的事件同时具有规则和脚本，则如果规则在任何脚本之后发生，则不会迁移组件的任何规则。 但是，可以通过在自适应表单创作中打开规则编辑器来迁移此类规则。 可以通过在自适应Forms编辑器的规则编辑器中打开这些组件来迁移这些组件。 -
要在自定义组件中迁移规则和脚本（从6.3升级时不需要），请点按自适应Forms自定义组件迁移，然后在下一个屏幕中，点按开始迁移。 迁移了以下内容：
- 使用规则编辑器（6.1 FP1及更高版本）创建的规则和脚本
- 使用6.1及更低版本UI中的“脚本”选项卡创建的脚本
-
要迁移模板（从6.3升级时不需要），请点按自适应Forms模板迁移，然后在下一个屏幕中，点按开始迁移。 迁移了以下内容：
- 旧模板 — 在使用AEM 6.1 Forms或更早版本的/apps下创建的自适应表单模板。 这包括模板组件中定义的脚本。
- 新模板 — 使用/conf下的模板编辑器创建的自适应表单模板。 这包括迁移使用规则编辑器创建的规则和脚本。
-
要迁移自适应表单自定义组件，请点按 自适应Forms自定义组件迁移 和在自定义组件迁移页面中，点按 开始迁移. 迁移了以下内容：
- 为自适应Forms编写的自定义组件
- 组件叠加（如果有）。
-
要迁移自适应表单模板，请点按 自适应Forms模板迁移 和在自定义组件迁移页面中，点按 开始迁移. 迁移了以下内容：
- 在/apps或/conf下使用AEM模板编辑器创建的自适应表单模板。
-
迁移AEM Forms云配置服务以利用新的上下文感知云服务范例，该范例包括触屏优化UI（在/conf下）。 迁移AEM Forms云配置服务时，/etc中的云服务将移至/conf。 如果您没有任何依赖旧路径(https://experienceleague.adobe.com/etc?lang=zh-Hans)的云服务自定义，则建议您在升级到6.4后立即运行迁移实用程序，并使用云配置触屏UI进行任何后续工作。 如果您有任何现有的云服务自定义，请在已升级的设置中继续使用经典UI，直到更新自定义以与迁移路径(https://experienceleague.adobe.com/conf?lang=zh-Hans)保持一致，然后运行迁移实用程序。
迁移 AEM Forms云服务，其中包括：点按AEM Forms云配置迁移（云配置迁移与AEMFD兼容包无关），点按AEM Forms云配置迁移，然后在配置迁移页面上，点按 开始迁移:
-
表单数据模型云服务
- 源路径：/etc/cloudservices/fdm
- 目标路径：/conf/global/settings/cloudconfigs/fdm
-
Recaptcha
- 源路径：/etc/cloudservices/recaptcha
- 目标路径：/conf/global/settings/cloudconfigs/recaptcha
-
Acrobat Sign
- 源路径：/etc/cloudservices/echosign
- 目标路径：/conf/global/settings/cloudconfigs/echosign
-
Typekit云服务
- 源路径：/etc/cloudservices/typekit
- 目标路径：/conf/global/settings/cloudconfigs/typekit
迁移过程进行时，浏览器窗口会显示以下内容：
- 更新资产时：资产已成功更新。
- 迁移完成后：已完成资产的迁移。
执行时，迁移实用程序会执行以下操作：
- 向资产中添加标记:添加标记“通信管理：迁移资产” / “自适应Forms :迁移的资产”。 ，以便用户能够识别已迁移的资产。 运行迁移实用程序时，系统中的所有现有资产都标记为已迁移。
- 生成标记:以前系统中存在的类别和子类别将创建为标记，然后这些标记与AEM中的相关通信管理资产相关联。 例如，信件模板的类别（声明）和子类别（声明）将生成为标记。
- 将布局和布局片段移动到AEM 6.4 Forms用户界面:如果您从6.2升级到6.4，则布局模板和布局片段将作为表单添加到AEM Forms 6.4用户界面部分。
note note NOTE 如果您从6.2升级到6.4，对于通信管理，则新文件夹可能会显示在包含您的资产的UI中。 您可能需要检查这些文件夹才能找到您的资产。 -
-
在迁移实用程序完成运行后，继续 家务任务.
运行迁移实用程序后的内部管理任务 housekeepingtasks
运行迁移实用程序后，请处理以下内务处理任务：
-
确保XFA版本的布局和片段布局为3.3或更高版本。 如果您使用旧版本的布局和片段布局，则在渲染信件时可能会出现问题。 要将旧XFA的版本更新至最新版本，请完成以下步骤：
- 将XFA下载为zip文件 从Forms用户界面。
- 解压缩文件。
- 在最新的Designer中打开XFA文件并保存它。 XFA的版本将更新为最新版本。
- 在Forms用户界面中上传XFA。
-
在迁移之前，发布之前在之前的系统中发布的所有资产。 迁移实用程序仅更新创作实例上的资产，并更新发布实例上发布资产所需的资产。
-
在AEM Forms 6.4中，表单用户组的某些权限发生了更改。 如果您希望任何用户能够上传包含脚本的XDP和自适应Forms，或者使用代码编辑器，则需要将它们添加到支持表单的用户组。 同样，模板作者无法再在规则编辑器中使用代码编辑器。 为使用户能够使用代码编辑器，请将它们添加到af-template-script-writers组。 有关将用户添加到群组的说明，请参阅 管理用户和用户组.