プロセスオペレーション

標準サブセットのフォルダ TBox Automation Tools->Process Operations には、以下のモジュールが含まれています。

TBoxスタート・プログラム

このモジュールで、Microsoft Windows® ファイルシステムに保存されているアプリケーションまたは実行ファイルを開くことができます。コマンドラインを通じてアプリケーションをシャットダウンする時にも利用できます（例5をご参照ください）。

次の モジュール属性 があります。

ModuleAttribute

説明

パス

開きたいアプリケーションへのパスまたは環境変数です。アプリケーションを終了するには、コマンドラインタスクの名前を入力してください。

このエントリーは必須です。

ディレクトリ

プログラムの作業ディレクトリを指定します。デフォルトでは、 Tricentis Tosca は登録ユーザーのホームディレクトリを使用します： C:\Documents and Settings\<user name> 。

引数

引数を使ってアプリケーションを開始または停止したい場合は、引数を指定します。

引数->引数

引数を定義し、 ActionModeInput を使用します。

アプリケーションを終了するには、Windowsタスクマネージャーの詳細タブに従って、引数の1つがその名前でなければなりません。

引数は複数指定でき、サブモジュール属性ごとに1つ指定できます。

WaitforExit

アプリケーションが終了するまで待つよう、 Tricentis Tosca に指示することができます。そのためには、 TRUE を設定し、 ActionMode Select を使用します。

オプションで、 StandardOutputFile 、 TimeoutForExit 、 ExitCode を指定します。

WaitforExit->StandardOutputFile

Tricentis Tosca にログを作成させたい場合は、ログファイルのパスと名前を指定します。

ログには標準出力 (stdout ) と標準エラー ( stderr) があります。

WaitforExit->TimeoutForExit

アプリケーションを終了する前に Tricentis Tosca が待つ最大時間を秒単位で指定します。

WaitforExit->ExitCode

あなたのアプリケーションの終了コードを確認します。そのためには、 Value 列にコードを入力し、 ActionMode Verify を使用します。

以下として実行します

Tricentis Tosca が、アプリケーションを開く際に使用するドメインまたはローカルのユーザークレデンシャルを定義します。

デフォルトでは、 Tosca Commander はActionMode Select を選択します。

->ユーザー名として実行

アプリケーションを開くユーザー名のユーザープリンシパル名（UPN）フォーマット

例： jdoe@company.com.

->パスワードとして実行

必要に応じて、ユーザーのパスワードを指定します。

この例では、 C:\Windows にあるアプリケーション Notepad.exe を起動します。

そのためには、 Tricentis Tosca は、 Username と Password で指定した John Doe のユーザークレデンシャルを使用します。

この例では、 D:\ にあるファイル Test01.xml を、 C:\Windows にあるプログラム notepad.exe で開きます。

定義された作業ディレクトリは C:\Temp です。

この例では、Google Chrome を起動し、プライベートモードでWebサイト www.tricentis.com を開きます：

この例では、 %COMMANDER_HOME% にある TCShell.exe を起動します。

さらに、 Tricentis Tosca は以下のアクションを実行します：

  • アプリケーションが終了するまで待機

  • アプリケーションの ExitCode ： 0 を検証

  • log.txt という名前のログファイルを作成し、 %TEMP% に保存

この例では、 %COMMANDER_HOME% にある TCShell.exe を起動します。

さらに、 Tricentis Tosca は以下のアクションを実行します：

  • アプリケーションが終了するまで待機

  • アプリケーションの ExitCode ： 0 を検証

  • log.txt という名前のログファイルを作成し、 %TEMP% に保存

この例では、 Windowsのコマンドラインタスクである TaskKill（リンクは新しいタブで開きます）を使用して、Chromeを強制的かつ即座にシャットダウンします。

TBoxクローズプログラム

モジュール TBoxクローズプログラムでは、以下のことが可能です。

  • アプリケーションまたはプロセスを閉じる。

  • アプリケーションが閉じるまで待つ。

  • アプリケーションまたはプロセスが現在実行中かどうか確認する。

これは、次のテストステップに進む前にアプリケーションを終了する必要がある場合に便利です。

モジュールには以下の モジュール属性があります。：

ModuleAttribute

ディスクリプション

Id*

アプリケーションのプロセス識別番号 (PID) 。例： 7588 。

名称*

アプリケーションのプロセス名。例： msedge.

メインウィンドウのタイトル*

メイン・アプリケーション・ウィンドウのタイトル。例： Slack 。

コマンドライン

アプリケーションを実行する際のコマンドラインのパラメータを入力して、識別を微調整することもできます。パラメータセットの特定の部分だけに興味がある場合は、ワイルドカードを使用します。

オペレーション

実行したい操作を選択します：

  • Close if Exist: 指定されたアプリケーションまたはプロセスを閉じます。アプリケーション、またはプロセスが存在しない場合、あるいはTricentis Toscaがそれを見つけられない場合、テストケースは何も閉じずに通過します。

  • Close: 指定されたアプリケーションを閉じます。指定されたアプリケーションが実行されていない場合、テストケースは失敗します。

  • Wait on Close ：指定されたアプリケーションが他のプロセスまたはユーザーによって閉じられるまで待機します。Tricentis Toscaは、 TBox > 同期 > 同期タイムアウトの設定で指定された時間を待ちます。

  • Verify Program Exists ：指定されたアプリケーションまたはプロセスが現在実行中かどうかを確認します。

*Tricentis Toscaが正しいアプリケーションまたはプロセスを見つけられるように、TestCaseでこれらの値の少なくとも1つを指定する必要があります。同一または類似の識別子を持つ複数のアプリケーションまたはプロセスがある場合は、TestCaseで複数の識別子を使用してください。

この例では、アプリケーション、ウィンドウのタイトルに Notepad が含まれているかどうかを確認します。これにはワイルドカード * を使用します。

ウィンドウタイトルに Notepad を含むアプリケーションを閉じます。

この例では、以前に notepad a.txt というコマンドで開いたメモ帳アプリケーションを閉じます。

コマンドラインを使用してパラメータを指定して開いたアプリケーションを閉じます。