JSON操作：JSON Operationsコンポーネント（AI Flowi Workflow）
JSON操作を行うJSON Operationsは、JSONオブジェクト内のデータを変更または選択します。DataまたはJSONを出力するソースの後、オブジェクトの構造変更、フィルタリング、確認が必要なステップの前に配置します。
以下の入力リファレンスは、AI Flowi Workflow 1.9.2のカタログに基づきます。公開中のバリデーターテンプレートには、そのJQ設定の本番テスト記録があります。ただし、その記録はすべての操作を検証したものではありません。
執筆：Ai Flowi · 公開日
入力
| 名前 | 型 | 必須 | 対応する入力型 | 説明 |
|---|---|---|---|---|
append_update_data | dict | いいえ | 記載なし | Append or Update操作で使用する辞書です。 |
data | other | はい | Data, JSON | 処理対象のオブジェクトです。この必須入力は、DataまたはJSONの接続を受け付けます。 |
filter_key | str | いいえ | Message | フィルタリングに使用するキーです。エクスポートにはキーパスの構文が定義されていません。 |
filter_values | dict | いいえ | 記載なし | Filter Values操作で使用する値の辞書です。 |
mapped_json_display | str | いいえ | Message | マッピング済みJSONの表示を示す名前のテキストフィールドです。書き込める形式と実行時の役割は、カタログでは説明されていません。 |
operations | sortableList | いいえ | 記載なし | 以下に示すJSON操作を選択し、順序を並べ替えられます。 |
operator | str | いいえ | 記載なし | 比較方法を選びます。選択肢はequals、not equals、contains、starts with、ends withです。 |
query | str | いいえ | Message | 検証済みテンプレートのJQ式です。JQ Expressionを使用する際は、このフィールドを表示した状態にしてください。 |
remove_keys_input | str | いいえ | Message | Remove Keysで対象のキーを指定するテキストです。このエクスポートには、区切り文字の形式が示されていません。 |
rename_keys_input | dict | いいえ | 記載なし | Rename Keysで使用する辞書です。カタログには、マッピングの方向が定義されていません。 |
select_keys_input | str | いいえ | Message | Select Keysで対象のキーを指定するテキストです。ここでは、リストの正確な構文は記載されていません。 |
selected_key | str | いいえ | 記載なし | キーを選択するフィールドです。エクスポートされた選択肢のリストは空です。 |
operationsの選択肢は、Select Keys、Literal Eval、Combine、Filter Values、Append or Update、Remove Keys、Rename Keys、Path Selection、JQ Expressionです。「必須ではない」という指定はカタログのメタデータであり、個々の操作に必要な設定を省略しても動作するという保証ではありません。記録されたJQの失敗では、空でないqueryが必要でした。
出力
| 名前 | 表示名 | 型 | 用途 |
|---|---|---|---|
data_output | JSON | JSON | 処理結果のオブジェクトをJSON出力から取得できます。後続のアクションに接続する前に、その構造を確認してください。 |
JSON Operationsを使用する場合
既存のオブジェクトのキーや値を処理する場合に使用します。リンク先のテンプレートでは、検証にJQを使用しています。入力がテキストとしてエンコードされたJSONの場合は、 JSON String Parser に、オブジェクトを含む文字列からJSONへの変換が記載されています。
別のコンポーネントを選ぶ場合
別々に接続した値を、設定可能なキーの下にまとめる場合は、 JSON Object Builderを確認してください。テンプレートを使ってテキストを抽出する場合は、 Parserを選びます。検証後にVerifiedとRejectedのどちらへ進むかを振り分ける場合は、 Verification Routerを使用します。カタログの説明では、フィールドを変更せずに検証結果全体を振り分けるとされています。
検証済みテンプレートと結果の記録
検証済みテンプレート：Webhook入力を検証し、200または422を返す。そのステータスには、 28件中28件が成功
と記録されています。AI Flowi Workflow 1.9.2を使用し、2026年10月9日に本番環境で実施されています。
本番実行では、正規化した入力を返す200レスポンス、または理由を含む422レスポンスが返されました。
このテンプレートでは、Universal Webhookのリクエストデータを dataに接続し、 operations でJQ Expressionを選択して、公開されている検証式を queryに指定します。JSON出力はVerification Routerに接続します。クエリ全体とレスポンスの分岐は、リンク先のテンプレートを参照してください。ここでは、新たな設定をテスト結果として紹介しているわけではありません。
このテンプレートは、4つの必須テキストフィールドを検証し、前後の空白を除去して、メールアドレス内のASCII英字を小文字にします。記録には、インポートしたコピーの検証やノード課金の実測は含まれていません。また、200レスポンスが確認するのは、検証が成功したことだけです。
制約
- JQフィールドは表示した状態にしてください。提供されたWebhookからGoogle Sheetsへのチュートリアルでは、クエリが非表示の場合に、HTTP 500と「JSON Query is required and cannot be blank」（JSONクエリは必須で、空にはできません）というエラーが記録されています。
- そのチュートリアルのSheetsへのマッピングでは、以前のエディターテストで、リストだけの結果が{"result": …}で包まれ、Append Rowsで失敗しました。valuesフィールドを持つオブジェクトは、包まれずにそのまま渡されました。リストがそのまま渡されると思い込まず、後続ステップが要求するデータ形式に合わせてください。
- カタログには操作名が記載されていますが、すべての操作について引数の詳細な形式が示されているわけではありません。フィールド名から、キーリストの区切り文字や名前変更マップの方向を推測しないでください。
- 28件のテスト結果が対象としているのは、バリデーターテンプレートのJQ式と設定済みの経路です。Literal Eval、Combine、その他の操作が本番テスト済みであることを示すものではありません。
- Verification Routerは検証結果を振り分けますが、検証済みバリデーターの実行時例外を捕捉するものではありません。アカウントに関する障害やタイムアウトでは、プラットフォームのエラーが返る場合があります。
JQの表示状態による失敗とリストのラップについての記録の出典： Sheetsチュートリアルの制約 および 以前のエディターテスト。
関連コンポーネント
JSON String Parser · JSON Object Builder · Verification Router · Parser
ノードの使用量
プラン：Goは年払いで月額USD8から（月払いUSD10）、Plusは月額USD16から（月払いUSD20）、Pro 100は月額USD80から（月払いUSD100）、Pro 200は月額USD160から（月払いUSD200）、Pro 500は月額USD400から（月払いUSD500）。毎月5,000～250,000 Flowi Tokensが含まれ、追加購入も可能です。ノード実行1回につき1トークン。サードパーティのAPIとモデルの利用料金は含まれません。
参照元
コンポーネントカタログ: processing.DataOperations、AI Flowi Workflow 1.9.2、エクスポート日：2026年10月9日。