迁移 AEM Forms 资产和文档

迁移实用程序将自适应Forms资源、云配置和对应管理资源从早期版本中使用的格式转换为AEM 6.4 Forms中使用的格式。运行迁移实用程序时，将迁移以下内容：

自适应表单的自定义组件
自适应表单和通信管理模板
云配置
Correspondence Management和自适应表单资产

注意

如果升级不到位，则对于Correspondence Management资产，您可以在每次导入资产时运行迁移。对于通信管理迁移，您需要安装Forms Compatibility Package。

迁移的方法

您可以将从AEM Forms 6.3或6.2升级到最新版AEM Forms 6.4或执行全新安装。根据您是升级了之前的安装还是执行了新安装，您需要执行以下操作之一：

如果是就地升级

如果您执行了就地升级，则升级实例已具有资产和文档。但是，在使用资产和文档之前，您需要安装AEMFD兼容性包（包括通信管理兼容性包）

然后，您需要通过运行迁移实用程序更新资产和文档。

如果安装不当

如果安装不当（新），则在您可以使用资源和文档之前，您需要安装AEMFD兼容性包（包括通信管理兼容性包）。

然后，您需要在新设置上导入您的资产包（zip或cmp），然后通过运行迁移实用程序更新资产和文档。由于向后兼容性相关的更改，crx-repository中几个文件夹的位置会发生更改。从以前的设置手动导出和导入依赖项（自定义库和资源）到新环境。

在继续迁移之前，请阅读

对于Correspondence Management资产：

对于从上一平台导入的资产，将添加一个属性：fd:version=1.0。
自AEM 6.1 Forms以来，注释不是开箱即用的。之前添加的注释可在资产中使用，但不会自动在界面上显示。您需要在AEM Forms用户界面中自定义extendedProperties属性以使注释可见。
在LiveCycle ES4等早期版本中，文本是使用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/fragmentlayouts。资产中的数据字典引用显示数据字典的路径而不是其名称。
需要重新调整文本模块中用于对齐的任何制表符空间。有关详细信息，请参阅Corresponce Management - Using tab spacing for arrange text。
资产编写器配置会更改为“对应管理”配置。
资产会移到文件夹下，并且名称包括“现有文本”和“现有列表”。

使用迁移实用程序

运行迁移实用程序

在对资源进行任何更改或创建资源之前，请运行迁移实用程序。我们建议您不要在进行任何更改或创建资源后运行该实用程序。确保在迁移过程运行时，Correspondence Management或Adaptive Forms Assets用户界面未打开。

