Eggplant コマンドラインオプション

このページでは、Eggplantコマンドを使用してコマンドラインからEggplant Functionalスクリプトを実行するときに使用できるさまざまなオプションについて説明します。このコマンドはEggplant Functional GUIを起動します。runscriptコマンドを使用してこれらのオプションのいずれかを実行すると、Eggplant Functional GUIが起動することに注意してください。runscriptコマンドについて詳しくは、Runscript コマンドオプションを参照してください。

これらのコマンドに関する詳細情報は、コマンドラインからの実行を参照してください。

注記

コマンドラインからこれらのコマンドを実行するときにrunscriptまたはEggplantコマンドで渡すオプションを説明するために、引数という用語を使用しています。他にもオプションやフラグという用語があります。

スクリプトへの入力として渡す値を指すために、パラメータという用語を使用しています。コマンドラインから実行するときにスクリプトにパラメータを渡す方法についての詳細は、パラメータの渡し方を参照してください。

-アラートオンエラー

使用

ブール値。 (はい/いいえ) スクリプトの実行が失敗した場合にアラートを表示するかどうかを指定します。

例

Mac

/Applications/eggPlant.app/Contents/MacOS/Eggplant -RunOnLaunch /Users/Alex/appTests.suite/Scripts/test3.script -AlertOnError yes

Windows

"C:\Program Files\eggPlant\eggPlant.bat" -RunOnLaunch "C:\Users\Alex\Documents\MyTests.suite\scripts\test3.script" -AlertOnError yes

Linux

Eggplant -RunOnLaunch ~/Documents/appTests.suite/Scripts/test1.script -AlertOnError yes

注記

このパラメータは、Eggplant Functional一般設定の接続が失敗したときにアラートを表示するを上書きします。

-AlertOnFailedConnections

使用

_Boolean. (Yes/No)_接続が失敗したときにアラートを表示するかどうかを指定します。

例

Mac

/Applications/eggPlant.app/Contents/MacOS/Eggplant -RunOnLaunch /Users/Alex/appTests.suite/Scripts/test3.script -AlertOnFailedConnections yes

Windows

"C:\Program Files\eggPlant\eggPlant.bat" -RunOnLaunch "C:\Users\Alex\Documents\MyTests.suite\scripts\test3.script" -AlertOnFailedConnections yes

Linux

Eggplant -RunOnLaunch ~/Documents/appTests.suite/Scripts/test1.script -AlertOnFailedConnections yes

注記

このパラメータは、Eggplant Functional一般設定のスクリプト実行が失敗したときにユーザーに警告するを上書きします。

-AutoShowRunWindow

使用

ブール値。 (Yes/No) スクリプトの実行時に実行ウィンドウを前方に移動するように指定します。

例

Mac

/Applications/eggPlant.app/Contents/MacOS/Eggplant -AutoShowRunWindow yes

Windows

"C:\Program Files\Eggplant\Eggplant.bat" -AutoShowRunWindow yes

Linux (bash shell)

Eggplant -AutoShowRunWindow yes

ノート

-AutoShowRunWindowフラグは、Eggplant Functional一般設定のスクリプトが実行されたときに実行ウィンドウを前面に表示するを上書きします。

-デフォルトドキュメントディレクトリ

使用

ディレクトリへのパス。 ヘルパー スイートのパスなど、スイートへの相対ファイル パスの開始ディレクトリを指定します。

例

Mac

/Applications/eggPlant.app/Contents/MacOS/Eggplant -DefaultDocumentDirectory ~/Documents/EggplantDocs

Windows

"C:\Program Files\Eggplant\eggPlant.bat" -DefaultDocumentDirectory "C:\Users\Elizabeth\Documents\eggPlantTests"

Linux

Eggplant ~/Documents/appTests.suite/Scripts/test1.script -DefaultDocumentDirectory ~/Documents

注記

これは、Eggplant Functional一般設定のデフォルトスイートディレクトリと同じです。

-open

使用

スイートまたはスクリプトへのパス。 -open 引数は、スイートを開いた状態でコマンドラインから Eggplant Functional を起動します。 -open 引数を使用して、特定のスイートへのパスを含めます。 -open 引数を使用して特定のスクリプトを開くこともできます。これを行うには、特定のスクリプトへのパスを含めます。

