迁移 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存储库。

  1. 在浏览器会话中,以管理员身份登录到AEM作者实例。

  2. 在浏览器中打开以下URL:

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

    浏览器显示四个选项:

    • AEM Forms 资产迁移
    • 自适应Forms自定义组件迁移
    • 自适应Forms模板迁移
    • AEM Forms 云配置迁移
  3. 执行以下操作以执行迁移:

    • 要迁移​资产,请点按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中显示,其中包含您的资产。 您可能需要检查这些文件夹以查找您的资产。

  4. 迁移实用程序运行完毕后,继续家政任务

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

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

  1. 确保XFA版的布局和片段布局为3.3或更高版本。 如果您使用旧版本的布局和片段布局,则在呈现字母时可能会出现问题。 要将旧版XFA更新到最新版本,请完成以下步骤:

    1. 从Forms用户界面中 以zip文件的形式下载XFA。
    2. 解压文件。
    3. 在最新的Designer中打开XFA文件并保存它。 XFA的版本将更新为最新版本。
    4. 在Forms用户界面中上传XFA。
  2. 在迁移前发布之前在先前系统中发布的所有资产。 迁移实用程序仅更新作者实例上的资产,并更新发布实例上需要发布资产的资产。

  3. 在AEM Forms 6.4中,表单用户组的某些权限会发生更改。 如果您希望任何用户能够上传包含脚本的XDP和自适应Forms,或使用代码编辑器,则需要将它们添加到表单级用户组。 同样,模板作者也无法再使用规则编辑器中的代码编辑器。 为使用户能够使用代码编辑器,请将他们添加到 af-template-script-writers 组。有关将用户添加到用户组的说明,请参阅管理用户和用户组

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now