ドキュメントExperience Cloud KCS

AEM as a Cloud Service:Oak インデックス diff.jsonのPackageOverlaps警告の解決

最終更新日： 2026年10月19日

✨ このコンテンツはAIが生成したもので、不正確である可能性があります。 生成AI用語

この記事では、複数のパッケージで異なるバージョンのOak Index diff.json ファイルが配信される場合に、Adobe Experience Manager as a Cloud Serviceで発生する競合とコード品質の警告を解決する方法について説明します。

説明 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 インデックス定義のサブセットのみが存在します。
  • パッケージのインストール順序に応じて、デプロイメント時にインデックスを交互に作成および削除できます。

原因

同じdiff.json ファイルの異なるバージョンを/oak:index/diff.indexの下に配信する複数のパッケージでは、ファイルの上書きとコード品質の重複の警告が発生します。 AEM as a Cloud Serviceでは、差分インデックスファイルの正規の配信は1つだけサポートされています。

解決策 resolution

問題を解決するには、次の手順に従います。

  1. 単一のサブプロジェクトまたはパッケージを指定して、規範的なdiff.json ファイルをui.apps/src/main/content/jcr_root/_oak_index/diff.index/diff.jsonの下に配置します。
  2. 他のすべてのサブプロジェクトまたはパッケージから、/oak:index/diff.index フィルターと関連するdiff.json配信を削除します。
  3. 規範的な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