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的ContextHub /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/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 问每个节点并检查类别属性。

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

对于任何未在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 (客户蓝图配置)

/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

重组指导 在上一个位置下创建的基架使用旧的基架框架,无法迁移到新位置。 要与新位置对齐,必须使用支持的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. 将设计从“上一位置”复制到“新位置”(/appsNew Location)。
  2. 使用将设计中的任何CSS、JavaScript和静态资源转换为客 户端库allowProxy = true
  3. 通过AEM >站点>自定义站点页 cq:designPath 面>页 面属性>高级选项卡>设计字段更新对属性中上一个位置的引用
  4. 更新引用上一个位置的任何页面以使用新的客户端库类别(这需要更新页面实施代码)。
  5. 更新AEM Dispatcher规则,允许通过代理servlet提供客 /etc.clientlibs/ 户端库。

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

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

Adobe搜索和提升集成客户端库

上一个位置

/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

在此页面上