Come accedere al contenuto tramite API di consegna di AEM access-your-content

In questa parte del Percorso per sviluppatori headless di AEM scopri come utilizzare le query GraphQL per accedere al contenuto dei frammenti di contenuto e inviarlo all’app (consegna headless).

Percorso affrontato finora story-so-far

Nel documento precedente del percorso headless AEM, Come modellare il contenuto hai appreso le nozioni di base sulla modellazione dei contenuti in AEM, quindi ora devi capire come modellare la struttura dei contenuti, quindi realizzare tale struttura utilizzando AEM Modelli di frammento di contenuto e Frammenti di contenuto:

  • Riconoscere i concetti e la terminologia relativi alla modellazione dei contenuti.
  • Scopri perché è necessaria la modellazione dei contenuti per la distribuzione di contenuti headless.
  • Scopri come realizzare questa struttura utilizzando Modelli di frammenti di contenuto di AEM (e creare contenuti con frammenti di contenuto).
  • Come modellare il contenuto; principi con esempi base.

Questo articolo si basa su questi elementi fondamentali per comprendere come accedere al contenuto headless esistente in AEM utilizzando l’API GraphQL AEM.

  • Pubblico: principiante

  • Obiettivo: scopri come accedere al contenuto dei frammenti di contenuto utilizzando query GraphQL di AEM:

    • Introduzione a GraphQL e all’API GraphQL di AEM.
    • Approfondisci i dettagli dell’API GraphQL di AEM.
    • Osserva alcune query di esempio per vedere come funzionano in pratica.

Vuoi accedere ai tuoi contenuti? so-youd-like-to-access-your-content

Quindi… hai tutto questo contenuto, ben strutturato (in Frammenti di contenuto) e in attesa di alimentare la tua nuova app. La domanda è: come arrivarci?

Ciò di cui hai bisogno è un modo per eseguire il targeting di contenuti specifici, selezionare ciò che ti serve e restituirlo all’app per un’ulteriore elaborazione.

Con Adobe Experience Manager (AEM), puoi accedere in modo selettivo ai frammenti di contenuto, utilizzando l’API GraphQL AEM, per restituire solo il contenuto necessario. Ciò significa che è possibile realizzare una distribuzione headless di contenuti strutturati da utilizzare nelle applicazioni.

NOTE
API GraphQL di AEM è un’implementazione personalizzata, basata sulle specifiche API GraphQL standard.

GraphQL - Introduzione graphql-introduction

GraphQL è una specifica open-source che fornisce:

  • un linguaggio di query che consente di selezionare contenuto specifico da oggetti strutturati.
  • un runtime per eseguire queste query con il contenuto strutturato.

GraphQL è un’API tipizzata fortemente. Ciò significa che tutti i contenuti devono essere chiaramente strutturati e organizzati per tipo, in modo che GraphQL comprenda accesso e modalità dello stesso. I campi dati sono definiti all’interno degli schemi GraphQL che definiscono la struttura degli oggetti contenuto.

Gli endpoint GraphQL forniscono quindi i percorsi che rispondono alle query GraphQL.

Ciò significa che l’app può selezionare in modo preciso, affidabile ed efficiente il contenuto necessario, esattamente ciò di cui hai bisogno quando viene utilizzata con AEM.

NOTE
Vedi GraphQL.org e GraphQL.com.

API GraphQL di AEM aem-graphql-api

L’API GraphQL dell’AEM è una versione personalizzata basata sulla specifica API GraphQL standard, configurata appositamente per consentire l’esecuzione di query (complesse) sui frammenti di contenuto.

I frammenti di contenuto vengono utilizzati, in quanto il contenuto è strutturato in base ai modelli di frammenti di contenuto. Questo soddisfa i requisiti fondamentali di GraphQL.

  • Un modello di frammento di contenuto è costituito da uno o più campi.
    • Ogni campo è definito in base a un tipo di dati.
  • I modelli per frammenti di contenuto vengono utilizzati per generare gli schemi GraphQL di AEM corrispondenti.

Per accedere effettivamente a GraphQL per AEM (e il contenuto) viene utilizzato un endpoint per fornire il percorso di accesso.

Il contenuto restituito, tramite l’API GraphQL di AEM, può quindi essere utilizzato dalle tue applicazioni.

