迁移实用程序将自适应Forms资产、云配置和通信管理资产从早期版本中使用的格式转换为AEM 6.4 Forms中使用的格式。 运行迁移实用程序时,将迁移以下内容:
如果升级不到位,对于通信管理资产,您可以在每次导入资产时运行迁移。 对于通信管理迁移,您需要安装Forms兼容包。
您可以从AEM Forms 6.3或6.2中升级到最新版本的AEM Forms 6.4,或执行全新安装。 根据您是升级了之前的安装还是执行了全新安装,您需要执行以下操作之一:
在就地升级时
如果您执行就地升级,则已升级的实例已具有资产和文档。 但是,在使用资产和文档之前,您需要安装AEMFD兼容包(包括通信管理兼容包)
然后,您需要通过运行迁移实用程序🔗的来更新资产和文档。
如果安装不当
如果安装过程不当(新),则在使用资产和文档之前,您需要安装AEMFD兼容包(包括通信管理兼容包)。
然后,您需要在新设置中导入资产包(zip或cmp),然后通过运行迁移实用程序更新资产和文档。 由于向后兼容性相关的更改,crx-repository中一些文件夹的位置发生了更改。 手动将依赖项(自定义库和资产)从以前的设置导出到新环境。
对于通信管理资产:
在对资产进行任何更改或创建资产之前,请运行迁移实用程序。 我们建议您在进行任何更改或创建资产后,不要运行该实用程序。 确保在迁移过程运行时,通信管理或自适应Forms Assets用户界面未打开。
首次运行迁移实用程序时,将创建具有以下路径和名称的日志:\[aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log
。 此日志会不断更新通信管理和自适应Forms迁移信息,如移动资产。
运行迁移实用程序之前,请确保已备份您的crx存储库。
在浏览器会话中,以管理员身份登录AEM创作实例。
在浏览器中打开以下URL:
https://[hostname]:[port]/[contextpath<a5//libs/fd/foundation/gui/content/migration.html]
浏览器显示四个选项:
执行以下操作以执行迁移:
要迁移资产,请点按AEM Forms Assets迁移,然后在下一个屏幕中,点按开始迁移。 迁移了以下内容:
在资产迁移期间,您可能会看到一些警告消息,如“为……发现冲突”。 这些消息表明无法迁移自适应表单中某些组件的规则。 例如,如果组件的事件同时具有规则和脚本,则如果规则在任何脚本之后发生,则不会迁移组件的任何规则。 但是,可以通过在自适应表单创作中打开规则编辑器来迁移此类规则。
可以通过在自适应Forms编辑器的规则编辑器中打开这些组件来迁移这些组件。
要在自定义组件中迁移规则和脚本(从6.3升级时不需要),请点按自适应Forms自定义组件迁移,然后在下一个屏幕中,点按开始迁移。 迁移了以下内容:
要迁移模板(从6.3升级时不需要),请点按自适应Forms模板迁移,然后在下一个屏幕中,点按开始迁移。 迁移了以下内容:
要迁移自适应表单自定义组件,请点按自适应Forms自定义组件迁移,然后在“自定义组件迁移”页面中,点按开始迁移。 迁移了以下内容:
要迁移自适应表单模板,请点按自适应Forms模板迁移,然后在“自定义组件迁移”页面中,点按开始迁移。 迁移了以下内容:
迁移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云配置迁移,然后在配置迁移页面,点按开始迁移:
表单数据模型云服务
Recaptcha
Adobe Sign
Typekit云服务
迁移过程进行时,浏览器窗口会显示以下内容:
执行时,迁移实用程序会执行以下操作:
如果您从6.2升级到6.4,对于通信管理,则新文件夹可能会显示在包含您的资产的UI中。 您可能需要检查这些文件夹才能找到您的资产。
在迁移实用程序完成运行后,继续执行家政任务。
运行迁移实用程序后,请处理以下内务处理任务:
确保XFA版本的布局和片段布局为3.3或更高版本。 如果您使用旧版本的布局和片段布局,则在渲染信件时可能会出现问题。 要将旧XFA的版本更新至最新版本,请完成以下步骤:
在迁移之前,发布之前在之前的系统中发布的所有资产。 迁移实用程序仅更新创作实例上的资产,并更新发布实例上发布资产所需的资产。
在AEM Forms 6.4中,表单用户组的某些权限发生了更改。 如果您希望任何用户能够上传包含脚本的XDP和自适应Forms,或者使用代码编辑器,则需要将它们添加到支持表单的用户组。 同样,模板作者无法再在规则编辑器中使用代码编辑器。 为使用户能够使用代码编辑器,请将他们添加到 af-template-script-writers 组。有关将用户添加到群组的说明,请参阅管理用户和用户群组。