DocumentationExperience Cloud KCS

AEM as a Cloud Service : avertissement de résolution des chevauchements de packages pour Oak Index diff.json

Dernière mise à jour : 19 octobre 2026

✨ Ce contenu est généré par l’IA et peut être inexact. Termes IA génératifs

Cet article explique comment résoudre des conflits et des avertissements de qualité du code dans Adobe Experience Manager as a Cloud Service lorsque plusieurs packages fournissent différentes versions du fichier Oak Index diff.json.

Description description

Environnement

Adobe Experience Manager as a Cloud Service (toutes versions)

Symptômes

  • L’étape Qualité du code de Cloud Manager signale un avertissement PackageOverlaps pour le chemin d’accès /oak:index/diff.index.
  • Plusieurs sous-projets livrent leur propre fichier ui.apps/src/main/content/jcr_root/_oak_index/diff.index/diff.json.
  • Chaque package comprend un diff.json différent sous le même chemin de référentiel.
  • Le dernier package installé remplace les autres, ce qui entraîne la présence d’un sous-ensemble seulement de définitions d’index Oak prévues.
  • Vous pouvez également créer et supprimer des index lors des déploiements d’en fonction de l’ordre d’installation du package.

Cause

Plusieurs packages fournissant différentes versions du même fichier diff.json sous /oak:index/diff.index entraînent des remplacements de fichiers et des avertissements de chevauchement de la qualité du code. Une seule diffusion canonique du fichier d’index Diff est prise en charge dans AEM as a Cloud Service.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Désignez un seul sous-projet ou package à posséder et à diffuser le fichier diff.json canonique sous ui.apps/src/main/content/jcr_root/_oak_index/diff.index/diff.json.
  2. Supprimez le filtre /oak:index/diff.index et la diffusion diff.json associée de tous les autres sous-projets ou packages.
  3. Assurez-vous que le diff.json canonique contient toutes les définitions d’index Oak requises de tous les sous-projets.
  4. Créez le package consolidé et vérifiez qu’il inclut toutes les définitions d’index nécessaires.
  5. Vérifiez que les autres packages ne diffusent plus le nœud /oak:index/diff.index ou le fichier diff.json.
  6. Déployez les packages mis à jour dans un environnement hors production (comme le développement ou l’assurance qualité).
  7. Assurez-vous que l’avertissement PackageOverlaps n’apparaît plus dans le rapport Qualité du code.
  8. Dans l’environnement cible, vérifiez que tous les index requis sont présents et fonctionnent comme prévu.
recommendation-more-help
experience-cloud-kcs-help-kbarticles