AEM 6.4中的通用資料庫重組

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

使用6.4升級

6.5升級版之前

使用6.4升級

ContextHub 組態

從AEM 6.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. 使用AEM的「工作流程模型編輯器」(Workflow Model Editor)，在「AEM >工具>工作流程>模型」(AEM > 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 to 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 Workflow 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 如果要保留，則會由中的AEM提供的「工作流程啟動程式」定義取代 /libs/settings/workflow/launcher。

工作流程指令碼

上一個位置 /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 。

如果在AEM 6.4 SP1發行之前升級至AEM 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網站>頁面>頁面屬性>進階標籤>雲端設定」的AEM網站頁面階層。
  3. 將任何移轉的舊版ContextHub組態與前述的AEM內容階層分離。
附註 N/A

Classic 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. 更新AEM Dispatcher規則，允許透過/etc.clientlibs/... 代理servlet。

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

  • 請勿將可編寫的設計移出 /etc。
附註 N/A

傳統儀表板設計

上一個位置 /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. 更新AEM Dispatcher規則，允許透過/etc.clientlibs/... 代理servlet。

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

  • 請勿將可編寫的設計移出 /etc。
附註 N/A

傳統報表設計

上一個位置 /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. 更新AEM Dispatcher規則，允許透過/etc.clientlibs/... 代理servlet。

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

  • 請勿將可編寫的設計移出 /etc。
附註 N/A

預設設計

上一個位置 /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. 更新AEM Dispatcher規則，允許透過/etc.clientlibs/... 代理servlet。

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

  • 請勿將可編寫的設計移出 /etc。
附註 N/A

Adobe DTM JavaScript端點

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

不需執行任何動作。

公共先前位置用作專用新位置的代理端點。
附註 N/A

Adobe DTM Web-Hook端點

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

不需執行任何動作。

公共先前位置用作專用新位置的代理端點。
附註 N/A

收件箱任務

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

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

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

多站點管理器Blueprint配置

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

/libs/msm

/apps/msm
重組指導
  1. 將自訂組態從複製 /etc/blueprints 到 /apps/msm。
  2. 移除 /etc/blueprints.
附註 N/A

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 Projects Dashboard Gadget設定從先前位置複製到新位置(/apps)。
    1. 請勿複製未修改的AEM Projects Dashboard Gadget設定，因為這些設定現在已存在於新位置(/libs)中。
  2. 更新任何參照「上一個位置」的AEM Projects範本，以指向適當的新位置。
附註 如果已套用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. 透過AEM Web Console，在 https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging for AEM重新啟動Day Communate 5 Tagging OSGi bundle，以辨識「新位置」包含內容且應使用。
附註

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

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

任何明確參照路徑的自訂程 /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
重組指導

任何新的翻譯雲端服務都必須移轉至新/apps位置( /conf/global 或 /conf/<tenant>)。

  1. 將上一個位置的現有配置遷移到新位置。
    • 透過「工具>雲端服務>轉譯雲端服務」的AEM製作UI, 手動重新建立新的Translation Cloud服務設定。
      或
    • 將任何新的Translation Cloud服務配置從「上一個位置」複製到「新/apps位置」( /conf/global 或 /conf/<tenant>)。
  2. 將適用的AEM設定與AEM內容階層建立關聯。
    1. 透過 AEM Sites >頁面>頁面屬性>進階標籤>雲端設定的AEM Sites頁面階層。
    2. 透過 AEM體驗片段>體驗片段>屬性>雲端服務標籤>雲端設定的AEM體驗片段階層。
    3. 透過 AEM Experience Fragments >資料夾>屬性>雲端服務標籤>雲端設定的AEM Experience Fragment資料夾階層。
    4. 透過「 AEM Assets >資料夾>資料夾屬性>雲端服務標籤>設定」的AEM Assets資料夾階層。
    5. 透過 AEM Projects >專案>專案屬性>進階標籤>雲端設定的AEM專案。
  3. 將任何移轉的舊版Translation Cloud服務與前述的AEM內容階層分離。
附註

翻譯雲服務解析按以下順序進行：

  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

移轉的Translation Cloud服務必須與AEM 6.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. 更新AEM Dispatcher規則，允許透過/etc.clientlibs/... 代理servlet。

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

  • 請勿將可編寫的設計移出 /etc。
附註 N/A

樹狀結構啟動Web主控台

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

廠商轉譯連接器雲端服務

上一個位置 /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>
重組指導

任何新的廠商翻譯連接器雲端服務都必須移轉至新/apps位置( /conf/global 或 /conf/<tenant>)。

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

翻譯雲服務解析按以下順序進行：

  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控制台管理儲存在先前位置或當前位置中的工作流程式包。

本頁內容