迁移 AEM Forms 资产和文档 migrate-aem-forms-assets-and-documents
迁移实用程序将自适应Forms资源、云配置和通信管理资源从早期版本中使用的格式转换为Adobe Experience Manager (AEM) 6.5 Forms中使用的格式。 运行迁移实用程序时，将迁移以下内容：
- 自适应表单的自定义组件
- 自适应表单和通信管理模板
- 云配置
- 通信管理和自适应表单资产
迁移方法 approach-to-migration
您可以将从AEM Forms 6.4、6.3或6.2 升级到最新版本的AEM Forms 6.5，或者进行新的安装。 根据您是升级以前的安装还是执行了全新安装，您必须执行以下操作之一：
如果有就地升级
如果您执行就地升级，则升级的实例已经具有资源和文档。 但是，必须先安装AEMFD兼容包（包括通信管理兼容包），然后才能使用资源和文档
然后，您必须通过运行迁移实用程序来更新资源和文档。
如果存在非就地安装
如果安装不恰当（全新），则必须先安装AEMFD兼容包（包括通信管理兼容包），然后才能使用资产和文档。
然后，您必须在新设置中导入资产包（zip或cmp），然后通过运行迁移实用程序来更新资产和文档。 Adobe建议仅在运行迁移实用程序后，才在新设置上创建资源。
由于向后兼容性相关的更改，crx存储库中几个文件夹的位置已更改。 手动将依赖项（自定义库和资产）从以前的设置导出和导入到新的环境。
在继续迁移之前 prerequisites
对于相应的管理资产：
- 对于从上一个平台导入的资产，将添加一个属性： fd：version=1.0。
- 自AEM 6.1 Forms起，无法立即使用注释。 之前添加的注释可在资源中使用，但不会自动在界面中显示。 自定义AEM Forms用户界面中的extendedProperties属性以显示注释。
- 在某些早期版本(如LiveCycleES4)中，文本是使用Flex RichTextEditor进行编辑的，但由于AEM 6.1 Forms，因此使用HTML编辑器。 由于此渲染和字体外观，字体大小和字体边距可能与创作用户界面中以前的版本不同。 但是，字母在呈现时看起来相同。
- 文本模块中的列表已得到改进，现在呈现方式有所不同。 视觉上可能有所差异。 Adobe建议您渲染并查看您在文本模块中使用列表的字母。
- 由于图像内容模块已转换为DAM资源并在迁移期间将布局和片段添加到表单，因此这些模块的“更新者”属性将更改为“管理员”。
- 资产的版本历史记录未迁移，且在迁移后不可用。 迁移后的后续版本历史记录将得到维护。
- 由于AEM 6.1 Forms已弃用“准备就绪Publish”状态，因此“准备就绪Publish”状态的所有资源都将更改为“已修改”状态。
- 由于用户界面在AEM Forms 6.3中进行了更新，因此执行自定义设置的步骤也有所不同。 如果您是从6.3之前的版本迁移，请重做自定义设置。
- 布局片段从
/content/apps/cm/layouts/fragmentlayouts/1001移至/content/apps/cm/modules/fragmentlayouts。 资产中的数据字典引用显示数据字典的路径而不是其名称。 - 必须重新调整用于文本模块中对齐的任何制表符空格。 有关详细信息，请参阅通信管理 — 使用制表符间距排列文本。
- 资产编辑器配置会更改为通信管理配置。
- Assets将移动到名为“现有文本”和“现有列表”等文件夹的下。
使用迁移实用程序 using-the-migration-utility
运行迁移实用程序 runningmigrationutility
在更改资产或创建资产之前，请运行迁移实用程序。 Adobe建议您在进行任何更改或创建资源后不要运行该实用程序。 确保在迁移过程中未打开通信管理或Adaptive 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自定义组件迁移，然后在“自定义组件迁移”页面中选择 开始迁移。 将迁移以下项：
- 为自适应Forms编写的自定义组件
- 组件叠加（如果有）。
-
要迁移自适应表单模板，请选择 自适应Forms模板迁移，然后在“自定义组件迁移”页面中选择 开始迁移。 将迁移以下项：
- 使用AEM模板编辑器在
/apps或/conf下创建的自适应表单模板。
- 使用AEM模板编辑器在
-
迁移AEM Forms Cloud Configuration Services以使用新的上下文感知云服务模式，其中包括支持触摸的UI（位于
/conf下）。 迁移AEM Forms云配置服务时，/etc中的云服务将移至/conf。 如果您没有任何依赖于旧版路径(/etc)的Cloud Service自定义设置，Adobe建议您在升级到6.5后运行迁移实用程序；请使用Cloud Configuration Touch UI执行任何进一步的工作。 如果您有任何现有的云服务自定义设置，请在升级后的安装中继续使用经典UI，直到自定义设置更新为与迁移的路径(/conf)一致，然后运行迁移实用程序。
要迁移 AEM Forms云服务（包括以下服务），请选择AEM Forms云配置迁移（云配置迁移独立于AEMFD兼容包）。 选择AEM Forms云配置迁移，然后在“配置迁移”页面上，选择 开始迁移：
-
表单数据模型云服务
- Source路径：
/etc/cloudservices/fdm - 目标路径：
/conf/global/settings/cloudconfigs/fdm
- Source路径：
-
Recaptcha
- Source路径：
/etc/cloudservices/recaptcha - 目标路径：
/conf/global/settings/cloudconfigs/recaptcha
- Source路径：
-
Adobe Sign
- Source路径：
/etc/cloudservices/echosign - 目标路径：
/conf/global/settings/cloudconfigs/echosign
- Source路径：
-
Typekit云服务
- Source路径：
/etc/cloudservices/typekit - 目标路径：
/conf/global/settings/cloudconfigs/typekit
- Source路径：
在迁移过程中，浏览器窗口会显示以下内容：
- 资源更新后：Assets已成功更新。
- 迁移完成后：完成资产的迁移。
运行迁移实用程序时，会执行以下操作：
- 将标记添加到资源：添加标记“Correspondence Management ： Migrated Assets”/“Adaptive Forms ： Migrated Assets”。 ，以便用户能够识别已迁移的资产。 运行迁移实用程序时，系统中所有现有资源均标记为已迁移。
- 生成标记：将以前系统中存在的类别和子类别创建为标记，然后这些标记与AEM中的相关通信管理资源相关联。 例如，信件模板的类别（索赔）和子类别（索赔）作为标记生成。
-
-
迁移实用程序运行完毕后，继续执行内部管理任务。
使用规则编辑器迁移规则 migrate-rules
通过在自适应Forms编辑器的规则编辑器中打开这些组件，可以迁移这些组件。
-
要在自定义组件中迁移规则和脚本（如果从6.3升级，则不需要），请选择自适应Forms自定义组件迁移，然后在下一个屏幕中，选择开始迁移。 将迁移以下项：
-
使用规则编辑器（6.1 FP1及更高版本）创建的规则和脚本
-
在6.1及更低版本的UI中使用“脚本”选项卡创建的脚本
-
-
要迁移模板（如果从6.3和6.4升级，则不需要），请选择自适应Forms模板迁移，然后在下一个屏幕中选择开始迁移。 将迁移以下项：
-
旧模板 — 在/apps下使用AEM 6.1 Forms或更低版本创建的自适应表单模板。 这包括模板组件中定义的脚本。
-
新模板 — 使用
/conf下的模板编辑器创建的自适应表单模板。 这包括迁移使用规则编辑器创建的规则和脚本。
-
运行迁移实用程序后的内部管理任务 housekeepingtasks
运行迁移实用程序后，请完成以下内部管理任务：
-
确保布局和片段布局的XFA版本为3.3或更高版本。 如果您使用的是较旧版本的布局和片段布局，则呈现信件时可能会出现问题。 要将旧版XFA更新到最新版本，请完成以下步骤：
- 从Forms用户界面下载XFA的zip文件。
- 提取文件。
- 在最新的Designer中打开XFA文件并保存。 XFA的版本将更新到最新版本。
- 在Forms用户界面中上传XFA。
-
Publish迁移前在上一个系统中发布的所有资源。 迁移实用程序仅会更新创作实例上的资源，要更新Publish实例上的资源，您必须发布资源。
-
在AEM Forms 6.4和6.5中，更改了Forms用户组的某些权限。 如果您希望您的任何用户能够上传包含脚本的XDP和自适应Forms或使用代码编辑器，则必须将它们添加到forms-power-users组。 同样，模板作者无法在规则编辑器中再使用代码编辑器。 要使用户能够使用代码编辑器，请将其添加到af-template-script-writers组。 有关将用户添加到组的说明，请参阅管理用户和用户组。