Exit

3.2.10 Exit

Exit - スクリプト、プロシージャ、または構造化されたコードブロックを終了し、終了コードを返します。スクリプト実行中に 'process' スコープの exit コマンドが呼び出されると、T-Plan Robot は終了し、指定された終了コードをオペレーティングシステムに返します。T-Plan RobotCLI Optionsおよびそのautomatic script execution examplesのドキュメントを参照のこと。

SYNOPSIS

exit <exit_code_number>[scope=<process|file|procedure|block>] [desc=<description>]

*赤は必須パラメータを示します

オプション

exit_code_number

-必須の終了コード。整数値でなければなりません。ゼロ以外の値はエラーまたは予期せぬ結果や動作を示します。スクリプト全体を終了するためにコマンドが呼び出され、そのコマンドによって作成されたレポートファイルがある場合Reportコマンドによって作成されたレポートファイルでは、終了コード0が "passed/successful "として表示され、その他のコードはすべて失敗として表示されます。この終了コードは、基礎となるオペレーティングシステムにも渡され、サードパーティのフレームワークによってスクリプトが終了した理由を特定するために使用できます。

scope=<process|file|procedure|block>

-終了コマンドのスコープを制御します。デフォルト値はスクリプトの実行を終了するプロセスです。実行が自動化されており、実行中の自動化プロセスがない場合、コマンドはJVM（Java仮想マシン）も終了させ、指定された終了コードを基盤となるオペレーティングシステムに返します。

file値は、現在実行されているファイルを終了します。コマンドを使用して別のスクリプトからスクリプトを実行している場合、呼び出されたスクリプトのみが終了します。Runコマンドを使用して別のスクリプトからスクリプトが実行されている場合は、呼び出されたスクリプトのみが終了し、制御はマスター・スクリプトに戻されます。

procedure 値は、最も内側のプロシージャから終了する。プロシージャが実行されていない場合、Exit コマンドは無視される。

ブロック値は、最も内側の構造化されたコードブロック、つまりfor文のif/elseの1つから抜ける。コマンドがそのようなステートメントから呼び出された場合、それは無視されます。

desc=<説明>

-終了スコープが指定されていないか、プロセスと等しい場合にのみ使用されます。コマンドはその説明を_EXIT_DESC変数の下に保存し、レポートフレームワーク（例えばEnterprise Report Provider)によって取得され表示されます。.

戻り値

コマンドは引数として指定された終了コードを返します。

例

Exit 10

• 実行されたスクリプトを終了し、終了コードとして 10 を返します。

Typeline myapplication 
Waitfor update extent=40% timeout=20s ontimeout="Exit 2" cumulative=true

• これはExitコマンドの典型的な使い方です。ターミナル・ウィンドウからmyapplicationというGUIアプリケーションを起動したときの状況を示しています。myapplicationのウィンドウは、画面サイズの少なくとも40％に等しい固定サイズを持っているとします。GUIが正しく起動すれば、スクリプトは続行されます。そうでなければWaitforコマンドは20秒間待機し、終了コード2でスクリプトを終了します。