Informazioni sull’utilizzo dei riferimenti nei frammenti di contenuto author-headless-references

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.

Hai appreso le nozioni di base sull’authoring di CMS headless, con un’introduzione all’authoring con AEMaaCS e, in particolare, all’authoring di frammenti di contenuto.

Questo articolo si basa su questi elementi e spiega come utilizzare i riferimenti per creare contenuti personalizzati per il progetto headless in AEM.

Obiettivo objective

Cosa sono i riferimenti what-are-references

I riferimenti sono semplicemente un meccanismo per collegare le risorse, sia che si tratti di altro contenuto, di risorse (come nelle immagini) o di altri frammenti. Anche se molto simili, ci sono alcune differenze.

Alcuni riferimenti sono costituiti da tipi di dati dedicati (ad esempio, Riferimenti al contenuto e Riferimenti ai frammenti), mentre altri sono semplicemente aggiunti come riferimento all’interno di un blocco di testo (riferimenti alle risorse e riferimenti ad hoc).

Riferimenti al contenuto content-references

I riferimenti ai contenuti fanno proprio questo: ti consentono di fare riferimento a qualsiasi altro contenuto. Viene aperto un browser che consente di selezionare l’elemento di contenuto.

Riferimenti a risorse/file multimediali assets-media-references

È possibile fare riferimento alle risorse (ad esempio, immagini o file multimediali) all’interno di un blocco di testo utilizzando l’opzione Inserisci risorsa. Viene aperto un browser che consente di selezionare la risorsa.

Riferimenti ai frammenti fragment-references

Anche in questo caso, i riferimenti ai frammenti fanno proprio questo: ti consentono di fare riferimento a un altro frammento. Per comprendere perché questo è significativo, è necessaria una spiegazione più completa.

Ad esempio, è possibile che siano definiti i seguenti modelli di frammento di contenuto:

Sembra abbastanza semplice, ma un’Azienda ha sia un amministratore delegato che dei dipendenti…e queste sono tutte persone, ognuna definita come Persona.

E una Persona può ricevere un Premio (o forse due).

E siamo solo all’inizio. A seconda della complessità, un premio potrebbe essere specifico per l’Azienda o un’Azienda potrebbe avere la sua sede principale in una città specifica.

La rappresentazione di queste interrelazioni può essere effettuata con i Riferimenti ai frammenti, in quanto sono compresi sia da te (l’autore) che dalle applicazioni headless.

In qualità di autore, non sei responsabile della definizione di queste relazioni (attività svolta dall’architetto di contenuti durante la creazione del modello di frammento di contenuto), ma devi sapere come riconoscere e modificare i riferimenti.

Come creare i frammenti nidificati author-nested-fragment

L’authoring dei riferimenti ai frammenti è abbastanza semplice (anche se in genere il campo non sarà etichettato come Riferimento a frammento). È possibile digitare direttamente il riferimento oppure (più probabilmente) selezionare l’icona della cartella per aprire un browser che consente di sfogliare e selezionare il frammento desiderato.

La definizione del modello di frammento di contenuto controlla:

Come accedere ai frammenti nidificati navigate-nested-fragment

Utilizzando la scheda Struttura ad albero dell’Editor frammento di contenuto, ci si può spostare tra i frammenti a cui fa riferimento il tuo frammento e, quindi, tra eventuali riferimenti che i frammenti possono contenere. Quando si seleziona un riferimento, il frammento viene aperto per la modifica.

Riferimenti ad hoc adhoc-references

I riferimenti ad hoc possono essere aggiunti come semplice collegamento all’interno di un blocco di testo:

Passaggio successivo whats-next

Ora che hai imparato i riferimenti e la struttura nei frammenti di contenuto, il passaggio successivo è Informazioni su metadati e assegnazione tag. In questo modo verrà introdotto e illustrato come definire metadati e tag per i frammenti di contenuto.

Risorse aggiuntive additional-resources