6.4中AEM的通用儲存庫重組

如父6.4頁中的「資料庫重組」頁中所述，升級至AEM6.4的客戶應使用此頁評估與資料庫更改相關的工作成果，這些工作可能會影響所有解決方案。 有些變更需要在6.4升級程AEM序中努力工作，而有些則會延遲至6.5升級。

使用6.4升級

6.5升級版之前

使用6.4升級

ContextHub 組態

從AEM6.4開始，沒有預設的ContextHub設定。 因此，在站點的根級別上，應設定cq:contextHubPathproperty以指示應使用哪種配置。

  1. 導覽至網站的根目錄。
  2. 開啟根頁面的頁面屬性，並選取「個人化」索引標籤。
  3. 在「Contexthub路徑」欄位中，輸入您自己的ContextHub設定路徑。

此外，在ContextHub配置中，sling:resourceType必須更新為相對而非絕對。

  1. 在CRX DE Lite中開啟ContextHub配置節點的屬性，例如/apps/settings/cloudsettings/legacy/contexthub
  2. 將sling:resourceType從/libs/granite/contexthub/cloudsettings/components/baseconfiguration變更為granite/contexthub/cloudsettings/components/baseconfiguration

亦即，ContextHub組態的sling:resourceType必須是相對的，而非絕對的。

工作流程模型

上一個位置 /etc/workflow/models
新位置

/libs/settings/workflow/models

/conf/global/settings/workflow/models

/var/workflow/models
重組指導

任何新的或修改的工作流模型都必須遷移到/conf/global/workflow/models。

  1. 將修改的工作流模型部署到本AEM地6.4開發實例中，使其存在於「上一個」位置。
  2. 使用「工作流模型編輯器」(AEMWorkflow Model Editor)，在AEM>「工具」(Tools)>「工作流」(Workflow)>「模型」(Models)中編輯「工作流模型」(Workflow Model)。
  3. 遷移修改的AEM提供的工作流模型時
    1. 在「工作流模型編輯器」開啟時，修改瀏覽器的地址URL，並將路徑段/libs/settings/workflow/models替換為/etc/workflow/models。
      • 例如，變更：http://localhost:4502/editor.html/libs/settings/workflow/models/dam/update_asset.html至http://localhost:4502/editor.html/etc/workflow/models/dam/update_asset.html
  4. 在工作流模型編輯器中啟用「編輯」模式，該模式將工作流模型定義複製到/conf/global/workflow/models。
  5. 點選「同步」按鈕，將變更同步至/var/workflow/models下的「執行階段工作流程模型」。
  6. 同時匯出「工作流程模型」(/conf/global/workflow/models/<workflow-model>?lang=zh-Hant)和「執行時期工作流程模型」(/var/workflow/models/<workflow-model>?lang=zh-Hant)，並整合至專AEM案。
    1. 例如，匯出：
      • /config/settings/workflow/models/dam/my_workflow_model 和
      • /var/workflow/models/dam/my_workflow_model
附註

「工作流模型」解析按以下順序進行：

  1. /conf/global/settings/workflow/models
  2. /libs/settings/workflow/models
  3. /etc/workflow/models

因此，如果要保留「上一個」AEM位置中保存的任何提供的工作流模型定制，則必須將其移至/conf/global/settings/workflow/models，否則將被/libs/settings/workflow/models中AEM提供的工作流模型定義所取代。

工作流程例項

上一個位置 /etc/workflow/instances
新位置 /var/workflow/instances
重組指導

不需要執行任何動作來與新位置對齊。

歷史工作流程例項可安全地繼續駐留在先前位置，而新的工作流程例項則會在新位置中建立。
附註 中的任何顯式路徑引用 「上一個位置」的 custom 程式碼也應考量「新位置」。 建議將此程式碼重構為使用工AEM作流程API。

工作流程啟動器

上一個位置 /etc/workflow/launcher/config
新位置

/libs/settings/workflow/launcher/config

/conf/global/settings/workflow/launcher/config
重組指導

任何新的或修改的Workflow Rachilters都必須遷移到/conf/global/workflow/launcher/config。

  1. 將任何新的或修改的工作流啟動程式配置從「上一個位置」複製到「新位置」(/conf/global)。
附註

Workflow Launcher解析按以下順序進行：

  1. /conf/global/settings/workflow/launcher
  2. /libs/settings/workflow/launcher
  3. /etc/workflow/launcher

