4.2.3 繰り返し実行部品
機能
フローを繰り返し実行できます。繰り返し入力プロパティ(inputProperties)に指定した値を,1 回の繰り返しごとにフローに設定し,サービスを実行できます。例えば,同じ処理を異なるサーバに実行したい場合などに便利です。
なお,フローの実行方法には,フローを並行で実行する「並行実行」と,フローの実行が完了したら次のフローを順番に実行する「逐次実行」があります。
注意事項
-
部品の実行中にタスクを実行停止した場合は,実行中の繰り返しフローは実行中の部品が完了次第停止されます。ただし,ユーザー応答待ち部品の場合は,部品の完了を待たないで停止されます。未実行の繰り返しフローは実行されないため,プロパティ「outputResult」には「false」が格納されます。
-
部品の実行中にタスクを強制停止した場合は,実行中の処理が直ちに終了され,タスクの状態が「失敗」になります。なお,[タスク詳細]ダイアログボックスに表示されるステップの戻り値は,-1になります。タスクログに出力される戻り値は,強制停止したタイミングによって異なります。
-
プロパティ「foreachMode」で「parallel」を指定している場合,繰り返し実行タスク内で参照・更新するサービスプロパティの値は,同じ繰り返し実行タスク(n回目のフロー)でだけ有効です。同時に処理している繰り返し実行タスク(n回目以外のフロー)とは,サービスプロパティの値を共有できません。
-
繰り返し実行部品から[失敗したステップからリトライ]でリトライすると,繰り返し実行部品の配下のステップが最初から実行されます。また,繰り返し実行部品の配下のステップの状態が「失敗」で,ステップ作成時に[ステップ作成]ダイアログボックスで設定した[後続ステップ実行条件]でステップの状態が「正常終了」になる条件を指定している場合は,タスクをリトライできません。
-
繰り返し実行部品から[失敗した次のステップからリトライ]でリトライすると,繰り返し実行部品の次のステップから実行されます。この場合,繰り返し実行部品のステップの状態は「正常終了」になります。ただし,すでに実行された繰り返し実行部品の配下のステップの状態は,変更されません。
バージョン
01.00.00
カテゴリ
Hitachi/Basic
戻り値
戻り値 |
説明 |
---|---|
-1 |
部品実行中にタスクが強制停止された。[タスク詳細]ダイアログボックスには,このステップの戻り値が表示される。 |
0 |
正常に終了した。 |
1 |
一部の繰り返し処理が失敗した。 |
2 |
すべての繰り返し処理が失敗した。 |
65 |
JP1/AOサーバとの接続に失敗した。例えば,部品実行中にJP1/AOサーバが停止された場合が該当する。 |
66 |
次のユーザーがJP1ユーザーにマッピングされている。
|
68 |
対象のジョブ実行IDに関する情報がない。 |
69 |
タスク処理エンジンの環境変数の取得に失敗した。 |
80 |
タスクの実行を停止した。 |
81 |
部品が不正な状態で呼び出された。 |
82 |
タスク処理エンジンからの要求メッセージを正しくパースできない。 |
83 |
JP1/AOサーバの環境が壊れている。 |
84 |
指定された部品の情報が取得できない。 |
86 |
指定したプロパティ値に誤りがある。 |
127 |
そのほかのエラーが発生した。 |
プロパティ一覧
プロパティを次の表に示します。
プロパティキー |
プロパティ名 |
説明 |
デフォルト値 |
入出力種別 |
必須区分 |
---|---|---|---|---|---|
inputProperties※1 |
繰り返し入力プロパティ |
繰り返す回数分の入力プロパティの値を1,024文字以内で指定します。 1回の繰り返しごとに,異なるプロパティを指定できます。プロパティは,コンマ区切りで指定してください。なお,コンマは区切り文字としてだけ使用してください。 また,繰り返す回数の上限は99回です。そのため,100個以上の値をコンマ区切りで指定できません。 |
− |
入力 |
○ |
outputProperties※2 |
繰り返し出力プロパティ |
繰り返した回数分の出力プロパティの値が1,024文字以内で出力されます。 1回の繰り返しごとに,1つのプロパティ値がプロパティ「inputProperties」の指定順にコンマ区切りで出力されます。なお,コンマは区切り文字として使用してください。 |
− |
出力 |
△ |
outputResult |
繰り返し実行結果 |
フローごとの実行結果がコンマ区切りで出力されます。
|
− |
出力 |
△ |
foreachMode |
繰り返し実行方式 |
繰り返し実行するフローの実行方式を指定します。
|
parallel |
入力 |
○ |
- 注※1
-
プロパティ「inputProperties」に指定した値は,繰り返し実行するフロー内で使用される予約プロパティ「reserved.loop.input」に格納されます。予約プロパティ「reserved.loop.input」は,繰り返しごとに異なる値が格納されます。予約プロパティ「reserved.loop.input」は,繰り返しごとに異なる値が格納されるため,参照指定「?dna_reserved.loop.input?」の形式で指定してください。
- 注※2
-
プロパティ「outputProperties」には,繰り返し実行するフロー内で使用される予約プロパティ「reserved.loop.output」の値が格納されます。
関連トピック
-
マニュアル「JP1/AO 構築ガイド」−「プロパティファイル(config_user.properties)」のトピック
-
マニュアル「JP1/AO サービステンプレート開発ガイド」−「予約プロパティ一覧」のトピック