Runscriptコマンドラインオプション
このページでは、runscript
コマンドを使用してコマンドラインからEggplant Functionalスクリプトを実行する際に使用できるさまざまなオプションについて説明します。このコマンドは、Eggplant Functional GUIを起動せずにスクリプトを実行します。
複数のオプションを追加するには、それぞれの前にスペースを挿入します。これらのコマンドについての詳細は、コマンドラインからの実行を参照してください。
Eggplant Functional GUIを起動するEggplant
コマンドを使用してスクリプトを起動するには、Eggplantコマンドラインオプションを参照してください。
重要: Eggplant Functionalのバージョン18.0以降のMacへのインストールでは、runscript
コマンドを呼び出すパスが/Applications/Eggplant.app/Contents/MacOS/runscript
に変更されました。エラーを防ぐために、Eggplant Functionalの以前のバージョンで作成されたテストを更新する必要があるかもしれません。また、Eggplant > Preferences > Run PreferencesでInstall runscript in /usr/bin/localボタンをクリックして、runscript
コマンドをユーザーパスに追加することもできます。これにより、runscript
をコマンドライン経由で任意のディレクトリから呼び出すことが可能になります。
Mac上でEggplant Functionalを実行していて、バージョンが18.0より古い場合、runscript
コマンドのパスは/Applications/Eggplant.app/runscript
です。
コマンドラインからrunscript
やEggplant
コマンドを実行する際に渡すオプションを指すために、私たちは_arguments_という言葉を使用します。その他、_options_や_flags_といった熟知の言葉もあります。
スクリプトへの入力として渡す値を指すために、私たちは_parameters_という言葉を使用します。コマンドラインからスクリプトを実行する際にパラメータを渡す方法についての詳細は、パラメータの渡し方を参照してください。
接続情報
RDPとVNC
以下のフラグを使用して、runscript
コマンドでVirtual Network Computing(VNC)またはRemote Desktop Protocol(RDP)のシステムアンダーテスト(SUT)の接続情報を指定します:
-host
– スクリプトで使用する特定のSUTのホスト名またはIPアドレス。-host引数を渡すときは、カラーデプス、パスワード、ポート、ユーザ名、接続名を指定することもできます。-connectionname
– 新たに作成される接続の希望する名前。-hostフラグと併用して、-connectionnameフラグは接続のSUT識別名を提供します。この値は、connectioninfo
関数が呼び出された場合にName
パラメータによって返されます。-port
– SUTに接続するソフトウェアのポート。これはVNCサーバーまたはRDP接続のポートで、ホストWindowsマシンのユーザー名とパスワードを提供します。-username
と-password
– SUTへのVNCサーバー接続の場合、通常はパスワードのみを提供する必要があります。特にUltraVNCを使用する場合など、稀にユーザー名が必要な場合もあります。RDP接続の場合、ホストWindowsマシンのユーザー名とパスワードを提供します。-password64
または-pass_code64
– 標準的な文字と非標準的な文字を含むパスワードやパスコードにBase64エンコーディングを使用する場合、-password64
または-pass_code64
のオプションを使用できます。Base64エンコーディングされたパスワードを渡すには-password64
オプションを、Base64エンコーディングされたパスコードを渡すには-pass_code64
オプションを使用します。パスワードやパスコードをBase64形式にエンコーディングする方法についての詳細は、Base64(エンコードとデコード)をご覧ください。-colorDepth
– ビューアウィンドウのSUTのカラーデプス:8、16、32。(デフォルト値:SUTのネイティブカラーデプス)-type
[RDP, VNC] – 接続の種類。"RDP"はRDP接続を指定し、Windows SUTのみで利用可能です。RDP接続はデフォルトでポート3389を使用します。"VNC"はVNC接続を指定します。デフォルトの接続タイプはVNCです。-typeパラメータを省略するとVNC接続になります。-DefaultHeight
と-DefaultWidth
– これらのパラメータは、SUT画面 を表示するために指定し、その表示の高さと幅をピクセル単位で指定します。これらのオプションはRDP接続のみで使用され、つまり-typeオプションが含まれていてRDPに設定されている場合のみ使用されます。
例:
以下にrunscript
コマンドによるVNCとRDP接続の例を示す。
Mac VNC および RDP 接続の例
/Applications/Eggplant.app/Contents/MacOS/runscript /Users/Alex/Docs.suite/Scripts/myTests/test2.script -host <IPアドレス> -port 5901 -username joeuser -password broncos
Mac VNC および RDP 接続の例
"C:\Program Files\Eggplant\runscript.bat" "C:\Users\Alex\Documents\MySuite.suite\Scripts\test2.script" -host <IPアドレス> -password "fast horses" -type rdp -DefaultWidth 1920 -DefaultHeight 1080
Mac VNC および RDP 接続の例
runscript ~/Documents/appTests.suite/Scripts/test1.script -host <IPアドレス> -port 5901 -username "joeuser" -password broncos
Sauce Labs
Sauce Labsのテストシステム(SUT)の接続情報を指定するために、runscript
コマンドと以下のフラグを使用します:
-SauceLabsConnectionName
– この接続に割り当てる名前。(オプション)-SauceLabsUser
– 使用するSauce Labsアカウントのユーザー名。(必須)-SauceLabsApiKey
– アカウントのSauce Labs APIキー。(必須)-SauceLabsDataCenter
– 接続するSauce Labsデータセンター。(必須)
Sauce Labsデバイス接続のために:
-SauceLabsBrowserName
– ブラウザの名前、例えば"Chrome"、"Firefox"