因此，「上一個」位置AEM中保留的提供工作流啟動程式的任何自定義都必須移動到「新位置」(/conf/global/settings/workflow/launcher)，否則將被/libs/settings/workflow/launcher中AEM提供的工作流啟動程式定義取代。

工作流指令碼

上一個位置 /etc/workflow/scripts
新位置

/libs/workflow/scripts

/apps/workflow/scripts
重組指導

任何新的或修改的工作流指令碼都必須遷移到「新位置」(New Location)，並且引用的工作流模型已更新，以反映「新位置」(New Location)。

  1. 將任何新的或修改的工作流指令碼從上一個位置複製到新位置。
    • /apps/workflow/scripts 應在SCM中維護。
  2. 更新工作流模型中先前位置對工作流指令碼的任何引用，以指向新位置。
附註

AEM 6.4 SP1在發行時，可讓此重組延遲至6.5 upgrade 。

如果在6.4 AEM AEM SP1發行之前升級到6.4，則應在升級項目中執行此重組。 如果不這樣做，編輯和保存引用「上一個位置」中指令碼的「工作流指令碼」將完全從「工作流步驟」中刪除「工作流指令碼」引用，並且只有「新位置」中的「工作流指令碼」將在指令碼選擇下拉式清單中可用。

6.5之前版本升級

ContextHub 組態

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

/libs/settings/cloudsettings

/conf/global/settings/cloudsettings

/conf/<tenant>/settings/cloudsettings
重組指導

任何新的或修改的ContextHub配置都必須遷移到新位置，並且必須更新引用的AEM Sites頁面以反映新位置。

  1. 將任何新的或修改的ContextHub配置從上一個位置複製到新位置。
  2. 將適用的組AEM態與內容階AEM層建立關聯。
    1. AEM Sites的頁面階層：AEM Sites>頁面>頁面屬性>進階標籤>雲端設定。
  3. 將任何遷移的舊版ContextHub配置與上述內容層AEM次分離。
附註 N/A

經典Cloud Services設計

上一個位置 /etc/designs/cloudservices
新位置

/libs/settings/wcm/designs/cloudservices

/apps/settings/wcm/designs/cloudservices
重組指導

適用於任何以SCM管理且不在執行時期透過設計對話方塊寫入的設計。

  1. 將設計從「上一個位置」複製到「新位置」(/apps)。
  2. 將「設計」中的任何CSS、JavaScript和靜態資源轉換為具有allowProxy = true的「用戶端程式庫」。
  3. 更新中上一個位置的引用 cq : designPath 屬性。
  4. 更新參照「上一位置」的任何頁面，以使用新的「用戶端程式庫」類別（這需要更新「頁面」實作代碼）。
  5. 更新AEMDispatcher規則，允許通過/etc.clientlibs/.. 代理servlet。

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

  • 請勿將可作者的設計移出/etc。
附註 不適用

傳統儀表板設計

上一個位置 /etc/designs/dashboards
新位置

/libs/settings/wcm/designs/dashboards

/apps/settings/wcm/designs/dashboards
重組指導

適用於任何以SCM管理且不在執行時期透過設計對話方塊寫入的設計。

  1. 將設計從「上一個位置」複製到「新位置」(/apps?lang=zh-Hant)。
  2. 將「設計」中的任何CSS、JavaScript和靜態資源轉換為具有allowProxy = true的「用戶端程式庫」。
  3. 在 cq : designPath 屬性。
  4. 更新參照「上一位置」的任何頁面，以使用新的「用戶端程式庫」類別（這需要更新「頁面」實作代碼）。
  5. 更新AEMDispatcher規則，允許通過/etc.clientlibs/.. 代理servlet。

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

  • 請勿將可作者的設計移出/etc。
附註 不適用

傳統報表設計

上一個位置 /etc/designs/reports
新位置

/libs/settings/wcm/designs/reports

/apps/settings/wcm/designs/reports
重組指導

適用於任何以SCM管理且不在執行時期透過設計對話方塊寫入的設計。

  1. 將設計從「上一個位置」複製到「新位置」(/apps?lang=zh-Hant)。
  2. 將「設計」中的任何CSS、JavaScript和靜態資源轉換為具有allowProxy = true的「用戶端程式庫」。
  3. 在 cq : designPath 屬性。
  4. 更新參照「上一位置」的任何頁面，以使用新的「用戶端程式庫」類別（這需要更新「頁面」實作代碼）。
  5. 更新AEMDispatcher規則，允許通過/etc.clientlibs/.. 代理servlet。

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

  • 請勿將可作者的設計移出/etc。
