Scopri le nozioni di base sulla modellazione dei contenuti per Headless con AEM

La storia finora

All'inizio del percorso di architetti di contenuti headless AEM la Introduzione sono stati trattati i concetti e la terminologia di base relativi alla modellazione dei contenuti senza testa.

Questo articolo si basa su questi elementi per comprendere come modellare i contenuti per il progetto AEM headless.

Obiettivo

  • Pubblico: Principiante
  • Obiettivo: Introduce i concetti di modellazione dei contenuti per CMS headless.

Modellazione dei contenuti con modelli di frammenti di contenuto

La modellazione dei contenuti (dati) è un insieme di tecniche consolidate, spesso utilizzate quando si sviluppano database di relazioni, quindi cosa significa la modellazione dei contenuti per AEM Headless?

Perché?

Per garantire che l’applicazione possa richiedere e ricevere in modo coerente ed efficiente il contenuto richiesto da AEM, questo contenuto deve essere strutturato.

Ciò significa che l'applicazione conosce in anticipo la forma di risposta e quindi come elaborarla. Questo è molto più semplice della ricezione di contenuti in formato libero, che devono essere analizzati per determinare cosa contengono e quindi come possono essere utilizzati.

Introduzione a Come?

AEM utilizza Frammenti di contenuto per fornire le strutture necessarie per la distribuzione headless dei contenuti alle applicazioni.

La struttura del modello di contenuto è la seguente:

  • realizzato dalla definizione del modello per frammenti di contenuto,
  • utilizzati come base dei frammenti di contenuto utilizzati per la generazione dei contenuti.
NOTA

I modelli per frammenti di contenuto vengono utilizzati anche come base degli schemi AEM GraphQL, utilizzati per recuperare i contenuti. Per ulteriori informazioni, consulta il Percorso Sviluppatore .

Le richieste di contenuti vengono effettuate utilizzando l’API GraphQL di AEM, un’implementazione personalizzata dell’API GraphQL standard. L’API GraphQL AEM consente alle applicazioni di eseguire query (complesse) sui frammenti di contenuto, con ogni query in base a un tipo di modello specifico.

Il contenuto restituito può quindi essere utilizzato dalle applicazioni.

Creazione di una struttura con modelli di frammenti di contenuto

I modelli per frammenti di contenuto forniscono vari meccanismi che consentono di definire la struttura del contenuto.

Un modello di frammento di contenuto descrive un’entità.

NOTA

La funzionalità Frammento di contenuto deve essere abilitata nel browser di configurazione per consentire la creazione di nuovi modelli.

SUGGERIMENTO

Il modello deve essere denominato in modo che l’autore del contenuto sappia quale modello selezionare durante la creazione di un frammento di contenuto.

All'interno di un modello:

  1. Tipi di dati consente di definire i singoli attributi.
    Ad esempio, definisci il campo contenente il nome di un insegnante come Testo e i loro anni di servizio come Numero.
  2. Tipi di dati Riferimento contenuto e Riferimento frammento consente di creare relazioni con altri contenuti all’interno di AEM.
  3. La Riferimento frammento il tipo di dati ti consente di realizzare più livelli di struttura nidificando i frammenti di contenuto (in base al tipo di modello). Questo è fondamentale per la modellazione dei contenuti.

Ad esempio:

Modellazione dei contenuti con frammenti di contenuto

Tipi di dati

AEM fornisce i seguenti tipi di dati per modellare il contenuto:

  • Testo su riga singola
  • Testo su più righe
  • Numero
  • Booleano
  • Data e ora
  • Enumerazione
  • Tag
  • Riferimento contenuto
  • Riferimento frammento
  • Oggetto JSON
NOTA

Ulteriori dettagli sono disponibili in Modelli di frammento di contenuto - Tipi di dati.

Riferimenti e contenuto nidificato

Due tipi di dati forniscono riferimenti a contenuti esterni a uno specifico frammento:

  • Riferimento contenuto
    Questo fornisce un semplice riferimento ad altri contenuti di qualsiasi tipo.
    Ad esempio, è possibile fare riferimento a un'immagine in una posizione specifica.

  • Riferimento frammento
    Questo fornisce riferimenti ad altri frammenti di contenuto.
    Questo tipo di riferimento viene utilizzato per creare contenuti nidificati, introducendo le relazioni necessarie per modellare il contenuto.
    Il tipo di dati può essere configurato in modo da consentire agli autori di frammenti di:

    • Modificare direttamente il frammento a cui si fa riferimento.
    • Crea un nuovo frammento di contenuto basato sul modello appropriato
NOTA

È inoltre possibile creare riferimenti ad hoc utilizzando i collegamenti all’interno dei blocchi di testo.

Livelli di struttura (frammenti nidificati)

Per la modellazione dei contenuti Riferimento frammento il tipo di dati consente di creare più livelli di struttura e relazioni.

Con questo riferimento è possibile connect vari modelli di frammenti di contenuto per rappresentare le interrelazioni. Questo consente all’applicazione headless di seguire le connessioni e accedere al contenuto in base alle necessità.

NOTA

Questo dovrebbe essere utilizzato con cautela e le migliori pratiche possono essere definite come nidificare quanto necessario, ma il meno possibile.

I riferimenti ai frammenti consentono di fare riferimento a un altro frammento.

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

  • Città
  • Azienda
  • Utente
  • Premi

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

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

  • La mia azienda - Azienda
    • Amministratore delegato - Persona
    • Dipendente/i - Persona
      • Premio(i) personale(i) - Premio(i)

Ed è solo per cominciare. 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 ottenuta con i Riferimenti ai frammenti, in quanto sono compresi dall’utente (l’architetto), dall’autore dei contenuti e dalle applicazioni headless.

Novità

Ora che hai imparato le nozioni di base, il passo successivo è quello di Scopri come creare modelli di frammenti di contenuto in AEM. Questo introdurrà e discuterà i vari riferimenti disponibili e come creare livelli di struttura con i Riferimenti frammento - una parte chiave della modellazione per gli headless.

Risorse aggiuntive

In questa pagina