AEM 6.4中的Sites Repository Restructing

如上層「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區段從上一個位置複製到適當的新位置（/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除錯程式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的「用戶端程式庫」參照framework。
  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規則，允許透過/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網站頁面，請更新頁面的 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/shabler/shablers

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

自適應網格LESS

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

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

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

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

上一個位置

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

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

  1. 依「上一個位置」的路徑對「用戶端程式庫」的任何參照都應更新為使用AEM的「用戶端程式庫」參照framework。
  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的「用戶端程式庫」參照framework。
  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的「用戶端程式庫」參照framework。
  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

本頁內容