STW.EXE のパラメータ

コマンドラインプログラムには、必須パラメータとオプションパラメータの両方があります。パラメータは、長い形式と短い形式のどちらかの名前を使用して指定できます。一部のオプションパラメータでは、環境の変更、スクリプトに変数を渡したり、出力ファイルの作成などを指定できます。

注: パラメータ名、スクリプト、スクリプトパラメータでは、大文字と小文字が区別されません。ただし、スクリプトパラメータの値は、指定どおりにスクリプトに渡されます。

注: パラメータ名の前には、文字 - の代わりに文字 / を使用できます。

パラメータの長い名前	パラメータの短い名前	必須かどうか	説明
dsn	-d	はい	データベースへの接続に使用する DSN の名前。このパラメータは必須ですが、空にすると `SilkTest` が使用されます。
username	-u	はい	接続に使用されるユーザー名。空にすると `Admin` が使用されます。
password	-p	いいえ	接続に使用されるパスワード名。パスワードが `Nothing` の場合はオプション (お勧めできません)。
project	-r	いいえ	再生するスクリプトを含むプロジェクト。デフォルトでは、プロジェクトのすべてのスクリプトが実行されます。固有のスクリプトを指定するには、-script パラメータを使用します。スクリプトを指定せず、スクリプトで入力パラメータが必要である場合は、デフォルト値が使用されます。 .NET スクリプトが先に実行され、ビジュアルテストが次に実行されます。プロジェクトが存在しない場合は、エラーメッセージが表示されます。重要: プロジェクトパラメータが指定されていない場合、`Common` プロジェクトがデフォルトで使用されます。たとえば、「`stw -d silktest -u admin -p admin -s Script1 -r OtherProject -s Script2`」のように指定した場合は、`Script1` は `Common` プロジェクトで実行され、`Script2` は `OtherProject` という名前のプロジェクトで実行されます。
environment	-e	いいえ	スクリプトに使用する実行環境の名前。このパラメータを含めない場合は、デフォルトの再生環境が使用されます。再生環境が存在しない場合、スクリプトは実行されません。重要: 使用する場合は、このパラメータの次に project と script パラメータを指定する必要があります。
script	-s	はい	再生する .NET スクリプト、ビジュアルテスト、またはキーワード駆動テストの名前。 .NET スクリプト、ビジュアルテスト、またはキーワード駆動テストが存在しない場合、エラーメッセージが表示されます。
variable	-m	いいえ	このパラメータを使用すると、.NET スクリプト、ビジュアルテスト、キーワード駆動テストのパラメータを指定できます。たとえば、このパラメータを使用して、Silk Central からキーワード駆動テストにグローバルプロパティを渡すことができます。指定すると、資産で定義されたグローバルプロパティは上書きされます。このパラメータを使用する場合は、script パラメータの次に指定する必要があります。名前と値のペアは、二重引用符で囲む必要があります。変数に割り当てる値を表すには、文字 `=` を使用します。ブール値パラメータは、`True` または `False` として指定する必要があります。パラメータは任意の順序で指定できますが、名前と数はスクリプトのパラメータと正確に一致する必要があります。渡す名前が多すぎたり、少なかったり、無効だったりすると、エラーメッセージが表示されてスクリプトは実行されません。
file	-f	いいえ	このオプションでは、コマンドラインパラメータをテキストファイルで指定し、コマンドラインプログラムに渡すことができます。再入力したくない長い引数がある場合にこれを使用できます。使用法の詳細については、「入力ファイル」を参照してください。
outputfile	-o	いいえ	実行されたスクリプトに関する情報を含むファイルの名前を指定するには、このパラメータを使用します。実行されて、正常に完了したか再生エラーを生成したスクリプトのみが出力ファイルに表示されます。パスや名前にスペースが含まれる場合は、出力ファイルの名前を引用符で囲む必要があります。使用法の詳細については、「出力ファイル」を参照してください。
browser	-b	いいえ	ブラウザーアプリケーション構成を持つスクリプトが実行されるブラウザーを指定するには、このパラメータを使用します。パラメータには次の値を指定できます (文字小文字は区別されません)。 `InternetExplorer` `Firefox` `GoogleChrome` `Edge` `AndroidBrowser` `Safari` `None` `AndroidBrowser` または `Safari` を使用する場合には、mobiledevice パラメータを指定します。重要: 使用する場合は、このパラメータの次に project と script パラメータを指定する必要があります。
commandlineargs	-cla	いいえ	スクリプトの基本状態に渡すコマンドライン引数を指定する場合には、このパラメータを使用します。コマンドライン引数を使用する任意の基本状態に対して、このパラメータを使用できます。エージェントがコマンドライン引数を使用する場合、この設定が渡されますが、それ以外の場合は、無視されます。コマンドライン引数の指定には、`silktest.commandLineArgs` 環境変数を使用することもできます。STW.exe のパラメータと環境変数の両方でコマンドライン引数が指定された場合は、STW.exe のパラメータが使用されます。重要: 使用する場合は、このパラメータの次に script パラメータを指定する必要があります。
viewportwidth	-vw	いいえ	ブラウザービューポートの幅をピクセルで指定する場合には、このパラメータを使用します。viewportwidth パラメータと viewportheight パラメータは同時に指定する必要があります。いずれか一方のパラメータだけを指定すると、エラーになります。viewportname パラメータを、このパラメータと同時に指定することはできません。
viewportheight	-vh	いいえ	ブラウザービューポートの高さをピクセルで指定する場合には、このパラメータを使用します。viewportheigth パラメータと viewportwidth パラメータは同時に指定する必要があります。いずれか一方のパラメータだけを指定すると、エラーになります。viewportname パラメータを、このパラメータと同時に指定することはできません。
viewportname	-vn	いいえ	UI であらかじめ定義したカスタムブラウザーサイズのリストの名前を使用して、ビューポートの幅と高さを指定する場合には、このパラメータを使用します。このリストは、ブラウザーの選択ダイアログ、アプリケーションの選択ダイアログの Web タブ、ブラウザーアプリケーション構成の編集ダイアログで、ブラウザーを選択するときに表示されます。viewportwidth パラメータと viewportheigth パラメータを、このパラメータと同時に指定することはできません。
orientation	-on	いいえ	orientation パラメータは、viewportname が指定されたときだけ有効になります。その値として、 portrait または landscape を指定できます。UI の向きの設定に該当します。
mobiledevice	-md	いいえ	スクリプトを実行するモバイルデバイスの名前。この名前は、ブラウザーの選択ダイアログボックスにも表示されます。この値をリセットするには、二重引用符で囲んだ空の文字列 ("") を渡します。重要: 使用する場合は、このパラメータの次に project と script パラメータを指定する必要があります。
append	-a	いいえ	結果を追加するには、このパラメータを使用します。オプションダイアログボックスに表示されるものと同じ設定です。
increment	-i	いいえ	結果を増分するには、このパラメータを使用します。オプションダイアログボックスに表示されるものと同じ設定です。
verbose	-v	いいえ	このパラメータでは、スクリプトの実行中にユーザーに出力が表示されます。コマンドラインの任意の場所に表示されることがあります。 DSN、ユーザー名、パスワードは常に表示されます。出力ファイルを使用する場合は、それが表示されます。スクリプト名が表示される場所では、プロジェクト名が表示され、名前が括弧で囲まれて後に続きます。スクリプトの名前、プロジェクト、スクリプトステータス、合計検証数、合格した検証数、失敗した検証数を含む行は、実行されたスクリプトごとに表示されます。
help または ?	-h	いいえ	コマンドラインプログラムの使用可能パラメータを表示するには、「`STW -?`」と入力します。
resultdir	-rd	いいえ	実行したスクリプトのすべての結果ファイルを保存するディレクトリを指定するには、このパラメータを使用します。次のファイルがこのディレクトリに保存されます。 XML 結果ファイル XML 結果ファイルに対応する XSLT ファイルエラー画面 (実行中にエラーが発生した場合)
connectionstring	-c	いいえ	リモートロケーションに接続されているブラウザーやモバイルデバイスをテストするには、このパラメータを使用します。connectionstring パラメータを使用してテストを実行するとき、モバイルデバイスとパラメータの間で connectionstring は出力ファイルに書き出されます。

