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
以指示應使用哪種配置。
- 導覽至網站的根目錄。
- 開啟根頁面的頁面屬性,並選取「個人化」索引標籤。
- 在「Contexthub路徑」欄位中,輸入您自己的ContextHub設定路徑。
此外,在ContextHub配置中,sling:resourceType
必須更新為相對而非絕對。
- 在CRX DE Lite中開啟ContextHub配置節點的屬性,例如
/apps/settings/cloudsettings/legacy/contexthub
- 將
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。
- 將修改的「工作流程模型」部署至本機AEM 6.4開發例項,如此就會存在於「上一個」位置。
- 使用AEM的「工作流程模型編輯器」(Workflow Model Editor),在「AEM >工具>工作流程>模型」(AEM > Workflow > Models)編輯「工作流程模型」(Workflow Model)。
- 移轉修改的AEM提供的工作流程模型時
- 在「工作流模型編輯器」開啟時,修改瀏覽器的地址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
- 在工作流模型編輯器中啟用「編輯」模式,該模式將工作流模型定義複製到/conf/global/workflow/models。
- 點選「同步」按鈕,將變更同步至/var/workflow/models下的「執行階段工作流程模型」。
- 匯出「工作流程模型」(/conf/global/workflow/models/<workflow-model>?lang=zh-Hant)和「執行時期工作流程模型」(/var/workflow/models/<workflow-model>?lang=zh-Hant),並整合至AEM專案。
- 例如,匯出:
/config/settings/workflow/models/dam/my_workflow_model 和
/var/workflow/models/dam/my_workflow_model
|
附註 |
「工作流模型」解析按以下順序進行:
/conf/global/settings/workflow/models
/libs/settings/workflow/models
/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 。
- 將任何新的或修改的工作流啟動程式配置從「上一個位置」複製到「新位置」(
/conf/global )。
|
附註 |
Workflow Launcher解析按以下順序進行:
/conf/global/settings/workflow/launcher
/libs/settings/workflow/launcher
/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)。
- 將任何新的或修改的工作流指令碼從上一個位置複製到新位置。
/apps/workflow/scripts 應在SCM中維護。
- 更新工作流模型中先前位置對工作流指令碼的任何引用,以指向新位置。
|
附註 |
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頁面以反映新位置。
- 將任何新的或修改的ContextHub配置從上一個位置複製到新位置。
- 將適用的AEM設定與AEM內容階層建立關聯。
- 透過「AEM網站>頁面>頁面屬性>進階標籤>雲端設定」的AEM網站頁面階層。
- 將任何移轉的舊版ContextHub組態與前述的AEM內容階層分離。
|
附註 |
N/A |
Classic Cloud Services Designs
上一個位置 |
/etc/designs/cloudservices |
新位置 |
/libs/settings/wcm/designs/cloudservices /apps/settings/wcm/designs/cloudservices |
重組指導 |
適用於任何以SCM管理且不在執行時期透過設計對話方塊寫入的設計。
- 將設計從「上一個位置」複製到「新位置」(
/apps )。
- 將「設計」中的任何CSS、JavaScript和靜態資源轉換為具有
allowProxy = true 的「用戶端程式庫」。
- 更新中上一個位置的引用
cq
:
designPath
屬性。
- 更新參照「上一位置」的任何頁面,以使用新的「用戶端程式庫」類別(這需要更新「頁面」實作代碼)。
- 更新AEM Dispatcher規則,允許透過/etc.clientlibs/... 代理servlet。
對於任何未在SCM中管理的設計,以及透過設計對話方塊修改執行時期的設計。
|
附註 |
不適用 |
傳統儀表板設計
上一個位置 |
/etc/designs/dashboards |
新位置 |
/libs/settings/wcm/designs/dashboards /apps/settings/wcm/designs/dashboards |
重組指導 |
適用於任何以SCM管理且不在執行時期透過設計對話方塊寫入的設計。
- 將設計從「上一個位置」複製到「新位置」(/apps?lang=zh-Hant)。
- 將「設計」中的任何CSS、JavaScript和靜態資源轉換為具有
allowProxy = true 的「用戶端程式庫」。
- 在
cq
:
designPath
屬性。
- 更新參照「上一位置」的任何頁面,以使用新的「用戶端程式庫」類別(這需要更新「頁面」實作代碼)。
- 更新AEM Dispatcher規則,允許透過/etc.clientlibs/... 代理servlet。
對於任何未在SCM中管理的設計,以及透過設計對話方塊修改執行時期的設計。
|
附註 |
不適用 |
傳統報表設計
上一個位置 |
/etc/designs/reports |
新位置 |
/libs/settings/wcm/designs/reports /apps/settings/wcm/designs/reports |
重組指導 |
適用於任何以SCM管理且不在執行時期透過設計對話方塊寫入的設計。
- 將設計從「上一個位置」複製到「新位置」(/apps?lang=zh-Hant)。
- 將「設計」中的任何CSS、JavaScript和靜態資源轉換為具有
allowProxy = true 的「用戶端程式庫」。
- 在
cq
:
designPath
屬性。
- 更新參照「上一位置」的任何頁面,以使用新的「用戶端程式庫」類別(這需要更新「頁面」實作代碼)。
- 更新AEM Dispatcher規則,允許透過/etc.clientlibs/... 代理servlet。
對於任何未在SCM中管理的設計,以及透過設計對話方塊修改執行時期的設計。
|
附註 |
不適用 |
預設設計
上一個位置 |
/etc/designs/default |
新位置 |
/libs/settings/wcm/designs/default /apps/settings/wcm/designs/default |
重組指導 |
適用於任何以SCM管理且不在執行時期透過設計對話方塊寫入的設計。
- 將設計從「上一個位置」複製到「新位置」(/apps?lang=zh-Hant)。
- 將「設計」中的任何CSS、JavaScript和靜態資源轉換為具有
allowProxy = true 的「用戶端程式庫」。
- 在
cq
:
designPath
屬性。
- 更新參照「上一位置」的任何頁面,以使用新的「用戶端程式庫」類別(這需要更新「頁面」實作代碼)。
- 更新AEM Dispatcher規則,允許透過/etc.clientlibs/... 代理servlet。
對於任何未在SCM中管理的設計,以及透過設計對話方塊修改執行時期的設計。
|
附註 |
不適用 |
Adobe DTM JavaScript端點
上一個位置 |
/etc/clientlibs/dtm |
新位置 |
/var/cq/dtm/clientlibs |
重組指導 |
不需執行任何動作。 公共先前位置用作專用新位置的代理端點。 |
附註 |
不適用 |
Adobe DTM Web-Hook端點
上一個位置 |
/etc/dtm-hook |
新位置 |
/var/cq/dtm/web-hook |
重組指導 |
不需執行任何動作。 公共先前位置用作專用新位置的代理端點。 |
附註 |
不適用 |
收件箱任務
上一個位置 |
/etc/taskmanagement |
新位置 |
/var/taskmanagement |
重組指導 |
使用收件箱清除維護任務可根據需要從上一個位置刪除舊任務。 |
附註 |
將Task遷移到新位置不需要任何操作。
- 「上一個位置」中顯示的任務仍可繼續使用並正常運作。
- 新任務在新位置中建立。
|
多站點管理器Blueprint配置
上一個位置 |
/etc/blueprints |
新位置 |
/libs/msm /apps/msm |
重組指導 |
- 將自定義配置從
/etc/blueprints 複製到/apps/msm 。
- 移除
/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 )。
- 將任何新的或已修改的AEM Projects Dashboard Gadget設定從上一個位置複製到新位置(
/apps )。
- 請勿複製未修改的AEM Projects Dashboard Gadget設定,因為這些設定現在存在於新位置(
/libs )中。
- 更新任何參照「上一個位置」的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 )
- 將任何新的或修改的複製通知電子郵件模板從上一個位置複製到新位置(
/apps )。
- 從上一個位置刪除所有遷移的複製通知電子郵件模板。
|
附註 |
唯一支援的新複製通知電子郵件模板是支援新語言環境。 複製通知電子郵件模板解析按以下順序進行:
/etc/notification/email/default/com.day.cq.replication
/apps/settings/notification-templates/com.day.cq.replication
/libs/settings/notification-templates/com.day.cq.replication
|
上一個位置 |
/etc/tags |
新位置 |
/content/cq:tags |
重組指導 |
所有標籤都必須移轉至/content/cq:tags 。
- 將所有標籤從上一個位置複製到新位置。
- 從上一個位置移除所有標籤。
- 透過AEM Web Console,在https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging重新啟動Day Commeture 5 Tagging OSGi bundle,讓AEM識別「新位置」包含內容且應使用。
|
附註 |
重新啟動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 |
重組指導 |
任何新的Translation Cloud服務都必須遷移到新位置(/apps 、/conf/global 或/conf/<tenant> )。
- 將上一個位置的現有配置遷移到新位置。
- 透過AEM製作UI,在「工具>雲端服務>轉譯雲端服務」手動重新建立新的Translation Cloud服務設定。
或
- 將任何新的Translation Cloud服務配置從「上一個位置」複製到「新位置」(
/apps 、/conf/global 或/conf/<tenant> )。
- 將適用的AEM設定與AEM內容階層建立關聯。
- 透過AEM網站>頁面>頁面屬性>進階標籤>雲端設定的AEM網站頁面階層。
- 透過AEM體驗片段>體驗片段>屬性>雲端服務標籤>雲端設定的AEM體驗片段階層。
- 透過AEM體驗片段>資料夾>屬性>雲端服務標籤>雲端設定的AEM體驗片段資料夾階層。
- 透過AEM Assets >資料夾>資料夾屬性>雲端服務標籤> Configuration的AEM Assets資料夾階層。
- 透過AEM專案>專案>專案屬性>進階標籤>雲端設定的AEM專案。
- 將任何移轉的舊版Translation Cloud服務與前述的AEM內容階層分離。
|
附註 |
翻譯雲服務解析按以下順序進行:
/conf/<tenant>/settings/cloudconfigs/translations/translationcfg
/conf/global/settings/cloudconfigs/translations/translationcfg
/apps/settings/cloudconfigs/translations/translationcfg
/libs/settings/cloudconfigs/translations/translationcfg
移轉的Translation Cloud服務必須與AEM 6.4相容。 |
翻譯語言
上一個位置 |
/etc/translation/supportedLanguages |
新位置 |
/libs/settings/translation/supportedLanguages /apps/settings/translation/supportedLanguages |
重組指導 |
任何新的或修改的翻譯語言定義都需要將所有翻譯語言定義遷移到新位置(/apps )。
- 如果對翻譯語言定義進行了任何添加或修改,則將所有翻譯語言定義從上一個位置複製到新位置(
/apps )。
|
附註 |
翻譯語言路徑解析按以下順序進行:
/etc/translation/supportedLanguages
/apps/settings/translation/supportedLanguage
/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解析按以下順序進行:
/conf/global/settings/translation/rules/translation_rules.xml
/apps/settings/translation/rules/translation_rules.xml
/etc/workflow/models/translation/translation_rules.xml
/libs/settings/translation/rules/translation_rules.xml
|
上一個位置 |
/etc/designs/translation/translationwidget |
新位置 |
/libs/settings/wcm/designs/translation/translationwidget /apps/settings/wcm/designs/translation/translationwidget |
重組指導 |
適用於任何以SCM管理且不在執行時期透過設計對話方塊寫入的設計。
- 將設計從「上一個位置」複製到「新位置」(/apps?lang=zh-Hant)。
- 將「設計」中的任何CSS、JavaScript和靜態資源轉換為具有
allowProxy = true 的「用戶端程式庫」。
- 在
cq
:
designPath
屬性。
- 更新參照「上一位置」的任何頁面,以使用新的「用戶端程式庫」類別(這需要更新「頁面」實作代碼)。
- 更新AEM Dispatcher規則,允許透過/etc.clientlibs/... 代理servlet。
對於任何未在SCM中管理的設計,以及透過設計對話方塊修改執行時期的設計。
|
附註 |
不適用 |
樹激活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> )。
- 將「上一個位置」中的現有配置遷移到「新位置」。
- 透過AEM製作UI(位於「工具>雲端服務>轉譯雲端服務」),手動建立新廠商轉譯連接器雲端服務設定。
或
- 將任何新的供應商翻譯連接器雲服務配置從先前位置複製到新位置(
/apps 、/conf/global 或/conf/<tenant> )。
- 將適用的AEM設定與AEM內容階層建立關聯。
- 透過AEM網站>頁面>頁面屬性>進階標籤>雲端設定的AEM網站頁面階層。
- 透過AEM體驗片段>體驗片段>屬性>雲端服務標籤>雲端設定的AEM體驗片段階層。
- 透過AEM體驗片段>資料夾>屬性>雲端服務標籤>雲端設定的AEM體驗片段資料夾階層。
- 透過AEM Assets >資料夾>資料夾屬性>雲端服務標籤> Configuration的AEM Assets資料夾階層。
- 透過AEM專案>專案>專案屬性>進階標籤>雲端設定的AEM專案。
- 將任何移轉的舊版Translation Cloud服務與前述的AEM內容階層分離。
|
附註 |
翻譯雲服務解析按以下順序進行:
/conf/<tenant>/settings/cloudconfigs/translations/<vendor>
/conf/global/settings/cloudconfigs/translations/<vendor>
/apps/settings/cloudconfigs/translations/<vendor>
/libs/settings/cloudconfigs/translations/<vendor>
|
工作流通知電子郵件模板
上一個位置 |
/etc/workflow/notification |
新位置 |
/libs/settings/workflow/notification /conf/global/settings/workflow/notification |
重組指導 |
任何修改的工作流通知電子郵件模板都必須遷移到新位置(/conf/global )。
- 將任何修改的工作流通知電子郵件模板從上一個位置複製到新位置。
- 從上一個位置移除移轉的工作流程通知電子郵件範本。
|
附註 |
工作流程通知電子郵件範本解析依下列順序進行:
/etc/workflow/notification
/conf/global/settings/workflow/notification
/libs/settings/workflow/notification
|
工作流包
上一個位置 |
/etc/workflow/packages |
新位置 |
/var/workflow/packages |
重組指導 |
應將先前位置中的現有工作流包遷移到新位置。
- 移除先前位置中未被其他內容參考且不需要的其他工作流程套件。
- 移動先前位置中未被其他內容引用,但新位置中其他必要位置的任何工作流程套件。
- 保留先前位置中其他內容所參照的任何工作流程套件。
|
附註 |
透過Classic UI Miscadmin主控台建立的工作流程套件會保留在先前的位置,而其他所有套件則會保留在新位置。 可以通過Classic UI Miscadmin控制台管理儲存在先前位置或當前位置中的工作流程式包。 |