Percorso della tua prima esperienza con AEM Headless path-to-first-experience

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.

Percorso affrontato finora story-so-far

Nel documento precedente del percorso AEM headless, Guida introduttiva a AEM headless hai imparato la teoria di base di un CMS headless e ora dovresti:

Questo articolo si basa su questi fondamentali in modo da capire come preparare il tuo progetto AEM headless.

Obiettivo objective

Questo documento illustra i passaggi necessari per implementare il primo progetto. Dopo averlo letto dovresti:

Requisiti requirements

Prima di continuare con questo documento, assicurati di aver rivisto il documento precedente nel Percorso per sviluppatori AEM Headless, Guida introduttiva a AEM Headless assicurandoti di:

Pianificazione del successo planning-for-success

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.

Oltre all’AEM, se stai creando un’applicazione lato client, vuoi anche assicurarti di disporre di un ambiente di sviluppo appropriato, in modo da poter testare il client in base alle chiamate API all’AEM.

Definizione di modelli di contenuto e API defining-models

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 esigenze aziendali.

Informazioni sugli ambienti understanding-environments

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.

Cooperazione tra sviluppatori e autori di contenuti cooperation

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 per poter creare test client e dell’unità per assicurarsi che il client sia in grado di eseguire correttamente il rendering del contenuto.

Gli autori e le autrici creano contenuti in base ai modelli di contenuto definiti nell’ambiente di staging. Utilizzando lo strumento di authoring per 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.

Configurazione setup

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 visualizzare le risorse aggiuntive per ulteriori informazioni sui singoli argomenti.

Configurazione configuration

Implementazione della prima app AEM headless

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.

Best practice best-practices

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 sviluppatori e autori di contenuti devono tenere a mente durante la pianificazione del progetto.

Organizzazione dei contenuti organizing-content

Creazione di contenuti authoring

Creazione di contenuti globali localization

Passaggio successivo what-is-next

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à.

Scegli la tua avventura choose-your-path

Indipendentemente dal tuo stile di apprendimento, Adobe vuole che tu abbia successo quando inizi con il tuo progetto AEM Headless.

Risorse aggiuntive additional-resources

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.