例

Mac

/Applications/eggPlant.app/Contents/MacOS/Eggplant -open ~/Documents/appTests.suite

/Applications/eggPlant.app/Contents/MacOS/Eggplant -open ~/Documents/appTests.suite/scripts/testscript.script

Windows

"C:\Program Files\eggPlant\Eggplant.bat" -open "C:\Users\Alex\Documents\appTests.suite"

"C:\Program Files\eggPlant\Eggplant.bat" -open "C:\Users\Alex\Documents\appTests.suite\scripts\testscript.script"

Linux

Eggplant -open ~/Documents/appTests.suite

Eggplant -open ~/Documents/appTests.suite/scripts/testscript.script

-param (-p)

使用

単一のパラメータ。 -param 引数はパラメータをスクリプトに渡します。 -param はスクリプト名の前後に使用できます。 -param 文字列はスクリプト内の各パラメータの前に置く必要があることに注意してください。 -p 形式は、同じパラメータの省略形です。相互に交換して使用できます。

注記

-param引数（最後に"s"が付かないもの）は、古い-paramsパラメータと同じではありません。

例

Mac

/Applications/eggPlant.app/Contents/MacOS/Eggplant -RunOnLaunch ~/Documents/appTests.suite/Scripts/test1.script -param "SUT1" -param "phonebook.txt"

Windows

"C:\Program Files\eggPlant\Eggplant.bat" -RunOnLaunch "C:\Users\Alex\Documents\MyTests.suite\scripts\test1.script" -param "SUT1" -p "phonebook.txt"

Linux

Eggplant -RunOnLaunch ~/Documents/appTests.suite/Scripts/test1.script -p "SUT1" -p "phonebook.txt"

-paramValue (-pv)

使用

単一のパラメータ式。 -paramValue 引数 (またはその省略形 -pv) は、リスト、プロパティ リスト、または他の複雑なパラメータ値をスクリプトに追加します。 SenseTalk 値関数は、指定された値をスクリプトに渡す前に適用されます。

-paramValueと-paramを自由に混在させて呼び出すことができます。-paramまたは-pの後に続く値は、スクリプトにリテラル文字列として渡されます。paramValueまたは-pvの後に続く値は、SenseTalk式として評価され、評価された値がスクリプトに渡されます。

例

Mac

/Applications/eggPlant.app/Contents/MacOS/Eggplant ~/Documents/appTests.suite/Scripts/test1.script -paramValue "[SUT1,SUT2]" -paramValue "{x:34, y:125}"

Windows

"C:\Program Files\eggPlant\Eggplant.bat" "C:\Users\Alex\Documents\MyTests.suite\scripts\test1.script" -p "SUT1" -pv "[1,2,3,5,9]"

Linux

Eggplant ~/MyTests.suite/Scripts/test1.script -paramValue "the international time" -pv '{name:"Joe User", id:"143G-2", password:"top secret"}'

-QuitAfterRun

使用

ブール値。 (はい/いいえ) 指定されたスクリプトまたはスイートのスケジュールを呼び出し、Eggplant Functional を終了します。終了をキャンセルするには、Eggplant Functional を開き、メイン メニューから Eggplant を選択し、次に Quit を選択します。次に、Cancel Quit ボタンをクリックします。

例

Mac

/Applications/eggPlant.app/Contents/MacOS/Eggplant -RunOnLaunch /Users/Alex/Docs.suite/Scripts/myTests/test2.script -QuitAfterRun yes

Windows

"C:\Program Files\Eggplant\Eggplant.bat" -RunOnLaunch "C:\Users\Alex\Documents\MySuite.suite\Scripts\test2.script" -QuitAfterRun yes

Linux

Eggplant -RunOnLaunch ~/Documents/appTests.suite/Scripts/test1.script ~/Documents/appTests.suite/Scripts/test2.script -QuitAfterRun yes

-ドキュメントを再度開く

使用

ブール値。 (はい/いいえ) Eggplant Functional を起動するときに、最後に開いていたスイートとスクリプトを再度開くかどうかを指定します。

例

Mac

