Lär dig hur du använder GraphQL API för headless-leverans av Content Fragment-innehåll och AEM Assets REST API för att hantera innehållsfragment.
Nu när du har skapat några innehållsfragment, kan du använda AEM-API:er för att leverera dem utan problem.
Resten av guiden fokuserar på GraphQL åtkomst och leverans av innehållsfragment.
Innan GraphQL API:er kan användas måste en GraphQL-slutpunkt skapas.
Navigera till verktyg, Allmänt väljer GraphQL.
Välj Skapa.
The Skapa ny GraphQL-slutpunkt öppnas. Här kan du ange:
Bekräfta med Skapa.
I konsolen finns en Bana kommer nu att visas baserat på den konfiguration som skapades tidigare. Detta är sökvägen som används för att köra GraphQL-frågor.
/content/cq:graphql/<configuration-name>/endpoint
Mer information om aktivering GraphQL-slutpunkter finns här.
Informationsarkitekterna måste utforma frågor för sina kanalslutpunkter för att kunna leverera innehåll. Dessa frågor behöver i allmänhet bara övervägas en gång per slutpunkt och modell. I den här guiden behöver vi bara skapa en.
GraphiQL är en integrerad utvecklingsmiljö som ingår i AEM. den är tillgänglig/synlig efter att du har konfigurera dina slutpunkter.
Logga in AEM as a Cloud Service och gå till GraphiQL-gränssnittet:
Du kan öppna frågeredigeraren från:
http://localhost:4502/aem/graphiql.html
GraphiQL IDE ä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 i headlessläge som JSON.
Anta att modellen vi skapade anropades person
med fält firstName
, lastName
och position
kan vi skapa en enkel fråga för att hämta innehållet i vårt innehållsfragment.
query
{
personList {
items {
_path
firstName
lastName
position
}
}
}
Skriv frågan i den vänstra panelen.
Klicka på Kör fråga eller använder Ctrl-Enter
snabbtangenten och resultatet visas som JSON i den högra panelen.
Klicka på Dokument på sidans övre högra hörn för att visa sammanhangsberoende dokumentation som hjälper dig att skapa frågor som anpassar sig till dina egna modeller.
GraphQL möjliggör strukturerade frågor som inte bara kan rikta sig till specifika datauppsättningar eller enskilda dataobjekt, utan också kan leverera specifika element i objekten, kapslade resultat, har stöd för frågevariabler och mycket annat.
GraphQL kan undvika både iterativa API-begäranden och överleverans, och i stället tillåter massleverans av exakt det som behövs för återgivning som svar på en enda API-fråga. Den resulterande JSON kan användas för att leverera data till andra webbplatser eller appar.
Så ja! Ni har nu en grundläggande förståelse för innehållshantering utan problem i AEM. Det finns förstås många fler resurser där du kan fördjupa dig i en heltäckande bild av de funktioner som finns.