---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GraphQL Explorer を使用して GraphQL API をテストする

# GraphQL Explorer を使用して GraphQL API をテストする {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：2分

統合された GraphQL テストツールを使用して、GraphQL API をテストクエリします。

## 始める前に

GraphQL API のスキーマを作成します。詳細については、「[GraphQL スキーマの作成](https://servicenow-prod.fluidtopics.net/XmUgFJ8qYAwbYAaFEVlfkg#build-graphql-scripted-schema "GraphQL スキーマを作成して、GraphQL クエリでデータを使用できるようにします。")」を参照してください。

イントロスペクションクエリを有効にすると、GraphQL Explorer はインスタンスのスキーマをドキュメントエクスプローラーに表示し、オートコンプリート提案として表示できるため、クエリとミューテーションを簡単に見つけることができます。詳細については、「[GraphQL スキーマのイントロスペクションクエリを有効にする](https://servicenow-prod.fluidtopics.net/zkqfkKLvfB4c~WJ_I1dI~g "イントロスペクションを有効にして、インスタンスのスキーマでサポートされているクエリとミューテーションを検出します。")」を参照してください。  
注:  
本番環境ではイントロスペクションクエリを使用しないでください。

必要なロール:graphql_schema_admin または admin

## このタスクについて

GraphQL エクスプローラーは、GraphiQL IDE を Now Platformに統合します。インターフェイスの詳細については、GraphiQL GitHubリポジトリの [GraphiQL の readme](https://github.com/graphql/graphiql/blob/main/packages/graphiql/README.md) を参照してください。

## 手順

1. 移動先 すべてSystem Web ServicesGraphQLGraphQL エクスプローラー.
2. **オプション:** イントロスペクションを有効にした場合は、左側のサイドバーで \[ドキュメントエクスプローラーを表示\] アイコン ( \[ ![ドキュメントエクスプローラーを表示\] アイコン]()) を選択して、使用可能なクエリまたはミューテーションを表示および検索します。
3. エディターで、スキーマへのクエリーを入力します。  
   アプリケーションとスキーマの両方の名前空間をクエリに含めます。適用できるディレクティブの詳細については、「 [ディレクティブとグローバル関数](https://servicenow-prod.fluidtopics.net/6WTXO0Z_d8_ld2Kr~1xX9Q#scripted-graph-ql__section_zdw_rnc_glb)」を参照してください。  
   この例では、次のアプリケーションとスキーマの両方の名前空間の使用を示しています。
   * アプリケーション名前空間：`x_graph_scope`
   * スキーマ名前空間：`planet`

   {#test-gql-schema__ul_ihg_pzh_dlb}

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

   この例は、@defer ディレクティブを使用して、最初のインシデント応答の後に \[openedBy\] フィールドの結果をストリーミングする方法を示しています。

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

4. **オプション:** エディターの下部で \[変数 \] を選択し、必要な変数を入力します。
5. \[クエリを実行\] アイコン ( \[ ![クエリを実行\] アイコン]()) を選択します。  
   ヒント:  
   キーボードショートカットを使用することもできます。使用可能なキーボードショートカットのリストを表示するには、\[ショートカットキーダイアログを開く (Open short keys dialog)\] アイコン ( \[ ![ショートカットキーダイアログを開く (Open short keys dialog)\] アイコン]()) を選択します。  
   クエリの結果が右ペインに返されます。
6. **オプション:** \[タブを追加\] アイコン ( \[ ![タブを追加\] アイコン]()) を選択して、追加のクエリを実行します。

## 次のタスク

以前のクエリのリストを表示する必要がある場合は、左側のサイドバーで \[履歴を表示\] アイコン ( ![\[履歴を表示\] アイコン]()) を選択します。

コンポーネント内のレコードデータにアクセスするには、カスタムコンポーネントを作成し、そのコンポーネントからスクリプト化された GraphQL スキーマをクエリします。詳細については、「[コンポーネントからの GraphQL スキーマのクエリ](https://servicenow-prod.fluidtopics.net/u4E8C_tl47HTj_FDnzlp8g "スクリプト化された GraphQL スキーマを照会して、コンポーネント内のレコードデータにアクセスします。")」を参照してください。