AEM 6.5中的Sites存储库重构

上次更新: 2023-11-08
  • 主题:
  • Upgrading
    查看有关此主题的更多信息

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

6.5版升级

在将来升级之前

6.5版升级

ContextHub 区段

上一个位置 /etc/segmentation/contexthub
新位置

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

/conf/<tenant>/settings/wcm/segments

重组指南

如果有任何新区段或修改的ContextHub区段是在源代码管理中编辑的,而不是在AEM中编辑的,则必须将它们迁移到新位置:

  1. 将任何新区段或修改的ContextHub区段从上一个位置复制到适当的新位置(/%3Ccode%3Eapps%3C/code%3E%EF%BC%8C%20%3Ccode%3E/conf/global%3C/code%3E%20%E6%88%96%20%3Ccode%3E/conf/<tenant>%3C/code%3E?lang=zh-Hans)
  2. 将之前位置对ContextHub区段的引用更新为新位置中已迁移的ContextHub区段(/apps/conf/global/conf/<tenant>)。

以下QueryBuilder查询将查找对ContextHub区段的所有引用,并位于以前的位置。

path=/content property=cq:segments property.operation=like property.value=/etc/segmentation/contexthub/%

可以通过以下方式执行: AEM QueryBuilder调试器UI. 请注意,这是一个遍历查询,因此不要对生产运行它,并确保根据需要调整遍历限制。

注释

保留到之前位置的ContextHub区段在中显示为只读 AEM >个性化>受众.

如果要在AEM中编辑ContextHub区段,则必须将其迁移到新位置(/conf/global/conf/<tenant>)。 在AEM中创建的任何新ContentHub区段都会保留到新位置(/conf/global/conf/<tenant>)。

AEM Sites页面属性仅允许使用上一个位置(/etc)或单个新位置(/apps/conf/global/conf/<tenant>),因此必须相应地迁移ContextHub区段。

可以从AEM引用站点中删除任何未使用的ContextHub区段,并且不会将其迁移到新位置:

  • /etc/segmentation/geometrixx/
  • /etc/segment/geometrixx-outdoors

注意:如果ClientContext正在使用,建议转换为ContextHub。

在将来升级之前

Adobe Analytics客户端库

上一个位置

/etc/clientlibs/foundation/sitecatalyst

新位置 /libs/cq/analytics/clientlibs/analytics
重组指南

这些客户端库的任何自定义使用都应按类别而不是路径引用客户端库:

  1. 应更新以前位置按路径对客户端库的任何引用,以便使用 AEM客户端库引用框架.
  2. 如果无法使用AEM客户端库引用框架,可以通过AEM客户端库代理servlet引用客户端库的绝对路径。
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/appmeasurement.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/plugins.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/sitecatalyst.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/tracking.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/util.js
注释

从不支持编辑这些客户端库。

要获取客户端库类别,请访问每个类别 cq:ClientLIbraryFolder 节点通过CRXDELite并检查categories属性。

  • /libs/cq/analytics/clientlibs/sitecatalyst/appmeasurement
  • /libs/cq/analytics/clientlibs/sitecatalyst/plugins
  • /libs/cq/analytics/clientlibs/sitecatalyst/sitecatalyst
  • /libs/cq/analytics/clientlibs/sitecatalyst/tracking
  • /libs/cq/analytics/clientlibs/sitecatalyst/util

经典Microsoft Word到网页设计

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

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

重组指南

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

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

对于未在SCM中管理并通过设计对话框修改运行时的任何设计:

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

移动设备模拟器配置

上一个位置

/etc/mobile

新位置

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

重组指南 必须将任何新的移动设备模拟器配置迁移到新位置。
  1. 将任何新的移动设备模拟器配置从上一个位置复制到新位置(/apps/conf/global/conf/<tenant>)。
  2. 对于依赖于这些Mobile Device Emulator配置的任何AEM Sites页面,请更新页面的 jcr :content 节点:
    [cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/groups/responsive ]
  3. 对于依赖这些移动设备模拟器配置的任何可编辑模板,请更新可编辑模板,并指向 cq deviceGroups 到新位置。
注释

移动设备模拟器配置分辨率按以下顺序进行:

  1. /conf/<tenant>/settings/mobile
  2. /conf/global/settings/mobile
  3. /apps/settings/mobile
  4. /libs/settings/mobile
  5. /etc/mobile

多站点管理器蓝图配置

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

/apps/msm (客户Blueprint配置)

/libs/msm (用于屏幕、商务的现成Blueprint配置)

重组指南

任何新的或修改的多站点管理器Blueprint配置必须迁移到新位置(/apps)。

  1. 将任何新的或修改过的多站点管理器Blueprint配置从上一个位置复制到新位置(/apps)。
  2. 从上一个位置删除所有迁移的多站点管理器Blueprint配置。
注释

所有AEM提供的多站点管理器Blueprint配置都存在于中的新位置 /libs.

内容未引用多站点管理器蓝色配置,因此没有要调整的内容引用。

多站点管理器转出配置

上一个位置

/etc/msm/rolloutConfigs

新位置

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

重组指南

任何新的或修改的多站点管理器转出配置必须迁移到新位置。

  1. 将任何新的或修改过的多站点管理器转出配置从上一个位置复制到新位置(/apps)。
  2. 将AEM页面上的任何引用更新到上一位置的多站点管理器转出配置,以指向新位置中的对应项(/libs/apps)。

