AEM as a Cloud Service: Warnung zu Paketüberschneidungen für Oak Index diff.json wird aufgelöst

Letzte Aktualisierung: 19. Oktober 2026

✨ Dieser Inhalt wird von KI generiert und könnte ungenau sein. Generative KI-Begriffe

In diesem Artikel wird erläutert, wie Sie Konflikte und Code-Qualitäts-Warnungen in Adobe Experience Manager as a Cloud Service beheben können, wenn mehrere Pakete verschiedene Versionen der Oak-Indexdatei „diff.json“ bereitstellen.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (alle Versionen)

Symptome

Im Code-Qualitätsschritt von Cloud Manager wird eine PackageOverlaps-Warnung für den Pfad /oak:index/diff.index.
Mehrere Unterprojekte stellen eine eigene ui.apps/src/main/content/jcr_root/_oak_index/diff.index/diff.json bereit.
Jedes Paket enthält einen anderen diff.json unter demselben Repository-Pfad.
Das zuletzt installierte Paket überschreibt die anderen, sodass nur eine Teilmenge der beabsichtigten Oak-Indexdefinitionen vorhanden ist.
Abhängig von der Reihenfolge der Paketinstallation können Indizes bei -Bereitstellungen abwechselnd erstellt und entfernt werden.

Ursache

Mehrere Pakete, die verschiedene Versionen derselben diff.json-Datei unter /oak:index/diff.index bereitstellen, führen zu Dateiüberschreibungen und Warnungen vor Codequalitätsüberschneidungen. In AEM as a Cloud Service wird nur ein kanonischer Versand der Diff-Indexdatei unterstützt.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

Bestimmen Sie ein einzelnes Unterprojekt oder Paket, das Eigentümer der kanonischen diff.json-Datei ist und unter ui.apps/src/main/content/jcr_root/_oak_index/diff.index/diff.json bereitgestellt wird.
Entfernen Sie den /oak:index/diff.index Filter und den zugehörigen diff.json-Versand aus allen anderen Unterprojekten oder Paketen.
Stellen Sie sicher, dass die kanonische diff.json alle erforderlichen Oak-Indexdefinitionen aus allen Unterprojekten enthält.
Erstellen Sie das konsolidierte Paket und stellen Sie sicher, dass es alle erforderlichen Indexdefinitionen enthält.
Vergewissern Sie sich, dass andere Pakete den /oak:index/diff.index Knoten oder die diff.json nicht mehr bereitstellen.
Stellen Sie die aktualisierten Pakete in einer Nicht-Produktionsumgebung bereit (z. B. DEV oder QA).
Stellen Sie sicher, dass die Warnung PackageOverlaps im Code-Qualitätsbericht nicht mehr angezeigt wird.
Überprüfen Sie in der Zielumgebung, ob alle erforderlichen Indizes vorhanden sind und wie erwartet funktionieren.

recommendation-more-help

experience-cloud-kcs-help-kbarticles