AEM 6.5中的Sites存放庫重新調整

如父項所述 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,%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/segmentation/geometrixx-outdoors

注意:如果ClientContext正在使用中,建議轉換為ContextHub。

未來升級前

Adobe Analytics用戶端程式庫

上一位置

/etc/clientlibs/foundation/sitecatalyst

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

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

  1. 應更新「上一個位置」上依路徑對用戶端程式庫的任何參考,以使用 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至網頁設計

上一位置 /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.
附註 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 =字串[行動/群組/回應式]
  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/swargers/swabrers

/apps/settings/ wcm /template-types/swargers/swabrers

重組指導 在「上一位置」下建立的架構使用舊版架構,且無法移轉至新位置。 若要與新位置一致,必須使用支援的架構架構重新開發任何舊版架構。
附註 不適用

響應網格較少

上一位置 /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和靜態資源轉換為 用戶端程式庫 with allowProxy = true.
  3. 更新上一個位置的參考,位於 cq:designPath 透過 AEM >網站>自訂網站頁面>頁面屬性>進階標籤>設計欄位.
  4. 更新任何參考上一個位置的頁面,以使用新的用戶端程式庫類別(這需要更新頁面實作程式碼)。
  5. 更新AEM Dispatcher規則,以允許透過 /etc.clientlibs/ 代理servlet。

對於未在SCM中管理的任何設計,以及通過設計對話框修改運行時:

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

Adobe Target整合用戶端程式庫

上一位置

/etc/clientlibs/foundation/target

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

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

  1. 應更新「上一個位置」上依路徑對用戶端程式庫的任何參考,以使用 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用戶端程式庫

上一位置

/etc/clientlibs/wcm/foundation

新位置 /libs/wcm/foundation/clientlibs
重組指導

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

  1. 應更新「上一個位置」上依路徑對用戶端程式庫的任何參考,以使用 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

本頁內容