チェーン内のコマンドやコマンドグループを繰り返し実行するには、イテレーターを設定する。
注: イテレータで使用するために、リレーショナル・データベースまたは外部ウェブ・サービスからの出力を JSON 配列に変換するには、JSON コネクタのCSV to JSON コマンド またはJSON 変数変換 を使用します。
反復子を設定する
イテレータを使えば、コマンドやグループを繰り返し実行することができる:
- 静的または動的な値のリスト
- 正確な数値
- 条件の有無に基づく
イテレーターは、コマンドやグループを繰り返すことができる:
- 地域やエンティティなどの静的な値のリスト
- ワークスペース・リソースとしてアップロードされたファイルや、チェインの前のコマンドから出力されたものなど、動的または可変的な値のリスト。
注: Aコマンドまたはグループの反復回数は1000回に制限されている。
値のリストに対してイテレータを実行する:
- チェーン内で、繰り返し実行するコマンドまたはグループを選択し、Edit をクリックする。
- Iterations タブで、Iterator を有効にする。
- Select modifier type で、List を選択する。
- 反復の値を入力する:
- 静的リストの場合は、Enter 。
- ダイナミック リストの場合、先のコマンドの出力から使用する値を選択する。
- 静的リストの場合は、Enter 。
イテレーターは、コマンドやグループを正確な数の値で繰り返すことができる。例えば、チェーンの前のコマンドから出力されたページの合計などである。
ステップ1.数値用の変数を設定する
反復回数を示すには、ダイナミック・チェーン変数を作成する:
- 連鎖の中で、は、カウンター のような反復回数を表す動的変数 を初期値なしで追加する。
- チェーン実行時に変数の初期値を設定するには、反復回数を出力するコマンドの後に、、Set dynamic chain variable イベントを追加する:
- 反復回数用に作成された動的変数を選択する。
- Value に、開始値(例えば1)を入力する。
ステップ2.コマンドグループを追加する
反復するコマンドと反復ルールを示すために、コマンド・グループを追加する:
- Set dynamic chain variable イベントの後、addCommand group を追加し、それらの間にリンクをドラッグする。
- グループを選択し、Edit をクリックする。
- グループのIterations
タブで、Iterator を有効にする。 - Select modifier type で、Repeat until を選択する。
- + Rule をクリックし、データ型に Float を選択し、反復を停止するタイミングを指定する。例えば、以前のコマンドのTotal records 出力に基づいて反復を行うには、変数値がTotal records 出力より大きい(>)場合に反復を停止するルールを設定する。
- 反復するコマンドをグループに追加する。
ステップ3.変数値をインクリメントするイベントを追加する
各反復で変数値をインクリメントする:
- グループの最後のステップとして、Set dynamic chain variable イベントを追加する:
- 反復回数用に作成された動的変数を選択する。
- Value で、同じ変数を選択する。
- 値 を変換するには、Value で変数をクリックし、Parse Number 変換を追加します。
- Add 変換を値1で追加し、Accept をクリックする。
値や値の正確な数が不明な場合は、特定の条件を満たすかどうかに基づいて反復することができます。例えば、指定した条件が存在する間、あるいは存在するまでコマンドを繰り返すことができる。
ステップ1.条件値の変数を設定する
イテレートする値を示す条件を表すには、ダイナミック・チェーン変数を作成する。例えば、あるコマンドが、そのレスポンスに追加ページが含まれているかどうかを示すブーリアン・キー出力と、各ページを識別する整数オフセット・パラメータを提供する場合、これらの値を格納する変数を作成する:
- チェインでは、、条件ごとに初期値なしの動的変数 。
- チェインの実行時に変数の初期値を設定するには、条件の値を出力するコマンドの後に、Set dynamic chain variable event を追加して、ダイナミック変数を選択し、その開始値を入力する。
例えば、ブーリアンキーの値を True、オフセット値を 0 と入力する。
ステップ2.コマンドグループを追加する
反復するコマンドと反復ルールを示すために、コマンド・グループを追加する:
- Set dynamic chain variable イベントの後、addCommand group を追加し、それらの間にリンクをドラッグする。
- グループを選択し、Edit をクリックする。
- グループのIterations
タブで、Iterator を有効にする。 - Select modifier type で、Repeat until を選択する。
- + Rule をクリックし、ブーリアンキーがFalseのときなど、反復を停止するタイミングを指定する。
- 反復するコマンドをグループに追加する。
ステップ3.各反復で変数値を設定する
グループの最後のステップとして、Set dynamic chain variable イベントを追加し、反復ごとに変数値をセットまたはインクリメントする。
- 変数の値を設定するには、各変数を先のコマンドのそれぞれの出力に対応させる。例えば、Boolean 変数では、ブーリアン・キー出力を選択し、Offset 変数では、整数オフセット・パラメーターを選択する。
- 変数をインクリメントするには 、例えばOffset 、その値をクリックし、Parse Number 変換と、Add 変換を、各反復でインクリメントする値で適用する。
イテレータ出力
イテレータの出力は、他のコマンドやイベントのプロパティとして使用することができます。リスト または まで繰り返す。
出力 | 説明 |
---|---|
コマンド反復またはグループ反復 | ループ内で処理される反復の変数値 |
インデックス | ループ内で処理された反復を示すゼロベースのカウント。 |
最初の反復 |
処理される反復がループの最初のものであるかどうかを指定するブール値。 |
最後の反復 | リスト イテレータの場合のみ、処理される反復がループの最後かどうかを指定するブーリアン値。 |
総反復回数 | リスト イテレーターの場合のみ、ループで処理された総反復回数をゼロベースでカウントする。 |
出力を別のコマンドまたはイベントのプロパティとして使用するには、それぞれCommand Iterator またはGroup Iterator で選択します。