AEM 6.5中的Sites存储库重构

如父项中所述 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/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
注释

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

要获取客户端库类别，请访问每个 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文件中对“先前位置”的任何引用，才能从“新位置”导入。

  • 更新在“上一位置”中引用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节点，并检查categories属性：

  • /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

在此页面上