AEM 6.4中的網站存放庫重新調整

如上層AEM 6.4中的存放庫重組頁面所述，升級至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 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。

在6.5之前升級

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
附註

從不支援編輯這些客戶端庫。

若要取得用戶端程式庫類別，請透過CRXDELite造訪每個cq:ClientLIbraryFolder節點，並檢查categories屬性。

  • /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。
附註 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：頁面]/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配置。
附註

/libs中的「新位置」中存在所有AEM提供的多站點管理器Blueprint配置。

內容不會參考多網站管理員藍色設定，因此沒有內容參考需要調整。

多站點管理器轉出配置

上一位置

/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 /範本類型/支架/支架

/apps/settings/ wcm /範本類型/支架/支架
重組指導 在「上一位置」下建立的架構使用舊版架構，且無法移轉至新位置。 若要與新位置一致，必須使用支援的架構架構重新開發任何舊版架構。
附註 N/A

響應網格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. 應更新先前位置上依路徑對用戶端程式庫的任何參照，以使用參考架構的AEM用戶端程式庫。
  2. 如果無法使用AEM用戶端程式庫參考架構，則可透過AEM用戶端程式庫代理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用戶端程式庫代理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
附註

從不支援編輯這些客戶端庫。

若要取得用戶端程式庫類別，請透過CRXDELite造訪每個cq:ClientLIbraryFolder節點，並檢查categories屬性：

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main

本頁內容