リスト
コレクションを扱うための 6 つのボックスです。 典型的な相手は、API が返してきた配列です。
Aggregate(集約)
Section titled “Aggregate(集約)”リストを 1 つの値にまとめます。
| 入力 | items(json) |
| 出力 | result |
| 設定 | op:count、sum、min、max、average、join — さらに field(集約する対象のプロパティ)と separator(join 用) |
HTTP リクエスト ──response[body.commandes]──► Aggregate(sum、field: montant)Map(各要素の変換)
Section titled “Map(各要素の変換)”リストの各要素を変換します。
| 入力 | items |
| 出力 | mapped(json) |
| 設定 | property(プロパティを取り出す)または expression(各要素に適用する Handlebars テンプレート) |
Filter(絞り込み)
Section titled “Filter(絞り込み)”リストを 2 つに分けます。
| 入力 | items |
| 出力 | kept(json)、rejected(json) |
| 設定 | property、operator(lt、lte、eq、gte、gt、ne、contains)、value |
出力はどちらも役に立ちます。rejected を Assert に接続すれば、
予期しない要素が現れたときに実行を失敗させられます。
リストに追加
Section titled “リストに追加”| 入力 | list(リスト)、既定の値 1 つ、さらに設定した値ごとに 1 ポート |
| 出力 | result(json) |
| 設定 | list(variable 型の値、または接続したもの)、values(追加する要素)、updateSourceVariable(既定は false) |
updateSourceVariable を有効にすると、このボックスは指定された実行変数に直接書き込みます。
ループの中で結果を積み上げていくときの手段です。
リストから削除
Section titled “リストから削除”前のボックスと同じ形です。渡された要素と深い比較で等しい要素を取り除きます。
List ops(リスト操作)
Section titled “List ops(リスト操作)”構造に対する操作です。
| 入力 | value(リスト)、key(文字列) |
| 出力 | result |
op | 効果 | フィールド |
|---|---|---|
sort | 並べ替える | key、order(asc / desc) |
unique | 重複を除く | — |
reverse | 逆順にする | — |
flatten | 平坦化する | depth(既定は 1) |
chunk | 一定数ずつに分割する | size |
slice | 一部を切り出す | start、end |
groupBy | キーごとにまとめる | key |