GraphQL - カスタムアクション

このアクションは、任意のカスタムGraphQL操作を実行するために使用できます。

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

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

• 変数
• フラグメント
• インラインフラグメント
• ディレクティブ
• エイリアス
• 複数の操作ドキュメント

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

入力フィールド

最低限、GraphQLドキュメントを提供する必要があります。これは有効なGraphQLクエリまたはミューテーションである必要があります。

以下の例では、GraphQLドキュメントは特定のIDを持つレコードの詳細を取得する単純なクエリです。このIDはクエリ内でハードコードされています。

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

IDをハードコードする代わりに、レシピのデータピルを使用してIDを注入することができます。

レコードIDは、ステップ2の出力からのRole Idデータピルによって設定されます。

データピルを使用したカスタムクエリ

また、GraphQLドキュメント内で変数を定義し、ユーザーに値を入力フィールドを介して提供させることもできます。

例えば、$role_id変数の値を提供するためにRole IDを入力します。

変数を使用したカスタムクエリ

もしGraphQLドキュメントに複数のクエリが含まれている場合、実行する操作を選択する必要があります。

以下のドキュメントには、RoleWithTagsとRoleWithoutTagsというクエリが含まれており、実行する操作はRole without tagsに設定されています。

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

出力フィールド

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

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