文件AEM 6.5使用手冊

AEM 6.5中的通用存放庫重新架構 common-repository-restructuring-in-aem

Last update: Mon Dec 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

如父項所述 AEM 6.5中的存放庫重組 頁面，升級至AEM 6.5的客戶應使用此頁面來評估與可能影響所有解決方案的存放庫變更相關聯的工作量。 在AEM 6.5升級程式期間，有些變更需要投入大量精力，而其他變更則可能延遲到未來升級。

6.5版升級

未來升級之前

6.5版升級 with-upgrade

ContextHub設定 contexthub-6.5

從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

即 sling:resourceType 的URL必須是相對的，而非絕對的。

工作流程模型 workflow-models

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

/libs/settings/workflow/models

/conf/global/settings/workflow/models

/var/workflow/models

重組指南

任何新的或修改過的工作流程模型必須移轉至/conf/global/workflow/models。

  1. 將修改過的工作流程模型部署至本機AEM 6.5開發執行個體，讓這些模型存在於「先前位置」。

  2. 在「AEM >工具>工作流程>模型」中，使用「AEM工作流程模型編輯器」編輯工作流程模型。

  3. 移轉修改的AEM提供的工作流程模型時

    1. 在「工作流程模型編輯器」開啟的狀態下，修改瀏覽器的位址URL，並將路徑區段/libs/settings/workflow/models取代為/etc/workflow/models。
      • 例如，變更： http://localhost:4502/editor.html /libs/settings/workflow/model/dam/update_asset.html 至 http://localhost:4502/editor.html /etc/workflow/model/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. 例如，匯出：

      • /conf/global/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 （先前位置），否則它們將會由AEM提供之/libs/settings/workflow/models中的工作流程模型定義取代。

工作流程例項 workflow-instances

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

無需任何動作即可與「新位置」對齊。

歷史工作流程例項可以安全地繼續駐留在「先前位置」，而新的「工作流程例項」將會建立在「新位置」。

附註
中的任何明確路徑參照 custom 先前位置的代碼也應說明新位置。 建議將此程式碼重構為使用AEM Workflow 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. 更新工作流'b5'7b模型中先前位置對「工作流'b5'7b指令碼」的任何參照，以指向「新位置」。
附註

AEM 6.4 SP1在發行時使其可延遲至6.5 upgrade .

如果升級至AEM 6.4 SP1發行之前的AEM 6.4，此重組應該作為升級專案的一部分來執行。 如果不這樣做，編輯和儲存參考先前位置中指令碼的工作流程步驟將會從工作流程步驟中完全移除工作流程指令碼參考，而且指令碼選取下拉式清單中只有新位置的工作流程指令碼可用。

未來升級之前 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 Service設計 classic-cloud-services-designs

上一個位置
/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/提供使用者端資料庫。 Proxy 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和靜態資源轉換為 客戶庫 替換為 allowProxy = true.
  3. 更新中先前位置的參照 cq ： designPath 屬性。
  4. 更新任何參考先前位置的頁面，以使用新的使用者端程式庫類別（這需要更新頁面實施程式碼）。
  5. 更新AEM Dispatcher規則，以允許透過/etc.clientlibs/提供使用者端資料庫。 Proxy 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和靜態資源轉換為 客戶庫 替換為 allowProxy = true.
  3. 更新中先前位置的參照 cq ： designPath 屬性。
  4. 更新任何參考先前位置的頁面，以使用新的使用者端程式庫類別（這需要更新頁面實施程式碼）。
  5. 更新AEM Dispatcher規則，以允許透過/etc.clientlibs/提供使用者端資料庫。 Proxy 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和靜態資源轉換為 客戶庫 替換為 allowProxy = true.
  3. 更新中先前位置的參照 cq ： designPath 屬性。
  4. 更新任何參考先前位置的頁面，以使用新的使用者端程式庫類別（這需要更新頁面實施程式碼）。
  5. 更新AEM Dispatcher規則，以允許透過/etc.clientlibs/提供使用者端資料庫。 Proxy servlet。

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

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

AdobeDTM JavaScript端點 adobe-dtm-javascript-endpoint

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

不需要採取任何動作。

先前的公用位置會作為私人新位置的Proxy端點。

附註
N/A

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

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

不需要採取任何動作。

先前的公用位置會作為私人新位置的Proxy端點。

附註
N/A

收件匣任務 inbox-tasks

上一個位置
/etc/taskmanagement
新位置
/var/taskmanagement
重組指南
使用 收件匣清除維護任務 以視需要從先前位置移除舊任務。
附註

將工作移轉至新位置不需要任何動作。

  • 「先前位置」中的工作仍可使用且正常運作。
  • 新任務即會在新位置中建立。

多站點管理員藍圖設定 multi-site-manager-blueprint-configurations

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

/libs/msm

/apps/msm