首次运行迁移实用程序时，将创建具有以下路径和名称的日志：\[aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log。此日志会不断更新Correspondence Management和Adaptive Forms迁移信息，如移动资源。

注意

在运行迁移实用程序之前，请确保已备份crx存储库。

在浏览器会话中，以管理员身份登录到AEM作者实例。
在浏览器中打开以下URL:

https://[hostname]:[port]/[context_path]/libs/fd/foundation/gui/content/migration.html

浏览器显示四个选项：
- AEM Forms 资产迁移
- 自适应Forms自定义组件迁移
- 自适应Forms模板迁移
- AEM Forms 云配置迁移
执行以下操作以执行迁移：
- 要迁移资产，请点按AEM Forms资产迁移，然后在下一个屏幕中，点按开始迁移。迁移以下内容：
  - 自适应表单
  - 文档片段
  - 主题
  - 书信
  - 数据字典
注意
在资产迁移期间，您可能会找到警告消息，如“为……找到冲突”。这些消息表明，无法迁移自适应表单中某些组件的规则。例如，如果组件具有具有规则和脚本的事件，则在任何脚本之后发生规则时，不会迁移组件的任何规则。但是，可以通过在自适应表单创作中打开规则编辑器来迁移此类规则。

通过在自适应Forms编辑器的规则编辑器中打开这些组件，可以迁移这些组件。
- 要在自定义组件中迁移规则和脚本（从6.3升级时不需要），请点按自适应Forms自定义组件迁移，并在下一个屏幕中点按开始迁移。迁移以下内容：
- 使用规则编辑器（6.1 FP1及更高版本）创建的规则和脚本
- 使用6.1及更早版本UI中的“脚本”选项卡创建的脚本
- 要迁移模板（从6.3升级时不需要），请点按自适应Forms模板迁移，然后在下一个屏幕中，点按开始迁移。迁移以下内容：
- 旧模板 — 使用AEM 6.1 Forms或更早版本在/apps下创建的自适应表单模板。这包括在模板组件中定义的脚本。
- 新模板 — 使用/conf下的模板编辑器创建的自适应表单模板。这包括迁移使用规则编辑器创建的规则和脚本。
- 要迁移自适应表单自定义组件，请点按自适应Forms自定义组件迁移，在“自定义组件迁移”页中，点按开始迁移。迁移以下内容：
  - 为自适应Forms编写的自定义组件
  - 组件叠加（如果有）。
- 要迁移自适应表单模板，请点按自适应Forms模板迁移，在“自定义组件迁移”页中，点按开始迁移。迁移以下内容：
  - 使用AEM模板编辑器在/apps或/conf下创建的自适应表单模板。
- 迁移AEM Forms云配置服务以利用新的上下文感知云服务模式，该模式包括触屏优化UI（在/conf下）。迁移AEM Forms云配置服务时，/etc中的云服务将移至/conf。如果您没有任何依赖旧路径(/etc?lang=zh-Hans)的云服务自定义项，建议您在升级到6.4后立即运行迁移实用程序，并使用云配置触屏UI进行进一步工作。如果您有任何现有的云服务自定义，请在已升级的设置上继续使用经典UI，直到自定义更新为与迁移路径(/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
- Adobe Sign
  - 源路径：/etc/cloudservices/echosign
  - 目标路径：/conf/global/settings/cloudconfigs/echosign
- Typekit云服务
  - 源路径：/etc/cloudservices/typekit
  - 目标路径：/conf/global/settings/cloudconfigs/typekit
迁移过程进行时，浏览器窗口将显示以下内容：
- 资产更新时：资产已成功更新。
- 迁移完成后：已完成资源迁移。
执行迁移实用程序时，将执行以下操作：
- 向资产中添加标记:添加标签“Correponsement Management:迁移的资产”/“自适应Forms:迁移的资产”。，以便用户能够识别已迁移的资产。运行迁移实用程序时，系统中的所有现有资源都标记为已迁移。
- 生成标记:之前系统中存在的类别和子类别将创建为标记，然后这些标记与AEM中的相关Correponse Management资产相关联。例如，将字母模板的类别（索赔）和子类别（索赔）生成为标记。
- 将布局和布局片段移动到AEM 6.4 Forms用户界面:如果您从6.2升级到6.4，则布局模板和布局片段将作为表单添加到AEM Forms 6.4用户界面部分。
注意

如果您从6.2升级到6.4，对于Corresponce Management，则新文件夹可能会在UI中显示，其中包含您的资产。您可能需要检查这些文件夹以查找您的资产。
迁移实用程序运行完毕后，继续家政任务。

运行迁移实用程序后的管理任务

运行迁移实用程序后，请注意以下管理任务:

确保XFA版的布局和片段布局为3.3或更高版本。如果您使用旧版本的布局和片段布局，则在呈现字母时可能会出现问题。要将旧版XFA更新到最新版本，请完成以下步骤：
1. 从Forms用户界面中以zip文件的形式下载XFA。
2. 解压文件。
3. 在最新的Designer中打开XFA文件并保存它。 XFA的版本将更新为最新版本。
4. 在Forms用户界面中上传XFA。
在迁移前发布之前在先前系统中发布的所有资产。迁移实用程序仅更新作者实例上的资产，并更新发布实例上需要发布资产的资产。
在AEM Forms 6.4中，表单用户组的某些权限会发生更改。如果您希望任何用户能够上传包含脚本的XDP和自适应Forms，或使用代码编辑器，则需要将它们添加到表单级用户组。同样，模板作者也无法再使用规则编辑器中的代码编辑器。为使用户能够使用代码编辑器，请将他们添加到 af-template-script-writers 组。有关将用户添加到用户组的说明，请参阅管理用户和用户组。