Komma åt och leverera innehållsfragment Headless Quick Start Guide accessing-delivering-content-fragments
Lär dig använda AEM Assets REST API för att hantera innehållsfragment och GraphQL API för headless-leverans av Content Fragment-innehåll.
Vad är GraphQL och Assets REST API:er? what-are-the-apis
Nu när du har skapat några innehållsfragment, kan du använda AEM-API:er för att leverera dem utan problem.
- GRAPHQL API Med kan du skapa förfrågningar om åtkomst och leverans av innehållsfragment.
- Om du vill använda det här slutpunkter måste definieras och aktiveras i AEMoch, om det behövs, GraphiQL-gränssnittet är installerat.
- Resursens REST API I kan du skapa och ändra innehållsfragment (och andra resurser).
Resten av guiden fokuserar på GraphQL åtkomst och leverans av innehållsfragment.
Leverera ett innehållsfragment med GraphQL how-to-deliver-a-content-fragment
Informationsarkitekterna måste utforma frågor så att deras kanalslutpunkter kan leverera innehåll. Dessa frågor får endast övervägas en gång per slutpunkt och modell. I den här guiden för att komma igång får du bara skapa en.
-
Logga in AEM och få åtkomst till GraphiQL-gränssnitt:
- Till exempel:
http://<host>:<port>/aem/graphiql.html
.
- Till exempel:
-
GraphiQL är en frågeredigerare i webbläsaren för GraphQL. Du kan använda den för att skapa frågor för att hämta innehållsfragment och leverera dem helhjärtat som JSON.
-
På den vänstra panelen kan du skapa din fråga.
-
Resultatet visas på den högra panelen.
-
Frågeredigeraren har funktioner för kodkomplettering och snabbtangenter för att enkelt köra frågan.
-
-
Anta att modellen du skapade anropades
person
med fältfirstName
,lastName
ochposition
kan du skapa en enkel fråga som hämtar innehållet i innehållsfragmentet.code language-text query { personList { items { _path firstName lastName position } } }
-
Skriv frågan i den vänstra panelen.
-
Klicka på Kör fråga (högerpil) eller använd
Ctrl-Enter
snabbtangenten och resultatet visas som JSON i den högra panelen.
-
Klicka:
-
Dokument längst upp till höger på sidan om du vill visa sammanhangsberoende dokumentation som hjälper dig att skapa frågor som anpassar sig till dina egna modeller.
-
Historik i det övre verktygsfältet om du vill visa tidigare frågor.
-
Spara som och Spara för att spara dina frågor, därefter kan du visa och hämta dem från Beständiga frågor panel och Publicera.
-
GraphQL möjliggör strukturerade frågor som inte bara kan rikta sig till specifika datauppsättningar eller enskilda dataobjekt, utan även kan leverera specifika element i objekten, kapslade resultat, har stöd för frågevariabler och mycket annat.
GraphQL kan undvika iterativa API-begäranden och överleverans. I stället kan man få exakt det som behövs för återgivningen som svar på en enda API-fråga. Den resulterande JSON kan användas för att leverera data till andra webbplatser eller appar.
Nästa steg next-steps
Så ja! Ni har nu en grundläggande förståelse för innehållshantering utan problem i AEM. Det finns många fler resurser där du kan fördjupa dig för att få en heltäckande bild av de funktioner som finns.
- Konfigurationsläsaren - Mer information om AEM Configuration Browser
- Innehållsfragment - Mer information om hur du skapar och hanterar innehållsfragment
- GraphiQL IDE för mer information om hur du använder GraphiQL IDE
- Beständiga frågor för mer information om beständiga frågor
- Stöd för innehållsfragment i AEM Assets HTTP API - Mer information om hur du får åtkomst till AEM direkt via HTTP API, via CRUD-åtgärder (Create, Read, Update, Delete)
- GRAPHQL API - Mer information om hur du levererar innehållsfragment utan problem