Distribuzione di contenuti headless tramite frammenti di contenuto con GraphQL headless-content-delivery-using-content-fragments-with-graphQL
Con Adobe Experience Manager (AEM), puoi utilizzare Frammenti di contenuto e l’API GraphQL AEM (un’implementazione personalizzata, basata su GraphQL standard) per fornire contenuti strutturati da utilizzare nelle applicazioni. La possibilità di personalizzare una singola query API consente di recuperare e fornire il contenuto specifico che desideri riprodurre (come risposta alla singola query API).
CMS headless headless-cms
Un sistema per la gestione dei contenuti (CMS) headless è:
-
"Un sistema di gestione dei contenuti headless, o CMS headless, è un sistema di gestione dei contenuti (CMS) solo di back-end creato come archivio dei contenuti che li rende accessibili tramite un'API per la visualizzazione 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-overview
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 per 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 aem-graphql-api
Ad Adobe, è 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 content-fragments-use-with-aem-graphql-api
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 content-fragments
Frammenti di contenuto:
-
Contengono contenuti strutturati.
-
Sono basati su un Modello per frammenti di contenuto che predefinisce la struttura del frammento risultante.
Modelli per frammenti di contenuto content-fragments-models
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 fragment-references
-
È 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 i dati strutturati.
- Quando è definito come multifeed, è possibile fare riferimento a (recuperare) più frammenti secondari dal frammento principale.
Anteprima JSON json-preview
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 learn-graphql-with-aem-sample-content-queries
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.