Komma åt och leverera innehållsfragment Headless Quick Start Guide

Senaste uppdatering: 2023-08-16

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?

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.

Leverera ett innehållsfragment med GraphQL

Informationsarkitekterna måste utforma frågor så att deras kanalslutpunkter kan leverera innehåll. Dessa frågor måste bara beaktas en gång per slutpunkt och modell. För att komma igång-guiden behöver du bara skapa en.

  1. Logga in AEM och få åtkomst till GraphiQL-gränssnitt:

    • Till exempel: http://<host>:<port>/aem/graphiql.html.
  2. 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.

      GraphiQL editor

  3. Anta att modellen du skapade anropades person med fält firstName, lastNameoch positionkan du skapa en enkel fråga som hämtar innehållet i innehållsfragmentet.

    query
    {
      personList {
        items {
          _path
          firstName
          lastName
          position
        }
      }
    }
    
  4. Skriv frågan i den vänstra panelen.

  5. Klicka på Kör fråga (högerpil) eller använd Ctrl-Enter snabbtangenten och resultatet visas som JSON i den högra panelen.
    GraphiQL-resultat

  6. Klicka på:

    • 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.

      GraphiQL-dokumentation

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

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.

På denna sida