文档AEM 6.5用户指南

AEM 6.5中的常见存储库重组 common-repository-restructuring-in-aem

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

如父项中所述 AEM 6.5中的存储库重组 页面，升级到AEM 6.5的客户应使用此页面评估与存储库更改关联的工作量，这些更改可能会影响所有解决方案。 在AEM 6.5升级过程中，有些更改需要您尽心尽力，而其他更改则可能会推迟到将来升级时再进行。

6.5版升级

在将来升级之前

6.5版升级 with-upgrade

ContextHub配置 contexthub-6.5

从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 到 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.5开发实例中，以使它们位于前一个位置。

  2. 在“AEM”>“工具”>“工作流”>“模型”中使用“AEM工作流模型编辑器”编辑工作流模型。

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

    1. 打开工作流模型编辑器后，修改浏览器的地址URL，并将路径段/libs/settings/workflow/models替换为/etc/workflow/models。
      • 例如，更改： http://localhost:4502/editor.html /libs/settings/workflow/model/dam/update_asset.html 到 http://localhost:4502/editor.html /etc/workflow/model/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. 例如，导出：

      • /conf/global/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，则此重构应作为升级项目的一部分执行。 如果不这样做，则编辑和保存引用前一位置中的脚本的工作流步骤将完全从工作流步骤中删除工作流脚本引用，并且只有新位置中的工作流脚本才在脚本选择下拉菜单中可用。

在将来升级之前 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. 取消任何已迁移的旧版ContextHub配置与上述的AEM内容层次结构的关联。
注释
不适用

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

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

/libs/settings/wcm/designs/cloudservices

/apps/settings/wcm/designs/cloudservices

重组指南

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

  1. 将设计从上一个位置复制到新位置(/apps)。
  2. 将设计中的所有CSS、JavaScript和静态资源转换为 客户端库 替换为 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和静态资源转换为 客户端库 替换为 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和静态资源转换为 客户端库 替换为 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和静态资源转换为 客户端库 替换为 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挂接端点 adobe-dtm-web-hook-endpoint

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

无需执行任何操作。

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

注释
不适用

收件箱任务 inbox-tasks

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

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

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

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

上一个位置
/etc/blueprints
新位置

/libs/msm

/apps/msm

重组指南
  1. 从复制自定义配置 /etc/blueprints 到 /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 Projects模板以指向相应的新位置。
注释
如果应用了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控制台，重新启动位于以下位置的Day Communique 5标记OSGi包： https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging ，以便AEM识别新位置：包含内容且应使用。
注释

重新启动Day Communique Tagging 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 Service都必须迁移到新位置(/apps， /conf/global 或 /conf/<tenant>)。

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

    • 通过在上的AEM创作UI手动重新创建新的翻译Cloud Service配置 “工具”>“Cloud Service”>“翻译Cloud Service”.
      或者
    • 将任何新的翻译Cloud Service配置从上一个位置复制到新位置(/apps， /conf/global 或 /conf/<tenant>)。

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

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

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

注释

翻译Cloud Service解析的顺序如下：

  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 Service必须与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和静态资源转换为 客户端库 替换为 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 Service 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 Service必须迁移到新位置(/apps， /conf/global 或 /conf/<tenant>)。

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

    • 通过，手动创建新的供应商翻译连接器Cloud Service配置 “工具”>“Cloud Service”>“翻译Cloud Service”中的AEM创作UI.
      或者
    • 将任何新的供应商翻译连接器Cloud Service配置从上一个位置复制到新位置(/apps， /conf/global 或 /conf/<tenant>)。

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

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

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

注释

翻译Cloud Service解析的顺序如下：

  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. 将未被其他内容引用、但在新位置有其他要求的任何Workflow包移动到前一位置。
  3. 将其他内容引用的任何工作流包保留在上一个位置。
注释

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

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2