文档AEM 6.4部署指南

AEM 6.4中的常用存储库重组 common-repository-restructuring-in-aem

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员
CAUTION
AEM 6.4已结束扩展支持，本文档将不再更新。 有关更多详细信息，请参阅 技术支助期. 查找支持的版本 此处.

如父项中所述 AEM 6.4中的存储库重组 页面中，升级到AEM 6.4的客户应使用此页面来评估与存储库更改相关的工作，这些更改可能会影响所有解决方案。 某些更改在AEM 6.4升级过程中需要工作，而其他更改可能会推迟到6.5升级。

升级6.4版

6.5升级之前

升级6.4版 with-upgrade

ContextHub 配置 contexthub-6.4

从AEM 6.4开始，没有默认的ContextHub配置。 因此，在站点的根级别上a cq:contextHubPathproperty 应设置为指示应使用的配置。

  1. 导航到站点的根。
  2. 打开根页面的页面属性，然后选择个性化选项卡。
  3. 在Contexthub路径字段中，输入您自己的ContextHub配置路径。

此外，在ContextHub配置中， sling:resourceType 需要更新为相对值，而非绝对值。

  1. 在CRX DE Lite中打开ContextHub配置节点的属性，例如 /apps/settings/cloudsettings/legacy/contexthub
  2. 更改 sling:resourceType 从 /libs/granite/contexthub/cloudsettings/components/baseconfiguration to granite/contexthub/cloudsettings/components/baseconfiguration

即 sling:resourceType ContextHub配置的绝对值必须是相对值，而不是绝对值。

工作流模型 workflow-models

上一位置
/etc/workflow/models
新位置

/libs/settings/workflow/models

/conf/global/settings/workflow/models

/var/workflow/models

重组指导

