Nozioni di base sull’authoring per headless con AEM

Ultimo aggiornamento: 5 marzo 2025

Creato per:

  • Amministratore
  • Sviluppatore

Percorso affrontato finora

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

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

Authoring, Anteprima e Pubblicazione

Generalmente, l’installazione di AEM è costituita da tre ambienti:

  • Autore
  • Pubblicazione
  • Anteprima

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.

Dalla console Frammenti di contenuto, puoi anche pubblicare nel Servizio di anteprima, per il test e la visualizzazione in anteprima, prima della pubblicazione. Consulta Pubblicazione e anteprima di un frammento.

Accesso

Come per la maggior parte dei sistemi, è necessario effettuare l’accesso. In qualità di autore, ricevi:

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

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

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

NOTE
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 andare 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
NOTE
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 dei frammenti di contenuto

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

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 della sezione File della console Risorse. Seleziona l’opzione 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 per frammenti di contenuto disponibili nella cartella

Questa sezione è leggermente più avanzata. Non ne hai bisogno se hai appena iniziato a fare delle prove, ma è molto utile quando sono disponibili divesi 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.

Crea proprietà cartella - Criteri

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

In caso - Configurazione cartella Cloud Services

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). Questo probabilmente non ti interesserà, ma se necessario è possibile controllare la Configurazione nel Cloud Services della cartella Proprietà:

Crea proprietà cartella - Configurazione

NOTE
Per ulteriori informazioni, consulta Applicare la configurazione alla cartella Risorse.

Creazione di un frammento di contenuto

Nella console Frammenti di contenuto puoi utilizzare Crea per aprire la finestra di dialogo Nuovo frammento di contenuto:

Console Frammenti di contenuto - Creazione di un nuovo frammento

Specifica:

  • Dove si trova
  • Modello per frammenti di contenuto
  • Titolo
  • Nome
  • Descrizione

Quindi conferma con Crea o con 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).

NOTE
I frammenti di contenuto sono una funzione di Sites, ma vengono memorizzati come Risorse.
Sono disponibili due editor per l’authoring dei frammenti di contenuto.
  • Il nuovo editor, accessibile principalmente dalla console Frammenti di contenuto.
  • L’editor originale, accessibile principalmente dalla console Risorse.

Quando l’editor si apre per la prima volta, vengono visualizzati i seguenti elementi:

  • Barra degli strumenti superiore: per informazioni chiave e azioni

    • Collegamento alla Console Frammenti di contenuto (icona Home)
    • Informazioni sul modello e sulla cartella
    • Collegamenti ad Anteprima, se per il modello è configurato il Pattern URL di anteprima predefinito
    • Azioni Pubblica e Annulla pubblicazione
    • Opzione per mostrare tutti i Riferimenti padre (icona collegamento)
    • Stato del frammento e le ultime informazioni salvate
    • Pulsante per passare all’editor originale (basato su Assets)

  • Pannello a sinistra: presenta le Varianti del frammento di contenuto e i relativi Campi:

    • questi collegamenti possono essere utilizzati per navigare nella struttura del frammento di contenuto

  • Pannello a destra: presenta schede che mostrano le proprietà (metadati) e i tag, informazioni sulla cronologia delle versioni e informazioni relative a eventuali copie per lingua

    • Scheda Proprietà, in cui puoi aggiornare il Titolo e la Descrizione del frammento, oppure la Variante

  • Pannello centrale: presenta i campi e il contenuto effettivi della variante selezionata

    • Consente di modificare il contenuto
    • Se nel modello sono stati definiti dei campi Segnaposto scheda, questi vengono visualizzati qui e possono essere utilizzati per la navigazione.

Ad esempio, per un frammento:

  • Possono essere richieste più informazioni, alcune con un tipo specifico. Come scoprirai più avanti nel tuo percorso, i riferimenti sono fondamentali per i contenuti headless.

  • Può essere possibile 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

NOTE
Per aiutare gli autori a completare alcuni campi correttamente, 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.

NOTE
Per ulteriori informazioni, consulta Varianti - Authoring di frammenti di contenuto.

Quello di cui (probabilmente) non devi preoccuparti

OK, questa potrebbe sembrare una sezione leggermente ambigua, ma appena aperto l’Editor frammento di contenuto e iniziato ad esplorarlo, visualizzerai diverse opzioni che (probabilmente) non sono applicabili al tuo percorso headless come Autore del 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 per frammenti di contenuto è disponibile nel pannello di destra dell’editor. 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
    Per ulteriori informazioni, consulta il Percorso Architect di contenuti AEM headless.

Pubblicazione

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

Le azioni di pubblicazione sono disponibili nell’editor:

Editor frammento di contenuto - Frammento personale

NOTE
Puoi anche pubblicare il frammento dalla console Risorse o Frammenti di contenuto.

Passaggio successivo

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

Experience Manager