附註 不適用

預設設計

上一個位置 /etc/designs/default
新位置

/libs/settings/wcm/designs/default

/apps/settings/wcm/designs/default
重組指導

適用於任何以SCM管理且不在執行時期透過設計對話方塊寫入的設計。

  1. 將設計從「上一個位置」複製到「新位置」(/apps?lang=zh-Hant)。
  2. 將「設計」中的任何CSS、JavaScript和靜態資源轉換為具有allowProxy = true的「用戶端程式庫」。
  3. 在 cq : designPath 屬性。
  4. 更新參照「上一位置」的任何頁面，以使用新的「用戶端程式庫」類別（這需要更新「頁面」實作代碼）。
  5. 更新AEMDispatcher規則，允許通過/etc.clientlibs/.. 代理servlet。

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

  • 請勿將可作者的設計移出/etc。
附註 不適用

AdobeDTM JavaScript端點

上一個位置 /etc/clientlibs/dtm
新位置 /var/cq/dtm/clientlibs
重組指導

不需執行任何動作。

公共先前位置用作專用新位置的代理端點。
附註 不適用

AdobeDTM Web-Hook端點

上一個位置 /etc/dtm-hook
新位置 /var/cq/dtm/web-hook
重組指導

不需執行任何動作。

公共先前位置用作專用新位置的代理端點。
附註 不適用

收件箱任務

上一個位置 /etc/taskmanagement
新位置 /var/taskmanagement
重組指導 使用收件箱清除維護任務可根據需要從上一個位置刪除舊任務。
附註

將Task遷移到新位置不需要任何操作。

  • 「上一個位置」中顯示的任務仍可繼續使用並正常運作。
  • 新任務在新位置中建立。

多站點管理器Blueprint配置

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

/libs/msm

/apps/msm
重組指導
  1. 將自定義配置從/etc/blueprints複製到/apps/msm。
  2. 移除 /etc/blueprints.
附註 不適用

AEM Projects Dashboard Gadget配置

上一個位置 /etc/projects/dashboard/gadgets
新位置

/libs/cq/core/content/projects/dashboard/gadgets

/apps/cq/core/content/projects/dashboard/gadgets
重組指導

任何新的或已修AEM改的「Projects Dashboard Gadget配置」都必須遷移到新位置(/apps)。

  1. 將任何新的或已修AEM改的「項目儀表板Gadget配置」從上一個位置複製到新位置(/apps)。
    1. 請勿複製未修AEM改的「Projects Dashboard Gadget配置」，因為這些配置現在存在於新位置(/libs)中。
  2. 更新參AEM考「上一個位置」的任何「項目」範本，以指向適當的新位置。
附註 如果應AEM用了6.4相容包，則在刪除相容包時必須執行儲存庫對齊活動。

複製通知電子郵件模板

上一個位置 /etc/notification/email/default/com.day.cq.replication
新位置

/libs/settings/notification-templates/com.day.cq.replication

/apps/settings/notification-templates/com.day.cq.replication
重組指導

任何新的或修改的複製通知電子郵件模板都必須遷移到新位置(/apps)

  1. 將任何新的或修改的複製通知電子郵件模板從上一個位置複製到新位置(/apps)。
  2. 從上一個位置刪除所有遷移的複製通知電子郵件模板。
附註

唯一支援的新複製通知電子郵件模板是支援新語言環境。

複製通知電子郵件模板解析按以下順序進行：

  1. /etc/notification/email/default/com.day.cq.replication
  2. /apps/settings/notification-templates/com.day.cq.replication
  3. /libs/settings/notification-templates/com.day.cq.replication

標記

上一個位置 /etc/tags
新位置 /content/cq:tags
重組指導

所有標籤都必須移轉至/content/cq:tags。

  1. 將所有標籤從上一個位置複製到新位置。
  2. 從上一個位置移除所有標籤。
  3. 透過AEMWeb主控台，在https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging重新啟動Day Commeture 5 Tagging OSGi搭售，以識別AEM新位置包含內容且應使用。
