Componente offerta mancante nell’ambiente di anteprima di AEM dopo gli aggiornamenti in Creazione
In Adobe Experience Manager (AEM), i componenti delle offerte aggiunti o aggiornati in Creazione non vengono visualizzati nell’ambiente di anteprima. Il problema interessa spesso pagine specifiche, mentre altre pagine continuano a visualizzare contenuti aggiornati come previsto. Non vengono visualizzati messaggi di errore, ma nell’anteprima vengono visualizzati componenti di offerta mancanti o obsoleti, che influiscono sulla convalida del contenuto prima della pubblicazione. Per risolvere questo problema, verifica il contenuto della pagina e la risposta API, seleziona Anteprima o backend-for-frontend caching, e ripubblica la pagina interessata.
Descrizione description
Ambiente
- Adobe Experience Manager (AEM), tutte le versioni
- Ambienti di anteprima disaccoppiati/headless (ad esempio, applicazioni front-end personalizzate che utilizzano API AEM)
Problema/Sintomi
- I componenti dell’offerta aggiornati o nuovi sono visibili in AEM Author ma non nell’ambiente di anteprima.
- Altre pagine possono essere aggiornate come previsto; il problema è specifico per alcune pagine.
- Non vengono visualizzati messaggi di errore espliciti.
Causa
La causa più comune è il caching nell’ambiente di anteprima o nel suo livello back-end-for-frontend (BFF), che può fornire risposte API non aggiornate. In genere non si tratta di un problema di replica di AEM Author o Publish.
Risoluzione resolution
Per risolvere il problema, segui la procedura riportata di seguito:
- Verifica che tutti i componenti dell’offerta prevista siano presenti e pubblicati nell’ambiente AEM Author.
- Utilizzare CRX/DE o la console AEM Sites per verificare che il nodo
jcr:contentdella pagina interessata contenga i componenti corretti. - Identifica l’endpoint API utilizzato dall’applicazione Preview per recuperare il contenuto. Questo endpoint è spesso personalizzato o headless. In caso di dubbi, consulta i team front-end o back-end.
- Accedi all’endpoint direttamente con un browser o uno strumento API e verifica che la risposta JSON includa tutti i componenti dell’offerta previsti.
- Determina se l’ambiente di anteprima o il relativo livello back-end per front-end memorizza nella cache le risposte API. Cancella la cache o riduci il time-to-live della cache per recuperare nuovo contenuto. Se l’implementazione include una logica di invalidazione della cache personalizzata, verifica che sia abilitata e funzionante.
- Apporta una piccola modifica identificabile alla pagina interessata in Author, ad esempio la modifica del testo o la ridisposizione dei componenti. Osserva l’ora di modifica e monitora quando viene visualizzato l’aggiornamento nell’ambiente di anteprima.
- Esamina i registri di AEM e Preview o backend-for-frontend per tracciare la propagazione della modifica.
- Se il problema persiste, aggiorna e ripubblica la pagina o il relativo nodo
jcr:contentper forzare un aggiornamento. - Chiedi ai team front-end o back-end di rivedere la logica di integrazione e caching. Verifica che l’applicazione Preview chiami gli endpoint AEM corretti e non distribuisca contenuto non aggiornato dalla cache.
- Verifica che tutti i componenti dell’offerta vengano visualizzati e che il contenuto corrente venga visualizzato nell’ambiente di anteprima.