Show Menu
主题×

AEM 6.5中的站点存储库重组

如AEM 6.5页面中的父存储库重组中所述 AEM 6.5中的存储库重组 ,升级到AEM 6.5的客户应使用此页面评估与影响AEM Sites Solution的存储库更改相关的工作成果。 某些更改需要在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区段从先前位置复制到相应的新位置(/ apps /conf/global /conf/<tenant> )
  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 执行此操作 查询Builder API 。 请注意,这是一个遍历查询,因此不要针对生产运行它,并确保根据需要调整遍历限制。
注释
ContextHub区段会在 AEM >个性化>受众中以只读方式保留到先前的位置
如果ContextHub区段要在AEM中进行编辑,则必须将其迁移到新位置( /conf/global /conf/<tenant> )。 在AEM中创建的任何新ContentHub区段将保留到新位置( /conf/global /conf/<tenant> )。
AEM站点页面属性仅允许选择上一位置( /etc )或单个新位置( /apps /conf/global /conf/<tenant> ),因此必须相应地迁移ContextHub区段。
可以删除AEM引用站点中任何未使用的ContextHub区段,但不能将其迁移到新位置:
  • /etc/segmentation/geometrixx/
  • /etc/segmentation/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
注释
从不支持编辑这些客户端库。
要获取客户端库类别,请通过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. 将设计从“上一位置”复制到“新位置”( /apps )。
  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站点页面,请更新页面的 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
重组指导 在“上一位置”下创建的基架使用旧版基架框架,无法迁移到“新位置”。 要与新位置对齐,必须使用支持的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规则,以允许通过代理servlet提供客 /etc.clientlibs/ 户端库。
对于任何未在SCM中管理的设计,以及通过设计对话框修改的运行时:
  • 请勿将可创作的设计移出 /etc
注释 建议使用可编辑模板构建AEM站点和页面,这些模板使用结构内容和策略代替设计。

Adobe Search and 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:ClientLiaryFolder节点并检查类别属性:
  • /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:ClientLiaryFolder节点并检查类别属性:
  • /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