---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Testen Sie GraphQL-APIs mit dem GraphQL-Explorer

# Testen Sie GraphQL-APIs mit dem GraphQL-Explorer {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Testen Sie die Abfrage Ihrer GraphQL-APIs mit einem integrierten GraphQL-Testtool.

## Vorbereitungen

Erstellen Sie ein Schema für Ihre GraphQL-API. Weitere Informationen finden Sie unter [Erstellen Sie ein GraphQL-Schema](https://servicenow-prod.fluidtopics.net/aRV7bI0JFxwl~t9Qdg5b~Q#build-graphql-scripted-schema "Erstellen Sie ein GraphQL-Schema, um Daten für GraphQL-Abfragen verfügbar zu machen.").

Durch das Aktivieren introspektiver Abfragen kann GraphQL-Explorer die Schemas in der Instanz im Dokumentations-Explorer und als Vorschläge zur automatischen Vervollständigung anzeigen, was das Auffinden von Abfragen und Mutationen erleichtert. Weitere Informationen finden Sie unter [Aktivieren Sie introspektive Abfragen für GraphQL-Schemata](https://servicenow-prod.fluidtopics.net/QX4kLMMefkslnTdQiFbxvQ "Erkennen Sie die Abfragen und Mutationen, die von Schemas in Ihrer Instanz unterstützt werden, indem Sie die Introspektionsaktivierung aktivieren.").  
Hinweis:  
Verwenden Sie keine introspektiven Abfragen in einer Produktionsumgebung.

Erforderliche Rolle: graphql_schema_admin oder admin

## Warum und wann dieser Vorgang ausgeführt wird

Der GraphQL-Explorer integriert die GraphiQL-IDE in Now Platform. Weitere Informationen zur Schnittstelle finden Sie in der [GraphiQL-Readme](https://github.com/graphql/graphiql/blob/main/packages/graphiql/README.md) -Datei im GraphiQL-Repository GitHub.

## Prozedur

1. Navigieren zu AlleSystem-WebservicesGraphQLGraphQL-Explorer.
2. **Wahlweise:** Wenn Sie die Introspektion aktiviert haben, wählen Sie in der linken Sidebar das Symbol zum Anzeigen des Dokumentations-Explorers ( ![Symbol]()zum Anzeigen des Dokumentations-Explorers ), um verfügbare Abfragen oder Mutationen anzuzeigen und zu suchen.
3. Geben Sie im Editor eine Abfrage für das Schema ein.  
   Schließen Sie sowohl den Anwendungs- als auch den Schema-Namespace in die Abfrage ein. Informationen zu den Richtlinien, die Sie anwenden können, finden Sie unter [Richtlinien und globale Funktionen](https://servicenow-prod.fluidtopics.net/OwAeu7C2~heRy~QkUfZRiA#scripted-graph-ql__section_zdw_rnc_glb).  
   Dieses Beispiel zeigt, wie sowohl der Anwendungs- als auch der Schema-Namespace verwendet werden:
   * Anwendungsnamespace: `x_graph_scope`
   * Schema-Namespace: `Plant`

   {#test-gql-schema__ul_ihg_pzh_dlb}

       query {
         x_graph_scope {
           planet {
             findAll {
               name
               mass
               distance
             }
           }
         }
       }

   In diesem Beispiel wird die Direktive @defer zum Streamen von Ergebnissen für das Feld openedBy nach der ersten Reaktion auf einen Incident verwendet.

       query findIncidents {
         now {
           incident {
             findAll {
               description {
                 displayValue
               }
               ...
               @defer(label: "my-label", if: true) {
                 openedBy {
                   firstName
                   lastName
                 }
               }
             }
           }
         }
       }

4. **Wahlweise:** Wählen Sie unten im Editor Variablen aus, und geben Sie die erforderlichen Variablen ein.
5. Wählen Sie das Symbol „Abfrage ausführen" (Symbol „ ![Abfrage ausführen]()" ).  
   Tipp:  
   Sie können auch eine Tastenkombination verwenden. Um die Liste der verfügbaren Tastenkombinationen anzuzeigen, wählen Sie das Symbol Dialogfeld mit Kurztasten ![öffnen]()(Symbol Dialogfeld mit Kurztasten öffnen).  
   Im rechten Bereich wird das Ergebnis Ihrer Abfrage angezeigt.
6. **Wahlweise:** Wählen Sie das Symbol „Registerkarte hinzufügen" (Symbol „ ![Registerkarte hinzufügen]()" ), um zusätzliche Abfragen auszuführen.

## Nächste Maßnahme

Wenn Sie eine Liste vorheriger Abfragen anzeigen möchten, wählen Sie in der linken Sidebar das Symbol „Verlauf anzeigen" (Symbol „ ![Verlauf anzeigen]()" ).

Um auf Datensatzdaten in einer Komponente zuzugreifen, können Sie eine anwenderdefinierte Komponente erstellen und Ihr geskriptetes GraphQL-Schema aus der Komponente abfragen. Weitere Informationen finden Sie unter [Fragen Sie ein GraphQL-Schema aus einer Komponente ab](https://servicenow-prod.fluidtopics.net/o88BblTl8rr6SltrpCnTCw "Greifen Sie auf Datensatzdaten in einer Komponente zu, indem Sie Ihr geskriptetes GraphQL-Schema abfragen.").