从上一个位置删除已迁移的多站点管理器转出配置。

注释 未能从“上一位置”删除迁移的多站点管理器转出配置,会导致向AEM作者显示重复的转出选项。

页面事件通知电子邮件模板

上一个位置

/etc/notification/email/default/com.day.cq.wcm.core.page

新位置

/libs/settings/notification-templates/com.day.cq.wcm.core.page

/apps/settings/notification-templates/com.day.cq.wcm.core.page

重组指南

唯一支持的新页面事件通知电子邮件模板是支持新区域设置。

页面事件电子邮件模板解析的顺序如下:

  1. /etc/notification/email/default/com.day.cq.wcm.core.page
  2. /apps/settings/notification-templates/com.day.cq.wcm.core.page
  3. /libs/settings/notification-templates/com.day.cq.wcm.core.page
注释

任何新的或修改过的页面事件通知电子邮件模板必须迁移到下的新位置 /apps

  1. 将任何新的或修改过的页面事件通知电子邮件模板从上一个位置复制到新位置(/apps)。
  2. 从上一个位置删除任何迁移的页面事件通知电子邮件模板。

页面基架

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

/libs/settings/ wcm /template-types/scaffolding/scaffolding

/apps/settings/ wcm /template-types/scaffolding/scaffolding

重组指南 在“先前位置”下创建的基架使用旧版基架框架,无法迁移到新位置。 要与新位置保持一致,必须使用支持的基架框架重新开发任何旧式基架。
注释 不适用

响应式网格更少

上一个位置 /etc/clientlibs/wcm/foundation/grid/grid_base.less
新位置 /libs/wcm/foundation/clientlibs/grid/grid_base.less
重组指南

必须更新自定义LESS文件中对“先前位置”的任何引用,才能从“新位置”导入。

  • 在“上一位置”更新任何引用grid_base.less的自定义LESS文件以引用新位置。
注释 引用不存在的项目 grid_base.less 文件导致页面和模板编辑器的布局模式无法正常工作,并中断页面布局。

静态模板设计

上一个位置 /etc/designs/<custom-site>
新位置 /apps/settings/wcm/designs/<custom-site>
重组指南

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

  1. 将设计从上一个位置复制到新位置(/apps)。
  2. 将设计中的所有CSS、JavaScript和静态资源转换为 客户端库 替换为 allowProxy = true.
  3. 更新对中先前位置的引用 cq:designPath 属性路径 AEM >站点>自定义站点页面>页面属性>高级选项卡>设计字段.
  4. 更新任何引用了先前位置的页面以使用新的客户端库类别(这需要更新页面实施代码)。
  5. 更新AEM Dispatcher规则以允许通过为客户端库提供服务 /etc.clientlibs/ 代理servlet。

对于未在SCM中管理并通过设计对话框修改运行时的任何设计:

  • 请勿将可创作设计移出 /etc.
注释 推荐的方法是使用可编辑模板构建AEM Sites和页面,这些模板使用结构内容和策略来代替设计。

Adobe Target集成客户端库

上一个位置

/etc/clientlibs/foundation/target

新位置 /libs/cq/testandtarget/clientlibs/testandtarget
重组指南

这些客户端库的任何自定义使用都应按类别而不是路径引用客户端库。

  1. 应更新以前位置按路径对客户端库的任何引用,以便使用 AEM客户端库引用框架.
  2. 如果无法使用AEM客户端库引用框架,可以通过AEM客户端库代理servlet引用客户端库的绝对路径:
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/testandtarget.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/atjs.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/atjs-integration.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/init.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/mbox.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/parameters.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/util.js
注释

从不支持编辑这些客户端库。

要获取客户端库类别,请通过CRXDELite访问每个cq:ClientLIbraryFolder节点,并检查类别属性:

  • /libs/cq/testandtarget/clientlibs/testandtarget/testandtarget
  • /libs/cq/testandtarget/clientlibs/testandtarget/atjs
  • /libs/cq/testandtarget/clientlibs/testandtarget/atjs-integration
  • /libs/cq/testandtarget/clientlibs/testandtarget/init
  • /libs/cq/testandtarget/clientlibs/testandtarget/mbox
  • /libs/cq/testandtarget/clientlibs/testandtarget/parameters
  • /libs/cq/testandtarget/clientlibs/testandtarget/util

WCM Foundation客户端库

上一个位置

/etc/clientlibs/wcm/foundation

新位置 /libs/wcm/foundation/clientlibs
重组指南

这些客户端库的任何自定义使用都应按类别而不是路径引用客户端库。

  1. 应更新以前位置按路径对客户端库的任何引用,以便使用 AEM客户端库引用框架.
  2. 如果无法使用AEM客户端库引用框架,可以通过AEM客户端库代理servlet引用客户端库的绝对路径。
  • /etc.clientlibs/wcm/foundation/clientlibs/accessibility.css
  • /etc.clientlibs/wcm/foundation/clientlibs/main.css
  • /etc.clientlibs/wcm/foundation/clientlibs/main.js
注释

从不支持编辑这些客户端库。

要获取客户端库类别,请访问每个类别 cq:ClientLIbraryFolder 节点通过CRXDELite并检查categories属性:

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main

在此页面上