文件AEM 6.4Deploying 指南

AEM 6.4中的常見存放庫重新調整架構 common-repository-restructuring-in-aem

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Developer
CAUTION
AEM 6.4已結束延伸支援，本檔案不再更新。 如需詳細資訊，請參閱 技術支援期. 尋找支援的版本 此處.

如父項所述 AEM 6.4中的存放庫重新調整架構 頁面中，升級至AEM 6.4的客戶應使用此頁面評估與存放庫變更相關的工作成果，這些工作成果可能會對所有解決方案造成影響。 AEM 6.4升級程式中有些變更需要付出大量工作，有些則可延後至6.5升級。

使用6.4升級

6.5之前的升級

使用6.4升級 with-upgrade

ContextHub 組態 contexthub-6.4

從AEM 6.4開始，沒有預設的ContextHub設定。 因此，在網站的根層級a 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 to granite/contexthub/cloudsettings/components/baseconfiguration

即 sling:resourceType ContextHub設定必須是相對值，而非絕對值。

工作流程模型 workflow-models

上一位置
/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 to http://localhost:4502/editor.html /etc/workflow/models/dam/update_asset.html

  4. 在工作流模型編輯器中啟用「編輯」模式，該編輯器將工作流模型定義複製到/conf/global/workflow/models。

  5. 點選「同步」按鈕，將變更同步至/var/workflow/models底下的「執行階段工作流程模型」。

  6. 匯出工作流程模型(https://experienceleague.adobe.com/conf/global/workflow/models/<workflow-model>?lang=zh-Hant)和執行階段工作流程模型(https://experienceleague.adobe.com/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提供的工作流模型定義所取代。

工作流程例項 workflow-instances

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

無需執行任何動作來與新位置一致。

歷史工作流實例可以安全地繼續駐留在「上一位置」中，而新的工作流實例將在「新位置」中建立。

附註
中的任何明確路徑參考 custom 「上一位置」的程式碼也應考量「新位置」。 建議您重構此程式碼，以使用AEM工作流程API。

工作流程啟動器 workflow-launchers

上一位置
/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 若要保留，則會由中AEM提供的工作流程啟動器定義取代 /libs/settings/workflow/launcher.

工作流程指令碼 workflow-scripts

上一位置
/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之前的升級 prior-to-upgrade

ContextHub 組態 contexthub-configurations

上一位置
/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設計 classic-cloud-services-designs

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

/libs/settings/wcm/designs/cloudservices

/apps/settings/wcm/designs/cloudservices

重組指導

對於在SCM中管理、而不是在運行時通過設計對話框寫入的任何設計。

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

對於未在SCM中管理的任何設計，以及通過設計對話框修改運行時。

  • 請勿將可製作的設計移出 /etc.
附註
N/A

傳統控制面板設計 classic-dashboards-designs

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

/libs/settings/wcm/designs/dashboards

/apps/settings/wcm/designs/dashboards

重組指導

對於在SCM中管理、而不是在運行時通過設計對話框寫入的任何設計。

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

對於未在SCM中管理的任何設計，以及通過設計對話框修改運行時。

  • 請勿將可製作的設計移出 /etc.
附註
N/A

傳統報表設計 classic-reports-designs

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

/libs/settings/wcm/designs/reports

/apps/settings/wcm/designs/reports

重組指導

對於在SCM中管理、而不是在運行時通過設計對話框寫入的任何設計。

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

對於未在SCM中管理的任何設計，以及通過設計對話框修改運行時。

  • 請勿將可製作的設計移出 /etc.
附註
N/A

預設設計 default-designs

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

/libs/settings/wcm/designs/default

/apps/settings/wcm/designs/default

重組指導

對於在SCM中管理、而不是在運行時通過設計對話框寫入的任何設計。

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

對於未在SCM中管理的任何設計，以及通過設計對話框修改運行時。

  • 請勿將可製作的設計移出 /etc.
附註
N/A

AdobeDTM JavaScript端點 adobe-dtm-javascript-endpoint

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

無需任何動作。

公用上一個位置充當專用新位置的代理端點。

附註
N/A

AdobeDTM Web-Hook端點 adobe-dtm-web-hook-endpoint

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

無需任何動作。

公用上一個位置充當專用新位置的代理端點。

附註
N/A

收件箱任務 inbox-tasks

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

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

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

多站點管理器Blueprint配置 multi-site-manager-blueprint-configurations

上一位置
/etc/blueprints
新位置

/libs/msm

/apps/msm

重組指導
  1. 從複製自訂配置 /etc/blueprints to /apps/msm.
  2. 移除 /etc/blueprints.
附註
N/A

AEM Projects儀表板小工具配置 aem-projects-dashboard-gadget-configurations

上一位置
/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相容性包，則在刪除相容性包時必須執行儲存庫對齊活動。

複製通知電子郵件模板 replication-notification-e-mail-template

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

標記 tags

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

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

  1. 將所有標籤從上一位置複製到新位置。
  2. 從上一個位置刪除所有標籤。
  3. 透過AEM Web主控台，在 https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging 讓AEM識別「新位置」包含內容，該位置應使用。
附註

重新啟動Day Commulate標籤OSGi套件組合只會在「上一位置」為空時，將「新位置」註冊為標籤根。

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

明確參考路徑的任何自訂程式碼 /etc/tags 必須更新為 /content/ cq ``:tags ，或最好重寫以搭配此移轉程式，運用TagManager Java API。

翻譯雲端服務 translation-cloud-services

上一位置
/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. 將先前位置的現有設定移轉至新位置。

    • 透過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/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相容。

翻譯語言 translation-languages

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

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

翻譯規則 translation-rules

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

翻譯介面工具集用戶端程式庫 translation-widget-client-library

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

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

/apps/settings/wcm/designs/translation/translationwidget

重組指導

對於在SCM中管理、而不是在運行時通過設計對話框寫入的任何設計。

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

對於未在SCM中管理的任何設計，以及通過設計對話框修改運行時。

  • 請勿將可製作的設計移出 /etc.
附註
N/A

樹激活Web控制台 tree-activation-web-console

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

廠商翻譯連接器Cloud Services vendor-translation-connector-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. 將「上一位置」中的現有配置遷移到「新位置」。

    • 手動建立新的供應商翻譯連接器Cloud Services配置，通過 AEM編寫UI，網址為「工具>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>

工作流程通知電子郵件範本 workflow-notification-email-templates

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

工作流程套件 workflow-packages

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

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

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

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

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

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56