GraphiQL IDE gebruiken graphiql-ide

Een implementatie van standaard GraphiQLwinde is beschikbaar voor gebruik met GraphQL API van Adobe Experience Manager (AEM).

NOTE
GraphiQL is inbegrepen in alle milieu's van AEM (maar zal slechts toegankelijk/zichtbaar zijn wanneer u uw eindpunten vormt).
In vorige versies was een pakket nodig om de GraphiQL IDE te installeren. Als u deze installatie hebt, kunt u deze nu verwijderen.
NOTE
U moet gevormd hebben uw eindpuntenin configuratiebrowseralvorens IDE GraphiQL te gebruiken.

Het GraphiQL hulpmiddel laat u testen en zuivert uw vragen van GraphQL door u toe te laten:

  • selecteer het Eindpunt aangewezen aan de configuratie van Plaatsen die u voor uw vragen wilt gebruiken
  • direct nieuwe query's invoeren
  • creeer, en toegang, Verlengde Vragen
  • stel uw vragen in werking om de resultaten onmiddellijk te zien
  • beheer Variabelen van de Vraag
  • sparen, en beheer Verlengde Vragen
  • publiceer, of unpublish, Verlengde Vragen (bijvoorbeeld, aan/van dev-publish)
  • zie de Geschiedenis van uw vorige vragen
  • gebruik de Ontdekkingsreiziger van de Documentatie om tot de documentatie toegang te hebben; het helpen u leren en begrijpen welke methodes beschikbaar zijn.

U kunt tot de vraagredacteur van één van beiden toegang hebben:

  • Hulpmiddelen > Algemeen > de Redacteur van de Vraag van GraphQL
  • direct; bijvoorbeeld http://localhost:4502/aem/graphiql.html

GraphiQL Interface

U kunt GraphiQL op uw systeem gebruiken zodat de vragen door uw cliënttoepassing kunnen worden gevraagd gebruikend verzoeken, en voor het publiceren van vragen. Voor productiegebruik, kunt u uw vragen dan bewegen aan uw productiemilieu. Aanvankelijk aan productieauteur voor het bevestigen van onlangs authored inhoud met de vragen, en productie publiceren voor levende consumptie.

Het selecteren van uw eindpunt selecting-endpoint

Als eerste stap moet u het Eindpunt selecteren dat u voor de vragen wilt gebruiken. Het eindpunt is aangewezen aan de configuratie van Plaatsen die u voor uw vragen wilt gebruiken.

Dit is beschikbaar in de vervolgkeuzelijst rechtsboven.

Een nieuwe query maken en doorgaan creating-new-query

U kunt uw nieuwe vraag in de redacteur ingaan - die in het midden-linkerpaneel, direct onder het logo GraphiQL is.

NOTE
Als u reeds een voortgezette vraag hebt geselecteerd, en het tonen in het redacteurspaneel, dan uitgezocht + (naast Gepersisteerde Vragen) om de redacteur klaar voor uw nieuwe vraag leeg te maken.

Begin gewoon te typen, de redacteur ook:

  • gebruikt mouseOver om aanvullende informatie over elementen weer te geven
  • biedt functies zoals syntaxismarkering, automatisch aanvullen en automatisch voorstellen
NOTE
GraphQL-query's beginnen doorgaans met een { -teken.
Lijnen die beginnen met een # worden genegeerd.

Gebruik sparen als om uw nieuwe vraag voort te zetten.

Uw voortgezette query bijwerken updating-persisted-query

Selecteer de vraag u van de lijst in het Blijven paneel van Vragen (ver links) wilt bijwerken.

De vraag wordt getoond in het redacteurspaneel. Breng om het even welke veranderingen aan u nodig hebt, dan gebruik sparen om uw updates aan de persisted vraag vast te leggen.

Query's uitvoeren running-queries

U kunt een nieuwe vraag in werking stellen onmiddellijk, of u kunt een voortgezette vraag laden en in werking stellen. Als u een voortgezette query wilt laden, selecteert u deze in de lijst. De query wordt weergegeven in het deelvenster Editor.

In beide gevallen is de query die wordt weergegeven in het editorpaneel de query die wordt uitgevoerd wanneer u een van de volgende twee doet:

  • klik op het Uitvoeren pictogram van de Vraag
  • de toetsenbordcombinatie gebruiken Control-Enter

Query-variabelen query-variables

GrahiQL winde laat u ook uw Variabelen van de Vraagbeheren.

Bijvoorbeeld:

de Variabelen van GraphQL

Het publiceren van voortgeduurde vragen publishing-persisted-queries

Zodra u uw voortgezette vraagvan de lijst (linkerpaneel) hebt geselecteerd kunt u Publish gebruiken en unpublish acties. Hierdoor worden ze geactiveerd naar uw publicatieomgeving (bijvoorbeeld dev-publish ), zodat uw toepassingen ze gemakkelijk kunnen gebruiken tijdens het testen.

NOTE
De definitie van het cache Time To Live {"cache-control":"parameter":value} van de aanblijvende query heeft een standaardwaarde van 2 uur (7200 seconden).

URL kopiëren om rechtstreeks toegang te krijgen tot de query copy-url

De optie van het Exemplaar URL laat u een vraag simuleren, door URL te kopiëren die wordt gebruikt om tot de voortgeduurde vraag direct toegang te hebben en de resultaten te zien. Dit kan vervolgens voor testdoeleinden worden gebruikt, bijvoorbeeld door toegang te krijgen tot een browser:

Bijvoorbeeld:

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

Door deze URL in browser te gebruiken, kunt u de resultaten bevestigen:

GraphiQL - Exemplaar URL

De optie van het Exemplaar URL is toegankelijk via de drie verticale punten rechts van de voortgeduurde vraagnaam (ver linkerpaneel):

GraphiQL - Exemplaar URL

Doorlopende query's verwijderen deleting-persisted-queries

De schrapping optie is ook toegankelijk via de drie verticale punten rechts van de voortgeduurde vraagnaam (ver linkerpaneel).

Uw blijvende query installeren op productie installing-persisted-query-production

Na het ontwikkelen van en het testen van uw persistente vraag met GraphiQL, is het definitieve doel het over te brengen naar uw productiemilieuvoor gebruik door uw toepassingen.

Sneltoetsen keyboard-shortcuts

Er zijn een selectie van toetsenbordkortere weg die directe toegang tot actiepictogrammen in winde verlenen:

  • Query uitvoeren: Shift-Control-P
  • Query samenvoegen: Shift-Control-M
  • Query uitvoeren: Control-Enter
  • Automatisch aanvullen: Control-Space
NOTE
Op sommige toetsenborden wordt de Control -toets gelabeld als Ctrl .
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2