Come accedere al contenuto tramite API di consegna di AEM

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

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?

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 dell’AEM, per restituire solo il contenuto necessario. Ciò significa che è possibile realizzare una distribuzione headless di contenuti strutturati da utilizzare nelle applicazioni.

NOTA

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

GraphQL - Introduzione

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.

NOTA

Vedi GraphQL.org e GraphQL.com.

API GraphQL di AEM

L’API GraphQL di AEM è una versione personalizzata basata sulle specifiche API standard di GraphQL, appositamente configurata 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.

NOTA

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 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

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

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

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

Configurazione iniziale

Prima di iniziare con le query sul contenuto è necessario:

Struttura di esempio

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.

I modelli di frammento verranno utilizzati:

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

Dove testare le query

Le query possono essere immesse in Interfaccia GraphiQL, ad esempio in:

  • http://localhost:4502/aem/graphiql.html
Interfaccia di GraphiQL

Guida introduttiva alle query

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

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

In questa pagina