実行の停止
スクリプトの実行を停止します。
コマンドの可用性: IBM RPA SaaS および IBM RPA オンプレミス
説明
Stop Execution (stopExecution) コマンドを使用するスクリプトの実行を停止します。 または、スクリプトが 「スクリプトの実行」などの別のコマンドによって参照されている場合、コマンドは呼び出し元スクリプトの実行を停止することもできます。
コマンドがエラー処理サブルーチンで実行されると、コマンドは失敗してスクリプトを停止します。 スクリプトでのエラーの処理方法について詳しくは、 例外処理の有効範囲 を参照してください。
スクリプト構文
IBM RPA の専有スクリプト言語の構文は、他のプログラミング言語と似ています。 スクリプト構文は、スクリプト・ファイル内のコマンドの構文を定義します。 この構文は、 IBM RPA Studioの 「スクリプト」 モードで操作できます。
stopExecution [--current(Boolean)]
入力パラメーター
以下の表は、このコマンドで使用可能な入力パラメーターのリストを示しています。 この表では、 IBM RPA Studioのスクリプト・モードで作業しているときのパラメーター名と、それに相当する Designer モードのラベルを確認できます。
| 「デザイナー」モードのラベル | 「スクリプト」モードの名前 | 必須 | 使用可能な変数タイプ | 説明 |
|---|---|---|---|---|
| 現行のみ | current |
Optional |
Boolean |
現行スクリプトの実行のみを停止し、呼び出し元スクリプトに実行を戻す場合に有効にします。 それ以外の場合、コマンドは現行コンテキスト内のすべてのスクリプトの実行を停止します。 |
例
例 1: この例では、スクリプトは実行されてから停止し、最後のメッセージは表示されません。
logMessage --message "Running..." --type "Info"
logMessage --message "Running..." --type "Info"
logMessage --message "Stop execution" --type "Info"
stopExecution
// The script stops now, right after the command.
logMessage --message "Script interrupted" --type "Info"
// The last message is not displayed because the script has been interrupted.
例 2: この例では、2 つのスクリプトが使用されています。 最初のスクリプトは、 「スクリプトの実行」 コマンドを使用して 2 番目のスクリプトを呼び出します。 2 番目のスクリプトが開始され、 「実行の停止」 コマンドによって中断されます。 現在は、 Only current パラメーターが指定されているため、実行は最初のスクリプトに戻されます。
最初のスクリプト:
logMessage --message "Running...\r\n" --type "Info"
logMessage --message "Running...\r\n" --type "Info"
executeScript --handleError --name secondScript
logMessage --message "End." --type "Info"
2 番目のスクリプト:
logMessage --message "Running ..." --type "Info"
logMessage --message "Stop Execution" --type "Info"
stopExecution --current
// The script stops now, right after the command.
logMessage --message "Script interrupted." --type "Info"
// The last message is not displayed because the script has been interrupted.