AEM 6.4中的站点存储库重组

如AEM 6.4](/docs/experience-manager-64/sites-deploying/repository-restructuring.html?lang=zh-Hans)中的父级[存储库重组页所述,升级到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/conf/global/conf/<tenant>)中迁移的ContextHub区段。

以下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. 应更新Previous Location(上一个位置)上按路径对客户端库的任何引用,以使用引用framework的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规则,以允许通过/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

重组指导 在“上一位置”下创建的基架使用旧版Scaffolding框架,无法迁移到新位置。 要与新位置对齐,必须使用支持的Scaffolding框架重新开发任何旧版Scaffolding。
注释 不适用

响应式网格LESS

上一个位置 /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. 通过AEM >站点>自定义站点页>页面属性>高级选项卡>设计字段更新对cq:designPath属性中的上一个位置的引用。
  4. 更新引用上一个位置的任何页面以使用新的客户端库类别(这需要更新页面实施代码)。
  5. 更新AEM Dispatcher规则,以允许通过/etc.clientlibs/代理servlet提供客户端库。

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

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

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

上一个位置

/etc/clientlibs/foundation/searchpromote

新位置 /libs/cq/searchpromote/clientlibs/searchpromote
重组指导

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

  1. 应更新Previous Location(上一个位置)上按路径对客户端库的任何引用,以使用引用framework的AEM客户端库。
  2. 如果无法使用AEM Client Library引用框架,则可以通过AEM Client Library Proxy servlet引用客户端库的绝对路径:
  • /etc.clientlibs/cq/searchpromote/clientlibs/searchpromotei.js
注释

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

要获取客户端库类别,请通过CRXDELite访问每个cq:ClientLIbraryFolder节点并检查类别属性:

  • /libs/cq/searchpromote/clientlibs/searchpromote

Adobe Target Integration Client Libraries

上一个位置

/etc/clientlibs/foundation/target

新位置 /libs/cq/testandtarget/clientlibs/testandtarget
重组指导

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

  1. 应更新Previous Location(上一个位置)上按路径对客户端库的任何引用,以使用引用framework的AEM客户端库。
  2. 如果无法使用AEM Client Library引用框架,则可以通过AEM Client Library Proxy 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. 应更新Previous Location(上一个位置)上按路径对客户端库的任何引用,以使用引用framework的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

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now