製品アップデートステータスページWorkato Academy
English
日本語
トライアルを開始
データオーケストレーション
データ変換
JSON Transformations by Workato

JSON Transformations by Workato - JSON変換アクション ​

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

JSON変換アクションを使用すると、jq式を使用して1つ以上のJSON入力を変換できます。 結果は、構造化JSON、CSVデータ、コンテンツストリーム、または下流ステップで使用するためにFileStorageに保存されたファイルとして形式設定できます。

JSON変換アクションは、タイムアウトエラーが発生することなくデータを一括で変換できる長時間アクションです。

アクションを設定するには、次の手順を実行します。

1

トリガーを設定した後、コネクターとしてJSON Transformations by Workatoを検索して選択します。

JSON Transformations by Workatoを選択JSON Transformations by Workatoを選択

2

JSON変換アクションを選択します。

3

データソースを追加をクリックして、ソースを定義します。

データソースを追加データソースを追加

1

データソース名を入力します。 この名前は、jq式で入力を参照するためのエイリアスとして使用されます。 たとえば、input1またはordersを使用します。

2

データをjqに渡す方法を定義する入力形式を選択します。

  • 入力: 標準JSONオブジェクト（.）を渡します。
  • Rawファイル: 生のプレーンテキストを渡します。
  • Slurpファイル: 複数のJSONオブジェクトを単一の配列（jq -s）として読み込みます。
3

ドロップダウンメニューからデータソースタイプを選択します。

  • コンテンツストリーム: 上流のトリガーまたはアクションがJSON入力をコンテンツストリームとして渡す場合に使用します。
  • FileStorageファイル: JSONファイルがWorkato FileStorageに保存されている場合に使用します。
4

選択したデータソースタイプに基づいて、必須フィールドを入力します。

  • コンテンツストリームを選択した場合は、生のJSONを含むデータピルを使用します。 返されたリストまたはレコードを有効なJSON文字列に変換するには、.to_jsonを適用します。 これをコンテンツ入力ストリームフィールドに貼り付けます。
  • FileStorageファイルを選択した場合は、FileStorageファイルパスフィールドに完全なファイルパスを入力します。 例: samplepath/filename.json。
5

任意です。 追加の入力を定義するには、もう一度データソースを追加をクリックします。

4

jq式を入力します。 この式は、入力データを変換する方法を定義します。

jq式は、JSONデータを抽出、フィルター、再形成する言語であるjqで記述された軽量クエリです。 キーの参照、配列のループ処理、値の形式設定、または構造のCSVへの変換を実行できます。 例: .items[] | {id, name}。

jq構文の詳細を確認し、例を参照するには、jqマニュアルを参照してください。

5

Slurpモード（jq -s）を使用してすべての入力を単一の配列としてjqに渡すには、入力をまとめて処理をはいに設定します。 これは、入力形式のソースにのみ適用されます。

6

出力セクションを展開し、結果の返され方を定義する出力タイプを選択します。 下流で使用するためにストリーミング可能なデータピルを返すには、コンテンツストリームを選択します。 結果をWorkato FileStorageに保存するには、FileStorageファイルを選択します。 最大50 MBの構造化JSONをインラインで返すには、JSONドキュメントを選択します。

7

選択した出力タイプに基づいて表示される出力フィールドを設定します。

出力 ​

出力フィールドは、選択した出力タイプに基づいて動的に読み込まれます。 たとえば、コンテンツストリームを選択した場合、出力には次が含まれます。

出力フィールド説明
内容変換されたJSONコンテンツ。ストリームとして返されます。
コンテンツサイズ（バイト）出力のサイズ（バイト単位）。
変換実行時間jq変換の実行にかかった時間。
合計処理時間アクション全体の完了にかかった時間。

最終更新日: