Guida rapida all’accesso e alla distribuzione di frammenti di contenuto senza intestazione

Scopri come utilizzare AEM API REST di Assets per gestire i frammenti di contenuto e l’API GraphQL per la distribuzione headless di contenuti con frammenti di contenuto.

Cosa sono le API REST di GraphQL e Assets?

Dopo aver creato alcuni frammenti di contenuto, puoi utilizzare le API AEM per distribuirli senza problemi.

  • L’ API GraphQL consente di creare richieste di accesso e distribuzione di frammenti di contenuto.
  • L’ API REST di Assets consente di creare e modificare frammenti di contenuto (e altre risorse).

Il resto di questa guida sarà incentrato sull’accesso GraphQL e la distribuzione di frammenti di contenuto.

Come consegnare un frammento di contenuto utilizzando GraphQL

Gli architetti di informazioni dovranno progettare query per i loro endpoint di canale per distribuire contenuti. In genere queste query devono essere considerate solo una volta per endpoint per modello. Ai fini di questa guida introduttiva, è sufficiente crearne una.

  1. Accedi a AEM come Cloud Service e accedi all'interfaccia GraphiQL:

    • Esempio: https://<host>:<port>/content/graphiql.html.
  2. GraphiQL è un editor di query interno al browser per GraphQL. Puoi utilizzarlo per creare query per recuperare frammenti di contenuto e distribuirli direttamente come JSON.

    • Il pannello a sinistra ti consente di creare la query.

    • Nel pannello a destra vengono visualizzati i risultati.

    • L’editor delle query dispone del completamento del codice e dei tasti di scelta rapida per eseguire facilmente la query.

      Editor GraphiQL

  3. Presupponendo che il modello creato sia stato denominato person con campi firstName, lastName e position, possiamo creare una semplice query per recuperare il contenuto del frammento di contenuto.

    query 
    {
      personList {
        items {
          _path
          firstName
          lastName
          position
        }
      }
    }
    
  4. Inserisci la query nel pannello a sinistra.
    Query GraphiQL

  5. Fai clic sul pulsante Esegui query o utilizza la chiave di scelta rapida Ctrl-Enter e i risultati vengono visualizzati come JSON nel pannello di destra.
    Risultati GraphiQL

  6. Fai clic sul collegamento Documenti in alto a destra della pagina per visualizzare la documentazione contestuale per aiutarti a creare le query che si adattano ai tuoi modelli.
    Documentazione di GraphiQL

GraphQL consente query strutturate in grado di eseguire il targeting non solo di set di dati specifici o di singoli oggetti di dati, ma anche di fornire elementi specifici degli oggetti, risultati nidificati, offerte di supporto per variabili di query e molto altro.

GraphQL può evitare richieste API iterative e consegna in eccesso, e consente invece la distribuzione in massa di esattamente ciò che è necessario per il rendering come risposta a una singola query API. Il JSON risultante può essere utilizzato per inviare dati ad altri siti o app.

Passaggi successivi

Tutto qui! Ora hai una conoscenza di base della gestione dei contenuti headless in AEM. Naturalmente, ci sono molte altre risorse in cui puoi immergerti per una comprensione completa delle funzioni disponibili.

  • Browser di configurazione : per informazioni dettagliate sul browser di configurazione AEM
  • Frammenti di contenuto : per informazioni dettagliate sulla creazione e la gestione dei frammenti di contenuto
  • Supporto dei frammenti di contenuto nell’API HTTP di AEM Assets - Per informazioni dettagliate sull’accesso AEM contenuto direttamente tramite l’API HTTP tramite operazioni CRUD (creazione, lettura, aggiornamento, eliminazione)
  • API GraphQL : per informazioni dettagliate su come distribuire frammenti di contenuto senza problemi

In questa pagina