Documentazione

Le mappature sling on-premise non riescono dopo la migrazione ad AEMaaCS

Last update: Mon Aug 25 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

La migrazione delle mappature sling da una configurazione AEM on-premise ad Adobe Experience Manager as a Cloud Service (AEMaaCS) introduce problemi di compatibilità a causa della natura immutabile dell’ambiente cloud. Per risolvere il problema, ristruttura e distribuisci le mappature sling utilizzando il formato compatibile con cloud supportato.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS) - Sites

Problema/Sintomi

  • Le mappature per più percorsi e domini non generano URL corretti.
  • Le mappature di inoltro e inversione in /etc/map non funzionano in AEMaaCS.
  • Gli URL in uscita non vengono visualizzati correttamente, ma vengono reindirizzati alla destinazione corretta.
  • Gli URL in ingresso si comportano correttamente, ma il comportamento in uscita non è coerente.
  • A causa dell’immutabilità di AEMaaCS, AEMaaCS richiede la distribuzione delle mappature Sling tramite il codice.

Risoluzione resolution

Per convertire e distribuire mappature sling compatibili con AEMaaCS, effettua le seguenti operazioni:

  1. Esporta i mapping sling esistenti dalla directory /etc/map locale in un pacchetto .zip.

  2. Aggiungi il pacchetto .zip esportato al codebase del progetto in your_project/ui.content/src/main/content/jcr_root/.

  3. Rinominare la cartella delle mappe nella directory etc in map.publish.

  4. Aggiorna la configurazione di Apache Sling Resource Resolver per fare riferimento a /etc/map.publish come percorso di mappatura.

    1. Crea o aggiorna il JSON di configurazione OSGi per il PID org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl.
    2. Imposta resource.resolver.map.location su /etc/map.publish.
    3. Se si esegue la migrazione della logica di mappatura da JCR, è possibile aggiornare resource.resolver.mapping con eventuali valori di array personalizzati.

  5. Salva tutte le modifiche e implementa la base di codice aggiornata utilizzando Adobe Cloud Manager per inviare le modifiche ad AEMaaCS.

  6. Esegui il test completo delle mappature negli ambienti di sviluppo e staging per garantire il corretto funzionamento degli URL in entrata e in uscita prima di distribuirli nell’ambiente di produzione.

Lettura correlata

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f