Guida rapida all’accesso e alla distribuzione di frammenti di contenuto headless accessing-delivering-content-fragments
Scopri come utilizzare l’API REST di AEM Assets per gestire i frammenti di contenuto e l’API di GraphQL per la distribuzione headless dei contenuti dei frammenti di contenuto.
Cosa sono le API REST di GraphQL e Assets? what-are-the-apis
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, è necessario che endpoint siano definiti e abilitati in AEM e, se necessario, che sia installata l'interfaccia GraphiQL.
- L'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 how-to-deliver-a-content-fragment
Gli architetti di informazioni devono progettare query per gli endpoint di canale per distribuire i contenuti. Considera queste query solo una volta per endpoint, per modello. Per questa guida introduttiva, creane una sola.
-
Accedi all'AEM e accedi all'interfaccia GraphiQL:
- Ad esempio:
http://<host>:<port>/aem/graphiql.html
.
- Ad esempio:
-
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.
-
-
Supponendo che il modello che hai creato si chiama
person
con campifirstName
,lastName
eposition
, puoi creare una semplice query per recuperare il contenuto del frammento di contenuto.code language-text query { personList { items { _path firstName lastName position } } }
-
Inserisci la query nel pannello a sinistra.
-
Fai clic sull'icona Esegui query (freccia destra) oppure utilizza il tasto di scelta rapida
Ctrl-Enter
e i risultati vengono visualizzati come JSON nel pannello di destra.
-
Fai clic su:
-
Documenti in alto a destra della pagina per visualizzare la documentazione contestuale per aiutarti a creare le 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é potrai elencarle e recuperarle dal pannello Query persistenti e da Publish.
-
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 next-steps
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 configurazioni 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