AEM 6.4中的常见存储库重组

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

升级6.4版

6.5升级之前

使用6.4升级

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

例如, ContextHub配置的sling:resourceType必须是相对配置,而不是绝对配置。

工作流模型

上一位置 /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.htmlhttp://localhost:4502/editor.html/etc/workflow/models/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. 例如,导出:
      • /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提供的工作流模型定义所取代。

工作流实例

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

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

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

注释 中的任何显式路径引用 “上一位置”的 custom 代码也应考虑“新位置”。 建议对此代码进行重构以使用AEM工作流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)中才能保留,否则将被/libs/settings/workflow/launcher中AEM提供的工作流启动器定义所取代。

工作流脚本

上一位置 /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升级之前

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. 取消与上述AEM内容层级中任何迁移的旧版ContextHub配置的关联。
注释 不适用

经典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-Hook端点

上一位置 /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项目模板,以指向相应的新位置。
注释 如果应用了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控制台,在https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging中重新启动Day Commule 5标记OSGi包,以便AEM识别新位置包含内容且应使用。
注释

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

在迁移到新位置后,对“上一位置”的引用将继续有效,因为所有功能都可利用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. 将先前位置的现有配置迁移到新位置。
    • 通过位于工具>Cloud Services>翻译Cloud Services的AEM创作UI,手动重新创建新的翻译Cloud Services配置。
      或者
    • 将任何新的翻译Cloud Services配置从“上一位置”复制到“新位置”(/apps/conf/global/conf/<tenant>)。
  2. 将适用的AEM配置与AEM内容层次结构关联。
    1. 通过AEM Sites >页面>页面属性>高级选项卡>云配置来AEM Sites页面层次。
    2. 通过AEM体验片段>体验片段>属性>Cloud Services选项卡>云配置实现的AEM体验片段层次结构。
    3. 通过AEM体验片段>文件夹>属性>Cloud Services选项卡>云配置的AEM体验片段文件夹层次结构。
    4. 通过AEM Assets >文件夹>文件夹属性>Cloud Services选项卡>配置来AEM Assets文件夹层次结构。
    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兼容。

翻译语言

上一位置 /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. 将“上一位置”中的现有配置迁移到“新位置”。
    • 通过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体验片段>体验片段>属性>Cloud Services选项卡>云配置实现的AEM体验片段层次结构。
    3. 通过AEM体验片段>文件夹>属性>Cloud Services选项卡>云配置实现AEM体验片段文件夹层次结构。
    4. 通过AEM Assets >文件夹>文件夹属性>Cloud Services选项卡>配置来AEM Assets文件夹层次结构。
    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>

工作流通知电子邮件模板

上一位置 /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
重组指导

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

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

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

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

在此页面上