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（工具>工作流>模型）編輯工作流模型。
  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
重組指導

必須將任何新的或修改的工作流啟動器遷移到/conf/global/workflow/launcher/config。

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

工作流啟動器解析按以下順序進行：

  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
重組指導

必須將任何新的或修改的工作流指令碼遷移到「新位置」，並更新參考的工作流模型以反映「新位置」。

  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 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. 更新AEM Dispatcher規則，以允許透過/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. 更新AEM Dispatcher規則，以允許透過/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. 更新AEM Dispatcher規則，以允許透過/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. 更新AEM Dispatcher規則，以允許透過/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
重組指導 使用收件箱清除維護任務可根據需要從上一個位置刪除舊任務。
附註

將任務遷移到新位置無需任何操作。

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

多站點管理器Blueprint配置

上一位置 /etc/blueprints
新位置

/libs/msm

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

AEM Projects儀表板小工具配置

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

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

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

任何新的或修改的AEM Projects儀表板小工具配置都必須遷移到新位置(/apps)。

  1. 將任何新的或修改的AEM Projects儀表板小工具配置從上一個位置複製到新位置(/apps)。
    1. 請勿複製未修改的AEM Projects儀表板小工具配置，因為新位置(/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. 透過AEM Web主控台，在https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging重新啟動Day Commulate 5 Tagging OSGi套件組合，讓AEM識別包含內容且應使用的新位置。
附註

重新啟動Day Commulate標籤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
重組指導

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

  1. 將先前位置的現有設定移轉至新位置。
    • 在工具>Cloud Services>翻譯Cloud Services，透過AEM製作UI手動重新建立新的翻譯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必須與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。
附註 不適用

樹激活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. 將「上一位置」中的現有配置遷移到「新位置」。
    • 通過AEM編寫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. 保留先前位置中其他內容所參考的任何工作流程套件。
附註

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

儲存在先前或未位置的工作流程套件可透過傳統UI Miscadmin主控台管理。

本頁內容