AEM as a Cloud Service:解決Oak索引diff.json的PackageOverlaps警告

✨ 此內容是AI產生的,可能不準確。 產生AI辭彙

本文說明當多個套件傳遞不同版本的Adobe Experience Manager as a Cloud Service索引diff.json檔案時,如何解決Oak中的衝突和程式碼品質警告。

說明 description

環境

Adobe Experience Manager as a Cloud Service (所有版本)

症狀

  • Cloud Manager的程式碼品質步驟會報告路徑/oak:index/diff.index的PackageOverlaps警告。
  • 多個子專案傳送自己的ui.apps/src/main/content/jcr_root/_oak_index/diff.index/diff.json檔案。
  • 每個套件在相同存放庫路徑下包含不同的diff.json。
  • 上次安裝的套件會覆寫其他套件,導致只出現預期Oak索引定義的子集。
  • 視套件安裝順序而定,可以在部署時交替建立與移除索引。

原因

多個套件在/oak:index/diff.index下傳送相同diff.json檔案的不同版本,會導致檔案覆寫和程式碼品質重疊警告。 AEM as a Cloud Service僅支援差異索引檔案的一次規範傳送。

解決方法 resolution

請依照下列步驟解決問題:

  1. 指定單一子專案或套件擁有並傳遞ui.apps/src/main/content/jcr_root/_oak_index/diff.index/diff.json下的標準diff.json檔案。
  2. 從所有其他子專案或套件中移除/oak:index/diff.index篩選器和關聯的diff.json傳遞。
  3. 請確定canonical diff.json包含所有子專案中所有必要的Oak索引定義。
  4. 建置整合套件並確認其包含所有必要的索引定義。
  5. 確認其他套件不再傳遞/oak:index/diff.index節點或diff.json檔案。
  6. 將更新的套件部署至非生產環境(例如DEV或QA)。
  7. 請確定「程式碼品質」報表中不再出現PackageOverlaps警告。
  8. 在目標環境中,確認所有必要的索引都存在,並如預期般運作。
recommendation-more-help
experience-cloud-kcs-help-kbarticles