例 1

この例では、Internet Explorer でブラウザースクリプトを実行するコマンドを示します。

STW –dsn silktest –browser InternetExplorer –script MyScript

例 2

この例では、 Internet Explorer と Google Chrome の両方でブラウザースクリプトを実行するコマンドを示します。

STW –dsn silktest –browser InternetExplorer –script MyScript –browser GoogleChrome –script MyScript

例 3

この例では、まず、Android ブラウザーでスクリプトを実行し、それからスクリプトのアプリケーション構成で設定されたブラウザーで実行するコマンドを示します。

STW –dsn silktest –browser AndroidBrowser –mobiledevice Nexus_4 –script MyScript –browser None –mobiledevice "" –script MyScript

例 4

この例では、モバイルデバイス上の Chrome for Android で Common プロジェクトのすべてのスクリプトを実行するコマンドを示します。

STW –dsn silktest –browser GoogleChrome –mobiledevice Nexus_4 –project Common

例 5

この例では、Mac に接続されたモバイルデバイス上の Chrome for Android で Common プロジェクトのすべてのスクリプトを実行するコマンドを示します。

STW –dsn silktest -connectionstring "platformName=Android;deviceName=Moto G;host=http://MyMac - GoogleChrome" –project Common

例 6

この例では、ブラウザービューポートサイズ 800x600 の Internet Explorer でブラウザースクリプトを実行するコマンドを示します。

STW –dsn silktest –browser InternetExplorer -viewportwidth 800 -vieportheight 600 –script MyScript

例 7

この例では、ブラウザービューポートサイズ SVGA (800, 600) の Internet Explorer でブラウザースクリプトを実行するコマンドを示します。

STW –dsn silktest –browser InternetExplorer -viewportname SVGA –script MyScript

例 8

この例では、カスタムプロファイルを指定した Mozilla Firefox でブラウザースクリプトを実行するコマンドを示します。

STW –dsn silktest -username admin -password admin -browser Firefox -commandLineArgs "-p MyProfile" -project Common -script BrowserTest