GraphQL - カスタムアクション

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

このアクションを使用すると、任意のカスタムGraphQLオペレーションを実行できます。

これは、レシピで再利用したい既存のGraphQLクエリまたはミューテーションがある場合に便利です。

また、次のようなGraphQLクエリ言語の高度な機能も使用できます。

  • 変数
  • フラグメント
  • インラインフラグメント
  • ディレクティブ
  • エイリアス
  • 複数オペレーションのドキュメント

これらの機能の詳細については、GraphQLドキュメントを参照してください。

入力

少なくとも、GraphQLドキュメントを指定する必要があります。 有効なGraphQLクエリまたはミューテーションである必要があります。

次の例では、GraphQLドキュメントは、クエリにハードコーディングされた特定のIDを持つレコードの詳細を取得するシンプルなクエリです。

シンプルなカスタムクエリ シンプルなカスタムクエリ

IDをハードコーディングする代わりに、レシピのデータピルを使用してIDを挿入できます。

レコードIDはロールIDStep 2データピルによって設定されます。

データピルを含むカスタムクエリ データピルを含むカスタムクエリ

または、GraphQLドキュメントで変数を定義し、ユーザーが入力フィールドを通じて値を指定できるようにすることもできます。

たとえば、$role_id変数の値を指定するには、ロールIDを入力します。

変数を含むカスタムクエリ 変数を含むカスタムクエリ

GraphQLドキュメントに複数のクエリが含まれている場合は、実行するオペレーションを選択する必要があります。

次のドキュメントにはRoleWithTagsおよびRoleWithoutTagsクエリが含まれており、実行するオペレーションRole without tagsに設定されています。

複数のクエリを含むカスタムクエリ 複数のクエリを含むカスタムクエリ)

出力

出力フィールドは、クエリで指定されたフィールドによって決まります。 後続のステップで使用するには、データツリーから関連するデータピルをマッピングします。

GraphQLカスタムアクションの出力フィールドの例 GraphQLカスタムアクションの出力フィールドの例

Last updated: