While #

Whileコンポーネントは、[ condition ]プロパティに設定した条件判定スクリプトによって終了判定する繰り返し計算の実行に使用します。
Whileコンポーネントのプロパティは以下です。

*1 コンポーネントの進行状態が"finished"もしくは"failed"の時のみ表示されます。

Whileループの終了条件 #

[ condition ]プロパティの条件判定要素として環境変数$WHEEL_CURRENT_INDEX（ループ系コンポーネントのループカウンタインデックス）が使用できます。
Whileコンポーネントにおける環境変数$WHEEL_CURRENT_INDEXは、初期値0,増加率1として扱われます。
[ condition ]プロパティに指定されたスクリプトファイルの終了コードが0の場合は真、それ以外の場合は、偽と判定してループ継続となります。
ただし、conditionに指定された文字列と一致するファイルが存在しなかった場合は、Javascriptの式とみなしてそのコードを実行します。
この場合、実行結果がtruthyな値の場合を真、falseyな値の場合を偽とします。
例として、$WHEEL_CURRENT_INDEXの値が3より小さい場合に継続するスクリプト、Javascript判定式を下記に示します。

スクリプトファイル #

#!/bin/bash
if [ $WHEEL_CURRENT_INDEX -lt 3 ] ; then
  exit 0
else
  exit 1
fi

Javascript #

WHEEL_CURRENT_INDEX < 3　　*1

*1 JavaScript判定式では$は不要です

ループ系コンポーネント（While/Foreach/For） #

Whileコンポーネントは、For/Foreachコンポーネントと同様にループ系コンポーネントとしてカテゴライズされ、
ループカウンタインデックスを環境変数$WHEEL_CURRENT_INDEXに持ちます。
ループ処理では、プロジェクト実行開始時に自身と同じ階層にループカウンタインデックスの値に応じたsuffixをつけてコンポーネント内に存在する全てのコンポーネントのコピーを作成します。
生成処理が完了したら、ループカウンタインデックスを進めて終了判定を行い、ループが終了してなければ再度コピーを作成します。
このときコピーされるコンポーネントは、1つ前のループ処理後のコンポーネント です。
以下に例を示します。

Whileコンポーネント名が「While」、conditionの設定が「$WHEEL_CURRENT_INDEXの値が3より小さいときループ継続する」という場合 #

実行前のプロジェクトのディレクトリ構造 #

While

実行開始ループカウンタ0 ($WHEEL_CURRENT_INDEX：0) #

While
While_0 ←ループカウンタaのため、While_0コンポーネントが生成します

実行開始ループカウンタ1 ($WHEEL_CURRENT_INDEX：1) #

While
While_0
While_1 ←「1」増加したWhile_1を生成します  
　　　　　このとき、While_1コンポーネントは、カウンタ0のWhile_0コンポーネントをコピーしたものです

以降、ループが終了するまでコンポーネントのコピー/実行を繰り返します。
ループが終了条件を満たした時点で、これらのコンポーネントは終了となります。
ループの条件判定は、コピーされたコンポーネント（While_*）ではなく、コピー元のコンポーネント（While）上で実行されます。

Whileコンポーネントの使用例 #

Whileコンポーネントのサンプルを示します。

このワークフローは下記の処理を行います。

1. calcTaskコンポーネントにより、面積算出ソルバーを実行する
2. 実行結果をloopCalcTaskコンポーネントに渡す
3. 「1の結果（面積の値）×ループインデックス＋3の結果」 を実行する *1
4. 3の計算結果をファイルとして出力する
5. Whileコンポーネントに設定された条件判定スクリプトで、ループ継続判定をする
6. ループ継続であればループインデックスに1を加算し処理1に戻り、ループ終了であればワークフローを終了する

*1　ループ回数2回目以降の計算にて使用する

While ワークフロー構成図 #

sampleWhile（whileコンポーネント）

・condition.sh #

#!/bin/bash
if [ $WHEEL_CURRENT_INDEX -lt 6 ] ; then
  exit 0
else
  exit 1
fi

While ワークフロー子階層　構成図 #

calkTask（Taskコンポーネント）

・calc.sh #

#!/bin/bash
g++ wheel_tutorial_solver.cc -o wheel_tutorial_solver  
./wheel_tutorial_solver
exit 0

・inputData.txt #

0, 0, 0
0, 10, 0
10, 0, 0

loopCalkTask（Taskコンポーネント）

*2 result.shの計算結果ファイル、loopCalcTask内でインプットデータとして利用

・resultRead.sh #

#!/bin/bash
result=$(cut -f 2 -d "=" input.txt)
if [ ! $WHEEL_CURRENT_INDEX = 0 ] ; then
    value=$(cut -f 2 -d "=" value.txt)
else
    value=0
fi
x=$(($result * $WHEEL_CURRENT_INDEX + $value))
echo $WHEEL_CURRENT_INDEX
echo value=$x
echo value=$x > value.txt
exit 0

ワークフロー実行結果 #

ループインスタンスの削除 #

(参考：ループインスタンスの削除)