メインコンテンツまでスキップ
バージョン:23.3

Eggplant Functionalのインターフェースと実行オプションの制御

これらのコマンドと関数を使用すると、Eggplant FunctionalのGUIのオプションを設定し、スクリプトの実行オプションを変更できます。

PauseScript コマンド

動作: 次のコマンドの前にスクリプトの実行を一時停止します。スクリプトは、手動で続行、ステップ先、または中止するまで一時停止したままになります。詳細については、実行ウィンドウを参照してください。

ノート

このコマンドは、Eggplant Functionalがコマンドラインから実行されている場合は影響しません。

パラメーター: なし。

例:

PauseScript

SetOption, SetOptions コマンド

動作: 現在のスクリプトの実行オプションの値を変更します。

パラメーター: 1つ以上のグローバルプロパティとそれらを変更する値。詳細については、SenseTalkのローカルおよびグローバルプロパティを参照してください。

例:

SetOption ShouldRepositionMouse:yes

例:

SetOptions {searchRectangle:["FormUpperLeft","FormLowerRight"], NextKeyDelay:.1, RemoteWorkInterval:.2}

GetOption, GetOptions 関数

動作: 指定されたグローバルプロパティの現在の値を返します。

先端

パラメータ値を渡さない場合、GetOptionGetOptionsは、すべてのRun Optionグローバルプロパティとその現在の値のリストを返します。詳細については、SenseTalkのローカルおよびグローバルプロパティを参照してください。

パラメーター: なし、1つ以上のグローバルプロパティ、またはグローバルプロパティグループ。

返り値: 指定されたグローバルプロパティの値、またはグローバルプロパティのリスト。例えば:

(defaultCaptureScreenSize:"", defaultScale:"", enableBackslashEscapeCodes:"False", forceScreenRefresh:"False", hotSpotScaling:"Inner", imageSearchCount:"7", imageSearchDelay:"0.3", keyDownDelay:"0.001", mouseClickDelay:"0.02", mouseDoubleClickDelay:"0.01", mouseDragSpeed:"10", mouseMoveDelay:"0.01", mouseMoveMode:"0", mouseMoveSpeed:"0", mouseRepositionSpeed:"0", nextKeyDelay:"0.1", preciseImageTolerance:"1", remoteWorkInterval:"0.2", scaleMultiplier:"1", sendShiftForCaps:"True", shouldRepositionMouse:"False", standardImageTolerance:"45", swipeSpeed:"40")

例:

log GetOption()

例:

put GetOption(scriptLogging)

例:

log GetOptions(TextOptions)

グローバルプロパティグループは以下の通りです:

Hide RunWindowShow RunWindow コマンド

動作: Runウィンドウを非表示または表示します。

ノート

このコマンドは、Eggplant Functionalがコマンドラインから実行される場合には影響を及ぼしません。

先端

Hideコマンドを使用して、スクリプトの実行を見る必要がない場合にRunウィンドウを閉じ、見たいRunの部分のRunウィンドウを表示するためにShowコマンドを挿入することができます。

パラメーター: なし。

例:

Show RunWindow

例:

Hide RunWindow

Hide RemoteWindowShow RemoteWindow コマンド

動作: Viewerウィンドウを非表示または表示します。(スクリプトが実行中でもViewerウィンドウを表示する必要はありません。)

ノート

このコマンドは、Eggplant Functionalがコマンドラインから実行される場合には影響を及ぼしません。

先端

Hideコマンドを使用して、そのSUTに対するスクリプトの実行を見る必要がない場合にViewerウィンドウを閉じ、見たい実行の部分のViewerウィンドウを表示するためにShowコマンドを挿入することができます。

パラメーター: なし。

例:

Show RemoteWindow

例:

Hide RemoteWindow

RunningFromCommandLine 関数

動作: スクリプトの実行がコマンドライン呼び出しから開始された場合はyesを返し、スクリプトがGUIインターフェイスを通じて実行されている場合はnoを返します。

パラメーター: なし。

例:

Log "Running from command line?:"&&RunningFromCommandLine()//RunningFromCommandLine()からの戻り値と文字列を連結してログに出力します

例:

params DebuggingMode //このパラメータにはtrueまたはfalseを渡します
if RunningFromCommandLine() and DebuggingMode then//RunningFromCommandLineとDebuggingModeの両方が"true"であるかをチェックします
TraceScreen On //TraceScreenをオンにします。これはデバッグに使用されます
set the ImageUpdate to "Auto" //ImageUpdateグローバルプロパティをAutoに設定します。これにより、ImageNotFoundの診断が一致する場合に、画像/OCRの更新を自動的にキャッシュできます
SetOption ValidateImagefound, true //ImageFoundがfalseを返すと、ImageUpdateをトリガーできます(デフォルトはfalse)
end if

例:

put ["ManchesterCity","CrystalPalace","LeicesterCity","SwanseaCity"] into teamList //teamListという変数にサッカーチームのリストを保存します
if not RunningFromCommandLine() then
//answerコマンドは、スクリプトのチーム入力を手動で選択するためのダイアログを提供します。answerコマンドはeggPlant GUIを使用するときにのみ効果的です
answer "どのプレミアリーグのサッカーチームを対象にしますか?" from list teamList//このコードはRunningFromCommandLineが"false"を返す場合にのみ実行されます
put it into team
else
put any item of teamList into team //RunningFromCommandLineが"true"を返す場合、teamはteamListからランダムに選択されます
end if
TypeText team

例:

//このコードは、スクリプトを他人にデモするために、GUIからスクリプトを実行するときにのみ、eggPlantの動作を遅くします
if RunningFromCommandLine() is false
set the MouseMoveSpeed to 6 //MouseMoveSpeedを調整すると、マウスカーソルがSUT上で位置間をスムーズに移動するようになります(デフォルトは0)
set the NextKeyDelay to .08
set the RemoteWorkInterval to 2.2
end if

HighlightRectangle コマンド

振る舞い: 指定された矩形をViewerウィンドウで赤く強調表示します。期間を指定した場合、強調表示は指定された時間の後に消えます。期間を指定してHighlightRectangleを選択肢またはAd Hoc Do Boxで実行するときには、期間を指定しても効果はありません。

パラメータ: 一つの矩形値。さらに、任意の期間値。

例:

HighlightRectangle[FoundImageLocation(), FoundImageLocation() + [50,10]]

例:

HighlightRectangle[ImageLocation("AnchorUpperLeft"), ImageLocation("AnchorLowerRight"), {duration:10 seconds}] //Defines the rectangle based on the ImageLocation() of two images

関連:

OpenSuite および CloseSuite コマンド (廃止予定)

ノート

これらのコマンドは廃止予定です。新しいスクリプト開発にはInitialSuitesおよびFinalSuitesを使用してください。スイートへのアクセスにInitialSuitesグローバルプロパティを変更することは、OpenSuiteコマンドを使用することよりもほぼ常に好ましいです。InitialSuitesで開くスイートは常に、画像とスクリプトリソースをチェックする最初のスイートであり、渡された順番でチェックされます。OpenSuiteコマンドで開くスイートはアクティブスイートの後にチェックされ、OpenSuitesがチェックされる順序は予測できません。