JSON Path

JSON Path

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

パスは、JSONオブジェクト内の特定の部分やコンポーネントを特定するために使用されます。これらのパスは「$」記号で始まり、JSONPath構文に従います。Input Path、Output Path、Result Pathで渡されるJSONオブジェクト内の特定の要素や値に属性を指定してアクセスするために使用されます。JSONデータ内の目的の場所(要素/値)を見つけるために、ナビゲーションシステムを使うようなものです。

JSONパスの使用に関するクイックガイド   

このセクションでは、JSONパスを使用してJSONオブジェクト内を移動し、特定のデータを抽出する方法について説明します。次のJSONデータを入力として使用する、従業員オンボーディングプロセスの例を使用します。

{
'employee_id': 'E12345',
'name': 'John Doe',
'department': 'Engineering',
'onboarding': {
'start_date': '2023-08-01',
'training_programs': [
'Orientation',
'Technical Skills',
'Company Policies'
],
'completed': true
}
}


オブジェクトプロパティへのアクセス 

JSONオブジェクト内の「propertyName」などのプロパティに割り当てられた値には、$.property_name形式でアクセスできます。

たとえば:

  • $.employee_idは「E12345」を返します。

  • $.name は「John Doe」を返します

  • $.departmentは「Engineering」を返します。


配列要素へのアクセス 

同様に、配列内の任意の要素に、指定したインデックスまたはインデックス範囲でアクセスする場合の表記は次のとおりです
  • $.array_name[index] - 指定したインデックスにある配列内の要素にアクセスします。
  • $.array_name[start:end]- 配列内のインデックス範囲(startからendまで)の要素にアクセスします。スライス表記[start:end]は、インデックスstartから開始し、インデックスendの要素は含めず、その直前までの要素を含めることを指定します。
  • $.array_name[start,count] - 配列内の要素にアクセスします。「start」は開始インデックスを示し、「count」は取得する要素数を指定します。
  • 例:
    • $.onboarding.training_programsは配列[「Orientation」、「Technical Skills」、「Company Policies」]を返します。
    • $.onboarding.training_programs[0:2] は[「Orientation」、「Technical Skills」]を返します。この場合、startは0、endは2です。つまり、インデックス0と1の要素を含め、インデックス2の要素は含めません。
    • $.onboarding.training_programs[1,2] は、インデックス1とインデックス2にある[「Technical Skills」、「Company Policies」]を返します。
 

ネストされたプロパティへのアクセス     

  • $.outer_property_name.inner_property_name - 別のJSONオブジェクト内にネストされたJSONオブジェクトのプロパティにアクセスします。

  • 例:

    • $.onboarding.start_dateは「2023-08-01」を取得します。
    • $.onboarding.completedは真偽値「true」を返します。
JSONパスの高度な使用方法やその他のフィルター機能については、こちらを参照してください

プロセスコンテキストからのデータ取得:$$.(プロセスコンテキスト)  

次のJSONパス式を使用すると、コンテキストオブジェクトからデータを抽出できます。ご存じのとおり、コンテキストオブジェクトは、現在の実行や実行時のCircuitの状態に関する詳細情報を含むJSONデータです。詳細については、コンテキストオブジェクトを参照してください。

このパス式は、入力ではなくプロセスコンテキストからデータを抽出するために使用されます。パスの先頭に$$を追加すると、コンテキストオブジェクト内の情報を参照することを指定できます。


構文:
$$.<JSON_Key> (「JSON_Key」を、取得したいコンテキストオブジェクト内の特定の項目名に置き換えます)。

例:
前の状態で次の内容が出力として設定されている場合:

{
'execution_name': 'test-case-1'
}

キー「execution_name」からオブジェクト全体にアクセスするには、JSONパス式$$['execution_name'] または$$.execution_nameを使用します。





次へInput Path
    • Related Articles

    • JSON変換

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 JSON変換ステートでは、さまざまなファイル形式のデータをJSONに変換し、サーキット内でさらに処理できます。 利用可能なステート。 JSONからJSONへの変換 CSVからJSONへの変換 XMLからJSONへの変換 YAMLからJSONへの変換 XLSXからJSONへの変換 ...
    • 入力パス

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Input Pathを使用すると、状態に渡される実際の入力をフィルターし、制御できます。JSONPath表記を使用して、Input Pathを([ビルダー表示]または[コード表示]で)定義することで、JSON入力の一部を選択し、状態内の処理に使用できます。 ...
    • パス

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Pass状態は、指定した次の状態にデータを転送するために使用します。入力データをそのまま渡すことも、処理中に必要に応じて追加情報を含めることもできます。つまり、この状態では、次の Input path、 Output path、またはResult path ...
    • 結果セレクターと結果パス

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Result PathとResult Selectorは、実行が成功したときにステートの結果から動的データを抽出するために使用します。 Result Selector Result ...
    • 出力パス

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 出力パスでは、ステートの出力の一部を選択して、処理のために次のステートに渡すことができ、 JSON出力から不要なオブジェクトを除外できます。出力パスを指定しない場合、JSONノード全体(ステート入力、ステート結果、結果パスによって決定)がステート出力として次のステートに送信されます。 ...