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/baseconfigurationgranite/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.html to http://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 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站点页面以反映新位置。

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

经典云服务设计

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

/libs/settings/wcm/designs/cloudservices

/apps/settings/wcm/designs/cloudservices

重组指导

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

  1. 将设计从“上一位置”复制到“新位置”(/appsNew Location)。
  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. 将设计从上一位置复制到新位置(/应用程序)。
  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. 将设计从上一位置复制到新位置(/应用程序)。
  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. 将设计从上一位置复制到新位置(/应用程序)。
  2. 使用将设计中的任何CSS、JavaScript和静态资源转换为客 户端库allowProxy = true
  3. 更新对以下位置的上一个位置的引用 cq : designPath 属性。
  4. 更新引用上一个位置的任何页面以使用新的客户端库类别(这需要更新页面实施代码)。
  5. 更新AEM Dispatcher规则,允许通过/etc.clientlibs/.. 代理servlet。

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

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

Adobe DTM JavaScript端点

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

无需执行任何操作。

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

注释 不适用

Adobe DTM 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控制台,重新启动Day Commutle 5 Tagging OSGi bundle( 位于 https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging),以便AEM识别新位置包含内容并应使用该位置。
注释

重新启动Day公报标记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

重组指导

任何新的翻译云服务都必须迁移到新位置(/apps/conf/global/conf/<tenant>)。

  1. 将以前位置的现有配置迁移到新位置。
    • 通过AEM创作UI在“工具”>“云服务”>“翻译云服务” 中手动重新创建新的翻译云服务配置
      或者
    • 将任何新的Translation Cloud服务配置从上一位置复制到新位置(/apps/conf/global ) /conf/<tenant>中。
  2. 将适用的AEM配置与AEM内容层次关联。
    1. 通过AEM Sites > Page > Page Properties > Advanced Tab > Cloud配置的AEM Sites页面层次结构
    2. 通过AEM体验片段> 体验片段>属性>云服务选项卡>云配置实现的AEM体验片段层次
    3. 通过AEM体验片段>文件 夹>属性>云服务选项卡>云配置获得AEM体验片段文件夹层次结构
    4. 通过AEM Assets >文件夹> 文件夹属性>云服务选项卡>配置,获得AEM Assets文件夹层次结构
    5. 通过AEM Projects > Projects > Project > Project Properties > Advanced Tab > Cloud Configuration实现AEM项目
  3. 将任何迁移的旧版翻译云服务与上述AEM内容层次结构取消关联。
注释

翻译云服务解决方案按以下顺序进行:

  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

迁移的翻译云服务必须与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. 将设计从上一位置复制到新位置(/应用程序)。
  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控制台现在可通过“工具”>“ 部署”>“复制”>“激活树”。

供应商翻译连接器云服务

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

重组指导

任何新的供应商翻译连接器云服务必须迁移到新位/apps置( /conf/global/conf/<tenant>)。

  1. 将上一位置中的现有配置迁移到新位置。
    • 通过AEM创作UI,在“工具”>“云服务”>“翻译云服务” 中手动创建新的供应商翻译连接器云服务配置
      或者
    • 将任何新的供应商翻译连接器云服务配置从以前的位置复制到新的位置(/apps/conf/global /conf/<tenant>)。
  2. 将适用的AEM配置与AEM内容层次关联。
    1. 通过AEM Sites > Page > Page Properties > Advanced Tab > Cloud配置的AEM Sites页面层次结构
    2. 通过AEM体验片段> 体验片段>属性>云服务选项卡>云配置实现的AEM体验片段层次
    3. 通过AEM体验片段>文件 夹>属性>云服务选项卡>云配置获得AEM体验片段文件夹层次结构
    4. 通过AEM Assets >文件夹> 文件夹>文件夹属性>云服务选项卡>配置,获得AEM Assets文件夹层次结构
    5. 通过AEM Projects > Projects > Project > Project Properties > Advanced Tab > Cloud Configuration实现AEM项目
  3. 将任何迁移的旧版翻译云服务与上述AEM内容层次结构取消关联。
注释

翻译云服务解决方案按以下顺序进行:

  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控制台进行管理。

在此页面上