Guida rapida all’accesso e alla distribuzione di frammenti di contenuto headless

Scopri come utilizzare l’API REST di AEM Assets per gestire i frammenti di contenuto e l’API GraphQL per la distribuzione headless dei contenuti di 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 distribuirle senza problemi.

• L’API GraphQL consente di creare richieste per accedere e distribuire frammenti di contenuto.
  • Per utilizzare questo, gli endpoint devono essere definiti e abilitati in AEMe, se necessario, Interfaccia GraphiQL installata.
• API REST di Assets consente di creare e modificare frammenti di contenuto (e altre risorse).

Il resto di questa guida è incentrato sull’accesso a GraphQL e sulla distribuzione di frammenti di contenuto.

Come distribuire un frammento di contenuto con GraphQL

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

1. Accedi all’AEM e accedi a Interfaccia GraphiQL:

   • Esempio: http://<host>:<port>/aem/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 senza problemi come JSON.

   • Il pannello a sinistra 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.

     

3. Supponendo che il modello che hai creato si chiama person con campi firstName, lastName e position, puoi 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.

5. Fai clic su Esegui query (freccia destra) o utilizza l’icona Ctrl-Enter e i risultati vengono visualizzati come JSON nel pannello di destra.
   

6. Fai clic su:

   • Documentazione in alto a destra per visualizzare la documentazione contestuale per aiutarti a creare query che si adattano ai tuoi modelli.

   • Cronologia nella barra degli strumenti superiore per visualizzare le query precedenti.

   • Salva con nome e Salva per salvare le query, dopodiché puoi elencarle e recuperarle dalla Query persistenti pannello e Pubblica.

     

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 consegne eccessive. Al contrario, consente la distribuzione in blocco di ciò che è esattamente 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. Sono disponibili molte altre risorse da approfondire per una comprensione completa delle funzioni disponibili.

• Browser configurazioni - Per informazioni dettagliate sul browser di configurazione AEM
• Frammenti di contenuto: per informazioni dettagliate sulla creazione e la gestione dei frammenti di contenuto
• IDE GraphiQL per ulteriori dettagli sull’utilizzo dell’IDE GraphiQL
• Query persistenti per ulteriori dettagli sulle query persistenti
• Supporto per frammenti di contenuto nell’API HTTP di AEM Assets: per informazioni dettagliate sull’accesso diretto ai contenuti AEM tramite l’API HTTP, mediante operazioni CRUD (Crea, Leggi, Aggiorna, Elimina)
• API di GraphQL: per informazioni dettagliate su come distribuire i frammenti di contenuto in modo corretto