附註

重新啟動Day Commute標籤OSGi捆綁包將僅在「上一個位置」為空時將「新位置」註冊為標籤根目錄。

針對所有運用TagManager API進行標籤解析的功能，移轉至新位置後，「上一個位置」的參考將AEM會繼續運作。

任何明確引用路徑/etc/tags的自訂代碼都必須更新為/content/ cq :tags ，或最好改寫為搭配此移轉，以運用TagManager Java API。

翻譯雲端服務

上一個位置 /etc/cloudservices/translation
新位置

/libs/settings/cloudconfigs/translation/translationcfg

/apps/settings/cloudconfigs/translation/translationcfg

/conf/global/settings/cloudconfigs/translation/translationcfg

/conf/<tenant>/settings/cloudconfigs/translation/translationcfg
重組指導

任何新的翻譯Cloud Services都必須遷移到新位置（/apps、/conf/global或/conf/<tenant>）。

  1. 將上一個位置的現有配置遷移到新位置。
    • 通過編寫UI(位於工具>Cloud ServicesAEM>翻譯Cloud Services)手動重新建立新的翻譯Cloud Services配置。
      或
    • 將任何新的翻譯Cloud Services配置從「上一個位置」複製到「新位置」（/apps、/conf/global或/conf/<tenant>）。
  2. 將適用的組AEM態與內容階AEM層建立關聯。
    1. AEM Sites的頁面階層(透過AEM Sites>頁面>頁面屬性>進階標籤>雲端設定)。
    2. 體AEM驗片段階層(透過AEM體驗片段>體驗片段>屬性>Cloud Services標籤>雲端設定)。
    3. 體驗AEM片段資料夾階層(透過AEM體驗片段>資料夾>屬性>Cloud Services標籤>雲端設定)。
    4. AEM Assets資料夾層次結構(通過AEM Assets>資料夾>資料夾屬性>Cloud Services頁籤>配置)。
    5. 透AEM過AEM專案>專案>專案屬性>進階標籤>雲端設定進行專案。
  3. 將任何遷移的舊版翻譯Cloud Services與上述內容層次AEM分離。
附註

翻譯Cloud Services解析按以下順序進行：

  1. /conf/<tenant>/settings/cloudconfigs/translations/translationcfg
  2. /conf/global/settings/cloudconfigs/translations/translationcfg
  3. /apps/settings/cloudconfigs/translations/translationcfg
  4. /libs/settings/cloudconfigs/translations/translationcfg

遷移的翻譯Cloud Services必須與AEM6.4相容。

翻譯語言

上一個位置 /etc/translation/supportedLanguages
新位置

/libs/settings/translation/supportedLanguages

/apps/settings/translation/supportedLanguages
重組指導

任何新的或修改的翻譯語言定義都需要將所有翻譯語言定義遷移到新位置(/apps)。

  1. 如果對翻譯語言定義進行了任何添加或修改，則將所有翻譯語言定義從上一個位置複製到新位置(/apps)。
附註

翻譯語言路徑解析按以下順序進行：

  1. /etc/translation/supportedLanguages
  2. /apps/settings/translation/supportedLanguage
  3. /libs/settings/translation/supportedLanguages

此解析度不支援合併覆蓋，這表示已解析的路徑必須包含所有支援的語言，且不會繼承高階解析度的支援語言。

翻譯規則

上一個位置 /etc/workflow/models/translation/translation_rules.xml
新位置

/libs/settings/translation/rules/translation_rules.xml

/apps/settings/translation/rules/translation_rules.xml

/conf/global/settings/translation/rules/translation_rules.xml
重組指導

修改的翻譯規則XML檔案必須遷移到新位置（/apps或/conf/global）。

1.將修改過的翻譯規則XML檔案從上一個位置複製到新位置。
附註

複製轉換規則XML解析按以下順序進行：

  1. /conf/global/settings/translation/rules/translation_rules.xml
  2. /apps/settings/translation/rules/translation_rules.xml
  3. /etc/workflow/models/translation/translation_rules.xml
  4. /libs/settings/translation/rules/translation_rules.xml

翻譯介面工具集客戶端庫

上一個位置 /etc/designs/translation/translationwidget
新位置

/libs/settings/wcm/designs/translation/translationwidget

/apps/settings/wcm/designs/translation/translationwidget
重組指導

