DocumentazioneExperience Cloud KCS

AEM as a Cloud Service: avviso Risoluzione PackageOverlaps per Oak Index diff.json

Ultimo aggiornamento: 19 ottobre 2026

✨ Il contenuto è generato tramite IA e potrebbe non essere accurato. Termini di IA generativi

Questo articolo spiega come risolvere i conflitti e gli avvisi di qualità del codice in Adobe Experience Manager as a Cloud Service quando più pacchetti distribuiscono versioni diverse del file diff.json dell’indice di Oak.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service (tutte le versioni)

Sintomi

  • Il passaggio di qualità del codice di Cloud Manager riporta un avviso PackageOverlaps per il percorso /oak:index/diff.index.
  • Più sottoprogetti distribuiscono il proprio file ui.apps/src/main/content/jcr_root/_oak_index/diff.index/diff.json.
  • Ogni pacchetto include un diff.json diverso nello stesso percorso dell’archivio.
  • L’ultimo pacchetto installato sovrascrive gli altri, facendo sì che sia presente solo un sottoinsieme delle definizioni dell’indice Oak previste.
  • Gli indici possono essere creati e rimossi in modo alternativo durante le distribuzioni, a seconda dell’ordine di installazione del pacchetto.

Causa

Più pacchetti che distribuiscono versioni diverse dello stesso file diff.json in /oak:index/diff.index generano sovrascritture di file e avvisi di sovrapposizione della qualità del codice. In AEM as a Cloud Service è supportata una sola distribuzione canonica del file dell’indice Diff.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Designare un singolo sottoprogetto o pacchetto da possedere e consegnare il file canonico diff.json in ui.apps/src/main/content/jcr_root/_oak_index/diff.index/diff.json.
  2. Rimuovi il filtro /oak:index/diff.index e la consegna diff.json associata da tutti gli altri sottoprogetti o pacchetti.
  3. Verificare che il canonico diff.json contenga tutte le definizioni di indice Oak richieste da tutti i sottoprogetti.
  4. Crea il pacchetto consolidato e verifica che includa tutte le definizioni di indice necessarie.
  5. Verificare che gli altri pacchetti non distribuiscano più il nodo /oak:index/diff.index o il file diff.json.
  6. Distribuisci i pacchetti aggiornati in un ambiente non di produzione (ad esempio DEV o QA).
  7. Assicurarsi che l’avvertenza PackageOverlaps non venga più visualizzata nel rapporto Qualità codice.
  8. Nell’ambiente di destinazione, verifica che tutti gli indici richiesti siano presenti e funzionino come previsto.
recommendation-more-help
experience-cloud-kcs-help-kbarticles