お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の
英語版を参照してください。
パスは、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形式でアクセスできます。
たとえば:
配列要素へのアクセス
同様に、配列内の任意の要素に、指定したインデックスまたはインデックス範囲でアクセスする場合の表記は次のとおりです。
-
$.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」]を返します。
ネストされたプロパティへのアクセス
プロセスコンテキストからのデータ取得:$$.(プロセスコンテキスト)
次のJSONパス式を使用すると、コンテキストオブジェクトからデータを抽出できます。ご存じのとおり、コンテキストオブジェクトは、現在の実行や実行時のCircuitの状態に関する詳細情報を含むJSONデータです。詳細については、コンテキストオブジェクトを参照してください。
このパス式は、入力ではなくプロセスコンテキストからデータを抽出するために使用されます。パスの先頭に$$を追加すると、コンテキストオブジェクト内の情報を参照することを指定できます。
構文:
$$.<JSON_Key> (「JSON_Key」を、取得したいコンテキストオブジェクト内の特定の項目名に置き換えます)。
例:
前の状態で次の内容が出力として設定されている場合:
{
'execution_name': 'test-case-1'
}
キー「execution_name」からオブジェクト全体にアクセスするには、JSONパス式$$['execution_name'] または$$.execution_nameを使用します。