Risoluzione dei problemi di accesso e configurazione dell’Editor universale quando AEM è l’origine di contenuto EDS
Quando Edge Delivery Services (EDS) utilizza AEM come origine di contenuto, gli autori non visualizzano nell’editor universale campi di metadati previsti, valori di configurazione di blocco, varianti di modello o dati JSON. La causa è quasi sempre una mancata corrispondenza a livello di architettura o configurazione: un progetto EDS supporta solo un’origine di contenuto principale; i modelli BYOM (Bring Your Own Model) devono esporre esplicitamente i metadati all’Editor universale; la popolazione di campi dinamici richiede un’estensione dell’Editor universale personalizzata e i dati JSON o di configurazione devono essere esposti intenzionalmente tramite l’archivio EDS, il contenuto strutturato o le mappature DAM. Confermando la modalità di authoring, applicando la regola basata su un’unica origine ed esponendo i metadati e i dati richiesti, i campi dell’editor mancanti vengono ripristinati.
Descrizione description
Problema: se AEM è l’origine di contenuto EDS, nell’editor universale non vengono visualizzati metadati, campi di blocco o dati JSON
Descrizione
Quando si lavora con Edge Delivery Services (EDS) e Universal Editor (UE), gli autori non visualizzano all’interno dell’editor campi di metadati previsti, valori di configurazione di blocco, varianti di modello e dati JSON. Le pagine non vengono caricate correttamente in UE, oppure gli autori non possono configurare i metadati a livello di pagina, i campi dinamici o le opzioni di blocco. In altri casi, i clienti tentano di creare modelli architettonici non supportati, ad esempio combinando Universal Editor e l’authoring basato su documenti all’interno di un singolo progetto EDS o configurando più origini di contenuto all’interno dello stesso fstab.yaml. Queste configurazioni errate causano rendering incoerente, metadati mancanti, impossibilità di utilizzare alcune interfacce di authoring o blocchi che non utilizzano gli input richiesti da AEM.
Ambiente:
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- AEM Managed Services
- AEM as a Cloud Service — Sites
- Edge Delivery Services (EDS)
- Editor universale
Problema/Sintomi:
- L’editor universale viene caricato, ma i campi di metadati o i campi di configurazione del blocco non vengono visualizzati e non viene visualizzato alcun errore.
- Impossibile eseguire il rendering dei blocchi a causa di metadati mancanti a livello di pagina o di blocco da BYOM.
- Gli autori si aspettano sia l’authoring basato su documenti che l’authoring UE in un progetto EDS, ma viene riconosciuta una sola origine.
- I dati JSON o di configurazione personalizzati non sono disponibili all’interno dell’editor universale, anche se il file esiste in DAM o GitHub.
- Le opzioni della finestra di dialogo dinamica o a discesa per i blocchi non si popolano mai in UE.
Causa principale:
EDS e Universal Editor seguono un rigoroso modello architetturale. Un singolo progetto EDS dispone di un’unica origine di contenuto principale; i modelli BYOM devono esporre esplicitamente i metadati all’Universal Editor; il popolamento dinamico dei campi richiede estensioni personalizzate dell’Universal Editor; inoltre, i dati di configurazione JSON o di altro tipo devono essere esposti intenzionalmente tramite l’archivio EDS, i contenuti strutturati o le mappature DAM. Una configurazione errata di una di queste aree comporta metadati mancanti, dati di configurazione inaccessibili o configurazioni ibride non supportate.
Come confermare
- Confermare la modalità di creazione utilizzata dal progetto, ovvero Editor universale, basato su documenti o entrambi, per stabilire se l’Editor universale è abilitato e se è previsto che funzioni per la pagina in questione. Se non è chiaro, acquisisci l’URL esatto che viene aperto in UE.
- Esaminare i requisiti di
fstab.yamlo del progetto per verificare che il progetto EDS utilizzi una sola origine di contenuto principale e se l’installazione tenta di combinare origini AEM e basate su documenti in un unico progetto. - Verificare se i metadati a livello di pagina necessari per l’authoring UE sono esposti tramite BYOM, inclusi un modello
page-metadatadi base e qualsiasi modello specifico. Verificare chetemplate= page-type sia memorizzato nei metadati della pagina se è necessario un modello.
Risoluzione resolution
-
Applica la regola per origine di contenuto singola. EDS supporta un’unica origine di contenuto principale per progetto. Se il progetto combina diverse origini, ad esempio AEM e l’authoring basato su documenti, vengono creati due siti EDS separati e viene utilizzato il routing CDN per indirizzare il traffico tra di essi. L’authoring nativo ibrido UE più basato su documenti in un singolo archivio non è supportato.
-
Esporre i metadati necessari per l’authoring UE tramite BYOM. Verificare che esista un modello di base
page-metadatae definire un modello di metadati specifico per il modello, se necessario. Conferma che le proprietà della pagina AEM espongono il valore di metadatitemplateprevisto dai blocchi. -
Esponi i dati JSON personalizzati o di configurazione in base al fatto che siano modificabili dall’autore o statici:
- Se i dati sono modificabili dall’autore, utilizza Contenuto strutturato EDS e definisci uno schema.
- Se i dati sono statici, archivia il JSON nell’archivio EDS o in AEM DAM con mappature esplicite.
Conferma che l’URL dell’endpoint risultante sia raggiungibile in modo che UE e i blocchi possano recuperare i dati.
4. Gestisci correttamente il menu a discesa dinamico o il gruppo di campi. EDS non supporta le origini dati dell’interfaccia utente Granite, pertanto non è possibile caricare le opzioni del menu a discesa dinamico in questo modo. Utilizza invece l’estensibilità dell’editor universale con campi personalizzati e chiamate API lato client, che richiede l’implementazione di un’estensione UE.
5. Verifica il comportamento di modelli e blocchi per i siti che richiedono più modelli di pagina. Contrassegna le pagine AEM pertinenti come Usa come modello e imposta i metadati del modello (classe CSS) per lo stile. Crea una pagina dal modello e conferma che contenga il contenuto iniziale e i metadati corretti.
Convalida
- Apri la pagina nell’Editor universale e conferma che tutti i campi di metadati previsti e i campi di configurazione dei blocchi siano visibili.
- Carica la pagina nel dominio
.pagee conferma i rendering di metadati dinamici o dati JSON nell’intestazione della pagina. - Conferma
fetch()chiamate agli endpoint JSON che restituiscono il contenuto previsto. - Conferma i blocchi utilizzando correttamente il rendering della configurazione dinamica dopo la ripubblicazione.