In questa parte del Percorso per sviluppatori headless AEM, comprenderai i passaggi per implementare la tua prima esperienza headless in AEM incluse considerazioni sulla pianificazione e apprenderai le best practice per rendere il percorso il più semplice possibile.
Nel documento precedente del percorso di AEM Headless, Guida introduttiva a AEM Headless hai imparato la teoria di base su cosa sia un CMS headless e ora dovresti:
Questo articolo si basa su questi fondamentali in modo da capire come preparare il tuo progetto AEM headless.
Questo documento illustra i passaggi necessari per implementare il primo progetto. Dopo averlo letto dovresti:
Prima di continuare con questo documento, accertati di aver rivisto il documento precedente nel Percorso per sviluppatori headless AEM, Guida introduttiva a AEM Headless assicurandoti di:
Per avviare il tuo primo progetto AEM headless devi disporre di un modello di contenuto che supporti la personalizzazione e gli aggiornamenti che desideri eseguire su tutti i tuoi canali.
Separato da AEM, assicurati anche di disporre di una configurazione dell’ambiente di sviluppo appropriata se stai creando un’applicazione lato client in modo da poter testare il client rispetto alle chiamate API a AEM.
Vuoi creare un’esperienza coerente e gestire campagne personalizzate tra i canali, in modo da poter esaminare ogni singolo canale e superficie come una propria struttura di contenuti distinta a cui distribuire. Tuttavia, un modello di contenuto a disposizione per ogni canale sarà difficile da mantenere.
È invece necessario considerare il modo in cui il contenuto su superfici diverse è correlato in base a principi di organizzazione quali gerarchie di marchi e prodotti, categorie di beni o superfici o passaggi nel percorso del cliente. Ad esempio, se disponi di un insieme di superfici che supportano un marchio specifico di auto prodotte, potresti voler iniziare con un modello di contenuto per informazioni generali che sarebbe vero per l’intera auto e poi avere elementi più specifici come il contenuto necessario da quando l’auto si avvia a quando ci sono problemi di servizio. Un modello di questo tipo applicherà l’ereditarietà del contenuto generale del marchio automobilistico, consentendo al tempo stesso turni in base al contesto specifico necessario. Aiuta anche nella gestione futura degli aggiornamenti di questo contenuto in quanto puoi applicare il controllo in base a ruoli come l’addetto marketing o il responsabile prodotto per l’intero marchio automobilistico rispetto a un autore responsabile dell’esperienza di “avvio automobile”.
Una volta ottenuto il modello di contenuto e una visualizzazione chiara dei vari client su cui deve essere mostrato il contenuto, è necessario assicurarsi che le API/GraphQL associate all’accesso a vari modelli di contenuto siano pubblicate per tutti i client che necessitano di tale contenuto. Esistono diverse opzioni per accedere a determinati contenuti. Puoi richiedere un contenuto specifico statico che consenta la memorizzazione in cache del contenuto e prestazioni migliori. Puoi anche richiedere contenuti generati dinamicamente che richiederanno un’elaborazione maggiore. Assicurati che i client sfruttino le API più efficienti per le loro esigenze aziendali.
All’interno di AEM esistono tre tipi di ambienti: sviluppo, staging e produzione.
Gli ambienti di sviluppo (se ne possono avere diversi) sono un luogo sicuro in cui sperimentare e testare idee. Durante la fase iniziale del progetto, Adobe consiglia di utilizzare gli ambienti di sviluppo per provare le varianti dei modelli di contenuto e vedere quali forniscono l’output previsto per le superfici.
L’ambiente di staging per i progetti headless viene utilizzato per convalidare le nuove versioni di prodotto AEM prima che vengano lanciate in produzione. Tieni un elenco aggiornato dei modelli di contenuto di produzione e un sottoinsieme di contenuto, in modo da poter fare eseguire il rendering dei file JSON per confrontare se forniscono ancora lo stesso output mentre apporti modifiche o se la versione di AEM introduce modifiche
La produzione è il luogo in cui gli autori di contenuti creano e gestiscono il contenuto effettivo. I cambiamenti del modello nella produzione devono essere effettuati con cura e tenendo presente la compatibilità con le versioni precedenti.
Durante la fase di sviluppo, si consiglia di lavorare con un ambiente di sviluppo e di staging. Passando al test delle prestazioni, dovrai passare all’ambiente di produzione.
Gli sviluppatori devono disporre di un ambiente di sviluppo AEM configurato con i modelli di contenuto popolati. Lo sviluppatore sviluppa il client che utilizzerà i contenuti da AEM headless, in quanto gli autori dei contenuti stanno ancora creando i contenuti. Ecco perché le definizioni API sono molto importanti. Sfruttando l’SDK di AEM, lo sviluppatore può creare un hook di prova in modo da poter creare client test e unit test per assicurarsi che il client sia in grado di eseguire correttamente il rendering del contenuto.
Gli autori e le autrici dei contenuti creano contenuti in base ai modelli di contenuto definiti nell’ambiente di staging. Utilizzando lo strumento per l’authoring dei frammenti di contenuto, l’autore crea un nuovo frammento di contenuto o ne modifica uno esistente. Prima di pubblicarlo, l’autore o l'autrice può visualizzare un’anteprima dell’aspetto che avrà nel client collaborando con lo sviluppatore per inviare il modello di contenuto allo sviluppo o impostare un ambiente per sviluppatori in modo che gli autori e le autrici possano visualizzare in anteprima l’aspetto che avrà nel client.
Prima di iniziare a utilizzare le funzionalità headless in AEM, assicurati che tutte le funzioni richieste siano abilitate. Questa sezione descrive i requisiti necessari. I passi effettivi per eseguire questi passaggi sono descritti più avanti nel Percorso per sviluppatori headless di AEM.
Facoltativamente, puoi anche fare riferimento alle risorse aggiuntive per ulteriori informazioni sui singoli argomenti.
Questa è una panoramica di ciò che è necessario per implementare la prima app headless utilizzando AEM per distribuire i contenuti. Come eseguire questi passaggi sarà descritto in dettaglio nelle parti successive del Percorso per Sviluppatori Headless.
Un progetto headless non solo ha successo grazie alla tecnologia implementata, ma anche grazie alla buona pianificazione e alla governance dei progetti. Di seguito sono riportate alcune best practice che gli autori e gli sviluppatori di contenuti devono tenere a mente durante la pianificazione del progetto.
Ora che hai completato questa parte del percorso per sviluppatori headless di AEM, dovresti:
Vogliamo che tu sfrutti questa conoscenza fondamentale per comprendere appieno il potere e la flessibilità di AEM Headless in modo da poterne trarre vantaggio nei tuoi progetti. Per fare questo, hai diverse possibilità.
Indipendentemente dal tuo stile di apprendimento, Adobe vuole che tu abbia successo quando inizi con il tuo progetto AEM Headless.
Sebbene sia consigliabile passare alla parte successiva del percorso di sviluppo headless consultando il documento Come modellare i contenuti come Modelli di contenuto AEM le seguenti sono alcune risorse aggiuntive e opzionali che approfondiscono alcuni concetti menzionati in questo documento, ma non sono indispensabili per continuare il percorso headless.