/Applications/eggPlant.app/Contents/MacOS/Eggplant -ReopenDocuments No

Windows

"C:\Program Files\Eggplant\Eggplant.bat" -ReopenDocuments no

Linux

Eggplant -ReopenDocuments no

注記

このパラメータは、Eggplant Functionalの一般設定前回のセッションからスイートを再開するを上書きします。

-接続の復元

使用

ブール値。 (はい/いいえ) Eggplant Functional の起動時に最後のセッションからの接続を復元するかどうかを指定します。

例

Mac

/Applications/eggPlant.app/Contents/MacOS/Eggplant -RestoreConnection yes

Windows

"C:\Program Files\Eggplant\Eggplant.bat" -RestoreConnection yes

Linux

Eggplant -RestoreConnection yes

注記

このパラメータは、Eggplant Functionalの一般設定前回のセッションからの接続を再開するを上書きします。

-RunOnLaunch

使用

スクリプトまたはスイート スケジュールへのパス。 Eggplant Functional の起動時に、指定されたスクリプトまたはスイート スケジュールを呼び出します。

例

Mac

/Applications/eggPlant.app/Contents/MacOS/Eggplant -RunOnLaunch /Users/Alex/Alex_Tests.suite/Schedule1

Windows

"C:\Program Files\Eggplant\Eggplant.bat" -RunOnLaunch "C:\Users\Alex\Documents\Eggplant\MySuite.suite\Schedule1"

Linux

Eggplant -RunOnLaunch ~/Documents/appTests.suite/scripts/test1.script

-スケールリモートスクリーン

使用

ブール値。デフォルト: オフ。 ScreenScaleRatio 設定で別途指定されていない限り、モバイル (iOS または Android) デバイスのリモート画面を元のサイズの 50% に拡大縮小します。コマンドラインフラグとしても渡されます。 VNC 接続でのみ使用できます。

重要

コマンドラインで一度設定すると、この設定は、その接続のEggplant Functional接続リスト項目に永続化されます。これは、scaleRemoteScreenをオフに設定する別のコマンドライン呼び出しを実行するか、Eggplant Functional接続インターフェイスのScreen Scale Ratioチェックボックスの選択を解除することで、再設定することができます。

例

Mac

/Applications/Eggplant.app/Contents/MacOS/Eggplant -RunOnLaunch ~/Desktop/MySuite.suite/Scripts/ToRunFromCLI.script -scaleRemoteScreen yes -host 10.1.11.111 -port 5902 -password securePassword

Windows

“C:\Program Files\Eggplant\Eggplant.bat” -RunOnLaunch “C:\Users\Dave\My Documents\MySuite.suite\Scripts\ToRunFromCLI.script” -scaleRemoteScreen yes -screenScaleRatio 3 -host 10.1.11.150 -port 5901 -password securePassword

Linux

eggplant -RunOnLaunch ~/Documents/TestSuite.sute/Scripts/ToRunfromCLI.script -scaleRemoteScreen yes -screenScaleRatio 2 -host 10.1.11.182 -port 5902 -password securePassword

-画面スケール比

使用

整数値 N。 画面のスケール比 1:N を決定します。N はユーザーが指定した整数値です。この設定は、ScaleRemoteScreen 設定で使用されるスケールを変更します。デフォルトの N 値は 2 (リモート画面を 50% に拡大縮小します) です。

例

Mac

/Applications/Eggplant20.app/Contents/MacOS/Eggplant -RunOnLaunch ~/Desktop/Elizabeth.suite/Scripts/ToRunFromCLI.script -scaleRemoteScreen yes -scaleScreenRatio 3 -host 10.1.11.120 -port 5901 -password securePassword

Windows

“C:\Program Files\Eggplant\Eggplant.bat” -RunOnLaunch “C:\Users\Dave\My Documents\MySuite.suite\Scripts\ToRunFromCLI.script” -scaleRemoteScreen yes -screenScaleRatio 4 -host 10.1.11.111 -port 5902 -password securePassword

Linux

eggplant -RunOnLaunch ~/Documents/TestSuite.sute/Scripts/ToRunfromCLI.script -scaleRemoteScreen yes -screenScaleRatio 3 -host 10.1.11.210 -port 5901 -password securePassword