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

実行オプションのグローバルプロパティ

これらのグローバルプロパティは、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 PreferencesDiagnosticsタブの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:

// グローバルプロパティの現在の設定を変数 '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"
//変数からグローバルプロパティを元の設定に戻します
set the AutoImageUpdateDiagnostics to OrigSettings

関連項目:

  • The AutoOCRUpdateDiagnostics
  • The ImageUpdateDiagnostics
  • The OCRUpdateDiagnostics

The AutoOCRUpdateDiagnostics

値: CaseSensitive, IgnoreSpaces, TextDifference, ValidCharacters, ValidWords, DPI, Language

デフォルト: Run PreferencesDiagnosticsタブの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 ImageSearchDelaythe 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 ImageSearchCountthe 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は、別々のKeyDownKeyUpコマンドの間の待機時間を管理しません。KeyUpKeyDownの間の待機時間を影響させるには、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に送信されるmouseDownmouseUpイベントの間の待機時間を決定します。

先端

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

Value: Time (in seconds).

Default: 0.01

Behavior: The MouseMoveDelayは、SUT上のマウスの移動の各ステップ間の待機時間を決定します。

Example:

Set the MouseMoveDelay to .06

関連項目:

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

関連項目:

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

関連項目:

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 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

例:

現在の SwipeSpeed を変数に格納します
put the SwipeSpeed into SS
put 10 into the SwipeSpeed
SwipeUp
SwipeSpeed を変数に格納されている値に戻します。
put SS into the SwipeSpeed
SwipeLeft

Example:

各スワイプを短くし、スワイプをより予測しやすくします
set the swipespeed to 2
WaitFor:0は、Eggplant Functionalに、デフォルトの7回ではなく、1回だけ画像をスキャンするように指示します
repeat until imagefound(image:"MenuOption",waitFor:0)
// 条件付き文を使用して、繰り返しループが4回繰り返されたら例外をスローして実行を停止します
if the counter is 4 then // 繰り返しループが何回目のイテレーションにあるかを確認します
throw "Image not found.", "Image not found while scrolling."
end if
SwipeUp
wait 2 // スワイプが発生した後、画面が落ち着くのを少し待ちます
end repeat
set the swipespeed to 40 // スワイプ速度をデフォルトの40に設定します

The WebElementDisplay

Value: Short or long.

Default: Long

Behavior: このグローバルプロパティは、実行の結果ログやスクリプトで呼び出されたときのWebElementオブジェクトの表示方法を制御します。つまり、put myElement。現在のページコンテキストで要素が利用できない場合、WebElementオブジェクトはthe WebElementDisplayが長いに設定されていても短い形式で表示されます。

Example:

set the WebElementDisplay to short