必须将任何新的或修改的工作流模型迁移到/conf/global/workflow/models。

  1. 将修改的工作流模型部署到本地AEM 6.4开发实例中，以便它们存在于“上一个”位置。

  2. 使用AEM工作流模型编辑器(位于AEM >工具>工作流>模型)编辑工作流模型。

  3. 迁移修改的AEM提供的工作流模型时

    1. 打开工作流模型编辑器后，修改浏览器的地址URL，并将路径段/libs/settings/workflow/models替换为/etc/workflow/models。
      • 例如，更改： http://localhost:4502/editor.html /libs/settings/workflow/models/dam/update_asset.html to http://localhost:4502/editor.html /etc/workflow/models/dam/update_asset.html

  4. 在工作流模型编辑器中启用编辑模式，该模式会将工作流模型定义复制到/conf/global/workflow/models。

  5. 点按同步按钮，将更改同步到/var/workflow/models下的运行时工作流模型。

  6. 导出工作流模型(https://experienceleague.adobe.com/conf/global/workflow/models/<workflow-model>?lang=zh-Hans)和运行时工作流模型(https://experienceleague.adobe.com/var/workflow/models/<workflow-model>?lang=zh-Hans)并集成到AEM项目中。

    1. 例如，导出：

      • /config/settings/workflow/models/dam/my_workflow_model 和
      • /var/workflow/models/dam/my_workflow_model
注释

工作流模型解析按以下顺序发生：

  1. /conf/global/settings/workflow/models
  2. /libs/settings/workflow/models
  3. /etc/workflow/models

因此，如果要保留“上一位置”中保留的AEM提供的工作流模型的任何自定义，则必须将其移至/conf/global/settings/workflow/models中，否则将被/libs/settings/workflow/models中AEM提供的工作流模型定义所取代。

工作流实例 workflow-instances

上一位置
/etc/workflow/instances
新位置
/var/workflow/instances
重组指导

无需执行任何操作即可与新位置保持一致。

历史工作流实例可以安全地继续驻留在先前位置，并且将在新位置中创建新的工作流实例。

注释
中的任何显式路径引用 custom “上一位置”的代码也应考虑“新位置”。 建议对此代码进行重构以使用AEM工作流API。

工作流启动器 workflow-launchers

上一位置
/etc/workflow/launcher/config
新位置

/libs/settings/workflow/launcher/config

/conf/global/settings/workflow/launcher/config

重组指导

必须将任何新的或修改的工作流启动器迁移到 /conf/global/workflow/launcher/config.

  1. 将任何新的或修改的工作流启动器配置从先前位置复制到新位置(/conf/global)。
注释

工作流启动器解析按以下顺序发生：

  1. /conf/global/settings/workflow/launcher
  2. /libs/settings/workflow/launcher
  3. /etc/workflow/launcher

因此，在“上一位置”中保留的AEM提供的工作流启动器的任何自定义都必须移至“新位置”(/conf/global/settings/workflow/launcher 如果保留，则将由中AEM提供的工作流启动器定义取代 /libs/settings/workflow/launcher.

工作流脚本 workflow-scripts

上一位置
/etc/workflow/scripts
新位置

/libs/workflow/scripts

/apps/workflow/scripts

重组指导

任何新的或修改的工作流脚本都必须迁移到新位置，并且引用的工作流模型已更新以反映新位置。

  1. 将任何新的或修改的工作流脚本从上一位置复制到新位置。
    • /apps/workflow/scripts 应在SCM中维护。
  2. 在工作流模型中的先前位置更新对工作流脚本的任何引用，以指向新位置。
注释

AEM 6.4 SP1在发布时，会使其延迟至6.5 upgrade .

如果在AEM 6.4 SP1发布之前升级到AEM 6.4，则应在升级项目中执行此重组。 如果不这样做，编辑和保存在“上一位置”中引用脚本的工作流步骤将完全从工作流步骤中删除工作流脚本引用，并且脚本选择下拉列表中将只提供位于新位置的工作流脚本。

6.5升级之前 prior-to-upgrade

ContextHub 配置 contexthub-configurations

上一位置
/etc/cloudsettings
新位置

/libs/settings/cloudsettings

/conf/global/settings/cloudsettings

/conf/<tenant>/settings/cloudsettings

重组指导

必须将任何新的或修改的ContextHub配置迁移到新位置，并且必须更新引用的AEM Sites页面以反映新位置。

  1. 将任何新的或已修改的ContextHub配置从上一个位置复制到新位置。
  2. 将适用的AEM配置与AEM内容层次结构关联。
    1. AEM Sites页面层级通过AEM Sites >页面>页面属性>高级选项卡>云配置.
  3. 取消与上述AEM内容层级中任何迁移的旧版ContextHub配置的关联。
注释
不适用

经典Cloud Services设计 classic-cloud-services-designs

上一位置
/etc/designs/cloudservices
新位置

/libs/settings/wcm/designs/cloudservices

/apps/settings/wcm/designs/cloudservices

重组指导

适用于在SCM中管理且不在运行时通过设计对话框写入的任何设计。

  1. 将设计从上一位置复制到新位置(/apps)。
  2. 将设计中的任何CSS、JavaScript和静态资源转换为 客户端库 with allowProxy = true.
  3. 更新对 cq : designPath 属性。
  4. 更新引用上一位置的任何页面以使用新的客户端库类别（这需要更新页面实施代码）。
  5. 更新AEM Dispatcher规则，以允许通过/etc.clientlibs/.. 代理servlet。

适用于任何未在SCM中管理的设计，以及通过设计对话框修改的运行时。

  • 请勿将可创作设计移出 /etc.
注释
不适用

经典功能板设计 classic-dashboards-designs

上一位置
/etc/designs/dashboards
新位置

/libs/settings/wcm/designs/dashboards

/apps/settings/wcm/designs/dashboards

重组指导

适用于在SCM中管理且不在运行时通过设计对话框写入的任何设计。

  1. 将设计从上一位置复制到新位置(https://experienceleague.adobe.com/apps?lang=zh-Hans)。
  2. 将设计中的任何CSS、JavaScript和静态资源转换为 客户端库 with allowProxy = true.
  3. 更新对 cq : designPath 属性。
  4. 更新引用上一位置的任何页面以使用新的客户端库类别（这需要更新页面实施代码）。
  5. 更新AEM Dispatcher规则，以允许通过/etc.clientlibs/.. 代理servlet。

适用于任何未在SCM中管理的设计，以及通过设计对话框修改的运行时。

  • 请勿将可创作设计移出 /etc.
注释
不适用

经典报表设计 classic-reports-designs

上一位置
/etc/designs/reports
新位置

/libs/settings/wcm/designs/reports

/apps/settings/wcm/designs/reports

重组指导

适用于在SCM中管理且不在运行时通过设计对话框写入的任何设计。

  1. 将设计从上一位置复制到新位置(https://experienceleague.adobe.com/apps?lang=zh-Hans)。
  2. 将设计中的任何CSS、JavaScript和静态资源转换为 客户端库 with allowProxy = true.
  3. 更新对 cq : designPath 属性。
  4. 更新引用上一位置的任何页面以使用新的客户端库类别（这需要更新页面实施代码）。
  5. 更新AEM Dispatcher规则，以允许通过/etc.clientlibs/.. 代理servlet。

适用于任何未在SCM中管理的设计，以及通过设计对话框修改的运行时。

  • 请勿将可创作设计移出 /etc.
注释
不适用

默认设计 default-designs

上一位置
/etc/designs/default
新位置

/libs/settings/wcm/designs/default

/apps/settings/wcm/designs/default

重组指导

适用于在SCM中管理且不在运行时通过设计对话框写入的任何设计。

  1. 将设计从上一位置复制到新位置(https://experienceleague.adobe.com/apps?lang=zh-Hans)。
  2. 将设计中的任何CSS、JavaScript和静态资源转换为 客户端库 with allowProxy = true.
  3. 更新对 cq : designPath 属性。
  4. 更新引用上一位置的任何页面以使用新的客户端库类别（这需要更新页面实施代码）。
  5. 更新AEM Dispatcher规则，以允许通过/etc.clientlibs/.. 代理servlet。

适用于任何未在SCM中管理的设计，以及通过设计对话框修改的运行时。

  • 请勿将可创作设计移出 /etc.
注释
不适用

AdobeDTM JavaScript端点 adobe-dtm-javascript-endpoint

上一位置
/etc/clientlibs/dtm
新位置
/var/cq/dtm/clientlibs
重组指导

无需执行任何操作。

公共先前位置用作专用新位置的代理端点。

注释
不适用

AdobeDTM Web-Hook端点 adobe-dtm-web-hook-endpoint

上一位置
/etc/dtm-hook
新位置
/var/cq/dtm/web-hook
重组指导

无需执行任何操作。

公共先前位置用作专用新位置的代理端点。

注释
不适用

收件箱任务 inbox-tasks

上一位置
/etc/taskmanagement
新位置
/var/taskmanagement
重组指导
使用 收件箱清除维护任务 以根据需要从先前位置删除旧任务。
注释

将任务迁移到新位置无需执行任何操作。

  • “上一位置”中存在的任务可继续使用并正常运行。
  • 新任务将在新位置中创建。

多站点管理器Blueprint配置 multi-site-manager-blueprint-configurations

上一位置
/etc/blueprints
新位置

/libs/msm

/apps/msm

重组指导
  1. 从以下位置复制自定义配置 /etc/blueprints to /apps/msm.
  2. 移除 /etc/blueprints.
注释
不适用

AEM项目功能板小工具配置 aem-projects-dashboard-gadget-configurations

上一位置
/etc/projects/dashboard/gadgets
新位置

/libs/cq/core/content/projects/dashboard/gadgets

/apps/cq/core/content/projects/dashboard/gadgets

重组指导

任何新的或修改的AEM项目功能板小工具配置必须迁移到新位置(/apps)。

  1. 将任何新的或已修改的AEM项目功能板小工具配置从先前的位置复制到新位置(/apps)。
    1. 请勿复制未修改的AEM项目功能板小工具配置，因为这些配置现在存在于新位置(/libs)。
  2. 更新任何引用“上一个位置”的AEM项目模板，以指向相应的新位置。
注释
如果应用了AEM 6.4兼容包，则需要在删除兼容包时执行存储库对齐活动。

复制通知电子邮件模板 replication-notification-e-mail-template

上一位置
/etc/notification/email/default/com.day.cq.replication
新位置

/libs/settings/notification-templates/com.day.cq.replication

/apps/settings/notification-templates/com.day.cq.replication

重组指导

任何新的或修改的复制通知电子邮件模板都必须迁移到新位置(/apps)

  1. 将任何新的或修改的复制通知电子邮件模板从先前的位置复制到新位置(/apps)。
  2. 从先前的位置删除所有迁移的复制通知电子邮件模板。
注释

唯一支持的新复制通知电子邮件模板是支持新区域设置。

复制通知电子邮件模板的解决顺序如下：

  1. /etc/notification/email/default/com.day.cq.replication
  2. /apps/settings/notification-templates/com.day.cq.replication
  3. /libs/settings/notification-templates/com.day.cq.replication

标记 tags

上一位置
/etc/tags
新位置
/content/cq:tags
重组指导

必须将所有标记迁移到 /content/cq:tags.

  1. 将所有标记从上一位置复制到新位置。
  2. 从上一位置删除所有标记。
  3. 通过AEM Web控制台，在 https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging 以便AEM识别新位置包含内容，且应使用。
注释

重新启动日公报标记OSGi包将仅在“上一位置”为空时将“新位置”注册为标记根。

在迁移到新位置后，对“上一位置”的引用将继续有效，因为所有功能都可利用AEM TagManager API进行标记解析。

显式引用路径的任何自定义代码

/etc/tags

必须更新为 /content/

cq

:tags

，或者最好进行重写以结合此迁移利用TagManager Java API。

翻译云服务 translation-cloud-services

上一位置
/etc/cloudservices/translation
新位置

/libs/settings/cloudconfigs/translation/translationcfg

/apps/settings/cloudconfigs/translation/translationcfg

/conf/global/settings/cloudconfigs/translation/translationcfg

/conf/<tenant>/settings/cloudconfigs/translation/translationcfg

重组指导

任何新的翻译Cloud Services都必须迁移到新位置(/apps, /conf/global 或 /conf/<tenant>)。

  1. 将先前位置的现有配置迁移到新位置。

    • 通过AEM创作UI在 工具>Cloud Services>翻译Cloud Services.
      或
    • 将任何新的翻译Cloud Services配置从上一位置复制到新位置(/apps, /conf/global 或 /conf/<tenant>)。

  2. 将适用的AEM配置与AEM内容层次结构关联。

    1. AEM Sites页面层级 AEM Sites >页面>页面属性>高级选项卡>云配置.
    2. AEM体验片段层次结构(通过 AEM体验片段>体验片段>属性>Cloud Services选项卡>云配置.
    3. AEM Experience Fragment文件夹层次结构(通过 AEM体验片段>文件夹>属性>Cloud Services选项卡>云配置.
    4. AEM Assets文件夹层次结构 AEM Assets >文件夹>文件夹属性>Cloud Services选项卡>配置.
    5. AEM项目(通过 AEM项目>项目>项目属性>高级选项卡>云配置.

  3. 取消与上述AEM内容层次结构中任何迁移的旧版翻译Cloud Services的关联。

注释

翻译Cloud Services解析按以下顺序进行：

  1. /conf/<tenant>/settings/cloudconfigs/translations/translationcfg
  2. /conf/global/settings/cloudconfigs/translations/translationcfg
  3. /apps/settings/cloudconfigs/translations/translationcfg
  4. /libs/settings/cloudconfigs/translations/translationcfg

迁移的翻译Cloud Services必须与AEM 6.4兼容。

翻译语言 translation-languages

上一位置
/etc/translation/supportedLanguages
新位置

/libs/settings/translation/supportedLanguages

/apps/settings/translation/supportedLanguages

重组指导

任何新的或修改的翻译语言定义都需要将所有翻译语言定义迁移到新位置(/apps)。

  1. 如果对翻译语言定义进行了任何添加或修改，则将所有翻译语言定义从先前位置复制到新位置(/apps)。
注释

翻译语言路径解析按以下顺序进行：

  1. /etc/translation/supportedLanguages
  2. /apps/settings/translation/supportedLanguage
  3. /libs/settings/translation/supportedLanguages

此分辨率不支持合并叠加，这意味着解析的路径必须包含所有受支持的语言，并且不会从更高级分辨率继承受支持的语言。

翻译规则 translation-rules

上一位置
/etc/workflow/models/translation/translation_rules.xml
新位置

/libs/settings/translation/rules/translation_rules.xml

/apps/settings/translation/rules/translation_rules.xml

/conf/global/settings/translation/rules/translation_rules.xml

重组指导

必须将修改的翻译规则XML文件迁移到新位置(/apps或 /conf/global)。

1.将修改的翻译规则XML文件从先前的位置复制到新位置。

注释

复制转换规则XML解析按以下顺序发生：

  1. /conf/global/settings/translation/rules/translation_rules.xml
  2. /apps/settings/translation/rules/translation_rules.xml
  3. /etc/workflow/models/translation/translation_rules.xml
  4. /libs/settings/translation/rules/translation_rules.xml

翻译小组件客户端库 translation-widget-client-library

上一位置
/etc/designs/translation/translationwidget
新位置

/libs/settings/wcm/designs/translation/translationwidget

/apps/settings/wcm/designs/translation/translationwidget

重组指导

适用于在SCM中管理且不在运行时通过设计对话框写入的任何设计。

  1. 将设计从上一位置复制到新位置(https://experienceleague.adobe.com/apps?lang=zh-Hans)。
  2. 将设计中的任何CSS、JavaScript和静态资源转换为 客户端库 with allowProxy = true.
  3. 更新对 cq : designPath 属性。
  4. 更新引用上一位置的任何页面以使用新的客户端库类别（这需要更新页面实施代码）。
  5. 更新AEM Dispatcher规则，以允许通过/etc.clientlibs/.. 代理servlet。

适用于任何未在SCM中管理的设计，以及通过设计对话框修改的运行时。

  • 请勿将可创作设计移出 /etc.
注释
不适用

树状激活Web控制台 tree-activation-web-console

上一位置
/etc/replication/treeactivation
新位置
/libs/replication/treeactivation
重组指导
无需执行任何操作。
注释
树激活Web控制台现已通过 工具>部署>复制>激活树.

供应商翻译连接器Cloud Services vendor-translation-connector-cloud-services

上一位置
/etc/cloudservices/<vendor>
新位置

/libs/settings/cloudconfigs/translation/<vendor>

/apps/settings/cloudconfigs/translation/<vendor>

/conf/global/settings/cloudconfigs/translation/<vendor>

/conf/<tenant>/settings/cloudconfigs/translation/<vendor>

重组指导

任何新的供应商翻译连接器Cloud Services都必须迁移到新位置(/apps, /conf/global 或 /conf/<tenant>)。

  1. 将“上一位置”中的现有配置迁移到“新位置”。

    • 手动通过 AEM创作UI(位于工具>Cloud Services>翻译Cloud Services).
      或
    • 将任何新的供应商翻译连接器Cloud Services配置从先前位置复制到新位置(/apps, /conf/global 或 /conf/<tenant>)。

  2. 将适用的AEM配置与AEM内容层次结构关联。

    1. AEM Sites页面层级 AEM Sites >页面>页面属性>高级选项卡>云配置.
    2. AEM体验片段层次结构(通过 AEM体验片段>体验片段>属性>Cloud Services选项卡>云配置.
    3. AEM Experience Fragment文件夹层次结构(通过 AEM体验片段>文件夹>属性>Cloud Services选项卡>云配置.
    4. AEM Assets文件夹层次结构 AEM Assets >文件夹>文件夹属性>Cloud Services选项卡>配置.
    5. AEM项目(通过 AEM项目>项目>项目属性>高级选项卡>云配置.

  3. 取消与上述AEM内容层次结构中任何迁移的旧版翻译Cloud Services的关联。

注释

翻译Cloud Services解析按以下顺序进行：

  1. /conf/<tenant>/settings/cloudconfigs/translations/<vendor>
  2. /conf/global/settings/cloudconfigs/translations/<vendor>
  3. /apps/settings/cloudconfigs/translations/<vendor>
  4. /libs/settings/cloudconfigs/translations/<vendor>

工作流通知电子邮件模板 workflow-notification-email-templates

上一位置
/etc/workflow/notification
新位置

/libs/settings/workflow/notification

/conf/global/settings/workflow/notification

重组指导

任何修改的工作流通知电子邮件模板都必须迁移到新位置(/conf/global)。

  1. 将之前位置中任何修改的工作流通知电子邮件模板复制到新位置。
  2. 从上一个位置删除迁移的工作流通知电子邮件模板。
注释

工作流通知电子邮件模板解析按以下顺序发生：

  1. /etc/workflow/notification
  2. /conf/global/settings/workflow/notification
  3. /libs/settings/workflow/notification

工作流包 workflow-packages

上一位置
/etc/workflow/packages
新位置
/var/workflow/packages
重组指导

应将之前位置中的现有工作流包迁移到新位置。

  1. 删除之前位置中其他内容未引用且不需要的任何工作流包。
  2. 在以前的位置移动任何未被其他内容引用但在新位置中需要的工作流包。
  3. 保留先前位置中其他内容引用的任何工作流包。
注释

通过经典UI Miscadmin控制台创建的工作流包将保留在先前的位置，而所有其他工作流包则保留到新位置。

可以通过经典UI Miscadmin控制台管理存储在以前或以下位置中的工作流包。

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56