Använda GraphiQL IDE

En implementering av standarden GraphiQL IDE kan användas med GraphQL API för Adobe Experience Manager (AEM) as a Cloud Service.

The GraphiQL kan du testa och felsöka dina GraphQL-frågor genom att aktivera:

• välj Slutpunkt lämplig för platskonfigurationen som du vill använda för dina frågor
• direkt mata in nya frågor
• skapa och få tillgång till Beständiga frågor
• köra dina frågor för att omedelbart se resultatet
• hantera Frågevariabler
• spara och hantera Beständiga frågor
• publicera eller avpublicera, Beständiga frågor, till antingen Publicera eller Förhandsgranska service, till exempel till/från dev-publish
• se Historik av dina tidigare frågor
• använder Dokumentationsutforskaren om du vill få tillgång till dokumentationen, så att du kan lära dig mer och förstå vilka metoder som finns.

Du kan öppna frågeredigeraren från:

• verktyg > Allmänt > GraphQL Query Editor
• direkt, till exempel http://localhost:4502/aem/graphiql.html

Du kan använda GraphiQL på datorn så att frågor kan begäras av klientprogrammet med hjälp av GET-förfrågningar och för publiceringsfrågor. För produktionsanvändning kan man sedan flytta frågor till produktionsmiljön. Till att börja med måste produktionsförfattaren validera nyskrivet innehåll med frågorna och till sist publicera produktionen för direktkonsumtion.

Markera slutpunkten

Som ett första steg måste du välja Slutpunkt som du vill använda för frågorna. Slutpunkten passar den platskonfiguration som du vill använda för dina frågor.

Det här är tillgängligt i listrutan högst upp till höger.

Skapa och behålla en ny fråga

Du kan ange den nya frågan i redigeraren, som finns i den vänstra panelen, direkt under GraphiQL-logotypen.

Börja skriva - redigeraren:

• använder muspekaren för att visa ytterligare information om element
• innehåller funktioner som syntaxmarkering, automatisk komplettering och automatisk föreslå

Använd Spara som för att behålla den nya frågan.

Uppdaterar din beständiga fråga

Välj frågan som du vill uppdatera i listan i dialogrutan Beständiga frågor panel (längst till vänster).

Frågan visas på redigeringspanelen. Gör de ändringar du behöver och använd sedan Spara för att implementera uppdateringar av den beständiga frågan.

Köra frågor

Du kan köra en ny fråga direkt eller läsa in och köra en beständig fråga. Om du vill läsa in en beständig fråga väljer du den i listan. Frågan visas i redigeringspanelen.

I båda fallen är frågan som visas på redigeringspanelen den fråga som körs när du antingen:

• välj på Kör fråga icon
• använda tangentbordskombinationen Control-Enter

Frågevariabler

Med GraphiQL IDE kan du också hantera Frågevariabler.

Till exempel:

Hantera cache för dina beständiga frågor

Beständiga frågor rekommenderas eftersom de kan cachelagras på dispatcher- och CDN-lagren, vilket i slutänden förbättrar prestanda för det begärande klientprogrammet. Som standard blir cacheminnet för innehållsleveransnätverket (CDN) ogiltigt baserat på en TTL-standardinställning (Time To Live).

Med GraphQL kan du konfigurera HTTP-cache-rubrikerna för att styra de här parametrarna för din enskilda beständiga fråga.

1. The Sidhuvuden är tillgängligt via de tre lodräta prickarna till höger om det beständiga frågenamnet (längst till vänster):

   

2. Om du väljer detta öppnas Cachekonfiguration dialogruta:

   

3. Välj lämplig parameter och justera sedan värdet efter behov:

   • cachekontroll - max-age
     Cacheminnen kan lagra det här innehållet under ett visst antal sekunder. Vanligtvis är det webbläsar-TTL (Time To Live).
   • surrogatkontroll - s-maxage
     Samma som max-age men gäller specifikt för proxy-cacheminnen.
   • surrogatkontroll - inaktuell-while-revalidate
     Cacheminnen kan fortsätta att leverera ett cachelagrat svar efter att det blivit inaktuellt i upp till det angivna antalet sekunder.
   • surrogatkontroll - stale-if-error
     Cacheminnen kan fortsätta att fungera som cachelagrat svar i händelse av ett fel eller ett ursprungsfel i upp till det angivna antalet sekunder.

4. Välj Spara för att behålla ändringarna.

Publicera och förhandsgranska beständiga frågor

När du har valt din beständiga fråga i listan (den vänstra panelen) kan du använda Publicera åtgärd.

Detta aktiverar frågan till den miljö du väljer. Du kan välja Publicera miljö (till exempel dev-publish) eller Förhandsgranska -miljö för enkel åtkomst av dina program vid testning.

Avpublicerar beständiga frågor

När du har valt din beständiga fråga i listan (den vänstra panelen) kan du använda Avpublicera åtgärd.

Detta inaktiverar frågan från den miljö du väljer, antingen Publicera eller Förhandsgranska miljö.

Kopiera URL för direktåtkomst till frågan

The Kopiera URL kan du simulera en fråga genom att kopiera den URL som används för att få direkt åtkomst till den beständiga frågan och se resultatet. Detta kan sedan användas för testning, t.ex. genom att gå till i en webbläsare:

Till exempel:

http://localhost:4502/graphql/execute.json/global/article-list-01

Genom att använda den här URL:en i en webbläsare kan du bekräfta resultatet:

The Kopiera URL är tillgängligt via de tre lodräta prickarna till höger om det beständiga frågenamnet (längst till vänster):

Tar bort beständiga frågor

The Ta bort Du kan även använda det här alternativet via de tre lodräta prickarna till höger om det beständiga frågenamnet (längst till vänster).

Installera den beständiga frågan i produktionen

När du har utvecklat och testat din beständiga fråga med GraphiQL är det sista målet att överför den till produktionsmiljön som kan användas i dina program.

Kortkommandon

Det finns ett urval av kortkommandon som ger direktåtkomst till åtgärdsikoner i den integrerade utvecklingsmiljön:

• Pretify Query: Shift-Control-P
• Kopplingsfråga: Shift-Control-M
• Kör fråga: Control-Enter
• Komplettera automatiskt: Control-Space