AEM 6.5中的常见存储库重组

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

6.5版升级

在将来升级之前

6.5版升级

ContextHub 配置

从AEM 6.4开始，没有默认的ContextHub配置。 因此，在站点的根级别上 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配置的项必须是相对项而不是绝对项。

工作流模型

上一个位置 /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. 导出两个工作流模型(/conf/global/workflow/models/<workflow-model>?lang=zh-Hans)和运行时工作流模型(/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提供的工作流模型定义。

工作流实例

上一个位置 /etc/workflow/instances
新位置 /var/workflow/instances
重构指南

无需执行任何操作即可与新位置对齐。

历史工作流实例可以安全地继续驻留在前一位置，而新工作流实例将创建在新位置。
注释 中的任何显式路径引用 custom “上一位置”的代码还应考虑“新位置”。 建议重构此代码以使用AEM Workflow API。

工作流启动器

上一个位置 /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.

工作流脚本

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

在将来升级之前

ContextHub 配置

上一个位置 /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 Services设计

上一个位置 /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.
注释 不适用

经典功能板设计

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

/libs/settings/wcm/designs/dashboards

/apps/settings/wcm/designs/dashboards
重构指南

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

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

用于未在SCM中管理的任何设计，并通过“设计”对话框修改运行时设置。

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

经典报表设计

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

/libs/settings/wcm/designs/reports

/apps/settings/wcm/designs/reports
重构指南

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

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

用于未在SCM中管理的任何设计，并通过“设计”对话框修改运行时设置。

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

默认设计

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

/libs/settings/wcm/designs/default

/apps/settings/wcm/designs/default
重构指南

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

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

用于未在SCM中管理的任何设计，并通过“设计”对话框修改运行时设置。

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

AdobeDTM JavaScript端点

上一个位置 /etc/clientlibs/dtm
新位置 /var/cq/dtm/clientlibs
重构指南

无需执行任何操作。

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

AdobeDTM Web挂接端点

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

无需执行任何操作。

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

收件箱任务

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

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

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

多站点管理器Blueprint配置

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

/libs/msm

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

AEM项目功能板小工具配置

上一个位置 /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兼容包，则必须在删除兼容包时执行存储库对齐活动。

复制通知电子邮件模板

上一个位置 /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

标记

上一个位置 /etc/tags
新位置 /content/cq:tags
重构指南

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

  1. 将所有标记从上一个位置复制到新位置。
  2. 从上一个位置删除所有标记。
  3. 通过AEM Web Console，重新启动Day Communique 5 Tagging OSGi捆绑包，网址为 https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging ，以便AEM识别新位置，该位置包含内容，应当使用。
注释

重新启动Day Communique Tagging OSGi捆绑包后，只有当Previous Location为空时，才会将新位置注册为标记根。

对于所有利用AEM TagManager API进行标记解析的功能，在迁移到新位置后，对之前位置的引用将继续有效。

任何显式引用路径的自定义代码 /etc/tags 必须更新到 /content/ cq :tags ，或者最好进行重写以结合此迁移使用TagManager Java API。

翻译云服务

上一个位置 /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”.
      或
    • 将任何新的翻译Cloud Services配置从上一个位置复制到新位置(/apps， /conf/global 或 /conf/<tenant>)。
  2. 将适用的AEM配置与AEM内容层次结构关联。
    1. AEM Sites页面层级，通过 AEM Sites >页面>页面属性>高级选项卡>云配置.
    2. 通过以下方式的AEM体验片段层次结构 AEM体验片段>体验片段>属性>Cloud Services选项卡>云配置.
    3. 通过以下方式的AEM体验片段文件夹层次结构 AEM Experience Fragments >文件夹>属性>Cloud Services选项卡>云配置.
    4. AEM Assets文件夹层次结构，通过 AEM Assets >文件夹>文件夹属性>Cloud Services选项卡>配置.
    5. AEM项目，通过 AEM项目>项目>项目属性>高级选项卡>云配置.
  3. 取消任何已迁移旧版翻译Cloud ServicesAEM与上述内容层级的关联。
注释

翻译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兼容。

翻译语言

上一个位置 /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

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

翻译规则

上一个位置 /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

翻译构件客户端库

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

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

/apps/settings/wcm/designs/translation/translationwidget
重构指南

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

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

用于未在SCM中管理的任何设计，并通过“设计”对话框修改运行时设置。

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

树激活Web控制台

上一个位置 /etc/replication/treeactivation
新位置 /libs/replication/treeactivation
重构指南 无需执行任何操作。
注释 树激活Web控制台现在可通过以下方式使用 工具>部署>复制>激活树.

供应商翻译连接器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. 将以前位置中的现有配置迁移到新位置。
    • 通过，手动创建新的供应商翻译连接器Cloud Services配置 位于“工具”>“Cloud Services”>“翻译Cloud Services”中的AEM创作UI.
      或
    • 将任何新的供应商翻译连接器Cloud Services配置从上一个位置复制到新位置(/apps， /conf/global 或 /conf/<tenant>)。
  2. 将适用的AEM配置与AEM内容层次结构关联。
    1. AEM Sites页面层级，通过 AEM Sites >页面>页面属性>高级选项卡>云配置.
    2. 通过以下方式的AEM体验片段层次结构 AEM体验片段>体验片段>属性>Cloud Services选项卡>云配置.
    3. 通过以下方式的AEM体验片段文件夹层次结构 AEM Experience Fragments >文件夹>属性>Cloud Services选项卡>云配置.
    4. AEM Assets文件夹层次结构，通过 AEM Assets >文件夹>文件夹属性>Cloud Services选项卡>配置.
    5. AEM项目，通过 AEM项目>项目>项目属性>高级选项卡>云配置.
  3. 取消任何已迁移旧版翻译Cloud ServicesAEM与上述内容层级的关联。
注释

翻译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>

工作流通知电子邮件模板

上一个位置 /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

工作流包

上一个位置 /etc/workflow/packages
新位置 /var/workflow/packages
重构指南

应将以前位置中的现有Workflow包迁移到新位置。

  1. 删除先前位置中未被其他内容引用且在其他情况下不需要的任何工作流包。
  2. 将任何未由其他内容引用、但在新位置有其他要求的工作流包移动到以前的位置。
  3. 将其他内容引用的任何工作流包保留在上一个位置。
注释

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

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

在此页面上