AEM 6.4中的站点存储库重组

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

升级6.4版

6.5升级之前

使用6.4升级

ContextHub 区段

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

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

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

重组指导

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

  1. 将任何新的或已修改的ContextHub区段从上一个位置复制到相应的新位置(/apps/conf/global/conf/<tenant>
  2. 将上一位置对ContextHub区段的引用更新为新位置(/apps/conf/global/conf/<tenant>)中已迁移的ContextHub区段。

以下QueryBuilder查询会在以前的位置中查找对ContextHub区段的所有引用。

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

这可以通过 AEM QueryBuilder Debugger 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/segmentation/geometrixx-outdoors

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

在6.5升级之前

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
注释

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

要获取客户端库类别,请通过CRXDELite访问每个cq:ClientLIbraryFolder节点并检查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. 对于依赖于这些移动设备模拟器配置的任何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

多站点管理器Blueprint配置

上一位置 /etc/blueprints
新位置

/apps/msm (客户Blueprint配置)

/libs/msm (Screens、Commerce的现成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文件中先前位置的任何引用,才能从新位置导入。

  • 更新“上一位置”(Previous Location)中引用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. 通过AEM >站点>自定义站点页面>页面属性>高级选项卡>设计字段更新对cq:designPath属性中上一位置的引用。
  4. 更新引用上一位置的任何页面以使用新的客户端库类别(这需要更新页面实施代码)。
  5. 更新AEM Dispatcher规则,以允许通过/etc.clientlibs/代理Servlet提供客户端库。

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

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

AdobeSearch和Promote集成客户端库

上一位置

/etc/clientlibs/foundation/searchpromote

新位置 /libs/cq/searchpromote/clientlibs/searchpromote
重组指导

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

  1. 应更新在“上一位置”中按路径对客户端库的任何引用,以使用AEM引用框架的客户端库。
  2. 如果无法使用AEM客户端库引用框架,则可以通过AEM客户端库代理Servlet引用客户端库的绝对路径:
  • /etc.clientlibs/cq/searchpromote/clientlibs/searchpromotei.js
注释

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

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

  • /libs/cq/searchpromote/clientlibs/searchpromote

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
注释

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

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

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

在此页面上