Per facilitare l’input diretto e il test delle query, è disponibile anche un’implementazione dell’interfaccia standard GraphiQL da usare con GraphQL di AEM (installabile con AEM). Offre funzioni quali evidenziazione della sintassi, completamento automatico, suggerimenti automatici, nonché una cronologia e una documentazione online.

NOTE
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 schemi e query AEM dato che:

  • Consentono di progettare, creare, curare e pubblicare contenuti indipendenti dalla pagina che possono essere distribuiti in modo headless.
  • Si basano su un modello per frammenti di contenuto, che predefinisce la struttura del frammento risultante utilizzando una selezione di tipi di dati.
  • È possibile ottenere livelli aggiuntivi di struttura con il tipo di dati Riferimento frammento, disponibile quando si definisce un modello.

Modelli per frammenti di contenuto content-fragments-models

Questi 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

Il Riferimento frammento:

  • È un tipo di dati specifico disponibile quando si definisce un modello di frammento di contenuto.

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

  • Consente di creare e quindi recuperare dati strutturati.

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

Anteprima JSON json-preview

Per facilitare la progettazione e lo sviluppo di modelli di frammenti di contenuto, puoi visualizzare in anteprima l’output JSON nell’Editor frammento di contenuto.

Anteprima JSON

Accessibili tramite l’API GraphQL di AEM actually-using-aem-graphiql

Configurazione iniziale initial-setup

Prima di iniziare con le query sul contenuto è necessario:

Struttura di esempio sample-structure

Per utilizzare effettivamente l’API GraphQL di AEM in una query, possiamo utilizzare le due strutture modello di frammento di contenuto molto semplici:

  • Azienda

    • Nome - Testo
    • Amministratore delegato (Persona) - Riferimento al frammento
    • Dipendenti (Persone) - Riferimento/i al frammento
  • Persona

    • Nome - Testo
    • Nome - Testo

Come puoi vedere, i campi Amministratore delegato e Dipendenti fanno riferimento ai frammenti persona.

Vengono utilizzati i modelli di frammenti:

  • durante la creazione del contenuto nell’Editor frammento di contenuto
  • per generare gli schemi GraphQL da interrogare

Dove testare le query where-to-test-your-queries

Le query possono essere immesse nell'interfaccia GraphiQL, ad esempio in:

  • http://localhost:4502/aem/graphiql.html

Interfaccia di GraphiQL

Guida introduttiva alle query getting-Started-with-queries

Una query semplice consiste nel restituire il nome di tutte le voci nello schema Azienda. Qui si richiede un elenco di tutti i nomi aziendali:

query {
  companyList {
    items {
      name
    }
  }
}

Una query leggermente più complessa consiste nel selezionare tutte le persone che non hanno un nome di “Jobs”. In questo modo verranno filtrate tutte le persone per quelle che non hanno il nome Jobs. Questo si ottiene con l'operatore EQUALS_NOT (ce ne sono molti altri):

query {
  personList(filter: {
    name: {
      _expressions: [
        {
          value: "Jobs"
          _operator: EQUALS_NOT
        }
      ]
    }
  }) {
    items {
      name
      firstName
    }
  }
}

È inoltre possibile creare query più complesse. Ad esempio, eseguire una query per tutte le aziende che hanno almeno un dipendente con il nome di “Smith”. Questa query illustra il filtro per qualsiasi persona di nome “Smith” e restituisce informazioni da frammenti nidificati:

query {
  companyList(filter: {
    employees: {
      _match: {
        name: {
          _expressions: [
            {
              value: "Smith"
            }
          ]
        }
      }
    }
  }) {
    items {
      name
      ceo {
        name
        firstName
      }
      employees {
        name
        firstName
      }
    }
  }
}

Per informazioni dettagliate sull’utilizzo dell’API GraphQL di AEM e sulla configurazione degli elementi necessari, puoi fare riferimento a:

  • Imparare a utilizzare GraphQL con AEM
  • La struttura del frammento di contenuto di esempio
  • Imparare a utilizzare GraphQL con AEM: contenuto di esempio e query

Passaggio successivo whats-next

Ora che hai imparato ad accedere ai contenuti headless e ad eseguire query tramite l’API GraphQL di AEM puoi imparare ad utilizzare l’API REST per accedere e aggiornare il contenuto dei frammenti di contenuto.

Risorse aggiuntive additional-resources

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2