適用於任何以SCM管理且不在執行時期透過設計對話方塊寫入的設計。

  1. 將設計從「上一個位置」複製到「新位置」(/apps?lang=zh-Hant)。
  2. 將「設計」中的任何CSS、JavaScript和靜態資源轉換為具有allowProxy = true的「用戶端程式庫」。
  3. 在 cq : designPath 屬性。
  4. 更新參照「上一位置」的任何頁面，以使用新的「用戶端程式庫」類別（這需要更新「頁面」實作代碼）。
  5. 更新AEMDispatcher規則，允許通過/etc.clientlibs/.. 代理servlet。

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

  • 請勿將可作者的設計移出/etc。
附註 不適用

樹激活Web控制台

上一個位置 /etc/replication/treeactivation
新位置 /libs/replication/treeactivation
重組指導 不需執行任何動作。
附註 樹激活Web控制台現在可通過​工具>部署>複製>激活樹​獲得。

廠商轉換連接器Cloud Services

上一個位置 /etc/cloudservices/<vendor>
新位置

/libs/settings/cloudconfigs/translation/<vendor>

/apps/settings/cloudconfigs/translation/<vendor>

/conf/global/settings/cloudconfigs/translation/<vendor>

/conf/<tenant>/settings/cloudconfigs/translation/<vendor>
重組指導

任何新的供應商翻譯連接器Cloud Services都必須遷移到新位置（/apps、/conf/global或/conf/<tenant>）。

  1. 將「上一個位置」中的現有配置遷移到「新位置」。
    • 通過編寫UI(在「工具」>「Cloud Services」>「翻譯Cloud Services」)手動建立新廠商翻譯連接器Cloud Services配置。
      或
    • 將任何新的供應商轉換連接器Cloud Services配置從先前位置複製到新位置（/apps、/conf/global 或/conf/<tenant>）。
  2. 將適用的組AEM態與內容階AEM層建立關聯。
    1. AEM Sites的頁面階層(透過AEM Sites>頁面>頁面屬性>進階標籤>雲端設定)。
    2. 體AEM驗片段階層(透過AEM體驗片段>體驗片段>屬性>Cloud Services標籤>雲端設定)。
    3. 體驗AEM片段資料夾階層(透過AEM體驗片段>資料夾>屬性>Cloud Services標籤>雲端設定)。
    4. AEM Assets資料夾層次結構(通過AEM Assets>資料夾>資料夾屬性>Cloud Services頁籤>配置)。
    5. 透AEM過AEM專案>專案>專案屬性>進階標籤>雲端設定進行專案。
  3. 將任何遷移的舊版翻譯Cloud Services與上述內容層次AEM分離。
附註

翻譯Cloud Services解析按以下順序進行：

  1. /conf/<tenant>/settings/cloudconfigs/translations/<vendor>
  2. /conf/global/settings/cloudconfigs/translations/<vendor>
  3. /apps/settings/cloudconfigs/translations/<vendor>
  4. /libs/settings/cloudconfigs/translations/<vendor>

工作流通知電子郵件模板

上一個位置 /etc/workflow/notification
新位置

/libs/settings/workflow/notification

/conf/global/settings/workflow/notification
重組指導

任何修改的工作流通知電子郵件模板都必須遷移到新位置(/conf/global)。

  1. 將任何修改的工作流通知電子郵件模板從上一個位置複製到新位置。
  2. 從上一個位置移除移轉的工作流程通知電子郵件範本。
附註

工作流程通知電子郵件範本解析依下列順序進行：

  1. /etc/workflow/notification
  2. /conf/global/settings/workflow/notification
  3. /libs/settings/workflow/notification

工作流包

上一個位置 /etc/workflow/packages
新位置 /var/workflow/packages
重組指導

應將先前位置中的現有工作流包遷移到新位置。

  1. 移除先前位置中未被其他內容參考且不需要的其他工作流程套件。
  2. 移動先前位置中未被其他內容引用，但新位置中其他必要位置的任何工作流程套件。
  3. 保留先前位置中其他內容所參照的任何工作流程套件。
附註

透過Classic UI Miscadmin主控台建立的工作流程套件會保留在先前的位置，而其他所有套件則會保留在新位置。

可以通過Classic UI Miscadmin控制台管理儲存在先前位置或當前位置中的工作流程式包。

本頁內容