重組指南
  1. 自訂組態複製來源 /etc/blueprints 至 /apps/msm.
  2. 移除 /etc/blueprints.
附註
N/A

AEM專案控制面板小工具設定 aem-projects-dashboard-gadget-configurations

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

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

/apps/cq/core/content/projects/dashboard/gadgets

重組指南

任何新或修改的AEM專案儀表板小工具設定都必須移轉到新位置(/apps)。

  1. 將任何新或修改的AEM專案儀表板小工具設定從先前的位置複製到新位置(/apps)。
    1. 請勿複製未修改的AEM專案儀表板小工具設定，因為這些設定現在存在於新位置(/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網頁主控台，重新啟動Day Communique 5標籤OSGi套件組合位於 https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging 以供AEM識別「新位置」包含內容且應使用。
附註

重新啟動Day Communique Tagging 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 Service都必須移轉到新的位置(/apps， /conf/global 或 /conf/<tenant>)。

  1. 將先前位置中的現有設定移轉到新位置。

    • 透過AEM編寫UI，在手動重新建立新的翻譯Cloud Service設定 「工具>Cloud Service>翻譯Cloud Service」.
      或
    • 將任何新的翻譯Cloud Service設定從上一個位置複製到新位置(/apps， /conf/global 或 /conf/<tenant>)。

  2. 將適用的AEM設定與AEM內容階層建立關聯。

    1. AEM Sites頁面階層，透過 AEM Sites >頁面>頁面屬性>進階標籤>雲端設定.
    2. AEM體驗片段階層，透過 AEM體驗片段>體驗片段>屬性>Cloud Service標籤>雲端設定.
    3. AEM體驗片段資料夾階層，透過 AEM體驗片段>資料夾>屬性>Cloud Service標籤>雲端設定.
    4. AEM Assets資料夾階層，透過 AEM Assets >資料夾>資料夾屬性>Cloud Service標籤>設定.
    5. AEM專案管道 AEM專案>專案>專案屬性>進階標籤>雲端設定.

  3. 解除所有已移轉的舊版翻譯Cloud ServiceAEM與上述內容階層的關聯。

附註

翻譯Cloud Service解析的順序如下：

  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 Service必須與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

翻譯Widget使用者端資料庫 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和靜態資源轉換為 客戶庫 替換為 allowProxy = true.
  3. 更新中先前位置的參照 cq ： designPath 屬性。
  4. 更新任何參考先前位置的頁面，以使用新的使用者端程式庫類別（這需要更新頁面實施程式碼）。
  5. 更新AEM Dispatcher規則，以允許透過/etc.clientlibs/提供使用者端資料庫。 Proxy servlet。

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

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

樹啟動Web主控台 tree-activation-web-console

上一個位置
/etc/replication/treeactivation
新位置
/libs/replication/treeactivation
重組指南
不需要採取任何動作。
附註
Tree Activation Web Console現在可透過以下方式使用 「工具」 > 「部署」 > 「復寫」 > 「啟動樹狀結構」.

廠商翻譯聯結器Cloud Service 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 Service都必須移轉至新位置(/apps， /conf/global 或 /conf/<tenant>)。

  1. 將先前位置中的現有組態移轉到新位置。

    • 手動建立全新廠商翻譯聯結器Cloud Service設定，透過 「工具>Cloud Service>翻譯Cloud Service」中的AEM編寫UI.
      或
    • 將任何新的廠商翻譯聯結器Cloud Service設定從先前的位置複製到新位置(/apps， /conf/global 或 /conf/<tenant>)。

  2. 將適用的AEM設定與AEM內容階層建立關聯。

    1. AEM Sites頁面階層，透過 AEM Sites >頁面>頁面屬性>進階標籤>雲端設定.
    2. AEM體驗片段階層，透過 AEM體驗片段>體驗片段>屬性>Cloud Service標籤>雲端設定.
    3. AEM體驗片段資料夾階層，透過 AEM體驗片段>資料夾>屬性>Cloud Service標籤>雲端設定.
    4. AEM Assets資料夾階層，透過 AEM Assets >資料夾>資料夾屬性>Cloud Service標籤>設定.
    5. AEM專案管道 AEM專案>專案>專案屬性>進階標籤>雲端設定.

  3. 解除所有已移轉的舊版翻譯Cloud ServiceAEM與上述內容階層的關聯。

附註

翻譯Cloud Service解析的順序如下：

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

先前位置中的現有Workflow套件應移轉到新位置。

  1. 移除先前位置中未被其他內容參考或不需要的任何Workflow套件。
  2. 將未被其他內容引用、但在新位置有其他需要的任何Workflow套件移至先前位置。
  3. 將其他內容參考的任何Workflow套件保留在先前位置。
附註

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

儲存在之前或以下位置的工作流程套件可以透過傳統UI Miscadmin控制檯進行管理。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2