AEM 6.5中的網站存放庫重組 sites-repository-restructuring-in-aem

如AEM 6.5🔗頁面的上層存放庫重新調整中所述,升級至AEM 6.5的客戶應使用此頁面來評估與影響AEM Sites解決方案的存放庫變更相關的工作量。 在AEM 6.5升級程式期間,有些變更需要投入大量精力,而其他變更則可能延遲到未來升級。

升級為6.5

未來升級之前

6.5版升級 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區段複製到適當的新位置(/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。

未來升級之前 prior-to-upgrade

Adobe Analytics使用者端資料庫 adobe-analytics-client-libraries

上一個位置
/etc/clientlibs/foundation/sitecatalyst
新位置
/libs/cq/analytics/clientlibs/analytics
重組指南

這些使用者端資料庫的任何自訂使用都應依類別而非路徑參照使用者端資料庫:

  1. 應更新先前位置依路徑對使用者端程式庫的任何參考,以使用AEM的使用者端程式庫參考架構

  2. 如果無法使用AEM使用者端程式庫參考架構,則可透過AEM的使用者端程式庫Proxy 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轉換為網頁設計 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和靜態資源轉換為具有allowProxy = true使用者端資料庫
  3. 更新對cq:designPath屬性中「先前位置」的參照。
  4. 更新任何參考先前位置的頁面,以使用新的使用者端程式庫類別(這需要更新頁面實施程式碼)。
  5. 更新AEM Dispatcher規則,以允許透過/etc.clientlibs/ Proxy 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

多站點管理員藍圖設定 multi-site-manager-blueprint-configurations

上一個位置
/etc/blueprints
新位置

/apps/msm (客戶Blueprint設定)

/libs/msm (Screens、Commerce的現成藍圖設定)

重組指南

任何新的或修改過的多站台管理員藍圖設定都必須移轉到新位置(/apps)。

  1. 將任何新的或修改過的多站點管理員Blueprint設定從上一個位置複製到新位置(/apps)。
  2. 從先前的位置移除所有已移轉的多站點管理員藍圖設定。
附註

所有AEM提供的多網站管理員藍圖設定都存在於/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檔案中對「先前位置」的任何參照,才能從「新位置」匯入。

  • 更新任何參照自訂LESS檔案,該檔案參照了「先前位置」中的grid_base.less,以參照新位置。
附註
參考不存在的grid_base.less檔案會導致頁面和範本編輯器的版面配置模式無法運作,並中斷頁面版面配置。

靜態範本設計 static-template-designs

上一個位置
/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/ Proxy servlet提供使用者端資料庫。

對於未在SCM中管理的任何設計,以及透過「設計」對話方塊修改的執行時間:

  • 請勿將可編寫的設計移出/etc
附註
建議的方法是使用可編輯範本來建立AEM Sites和頁面,這些範本使用結構內容和原則來取代設計。

Adobe Target整合使用者端程式庫 adobe-target-integration-client-libraries

上一個位置
/etc/clientlibs/foundation/target
新位置
/libs/cq/testandtarget/clientlibs/testandtarget
重組指南

這些使用者端資料庫的任何自訂使用都應依類別而非路徑參照使用者端資料庫。

  1. 應更新先前位置依路徑對使用者端程式庫的任何參考,以使用AEM的使用者端程式庫參考架構
  2. 如果無法使用AEM使用者端程式庫參考架構,則可透過AEM的使用者端程式庫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使用者端程式庫 wcm-foundation-client-libraries

上一個位置
/etc/clientlibs/wcm/foundation
新位置
/libs/wcm/foundation/clientlibs
重組指南

這些使用者端資料庫的任何自訂使用都應依類別而非路徑參照使用者端資料庫。

  1. 應更新先前位置依路徑對使用者端程式庫的任何參考,以使用AEM的使用者端程式庫參考架構
  2. 如果無法使用AEM使用者端程式庫參考架構,則可透過AEM的使用者端程式庫Proxy 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
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2