In questa parte del AEM Percorso di sviluppo headless, comprenderai i passaggi per implementare la tua prima esperienza headless in AEM incluse considerazioni sulla pianificazione e apprendi le best practice per rendere il percorso il più semplice possibile.
Nel documento precedente del percorso senza testa AEM, Guida introduttiva di AEM Headless hai imparato la teoria di base su cosa sia un CMS headless e dovresti ora:
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 la lettura dovrebbe:
Prima di continuare con questo documento, accertati di aver rivisto il documento precedente nel Percorso di sviluppatori AEM Headless, Guida introduttiva di AEM Headless assicurati 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.
Separati da AEM, assicurati anche di disporre di un ambiente di sviluppo appropriato impostato 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 eseguire la distribuzione. Tuttavia, disporre di un proprio modello di contenuto 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 di clienti. Ad esempio, se si dispone di un insieme di superfici che supportano una marca specifica di auto prodotte, si può 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 quando l'auto sta iniziando 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 al marketing o il responsabile prodotto per l’intero marchio automobilistico rispetto a un autore responsabile dell’esperienza di "automobile di partenza".
Una volta ottenuto il modello di contenuto e una visualizzazione chiara dei vari client a cui deve essere applicato il contenuto, è necessario assicurarsi che le API/GraphQL associate all’accesso a vari modelli di contenuto siano pubblicate su tutti i client che necessitano tale contenuto. Esistono diverse opzioni per accedere a determinati contenuti. Puoi richiedere un contenuto specifico statico che consenta il caching del contenuto e prestazioni migliori. Puoi anche richiedere contenuti generati dinamicamente che richiederanno un’elaborazione maggiore. Assicurati che i clienti 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 sperimentare 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 implementate 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 i file che comunque forniscono lo stesso output, come si apporta modifiche o 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 con 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 AEM, lo sviluppatore può creare un gancio di test in modo da poter creare test client e di unità per assicurarsi che il client sia in grado di eseguire correttamente il rendering del contenuto.
Gli autori 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 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 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 nella sezione AEM Percorso di sviluppo headless.
Facoltativamente, puoi anche fare riferimento al 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 Headless Developer.
Un progetto senza testa 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.
Dopo aver completato questa parte del Percorso di sviluppatori AEM Headless, devi:
Vogliamo che si basi su questa conoscenza fondamentale per comprendere appieno il potere e la flessibilità di AEM Headless in modo da poterne trarre vantaggio per i propri progetti. Per fare questo, hai delle opzioni.
Indipendentemente dal tuo stile di apprendimento, l'Adobe vuole che tu abbia successo quando inizi con il tuo progetto AEM Headless.
Mentre è consigliabile passare alla parte successiva del percorso di sviluppo headless rivedendo il documento Come modellare il contenuto come modelli di contenuto AEM, di seguito sono riportate alcune risorse aggiuntive facoltative che approfondiscono alcuni concetti menzionati in questo documento, ma non è necessario che continuino sul percorso headless.