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