JSONファイルのソース。

上流ワークアイテムから結果を選択する際に使用するデータタグ。

JSONファイルのパス。

ここには、実行したい取得オペレーションを指定します。

Deserialize Work Item:

このオペレーションは、指定したJSONファイルからワークアイテムをデシリアライズします。 そのJSONファイルは、例えばJSON Outputから生成されるファイルのように、シリアライズ化されたワークアイテムファイルとしてフォーマットされている必要があります。

このノードの入力である上流のワークアイテム上の既存アトリビュートが.jsonファイル内のワークアイテムにも含まれている場合の挙動を決めます。 デフォルトでは、このノードは上流のワークアイテムの既存アトリビュート値を優先しますが、このパラメータを代わりに Keep JSON Attribute に変更することで、その既存アトリビュートを.jsonファイルで見つかった値で上書きされるようにすることができます。

このパラメータは、 Operation が Deserialize Work Item に設定されている場合にのみ利用可能です。

JSONファイルから読み込まれたワークアイテムがそのJSONファイル内で指定されたワークアイテムインデックスを使用するかどうかを決めます。 このトグルを無効にすると、ワークアイテムは代わりに親インデックスを使用します。

このパラメータは、 Operation が Deserialize Work Item に設定されている場合にのみ利用可能です。

このパラメータは、クエリ(照会)の一部が失敗した際の処理内容を制御します。 クエリが失敗する例としては、インデックス化されている配列のサイズよりも大きいインデックスをクエリに使用した場合です。

このマルチパラメータ内のパラメータを使用することで、 Retrieve オペレーションを使用した際に実行させたいデータ抽出を指定することができます。

このパラメータは、JSONオブジェクトのパスまたは抽出したい値を指定する際に使用されます。 ここに/文字で区切った階層構文を使用することで、そのパスを指定することができます。 その階層内にリストがあれば、数値を使って配列インデックスを指定することができます。

例えば、以下のJSONファイルがあったと仮定します:

{
"plants" :
[
    { "name" : "tree", "inMyGarden" : true, "height" : 5.5 },
    { "name" : "sunflower", "inMyGarden": false, "height" : 3 }
]
}

そして、1番目の植物の高さを取得したい場合は、その照会は以下のように指定します:

plants/0/height

2番目の植物の名前を取得したい場合は、その照会は以下のように指定します:

plants/1/name

Array Retrieve オペレーションを実行する時は、その照会には 必ず JSON内のリストを指定してください。 以下で説明するように1つ例外があります。

Array Retrieve オペレーションには、その照会にワイルドカード(*)を使用することができます。 このワイルドカードによって、JSON階層が分岐で走査され、そのレベルにおける各オブジェクトがJSON走査の分岐になります。

以下のようなJSONファイルがあったと仮定します:

{
"Houdini" : {
    "Contexts" : {
    "Sop" : {
        "mountain" : {
        "name" : "Mountain"
        },
        "polybevel" : {
        "name" : "PolyBevel"
        }
    },
    "Top" : {
        "jsoninput" : {
        "name" : "Json Input"
        },
        "jsonoutput" : {
        "name" : "Json Output"
        }
    }
    }
}
}

そして、このJSONファイル内のすべてのノードの名前を取得したいので、以下の照会を実行したとします:

Houdini/Contexts/*/*

そして、Fieldパラメータを name に設定します。

これによって、4個の別々のワークアイテムが生成され、各ワークアイテムにはノード名が含まれます。 これらのオブジェクトすべてが独立していて、同じ配列に属しているわけではないので、それぞれのjson_arrayindexは 0 に設定されます。

このパラメータは、 Array Retrieve オペレーションを実行した時にのみ使用されます。 これは、 Query で指定されたリストの 各 配列インデックスから取得されるプロパティを指定する際に使用されます。

Query で指示された配列が匿名オブジェクト(例えば、整数の配列)で充たされていた場合、 このパラメータには、単に配列内のすべてを取得することを意味するワイルドカード(*)を設定することができます。

ここには、抽出した値を格納するワークアイテムアトリビュートの名前を指定します。

ここには、照会されたJSONデータの保存に使用するPDGアトリビュートのタイプを指定します。 特定のPDGアトリビュートタイプが選択されていて、且つ、そのJSONデータタイプと一致しなかった場合、結果はエラーになります。 Automatic オプションを選択すると、JSONオブジェクトがPyObjectsとして保存されます。

ここには、抽出した値を格納するワークアイテムアトリビュートのリストのインデックスを指定します。