Distribuzione di contenuti headless tramite frammenti di contenuto con GraphQL

Con Adobe Experience Manager (AEM), puoi utilizzare Frammenti di contenuto, insieme all’API GraphQL di AEM (un’implementazione personalizzata, basata su GraphQL standard), per distribuire in modo headless contenuti strutturati da utilizzare nelle applicazioni. La possibilità di personalizzare un’unica query API consente di recuperare e fornire il contenuto specifico che desideri riprodurre (come risposta alla singola query API).

CMS headless

Un sistema per la gestione dei contenuti (CMS) headless è:

  • Un sistema per la gestione dei contenuti headless, o CMS headless, è un sistema di gestione dei contenuti (CMS) di back-end progettato come archivio che rende i contenuti accessibili tramite un’API per visualizzarli su qualsiasi dispositivo“.

    Vedi Wikipedia.

In termini di authoring di frammenti di contenuto in AEM, questo significa che:

  • È possibile utilizzare i frammenti di contenuto per l’authoring contenuti che non sono destinati principalmente alla pubblicazione diretta (1:1) su pagine formattate.

  • Il contenuto dei frammenti sarà strutturato in modo predeterminato in base ai modelli per frammenti di contenuto. Questo ne semplifica l’accesso da parte delle applicazioni che poi elaboreranno ulteriormente i contenuti.

GraphQL: panoramica

GraphQL è:

  • …un linguaggio di query per le API e un runtime per l’esecuzione di tali query con i dati esistenti.

    Vedi GraphQL.org

L’API GraphQL di AEM consente di eseguire query (complesse) sui Frammenti di contenuto; ogni query è basata su un tipo di modello specifico. Il contenuto restituito può quindi essere utilizzato dalle applicazioni.

API GraphQL di AEM

Per Adobe Experience è stata sviluppata un’implementazione personalizzata dell’API GraphQL standard. Per informazioni, consulta API GraphQL AEM per l’utilizzo con Frammenti di contenuto.

L’implementazione dell’API GraphQL per AEM si basa sulle librerie Java GraphQL.

Frammenti di contenuto da utilizzare con l’API GraphQL di AEM

I frammenti di contenuto possono essere utilizzati come base per GraphQL per query AEM per i seguenti motivi:

  • Consentono di progettare, creare, curare e pubblicare contenuti indipendenti dalla pagina.
  • I Modelli per frammenti di contenuto forniscono la struttura richiesta per mezzo di tipi di dati definiti.
  • Il Riferimento frammento, disponibile quando si definisce un modello, può essere utilizzato per definire livelli di struttura aggiuntivi.
Frammenti di contenuto da utilizzare con GraphQL

Frammenti di contenuto

Frammenti di contenuto:

Modelli per frammenti di contenuto

I Modelli per frammenti di contenuto:

  • Sono utilizzati per generare gli Schemi, una volta Abilitati.

  • Forniscono i tipi di dati e i campi richiesti per GraphQL. Assicurano che l’applicazione trasmetta solo richieste ammesse e riceva solo i contenuti previsti.

  • Il tipo di dati Riferimenti frammento può essere utilizzato nel modello per fare riferimento a un altro frammento di contenuto e quindi introdurre ulteriori livelli di struttura.

Riferimenti frammento

Il Riferimento frammento:

  • È di particolare interesse in combinazione con GraphQL.

  • È un tipo di dati specifico che può essere utilizzato durante la definizione di un modello per frammento di contenuto.

  • Fa riferimento a un altro frammento, a seconda di un modello per frammento di contenuto specifico.

  • Consente di recuperare dati strutturati.

    • Quando è definito come multifeed, è possibile fare riferimento a (recuperare) più frammenti secondari dal frammento principale.

Anteprima JSON

Per semplificare la progettazione e lo sviluppo dei modelli per frammenti di contenuto, puoi visualizzare in anteprima l’output JSON.

Imparare a utilizzare GraphQL con AEM: contenuto di esempio e query

Per un’introduzione all’utilizzo dell’API GraphQL di AEM, consulta Imparare a utilizzare GraphQL con AEM: contenuto di esempio e query.

Tutorial: guida introduttiva ad AEM headless e GraphQL

Cerchi un pratico tutorial? Dai un'occhiata al tutorial Guida introduttiva di headless AEM e GraphQL che illustra come creare ed esporre contenuti, utilizzati da un’app esterna, mediante le API GraphQL di AEM in uno scenario CMS headless.

In questa pagina