• イントロスペクションを通じてクエリに使用できるフィールドとオブジェクトを検出します。
• コンポーネントから必要な正確なデータをクエリします。
• REST 要求に対して複数のエンドポイントを使用するのではなく、単一の API から考えられる複数のクエリを管理します。
• スキーマを公開して、サードパーティシステムと統合します。
• コンポーネントから GraphQL クエリを生成し、応答を処理します。

• スキーマを作成するための GraphQL ナレッジ。
• API 動作を定義するための JavaScript の知識。
• Web コンポーネントの概念に関する一般的な知識。
• レコードデータを消費するカスタム ワークスペース コンポーネント。
• スキーマで公開する ServiceNow データモデルについて理解する。
• GlideRecord ナレッジを使用して、フィールドをリゾルバースクリプトのレコードデータにマッピングします。

GraphQL スキーマ定義言語 (SDL)

GraphQL クエリで使用できるフィールドの構造とデータ型を定義します。GraphQL スクリプトスキーマ [sys_graphql_schema] テーブルの スキーマ スクリプトフィールドを使用して、SDL を定義できます。SDL は、クエリ操作とミューテーション操作のみをサポートしています。

リゾルバー

各フィールドから返されるデータを定義します。[GraphQL スクリプトスキーマ] フォームの [GraphQL スクリプトリゾルバー] 関連リストで、各フィールドのリゾルバーを定義できます。

タイプリゾルバー

インターフェイスとユニオンを具体的な GraphQL タイプに解決します。たとえば、 インシデント タイプと 問題 タイプのユニオンを定義することができます。typeresolver スクリプトを使用して、いつどのものを返すかを定義します。[GraphQL スクリプトスキーマ] フォームの [GraphQL スクリプト型リゾルバー] 関連リストでタイプリゾルバーを定義できます。

リゾルバーマッピング

リゾルバーをスキーマ内のフィールドにマッピングします。リゾルバーマッピングは、[GraphQL スクリプトスキーマ] フォームの [GraphQL スクリプト化されたリゾルバーマッピング] 関連リストで定義できます。

• サブスクリプション操作
• カスタムスカラータイプ

アプリケーション名前空間

カスタムアプリケーションの名前空間。アプリケーション名前空間の詳細については、「 アプリケーションスコープ」を参照してください。

スキーマ名前空間

すべてのクエリが一意であることを確認するためのスキーマの名前空間。1 つのアプリケーションに複数のスキーマ名前空間を含めることができます。

• アプリケーション名前空間: x_graph_scope
• スキーマ名前空間: 惑星

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

@source スキーマディレクティブ

GraphQL フィールドを親オブジェクトのプロパティ値にマッピングします。フィールドに個別のリゾルバースクリプトがある場合、システムは親オブジェクトの代わりにそのフィールドが解決されるレコードを使用します。

スキーマスクリプトで @source ディレクティブを使用します。

@defer クエリディレクティブ

GraphQL フラグメントの処理をクエリの後半まで保留します。このクエリディレクティブを使用して、フラグメント内の応答が遅いフィールドのデータの返却を遅らせます。保留されたフラグメントのフィールド結果をマルチパート応答としてストリーミングします。

注:

@defer ディレクティブを使用するには、GraphQL クライアントがマルチパート/混合 HTTP ヘッダーを受け入れる必要があります。たとえば、HTTP ヘッダーを Accept: multipart/mixed; boundary="-" に設定します。

@defer ディレクティブを使用して、ユーザーのインタラクション時間を短縮します。 このクエリディレクティブを無差別に適用すると、パフォーマンスが低下する可能性があるため、避けてください。パフォーマンステストを実施して、パフォーマンスを向上させるために保留できるフィールドを決定します。

リゾルバー関数

これらの関数は、グローバル env オブジェクトで使用できます。

• getArguments():前のフィールドの引数を返します。
• getSource():親オブジェクトを返します。

リゾルバースクリプトで使用します。

Typeresolver 関数

これらの関数は、グローバル env オブジェクトで使用できます。

• getArguments():前のフィールドの引数を返します。
• getObject(): 親オブジェクトを返します。
• getTypeName():インターフェイスまたは Union タイプの名前を返します。

タイプリゾルバースクリプトで使用します。