Nozioni di base sull’authoring per headless con AEM author-headless-basics
Percorso affrontato finora story-so-far
All’inizio del Percorso di authoring dei contenuti headless in AEM, nell’Introduzione sono stati trattati i concetti e la terminologia di base relativi all’authoring per headless.
Questo articolo si basa su questi elementi per comprendere come creare contenuti personalizzati per il progetto headless AEM.
Obiettivo objective
-
Pubblico: principiante
-
Obiettivo: scopri le nozioni di base sull’authoring di CMS headless:
- introduzione all’authoring con AEMaaCS
- Introduzione ai frammenti di contenuto
Operazioni di base basic-handling
Prima di iniziare a gestire i frammenti di contenuto, ecco un’introduzione (molto) rapida all’utilizzo di AEM…ma niente sostituisce l’esperienza di accesso e di utilizzo del sistema.
Creazione e pubblicazione author-preview-publish
Un’installazione di AEM è in genere costituita da almeno due ambienti:
- Autore
- Pubblicazione
Accedi e utilizza l’ambiente di authoring per generare i contenuti. Quando è tutto pronto, pubblica il contenuto in modo che diventi disponibile. Per gli headless sarà disponibile in altre applicazioni, per le pagine web sarà disponibile ai lettori sul web.
Per ulteriori dettagli, consulta i concetti di authoring.
Accesso signing-in
Come per la maggior parte dei sistemi, è necessario effettuare l'accesso. In qualità di autore, riceverai:
- Nome utente (account)
- Password
- Collegamento per accedere alla schermata di accesso
Il tuo account sarà stato configurato con tutti i privilegi necessari. In caso di problemi, Adobe consiglia di contattare il team di supporto interno per il progetto.
Navigazione navigation
La prima volta che esegui l’accesso a una piccola esercitazione online, verranno evidenziate alcune delle funzioni principali dell’interfaccia utente.
È quindi possibile utilizzare il pannello di navigazione per accedere alle aree chiave di AEM. Per i frammenti di contenuto verrà utilizzata la console Assets.
Per aprire il pannello di navigazione, seleziona l’icona Adobe in alto a sinistra, seguita dall’icona della bussola piccola:
All’interno della console puoi selezionare le cartelle per passare al frammento di contenuto oppure le breadcrumb (nell’intestazione) per tornare alla struttura.
Azioni, selezione, visualizzazione actions-selecting-viewing
La console Assets ha dedicato Barre degli strumenti azione e Azioni rapide che puoi utilizzare dopo aver selezionato una risorsa (ad esempio, una cartella o un frammento di contenuto).
Le Azioni rapide sono disponibili per una singola risorsa, vedi Basilea nell'esempio seguente:
La barra degli strumenti Azioni consente di accedere a tutte le azioni applicabili allo scenario corrente. Le azioni disponibili possono variare, ad esempio a seconda della posizione o se sono state selezionate più risorse:
Puoi selezionare il formato di visualizzazione delle risorse con il Selettore di visualizzazione:
Puoi visualizzare ulteriori informazioni sugli elementi utilizzando il Selettore della barra. Ciò consente anche di accedere ad azioni aggiuntive.
Authoring dei frammenti di contenuto authoring-content-fragments
Questa è stata una rapida introduzione all’interfaccia utente AEM, ma dovresti aver avuto l’occasione di provarla. Ora passiamo a quello che ti interessa di più: frammenti di contenuto per headless.
Dovremo passare dall’inizio alla fine delle operazioni, ma l’istanza potrebbe avere già cartelle e/o frammenti creati, che potrebbero trovarsi in posizioni diverse. I principi sono gli stessi.
Organizzazione e navigazione organizing-and-navigating
A meno che non siano disponibili pochissimi frammenti di contenuto, è consigliabile organizzarli in modo da poterli trovare nuovamente (insieme ad altri).
Creazione di una cartella creating-folder
Per eseguire questa operazione, crea una serie di cartelle nella sezione File della console Assets. Seleziona l’opzione Crea (in alto a destra), seguita da Cartella:
Viene visualizzata una finestra di dialogo in cui puoi inserire i dettagli, quindi confermare con Crea:
Utilizzo di percorsi e tag per limitare i modelli per frammenti di contenuto disponibili nella cartella tags-paths-for-models-in-folder
Questa sezione è leggermente più avanzata. Non ne hai veramente bisogno se stai solo iniziando e provando le cose, ma è più utile quando hai molti frammenti. Quindi è bene conoscerla, anche se non la stai ancora usando.
L’architect di contenuti avrà creato tutti i modelli di frammento di contenuto necessari per il progetto corrente e forse anche altri progetti. Per semplificare le cose a te stesso e agli altri autori, puoi limitare l’elenco dei modelli disponibili per una cartella specifica.
Dopo aver creato la tua cartella è possibile aprire la cartella Proprietà. Qui ci sono varie schede con informazioni e dettagli di configurazione sulla cartella. In particolare per i frammenti di contenuto, puoi utilizzare la scheda Criteri per definire percorsi e/o tag specifici per questa cartella. Questo limita i modelli per frammenti di contenuto disponibili per l’utilizzo nella cartella, poiché i modelli per frammenti di contenuto devono soddisfare questi requisiti prima di poter essere utilizzati per generare frammenti in questa cartella.
Puoi quindi navigare tra queste cartelle per creare e modificare i frammenti di contenuto.
In caso - Configurazione cartella Cloud Services cloud-services-folder
In caso…
Probabilmente ti verrà offerta una cartella iniziale in cui puoi creare le tue cartelle. Come alcuni dettagli di configurazione devono essere applicati alla cartella principale (in genere da uno sviluppatore o da un amministratore di sistema). Probabilmente non ti interessa, ma se necessario puoi controllare la Configurazione nei Cloud Service della cartella Proprietà:
Creazione di un frammento di contenuto creating-fragment
La creazione di un frammento di contenuto è molto simile. È sufficiente utilizzare l'opzione Frammento di contenuto:
Questa volta viene aperta una procedura guidata. Il primo passaggio consiste nel selezionare il modello per frammenti di contenuto su cui basare il frammento:
Dopo aver continuato con Avanti puoi fornire i dettagli (Base e Avanzate) del frammento:
Conferma con Crea e potrai Aprire il frammento nell'editor.
Modifica di un frammento editing-fragment
Puoi aprire un frammento immediatamente dopo averlo creato o selezionandolo dalla console Assets.
Quando l’editor si apre per la prima volta, vedrai:
-
Un elenco di icone a sinistra permette di accedere a varie aree di funzionalità. L’editor si apre nella scheda Variazioni, in questo punto avviene la maggior parte delle modifiche. Potresti anche essere interessato alle schede Annotazioni e Metadati.
-
Intestazione con informazioni sul frammento e accesso a varie azioni.
-
L’area di modifica principale dipende dal modello utilizzato per creare il frammento.
Come esempi:
-
Frammento che richiede solo più informazioni, alcune con un tipo specifico. Come scoprirai andando avanti nel tuo percorso, i riferimenti sono fondamentali per i contenuti headless.
-
Frammento che consente di scrivere una lunga sezione di testo. Qui sono disponibili opzioni aggiuntive per la gestione e la formattazione del testo. Puoi anche aprire i singoli campi di testo in un editor a schermo intero (utilizzando l’icona a forma di piccolo schermo a destra)
Conferma gli aggiornamenti con Salva o Salva e chiudi.
Quello di cui (probabilmente) non devi preoccuparti what-you-probably-do-not-need-to-worry-about
OK, questa potrebbe sembrare una sezione leggermente ambigua, ma una volta aperto l’Editor frammento di contenuto e iniziato ad esplorarlo, vedrai diverse opzioni che (probabilmente) non si adattano al tuo percorso headless come Autore di contenuto. Questo è solo un rapido resoconto di ciò che dovresti essere in grado di ignorare nel contesto headless:
-
Modelli per frammenti di contenuto
Il nome del modello di frammento di contenuto verrà visualizzato nella parte superiore dell’editor, direttamente sotto il nome del frammento. Questo è anche un collegamento che ti porta all’editor modelli.
I modelli per frammenti di contenuto sono di fatto vitali per i frammenti di contenuto quando definiscono la struttura utilizzata. Tuttavia, la creazione e la modifica di tali elementi è (in genere) responsabilità di un’altra persona, l’architect di contenuti.note note NOTE Per ulteriori informazioni, consulta il Percorso Architect di contenuti AEM headless. -
Contenuto associato
Questo è abbastanza ovvio in quanto si tratta di una scheda nell’editor.
I frammenti di contenuto sono disponibili in AEM in diverse versioni. Originariamente erano disponibili per l’uso “tradizionale” durante l’authoring delle pagine…e sono ancora utilizzati in questo contesto. Questo può comportare l’associazione di risorse (ad esempio immagini) che, pur non essendo incorporate nel frammento, devono essere disponibili per l’autore durante l’authoring di una pagina.
-
Anteprima
Questa è un’altra scheda nell’editor e fornisce una vista tecnica, destinata principalmente agli sviluppatori.
-
Aggiorna i riferimenti di pagina
Questa azione è disponibile nel menu a discesa … (puntini di sospensione). Non è interessante per gli autori headless in quanto si riferisce all’authoring delle pagine.
Pubblicazione publishing
Una volta completato il frammento, puoi Pubblicare in modo che sia disponibile per le applicazioni headless.
Le azioni di pubblicazione sono disponibili nell'editor o nella barra degli strumenti della console Assets:
Passaggio successivo whats-next
Ora che hai imparato le nozioni di base, il passo successivo è Scopri come utilizzare i riferimenti. Questo introduce e illustra i vari riferimenti disponibili e come creare livelli di struttura con i Riferimenti ai frammenti, una parte chiave dell’authoring per gli oggetti headless.
Risorse aggiuntive additional-resources
-
Operazioni di base - questa pagina si basa principalmente sulla console Sites, ma molte delle funzioni sono anche rilevanti per l’authoring Frammenti di contenuto nella console Risorse.
-
Utilizzo di frammenti di contenuto
-
Guide introduttive