必要なパラメータ
- jsonpath:ループ対象となる指定セグメントの1始まりのインデックスjsonpath(例:
<arc:set attr="myinputitem.jsonpath" value="/json/foo/" />)。
オプションのパラメータ
- uri:JSON ファイルのURI(例:
http://mydomain.com/resources/somedata.json、/tmp/myfile.json、または[FilePath])。 - text:JSON データへの読み取り可能なハンドル参照。このハンドルはjsonOpen オペレーションによって作成され、インプットJSON がファイルやrawテキストではない場合、またはドキュメントのファイルデータにアクセスする複数のアクションを実行する必要がある場合に役立ちます。
- handle:JSON データへの読み取り可能なハンドル参照。このハンドルはjsonOpen オペレーションによって作成され、対象のJSON がインプットファイルではない場合にのみ必要です。詳細と例についてはjsonOpen を参照してください。
アウトプット属性
- jsonpath:インプットアイテムに設定されたjsonpath を基準とした、アウトプットアイテムの1始まりのインデックスjsonpath。
- name:ループ対象となる指定要素の名前を返します(例:
[myoutitem.name]はfooJSON 要素の名前であるfooに解決されます)。 - type:ループ対象となる指定要素のデータ型を返します(例:
foo要素が文字列値を持つ場合、[myoutitem.type]はSTRINGに解決されます)。
例
インプットファイルとして渡される次のJSON について考えてみます:colors 配列内のすべてのオブジェクトを列挙できます:
