AEM 6.5中的網站存放庫重組

上次更新： 2023-11-08
  • 主題：
  • Upgrading
    檢視有關此主題的更多資訊
  • 建立對象：
  • Developer

如父項所述 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-Hant)
  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/segment/geometrixx-outdoors

注意：如果ClientContext正在使用中，建議將其轉換為ContextHub。

未來升級之前

Adobe Analytics使用者端資料庫

上一個位置

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

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

  1. 應更新先前位置依路徑列出的「使用者端程式庫」參考以使用 AEM Client Library參考架構.
  2. 如果無法使用AEM Client Library參照架構，則可透過AEM Client Library 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
附註

不支援編輯這些使用者端資料庫。

若要取得「使用者端資源庫」類別，請造訪每個類別 cq:ClientLIbraryFolder 節點透過CRXDELite檢查類別屬性。

  • /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/ Proxy servlet。

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

  • 請勿將可作者設計移出 /etc.
附註 N/A

行動裝置模擬器設定

上一個位置

/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

多站點管理員藍圖設定

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

/apps/msm （客戶Blueprint設定）

/libs/msm （Screens、Commerce適用的現成Blueprint設定）
重組指南

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

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

所有AEM提供的多站點管理器藍圖設定都存在於中的新位置 /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
重組指南 在「先前位置」下建立的支架會使用舊版支架架構，且無法移轉至新位置。 為了與新位置保持一致，必須使用支援的支架框架重新開發任何舊式支架。
附註 N/A

回應式格線較少

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

必須更新自訂LESS檔案中對「先前位置」的任何參照，才能從「新位置」匯入。

  • 更新任何參照自訂LESS檔案，該檔案參照了「先前位置」中的grid_base.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/ Proxy servlet。

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

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

Adobe Target整合使用者端程式庫

上一個位置

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

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

  1. 應更新先前位置依路徑列出的「使用者端程式庫」參考以使用 AEM Client Library參考架構.
  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. 應更新先前位置依路徑列出的「使用者端程式庫」參考以使用 AEM Client Library參考架構.
  2. 如果無法使用AEM Client Library參照架構，則可透過AEM Client Library Proxy 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並檢查類別屬性：

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main
上一頁
Next page

此頁面上的