実行オプションのグローバルプロパティ
これらのグローバルプロパティは、Eggplant Functionalを使用してSenseTalkスクリプトを実行する際にテスト対象のシステム(SUT)との対話を決定します。デフォルト値はほとんどの状況に適しています。一般的なSenseTalkのグローバルおよびローカルプロパティもEggplant Functionalスクリプティングで役立つことを覚えておいてください。(例えば、the colorFormat
グローバルプロパティ)
以下に説明する実行オプションのプロパティに加えて、SenseTalkにはEggplant Functional用の追加のアプリケーション固有のプロパティが含まれており、これらは一般的にアプリケーションの環境がSenseTalkスクリプトとどのように動作するかに影響を与えます。
これらの値は、Eggplant > Preferencesへ移動してからRunタブを選択することで、Eggplant FunctionalのRun設定の一部として設定することができます。スクリプト内のプロパティの値を変更すると、その実行時間の値が 影響を受けますが、アプリケーションの設定で設定された値は変更されません。
ローカルとグローバルのプロパティの一般的な使用については、SenseTalkのローカルとグローバルプロパティを参照してください。
The AdaptiveImageTolerance
値: 正の数。
デフォルト: 30
動作: Adaptive to Image検索タイプのキャプチャ画像と潜在的な画像マッチとの間の変化に対する感度を調整します。検索許容範囲については、Toleranceを参照してください。
この値を100以上に設定すると、誤陽性のマッチが発生する可能性があります。
Example:
set the AdaptiveImageTolerance to 45
The AutoImageUpdateDiagnostics
値: DynamicTolerance
, AlternateTypes
, ScalingSearch
, DiscrepancySearch
, CropEdges
, OCRSearch
, PriorLocation
, OriginalLocation
デフォルト: Run PreferencesのDiagnosticsタブのAutomatic Image Diagnosticsセクションで設定された値を使用します。ただし、プリファレンスパネルで行われた変更は、アプリケーションを再起動した後までデフォルト値に反映されないことに注意してください。
動作: The AutoImageUpdateDiagnostics
は、Image Update パネルのAuto Updateオプションを使用した場合の画像検索に使用される検索診断を決定します。このグローバルプロパティを使用して、特定の検索に必要に応じてスクリプトの実行中の診断を変更することができます。
各検索診断の動作については、Image Diagnostics Selectionsを参照してください。Image Updateパネルについての情報は、The Image Update Panelを参照してください。
Example:
set the AutoImageUpdateDiagnostics to(DynamicTolerance, AlternateTypes, ScalingSearch, DiscrepancySearch, CropEdges, OCRSearch, PriorLocation, OriginalLocation)
Example:
// Stores the current settings of the global property in the variable 'OrigSettings'
put the AutoImageUpdateDiagnostics into OrigSettings
// Changes the setting for the global property
put the AutoImageUpdateDiagnostics into OrigSettings
click "oContacts" // Performs a search action using the new diagnostics settings
click image:"oContacts"
// Returns the global property to its original settings from the variable
set the AutoImageUpdateDiagnostics to OrigSettings
関連項目:
The AutoOCRUpdateDiagnostics
The ImageUpdateDiagnostics
The OCRUpdateDiagnostics
The AutoOCRUpdateDiagnostics
値: CaseSensitive
, IgnoreSpaces
, TextDifference
, ValidCharacters
, ValidWords
, DPI
, Language
デフォルト: Run PreferencesのDiagnosticsタブのAutomatic OCR Diagnosticsセクションで設定された値を使用します。ただし、プリファレンスパネルで行われた変更は、アプリケーションを再起動した後までデフォルト値に反映されないことに注意してください。
動作: The AutoOCRUpdateDiagnostics
は、OCR UpdateパネルのAuto Updateオプションを使用した場合のOCRテキスト検索に使用される検索診断を決定します。このグローバルプロパティを使用して、特定の検索に必要に応じてスクリプトの実行中の診断を変更することができます。
各検索診断の動作については、OCR Diagnostics Selectionsを参照してください。OCR Updateパネルについての情報は、The OCR Update Panelを参照してください。
Example:
set the AutoOCRUpdateDiagnostics to(CaseSensitive, IgnoreSpaces, TextDifference, ValidCharacters, ValidWords, DPI, Language)
Example:
// Stores the current settings of the global property in the variable 'OrigSettings'
put the AutoImageUpdateDiagnostics into OrigSettings
set the AutoOCRUpdateDiagnostics to (CaseSensitive, ValidCharacters)
click text:"Testplant"
// Returns the global property to its original settings from the variable
put the AutoImageUpdateDiagnostics into OrigSettings
関連項目:
The AutoImageUpdateDiagnostics
The ImageUpdateDiagnostics
The OCRUpdateDiagnostics
The ForceScreenRefresh
値: True または False.
デフォルト: False.
動作: The ForceScreenRefresh
は、各コマンドの後でEggplant Functionalがビューアウィンドウをリフレッシュするかどうかを決定します。
Example:
SetOption ForceScreenRefresh, true
the ForceScreenRefresh
は、めったに必要ないし、スクリプトの実行を大幅に遅くします。しかし、画面のアーティファクトを大量に生成しているSUTや、VNCサーバーを介してうまく表示されないソフトウェアを実行している場た場合には役立つかもしれません。
The ImageSearchCount
値: 正の整数。
デフォルト: 7
動作: The ImageSearchCount
は、Eggplant Functionalがビューアウィンドウをスキャンして画像を探す回数を決定します。WaitFor
を含む画像検索を行う場合、Eggplant Functionalは自動的にthe ImageSearchDelay
をthe ImageSearchCount
に従って調整します。また、the ImageSearchTime
グローバルプロパティを使用して、画像またはテキスト(OCR)検索のセクションの検索時間を影響させることもできます。
the ImageSearchCount
を1に設定すると、画像検索は現在のビューアウィンドウのみを見て、ImageSearchDelay
、画面のリフレッシュ、マウスの再位置決めをバイパスします。この設定は、検索を行う最速の方法ですが、失敗する可能性があります。
WaitFor
コマンドとWaitFor
プロパティは、単一の画像検索のために間接的にthe ImageSearchCount
を設定するために使用できます。Eggplant Functionalアプリケーションは、the ImageSearchDelay
によって指定された頻度で、WaitFor
によって指定された時間に可能な限り多くのスキャンを適応させます。
Example:
SetOption ImageSearchCount, // WaitForを介してimageSearchTimeの上書きを持たない任意の画像検索の画像検索のスキャン回数を3に設定します
SetOption ImageSearchTime, Ist
Example:
SetOption ImageSearchCount, 5 // ImageSearchCountを5に設定し、間接的にImageSearchDelayを.36に変更します
SetOption ImageSearchTime, Ist
WaitFor 10, "Dialog" // .36のImageSearchDelayに基づいて、画像を28回スキャンします
WaitFor 10, "SaveDialog"
Example:
imageSearchCount の現在の値を変数に格納します
set ISC to the imageSearchCount
// Set the imageSearchDelay to 1
set the imageSearchDelay to 1
// Scans for the image only once per execution of the imagefound() function
repeat until imagefound(image:"Footer")
imagefound() 関数の実行ごとに 1 回だけ画像をスキャンします
repeat until imagefound(image:"Footer")
画像の表示に時間がかかりすぎる場合、繰り返しループを終了したり、実行を終了したり、スクリプトを失敗させたりする方法として、エラー処理を提供します
repeatindex() = 10ならば、"Image not found", "Image not found while scrolling."を投げる
SwipeUp // 画像が見つからない場合、画面を上にスワイプします
end repeat
ImageSearchCount を元の値に戻します
set the imageSearchDelay to 1
Example:
WaitFor 0, "Done_Button" // 実行スキャン = (120/the ImageSearchDelay + 1 scans)、最も近い整数に切り捨てます
Click (ImageName: "Done_button", waitFor: 2 minutes)
Example:
WaitFor 0, "Done_Button" // 実行スキャン = (10/the ImageSearchDelay + 1 scans)、最も近い整数に切り捨てます
WaitFor 10, "LuckyButton"
waitFor
の0は、the ImageSearchCount
を1に設定する特別な値です。
Example:
imagefound() 関数の実行ごとに 1 回だけ画像をスキャンします
repeat until imagefound(image:"Footer")
// 画像が許容可能なイテレーション数後に見つからない場合、リピートループを終了するためのエラーハンドリングを提供します SwipeUpend repeat
repeatindex() = 7ならば、"Image not found", "Image not found while scrolling."を投げる
SwipeUp
end repeat
関連項目:
The ImageSearchDelay
Value: Time (in seconds).
デフォルト: 0.3
例:
振る舞い: The ImageSearchDelay
は画像を検索する間の待ち時間を決定します。
Example:
Set the ImageSearchDelay to .6
Example:
Set the imageSearchDelay to // 過渡的な要素の検出を確実にするために、スキャンの頻度を増加させます。Eggplant Functionalはこの頻度でエリアを検索しようとしますが、エリアが大きい場合や画像コレクションを検索している場合など、各スキャンが完了するのを許すように頻度を自動的に調整します。
Set the imageSearchDelay to 0.1
検索領域を画面のサブセットに制限し、imageSearchDelay を低くします
WaitFor 1, (imageName:"RedLight", searchRectangle:("SignalUpperLeft","SignalLowerRight"))
関連項目:
The ImageSearchTime
Value: Time (in seconds).
デフォルト: 1.8
振る舞い: Eggplant Functionalが画像検索またはテキスト(OCR)検索に失敗を報告する前に費やす時間を決定します。これはthe ImageSearchCount
とthe ImageSearchDelay
に影響を受けます。
実際の検索時間はthe ImageSearchTime
で指定された時間よりも長くなることがあります。例えば、ImageSearchTime
を.3、ImageSearchDelay
を.3とすると、通常2回のスキャンが実行され、そのうちの2回目は.3秒後に始まります。その後、スキャンは.3秒を過ぎてから完了しなければなりません。さらに、the ImageSearchTime
を.3、the ImageSearchDelay
を.3に設定した場合、Eggplant Functionalは常に2回のスキャンを試みますが、各スキャンが大画面サイズや大量の画像コレクションなどの要因により、the ImageSearchDelay
の.3秒よりも時間がかかる場合、スキャンの頻度は要因を収容するように自動的に伸び、全体の検索時間がthe ImageSearchTime
の.3秒よりも長くなります。
実際の検索時間はthe ImageSearchTime
で指定された時間よりも短くなることもあります。例えば、ImageSearchTime
を.5、ImageSearchDelay
を.5とした場合、最大2回のスキャンを開始するだけの時間しかありません。3回目のスキャンは.6秒以上の時間が経過しないと発生しません。もし2回目のスキャンが.2秒未満で実行完了した場合、全体の検索時間は.5秒未満になる可能性があります。
Example:
Set the ImageSearchTime to 5
関連項目:
The ImageUpdateDiagnostics
値: StandardSearch
, DynamicTolerance
, AlternateTypes
, ScalingSearch
, DiscrepancySearch
, OCRSearch
, PriorLocation
, OriginalLocation
, CropEdges
振る舞い: The ImageUpdateDiagnostics
は、Image UpdateパネルのManual Updateオプションを使用するときに、どの検索診断が画像検索に使用されるかを決定します。このグローバルプロパティを使用して、特定の検索に必要に応じてスクリプトの実行中に診断を変更できます。
各検索診断の動作については、Image Diagnostics Selectionsを参照してください。Image Updateパネルについての情報は、The Image Update Panelを参照してください。
各検索診断の動作については、Image Diagnostics Selectionsを参照してください。Image Updateパネルについての情報は、The Image Update Panelを参照してください。
Example:
set the ImageUpdateDiagnostics to (StandardSearch, DynamicTolerance, AlternateTypes, ScalingSearch, DiscrepancySearch, CropEdges, OCRSearch, PriorLocation, OriginalLocation)
関連項目:
The AutoImageUpdateDiagnostics
The AutoOCRUpdateDiagnostics
The OCRUpdateDiagnostics
The KeyDownDelay
Value: Time (in seconds).
デフォルト: 0.001
振る舞い: The KeyDownDelay
は、SUTに送信されるキーダウンイベントとキーアップイベントの間の待機時間を決定します。
the KeyDownDelay
は、別々のKeyDown
とKeyUp
コマンドの間の待機時間を管理しません。KeyUp
とKeyDown
の間の待機時間を影響させるには、the RemoteWorkInterval
を使用してください。
the KeyDownDelay
のデフォルト値は非常に高速で、特定のウェブブラウザやアプリにとっては速すぎることがあります。そのため、TypeText
コマンドで使用される文字がSUTに受け取られない場合があります。the KeyDownDelay
をSUTに適した速度に調整す ることで、SUTが文字を見落とすことがなくなります。the KeyDownDelay
が助けにならない場合は、the NextKeyDelay
を試してみてください。
Example:
SetOption KeyDownDelay, .05
Example:
set the KeyDownDelay to .1 // 各キーを0.1秒間押し続けてから離す
TypeText "www.yahoo.com",return // KeyDownとKeyUpの両方のイベントはTypeTextコマンドに組み込まれているため、指定された文字列の各キー(Returnキーも含む)はKeyDownDelayの影響を受けます
関連項目:
The MouseClickDelay
Value: Time (in seconds).
Default: 0.02
Behavior: The MouseClickDelay
は、SUTに送信されるmouseDown
とmouseUp
イベントの間の待機時間を決定します。
the MouseClickDelay
のデフォルト値は非常に高速で、特定のアプリケーションにとっては速すぎることがあります。そのため、デフォルト値を使用するクリックやタップがアプリケーションに反応しないことがあります。the MouseClickDelay
をSUTに適した速度に調整することで、SUTがクリックやタップイベントを認識するようになります。
Example:
set the MouseClickDelay to .5
The MouseDoubleClickDelay
Value: Time (in seconds).
Default: 0.01
Behavior: The MouseDoubleClickDelay
は、ダブルクリックがSUTに送信された際、最初のクリック(mouseUp
イベント)の終了から二回目のクリック(mouseDown
イベント)の開始までの待機時間を決定します。
the MouseDoubleClickDelay
のデフォルト値は非常に高速で、特定のアプリケーションにとっては速すぎることがあります。そのため、デフォルト値を使用するダブルクリックやダブルタップがアプリケーションに反応しないことがあります。the MouseDoubleClickDelay
をSUTに適した速度に調整することで、SUTがクリックやタップイベントを認識するようになります。
Example:
Set the MouseDoubleClickDelay to .004
The MouseDragSpeed
Value: A number, 0 or greater.
Default: 10
Behavior: The MouseDragSpeed
は、ドラッグコマンド中にSUTのマウスが移動する速度を決定します。この値は、Eggplant FunctionalがSUTのマウスをドラッグする各ステップでのピクセル数を表します。(ステップ間では、the MouseMoveDelay
値の長さだけ一時停止します。)
Example:
Set the MouseDragSpeed to 12
Example:
setOption mouseDragSpeed, 5 // Eggplant FunctionalがSUTのマウスを各ステップでドラッグするピクセル数をデフォルト値から減らす
Drag "ItemtoDrag"
Drop "DropLocation"
setOption mouseDragSpeed, 10
関連項目:
The MouseMoveDelay
Global PropertyThe MouseMoveMode
Global PropertyThe MouseMoveSpeed
Global Property
The MouseMoveDelay
Value: Time (in seconds).
Default: 0.01
Behavior: The MouseMoveDelay
は、SUT上のマウスの移動の各ステップ間の待機時間を決定します。
Example:
Set the MouseMoveDelay to .06
関連項目:
The MouseDragSpeed
Global PropertyThe MouseMoveMode
Global PropertyThe MouseMoveSpeed
Global Property
MouseMoveMode
デフォルト: 0
デフォルト: 0
挙動: MouseMoveMode
はマウスが一つの位置から次の位置へ移動する経路を決定します。オプションは次のとおりです:
- 0: マウスは直線で移動します。
- 1: マウスはまず水平に、次に垂直に移動します。
- 2: マウスはまず垂直に、次に水平に移動します。
もし MouseMoveSpeed
の値が0なら、 マウスは次の位置に瞬時にジャンプし、MouseMoveMode
の値は関係ありません。
例:
SetOption MouseMoveMode, 1
Example:
Click "ObjectsMenu"
put the MouseMoveMode into MMM
set the MouseMoveSpeed to 10
set the MouseMoveMode to 2 // マウス移動速度が0から変更されたため、マウス移動モードが2に設定された場合、マウスカーソルは最初に垂直に移動し、次に水平に移動して新しい位置に移動します
Moveto "Circles"
Moveto text:"Radius"
Click "Value"
set the MouseMoveMode to MMM
set the MouseMoveSpeed to 0
関連項目:
The MouseDragSpeed
Global PropertyThe MouseMoveDelay
Global PropertyThe MouseMoveSpeed
Global Property
MouseMoveSpeed
Value: A number, 0 or greater.
デフォルト: 0.01
挙動: MouseMoveSpeed
は、ビューワウィンドウ内でSUTマウスがどれだけ速く移動するかを決定します。この値は、Eggplant FunctionalがSUTマウスを一歩ずつ移動させるピクセル数を表します。(ステップ間には、MouseMoveDelay
値の長さの一時停止があります。)
デフォルト値の0では、マウスは現在の位置から次のポイントへ一歩でジャンプします。
一部のシステム(特に特定のLinuxシステム)、アプリケーション(Flashアプリケーションなど)、VNC技術(特にKVM-over-IPデバイス)は、デフォルトのMouseMoveSpeed
値の下でマウスを追跡したり認識したりするのが難しい場合があります。これらの環境では、値を10から始めて、必要に応じて値を減らして適切なものを見つけます。逆に、10が十分に遅い場合は、SUTが追跡できなくなる前にマウスがどれだけ速く動くことができるかを確認するために、値を増やしてみることができます。
Example:
SetOption MouseMoveSpeed, 10
関連項目:
The MouseDragSpeed
Global PropertyThe MouseMoveDelay
Global PropertyThe MouseMoveMode
Global Property
NextKeyDelay
Value: Time (in seconds).
Default: 0.01
挙動: NextKeyDelay
は、SUTに送信されるキーストロークの間の待ち時間を決定します。
NextKeyDelay
のデフォルト値は非常に高速で、特定のウェブブラウザーやアプリケーションには速すぎることがあります。そのため、TypeText
コマンドで使用される文字がSUTに受信されないことがあります。NextKeyDelay
をSUTに適した遅い速度に調整することで、SUTが文字を見逃さないことを保証します。NextKeyDelay
の調整が問題を解決しない場合は、KeyDownDelay
も変更してみてください。
Example:
SetOption NextKeyDelay, .08
Example:
set the nextKeyDelay to .1
TypeText "812903812903801983012830912830912830193801238"
関連項目:
The OCRUpdateDiagnostics
Value: StandardSearch
, CaseSensitive
, IgnoreSpaces
, TextDifference
, ValidCharacters
, ValidWords
, DPI
,Language
Behavior: the OCRUpdateDiagnostics
は、OCR UpdateパネルのManual Updateオプションを使用するときにOCRテキスト検索に使用する検索診断を決定します。このグローバルプロパティを使用して、特定の検索に必要に応じてスクリプトの実行中に診断を変更することができます。
各検索診断がどのように動作するかについての情報は、OCR Diagnostics Selectionsを参照してください。OCR Updateパネルについての情報は、The OCR Update Panelを参照してください。
各検索診断の動作については、OCR Diagnostics Selectionsを参照してください。OCR Updateパネルについての情報は、The OCR Update Panelを参照してください。
Example:
set the OCRUpdateDiagnostics to (StandardSearch, CaseSensitive, IgnoreSpaces, TextDifference, ValidCharacters, ValidWords, DPI, Language)
関連項目:
The AutoImageUpdateDiagnostics
Global PropertyThe AutoOCRUpdateDiagnostics
Global PropertyThe ImageUpdateDiagnostics
Global Property
The PreciseImageTolerance
Value: An integer, 0-255.
Default: 1
Behavior: Precise to Image 検索タイプで使用されるデフォルトのトレランスを設定します。検索トレランスについての詳細は、Toleranceを参照してください。
例:
Set the PreciseImageTolerance to 3
The RemoteWorkInterval
Value: Time (in seconds).
Default: 0.7
Behavior: The RemoteWorkInterval
は、Eggplant FunctionalがSUTがタスクを実行するために許可する最小時間を決定します。この設定は、SUTとの相互作用の全体的な速度を制御する重要なタイミングパラメータです。
Example:
SetOption RemoteWorkInterval, 1
Example:
各アクション (Click、TypeText) 間で許容される最小遅延を .1 秒に短縮します
set the remoteWorkInterval to .1
Click "FirstNameField"
TypeText "Bob"
Click "LastNameField"
TypeText "Anderson"
Click "AgeField"
TypeText "33"
The SendShiftForCaps
**Value:**Value: Yes, Always, and Never.
Default: Yes
Behavior: The SendShiftForCaps
は、大文字がSUTに送られる際にShiftKeyDown
を使用するかどうかを決定します。
- Yes: モディファイヤーキーのパラメーターを含まないコマンドで大文字を入力するためにShiftキーを送ります。例えば、
TypeText AltKey & "S"
ではShiftを送って大文字のSを生成することはありません。なぜなら、その結果をAlt+s
からShift+Alt+s
に変えるからです。しかし、TypeText "Seattle"
では、大文字のSを入力するためにShiftを送ります。 - Always:
TypeText
パラメーターに大文字が現れるたびに、ShiftキーをSUTに送ります。 - Never: 大文字を入力するためにShiftを送ることはありません。(ただし、
ShiftKey
パラメーターを明示的に渡すことでShiftキーを送ることは可能です。)
Example:
Set the SendShiftForCaps to yes
The ShouldRepositionMouse
Values: True or false.
Default: False
Behavior: the ShouldRepositionMouse
は、画像検索中にSUTマウスがビューアウィンドウの右下隅(または the RepositionPoint
の座標)に移動するかどうかを決定します。(マウスを再配置することで、他の場所の画像を覆い隠すことを防ぎます。)the ShouldRepositionMouse
は、ポップアップメニューやツールチップなどのマウスオーバーイベントが発生し、確認しているUI要素を覆い隠す可能性がある場合に特に関連します。
Example:
Set the ShouldRepositionMouse to True
Example:
setoptions (shouldrepositionmouse:true,repositionpoint:(10,10)) // 一つのコマンドで、ShouldRepositionMouseを有効にし、RepositionPointを座標位置(10,10)に変更します
WaitFor 5, "DesktopIcon"
Example:
set the shouldrepositionmouse to true // shouldrepositionmouseがfalseに設定されていると、カーソルはアカウントメニュー要素の上に停留し、ポップアップメニューを作成し、UIの一部を覆い隠します。
この動作により、検索する次の要素が非表示になる場合があります。これをtrueに設定すると、Eggplant Functionalは自動的にカーソルをRepositionPointに移動します
(デフォルトでは画面の右下隅) は、要素の最初のスキャンで画像またはテキスト(OCR) が見つからない場合です。
set the ShouldRepositionMouse to True
Click "UniversalMenu_Account"
Click "Account Details"
The StandardImageTolerance
Value: An integer, 0-255.
Default: 45
Behavior: Tolerant to Background画像検索タイプで使用されるデフォルトの許容値を設定します。検索許容値の詳細は、Toleranceを参照してください。
デフォルトの値は、ほとんどの状況に適しています。実用的な値は0から100の範囲ですが、80以上の値は誤検出を引き起こす可能性 があります。
Example:
Set the StandardImageTolerance to 50
Example:
SetOption PreciseImageTolerance, 4
The SwipeSpeed
Value: A number, 0 or greater.
Default: 40
Behavior: This global property controls the speed at which swipe events occur. The value represents the number of pixels EggplantFunctionalがSUTマウスを一歩ごとにドラッグするピクセル数を表します。
Example:
Set the SwipeSpeed to 3