AEM 6.4中的Sites Repository Restructing

如AEM 6.4 (AEM 6.4中的父資料庫重組)頁面所述,升級至AEM 6.4的客戶應使用此頁面來評估與影響AEM Sites Solution的資料庫變更相關的工作成果。 有些變更需要在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區段從先前位置複製到適當的新位置(/%3Ccode%3Eapps%3C/code%3E%E3%80%81%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除錯程式UI執行。 請注意,這是遍歷查詢,因此不要針對生產運行它,並確保根據需要調整遍歷限制。

附註

ContextHub區段持續存在至先前位置,在 AEM >個人化>觀眾中顯示為唯讀

若要在AEM中編輯ContextHub區段,則必須將它們移轉至新/conf/global 位置( /conf/<tenant>或)。 在AEM中建立的任何新ContentHub區段都會持續存留至新/conf/global 位置( /conf/<tenant>或)。

AEM網站頁面屬性僅允許選取「上一個位置」(/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. 依「上一個位置」的路徑對「用戶端程式庫」的任何參照都應更新,以使用 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網頁設計

上一個位置 /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規則,以允許透過Proxy servlet提供用戶端 /etc.clientlibs/ 程式庫。

對於未在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網站頁面,請更新頁面的節 jcr :content :
    [cq:Page]/jcr:content@cq: deviceGroups =字串[ 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 (客戶藍圖配置)

/libs/msm (適用於螢幕、商務的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/shawblers/swablers

/apps/settings/ wcm /template-types/shawblers/swablers

重組指導 在「上一個位置」下建立的腳手架使用舊版「腳手架」架構,無法移轉至「新位置」。 要與新位置保持一致,任何舊式腳手架都必須使用支援的腳手架架構重新開發。
附註 N/A

互動式格線

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

對自定義LESS檔案中「上一個位置」(Previous Location)的任何引用都必須更新為從「新位置」(New Location)導入。

  • 更新在「上一個位置」中引用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. 透過 cq:designPath AEM >網站>自訂網站頁面>頁面屬性>進階標籤>設計欄位,更新屬性中「上一個位置」的參考
  4. 更新參照「上一位置」的任何頁面,以使用新的「用戶端程式庫」類別(這需要更新「頁面」實作代碼)。
  5. 更新AEM Dispatcher規則,允許透過Proxy servlet提供用戶端 /etc.clientlibs/ 程式庫。

對於未在SCM中管理且透過設計對話方塊修改執行時期的任何設計:

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

Adobe Search and Promote整合用戶端程式庫

上一個位置

/etc/clientlibs/foundation/searchpromote

新位置 /libs/cq/searchpromote/clientlibs/searchpromote
重組指導

對這些客戶機庫的任何自定義使用都應按類別引用客戶機庫,而不是按路徑引用。

  1. 依「上一個位置」的路徑對「用戶端程式庫」的任何參照都應更新,以使用 AEM的「用戶端程式庫」參照架構
  2. 如果無法使用AEM的用戶端程式庫參考架構,則可透過AEM的用戶端程式庫Proxy servlet參考用戶端程式庫的絕對路徑:
  • /etc.clientlibs/cq/searchpromote/clientlibs/searchpromotei.js
附註

不支援編輯這些用戶端程式庫。

要獲取「客戶端庫」類別,請通過CRXDELite訪問每個cq:ClientLibraryFolder節點並檢查類別屬性:

  • /libs/cq/searchpromote/clientlibs/searchpromote

Adobe Target整合用戶端程式庫

上一個位置

/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用戶端程式庫

上一個位置

/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

本頁內容