AEM 6.5中的常见存储库重组

如AEM 6.5](/docs/experience-manager-65/sites-deploying/repository-restructuring.html?lang=zh-Hans)中的父级[存储库重组页中所述,升级到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

即,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.5开发实例中,以便它们存在于“上一个”位置。
  2. 使用AEM Workflow Model Editor编辑工作流模型,网址为: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 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,如果要保留,则这些自定义将被/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,则此重组应作为升级项目的一部分执行。 否则,编辑和保存引用“上一位置”中脚本的工作流步骤将从工作流步骤中完全删除工作流脚本引用,并且只有“新位置”中的工作流脚本在脚本选择下拉列表中可用。

未来升级前

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
注释 不适用

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 Communate标记OSGi捆绑包将仅将New Location注册为标记根(如果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 Experience Fragment层次结构,通过AEM Experience Fragments > Experience Fragments >属性>Cloud Services选项卡>云配置
    3. AEM Experience Fragments文件夹层次结构,通过AEM Experience Fragments >文件夹>属性>Cloud Services选项卡>云配置
    4. AEM Assets文件夹层次结构,通过AEM Assets >文件夹>文件夹属性>Cloud Services选项卡>配置
    5. AEM项目(通过AEM项目>项目>项目属性>高级选项卡>云配置)。
  3. 将任何迁移的旧版翻译Cloud Services与上述AEM内容层次结构取消关联。
注释

翻译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 Experience Fragment层次结构,通过AEM Experience Fragments > Experience Fragments >属性>Cloud Services选项卡>云配置
    3. AEM Experience Fragment文件夹层次结构(通过AEM Experience Fragments >文件夹>属性>Cloud Services选项卡>云配置)。
    4. AEM Assets文件夹层次结构,通过AEM Assets >文件夹>文件夹属性>Cloud Services选项卡>配置
    5. AEM项目(通过AEM项目>项目>项目属性>高级选项卡>云配置)。
  3. 将任何迁移的旧版翻译Cloud Services与上述AEM内容层次结构取消关联。
注释

翻译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控制台管理存储在以前或以下位置的工作流包。

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now