Nozioni di base sull’authoring per headless con AEM

La storia finora

All'inizio del AEM Percorso di authoring dei contenuti headless la Introduzione ha trattato 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

  • 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

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

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 sei pronto, pubblichi il contenuto in modo che diventi disponibile in genere. Per i headless questo sarebbe per altre applicazioni, per le pagine web questo sarebbe per i lettori sul web.

Per ulteriori dettagli, consulta i concetti di authoring .

Accesso

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, ti consigliamo di contattare il team di supporto per il progetto interno.

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à utilizzato il Frammenti di contenuto (per alcune azioni puoi usare anche la Risorse console).

Per aprire il pannello di navigazione, seleziona l’icona dell’Adobe in alto a sinistra e l’icona a forma di piccola bussola.

NOTA

Anche se i frammenti di contenuto sono una funzione di AEM Sites vengono salvati come Risorse. Questo è un dettaglio tecnico che non dovrebbe influenzare l'utente, ma potrebbe essere utile da sapere.

Nella console puoi selezionare le cartelle nel pannello a sinistra per passare al frammento di contenuto. Puoi anche filtrare e/o eseguire ricerche.

Console Frammenti di contenuto

Azioni, Selezione, Visualizzazione

Nella barra degli strumenti della console Frammenti di contenuto è disponibile una scelta di azioni relative ai frammenti di contenuto:

  • Apri in Assets
  • Crea
  • La colonna Riferimento da fornisce inoltre un collegamento diretto per visualizzare tutti i riferimenti principali di tale frammento, compresi i riferimenti a frammenti di contenuto, frammenti di esperienza e pagine.
  • Passando il puntatore del mouse sul nome della cartella verrà visualizzato il percorso JCR.

Dopo aver selezionato il frammento, saranno disponibili tutte le azioni appropriate:

  • Apri
  • Pubblica (e Annulla pubblicazione)
  • Copia
  • Sposta
  • Rinomina
  • Elimina
NOTA

Azioni come Pubblica, Annulla pubblicazione, Elimina, Sposta, Rinomina, Copia, attivano un processo asincrono. L’avanzamento di tale processo può essere monitorato tramite l’interfaccia dei processi asincroni di AEM.

Authoring di frammenti di contenuto

Questa è stata una rapida introduzione all'interfaccia utente AEM, ma potete provarla. Ora arriviamo al tuo vero interesse - 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

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

Per farlo, crea una serie di cartelle all’interno di File della sezione Risorse console. Seleziona la Crea (in alto a destra), seguita da Cartella:

Opzione Crea cartella

Viene visualizzata una finestra di dialogo in cui puoi inserire i dettagli, quindi confermare con Crea:

Finestra di dialogo Crea cartella

Utilizzo di percorsi e tag per limitare i modelli di frammenti di contenuto disponibili nella cartella

Questa sezione è leggermente più avanzata. Non ne avete proprio bisogno se state solo cominciando a provare le cose, ma lo è molto utile quando si hanno molti frammenti. Quindi è bene sapere - anche se non lo usi ancora abbastanza.

L’architetto 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 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 funzione Criteri per definire percorsi e/o tag specifici per questa cartella. Questo limita i modelli di frammento di contenuto disponibili per l’utilizzo nella cartella, poiché i modelli di frammento di contenuto devono soddisfare questi requisiti prima di poter essere utilizzati per generare frammenti in questa cartella.

Creare proprietà cartella - Criteri

NOTA

Per ulteriori informazioni, consulta Modelli per frammenti di contenuto - Consentire modelli per frammenti di contenuto nella cartella delle risorse.

Puoi quindi navigare tra queste cartelle per creare e modificare i frammenti di contenuto.

Solo nel caso - Configurazione Cloud Services cartelle

Solo nel caso…

Probabilmente ti verrà offerta una cartella iniziale in cui puoi creare le cartelle. Come alcuni dettagli di configurazione devono essere applicati alla cartella principale (in genere da uno sviluppatore o da un amministratore di sistema). Questo probabilmente non vi interesserà, ma se necessario è possibile controllare il Configurazione in Cloud Services della cartella Proprietà:

Crea proprietà cartella - Configurazione

NOTA

Per ulteriori informazioni, consulta Applica la configurazione alla cartella delle risorse.

Creazione di un frammento di contenuto

In Frammenti di contenuto console utilizzabile Crea per aprire Nuovo frammento di contenuto finestra di dialogo:

Console Frammenti di contenuto - Creazione di un nuovo frammento

Specifica la:

  • Dove si trova
  • Modello a frammento di contenuto
  • Titolo
  • Nome
  • Descrizione

Quindi conferma con uno dei due Crea o Crea e apri.

Modifica di un frammento

È possibile aprire un frammento subito dopo averlo creato, oppure selezionandolo dalla console Frammenti di contenuto (anche dalla console Risorse ).

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 Variazioni in questo punto avviene la maggior parte delle modifiche. Potresti anche essere interessato al Annotazioni e Metadati schede.

  • 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. Per i contenuti headless, i riferimenti sono fondamentali, ne saprai di più nel tuo percorso.

    Editor frammento di contenuto - Frammento personale

  • 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)

    Editor frammento di contenuto - Alaska Spirits

NOTA

Per aiutare gli autori a completare alcuni campi con successo, potrebbe essere necessaria una documentazione specifica per il progetto.

Consulta Modelli per frammenti di contenuto - Tipi di dati e proprietà per dettagli generici.

Conferma gli aggiornamenti con Salva o Salva e chiudi.

NOTA

Per ulteriori informazioni, consulta Varianti - Creazione di frammenti di contenuto .

Quello di cui (probabilmente) non deve preoccuparsi

OK, questa potrebbe sembrare una sezione leggermente strana, ma una volta aperto l’Editor frammento di contenuto e iniziato ad esplorarlo, vedrai diverse opzioni che (probabilmente) non si applicano al tuo percorso headless come Autore di contenuto. Questo è solo un rapido resoconto di ciò che dovreste 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’architetto di contenuti.

    NOTA

    Per ulteriori informazioni, consulta il Percorso AEM architetto di contenuti headless .

  • Contenuto associato

    Questo è abbastanza ovvio in quanto è una scheda nell'editor.

    I frammenti di contenuto sono disponibili in AEM da 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 all’autore durante la creazione 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 nella pagina (puntini di sospensione) a discesa. Non è interessante per gli autori headless in quanto si riferisce all’authoring delle pagine.

Pubblicazione

Una volta completato il frammento, puoi Pubblica in modo che sia disponibile per le applicazioni headless.

Le azioni di pubblicazione sono disponibili nell’editor (o dalla barra degli strumenti di Frammenti di contenuto o Risorse console):

Editor frammento di contenuto - Frammento personale

Novità

Ora che hai imparato le nozioni di base, il passo successivo è quello di Scopri come utilizzare i riferimenti. Questo introduce e discute 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

In questa pagina