GraphQL エクスプローラーで GraphQL API をテストする

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

始める前に

GraphQL API のスキーマを作成します。詳細については、「GraphQL スキーマの作成」を参照してください。

イントロスペクションクエリを有効にすると、GraphQL エクスプローラーは、ドキュメントエクスプローラーのインスタンスのスキーマをオートコンプリート提案として表示できるため、クエリとミューテーションの検索が容易になります。詳細については、「GraphQL スキーマのイントロスペクションクエリを有効にする」を参照してください。

注:

本番環境ではイントロスペクションクエリを使用しないでください。

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

このタスクについて

GraphQL エクスプローラーは、GraphiQL IDE を Now Platformに統合します。インターフェイスの詳細については、GraphiQL GitHubリポジトリの GraphiQL readme を参照してください。

手順

1. 次のように移動する。 All (すべて) > システム Web サービス > GraphQL > GraphQL エクスプローラー.
2. オプション: イントロスペクションを有効にした場合は、左側のサイドバーで [ドキュメントエクスプローラーを表示] アイコン ( ) を選択して、利用可能なクエリーまたはミューテーションを表示および検索します。
3. エディターで、スキーマへのクエリを入力します。

   アプリケーションとスキーマの両方の名前空間をクエリに含めます。適用できるディレクティブの詳細については、「 ディレクティブとグローバル関数」を参照してください。

   この例では、次のアプリケーションとスキーマの両方の名前空間の使用を示しています。

   • アプリケーション名前空間：x_graph_scope
   • スキーマ名前空間：planet

   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)] アイコン (短い ) を選択します。
   クエリの結果が右ペインに表示されます。
6. オプション: [タブの追加] アイコン ( ) を選択して、追加のクエリを実行します。

次のタスク

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

コンポーネント内のレコードデータにアクセスするには、カスタムコンポーネントを作成し、コンポーネントからスクリプト化された GraphQL スキーマのクエリを実行します。詳細については、「コンポーネントからの GraphQL スキーマのクエリ」を参照してください。