AEM 6.5中的Sites存储库重构 sites-repository-restructuring-in-aem

/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 > Personalization > Audiences 中显示为只读。

如果要在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。

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

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

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

不适用

/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

/apps/msm （客户Blueprint配置）

/libs/msm (适用于Screens、Commerce的现成Blueprint配置)

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

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

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

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

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

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

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

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

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

/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. 从上一个位置删除任何迁移的页面事件通知电子邮件模板。

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

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

不适用

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

• 在“上一位置”更新任何引用grid_base.less的自定义LESS文件以引用新位置。

引用不存在的grid_base.less文件会导致页面和模板编辑器的布局模式不起作用，并中断页面布局。

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

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

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

• 请勿将可创作设计移出/etc。

推荐的方法是使用可编辑模板构建AEM Sites和页面，这些模板使用结构内容和策略来代替设计。

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

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

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

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