AEM 6.4中的站点存储库重组 sites-repository-restructuring-in-aem

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

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

升级6.4版

6.5升级之前

升级6.4版 with-upgrade

ContextHub 区段 contexthub-segments

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

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

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

重组指导

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

  1. 将任何新的或已修改的ContextHub区段从上一个位置复制到相应的新位置(https://experienceleague.adobe.com/%3Ccode%3Eapps%3C/code%3E,%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 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升级之前 prior-to-upgrade

Adobe Analytics客户端库 adobe-analytics-client-libraries

上一位置
/etc/clientlibs/foundation/sitecatalyst
新位置
/libs/cq/analytics/clientlibs/analytics
重组指导

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

  1. 对Previous Location(上一位置)中按路径对客户端库的任何引用都应更新为使用 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 节点,并检查类别属性。

  • /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到网页设计 classic-microsoft-word-to-web-page-designs

上一位置
/etc/designs/wordDesign
新位置

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

重组指导

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

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

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

  • 请勿将可创作设计移出 /etc.
注释
不适用

移动设备模拟器配置 mobile-device-emulator-configurations

上一位置
/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配置 multi-site-manager-blueprint-configurations

上一位置
/etc/blueprints
新位置

/apps/msm (客户Blueprint配置)

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

重组指导

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

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

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

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

多站点管理器转出配置 multi-site-manager-rollout-configurations

上一位置
/etc/msm/rolloutConfigs
新位置

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

重组指导

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

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

从以前的位置删除迁移的多站点管理器转出配置。

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

页面事件通知电子邮件模板 page-event-notification-e-mail-template

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

页面基架 page-scaffolding

上一位置
/etc/scaffolding
新位置
/libs/settings/ wcm /template-types/scaffolding/scaffolding/apps/settings/ wcm /template-types/scaffolding/scaffolding
重组指导
在“上一位置”下创建的基架使用旧版基架框架,且无法迁移到“新位置”。 要与新位置保持一致,必须使用支持的基架框架重新开发任何旧版基架。
注释
不适用

无响应网格 responsive-grid-less

上一位置
/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 文件会导致页面和模板编辑器的布局模式无法正常工作,并且会中断页面布局。

静态模板设计 static-template-designs

上一位置
/etc/designs/<custom-site>
新位置
/apps/settings/wcm/designs/<custom-site>
重组指导

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

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

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

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

Adobe Target集成客户端库 adobe-target-integration-client-libraries

上一位置
/etc/clientlibs/foundation/target
新位置
/libs/cq/testandtarget/clientlibs/testandtarget
重组指导

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

  1. 对Previous Location(上一位置)中按路径对客户端库的任何引用都应更新为使用 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客户端库 wcm-foundation-client-libraries

上一位置
/etc/clientlibs/wcm/foundation
新位置
/libs/wcm/foundation/clientlibs
重组指导

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

  1. 对Previous Location(上一位置)中按路径对客户端库的任何引用都应更新为使用 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 节点,并检查类别属性:

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56