バージョン：23.5

Eggplant Functional のグローバルプロパティ

Eggplant Functional のグローバルプロパティは、具体的にはEggplant FunctionalアプリケーションからSenseTalkスクリプトを実行するためのものです。しかし、一般的なSenseTalkのグローバルとローカルプロパティもEggplant Functionalのスクリプト作成に役立ちます。（例えば、The ColorFormat グローバルプロパティなど。）

下記に説明するアプリケーション固有のプロパティに加えて、SenseTalkには、テスト実行の過程でシステムテスト（SUT）とのインタラクションに関連するEggplant Functional用のRun Optionsのグローバルプロパティも含まれています。

これらのグローバルプロパティの多くはEggplant FunctionalのTextとRunの設定（Eggplant > Preferences）に表示されます。グローバルプロパティとして使用することで、スクリプトごとに、または単一のスクリプト内で複数回変更することができます。スクリプト内でプロパティの値を変更すると、その実行時間の値が影響を受けますが、アプリケーションの設定で設定された値は変更されません。

ローカルプロパティとグローバルプロパティの使用に関する一般的な情報については、SenseTalkのローカルとグローバルプロパティを参照してください。

`The CaptureScreenImageFormat` グローバルプロパティ

Value: PNG、JPG、または TIFF

Default: PNG

Behavior: テスト実行中にスクリーンショットをキャプチャする際に、the CaptureScreen コマンドが使用する画像ファイルフォーマットを変更します。

例:

set the CaptureScreenImageFormat to JPG

`The CaptureScreenJPGCompressionQuality` グローバルプロパティ

Value: 1-100 の間の整数Default: 100 (無圧縮；可能な限り無損失)

Default: 0.7秒（または、EggplantのUsabilityタブで設定した値）

Behavior: the CaptureScreen コマンドでキャプチャされたJPG形式のスクリーンショットの圧縮品質を調整します。この数字は、画像圧縮中に保持される画像品質のパーセンテージを示し、1は画像データの損失が多く品質が大幅に低下することを示し、100は圧縮が可能な限り100%の元の品質を保持することを意味します。

例：

set the CaptureScreenJPGCompressionQuality to 75 -- 圧縮品質を下げ、ファイルをさらに小さくしますが、一部の画像の明瞭さを犠牲にします

`The CaptureScreenScaleFactor` グローバルプロパティ

Value: 0 から 1 の間の小数値。

Default: 1 (フルサイズ)

Behavior: the CaptureScreen コマンドでキャプチャされた画像のスケールを調整します。例えば、the ScaleFactorForCaptureScreenを.5に設定すると、スクリーンショットが保存される前に、その画像の寸法（高さと幅の両方）を半分にします。したがって、1000x1000ピクセルの画像は500x500ピクセルに削減されます。

ノート

この機能はCaptureScreenコマンドでキャプチャした画像に特有のものであり、画像検索に使用されるスケールファクタとは異なります。キャプチャした画像を検索目的でスケールする方法については、Finding ImagesページのImage ScalingまたはThe ScaleFactors Global Propertyを参照してください。

例:

set the CaptureScreenScaleFactor to .5 -- これにより、画像のスケールが半分になります

`The CollectionFilter` グローバルプロパティ

Value: NameとDescriptionの1つまたは両方を含むプロパティリスト

Default: フィルタなし

Behavior: 指定された文字列を含む名前または説明の画像に検索を制限します。

ノート

画像に説明を設定するには、スイート内の画像ビューアを使用します。

例:

Set the CollectionFilter to (Name: "English", Description: "release 5.0")

例:

params SUTOS
If SUTOS is "iOS"
  set the CollectionFilter to (Name:"iOS")
else if SUTOS is "Android"
  set the CollectionFilter to (Name:"Android")
end if

先端

the CollectionFilterをリセットするには、値を空に設定します。

例:

Set the CollectionFilter to empty

`The CommandLineOutput` グローバルプロパティ

Value: True（またはOn、またはYes）、False（またはOff、またはNo）

Default: False

Behavior: The CommandLineOutputは、UnixまたはWindowsのコマンドラインからスクリプトを実行したときに標準出力ストリームにメッセージを出力するかどうかを制御します。

Off: 標準出力(stdout)には何も出力されません。
On: スクリプトの出力全体がEggplant Functionalのグラフィカルインターフェースに表示されると同時に標準出力ストリームにも送信されます。

例:

Set the CommandLineOutput to On

例:

SetOption CommandLineOutput, Off

先端

The CommandLineOutputはrunscript command line optionとしても利用できます。

`The CompareScreenAction` グローバルプロパティ

Value: ShowPanel、LogWarning、LogError、またはShowPanelAlways

設定を区別するための略語も許されています：Panel、Warning、Error、またはAlways

Default: ShowPanel

Behavior: このグローバルプロパティは、CompareScreenコマンドを実行したときのアクションを制御します。このプロパティを使用して、スクリプトの実行中の動作を変更することができます。利用可能なオプションは次のとおりです：

ShowPanel: 画面の違いが検出された場合、Compare Screenパネルが開きます。
LogWarning: 画面の違いが検出された場合、警告メッセージがログに記録されます。
LogError: 画面の違いが検出された場合、エラーメッセージがログに記録されます。
ShowPanelAlways: 画面の違いが検出されてもされなくても、Compare Screenパネルが開きます。

例:

set the CompareScreenAction to "Always"

例:

BeginTestCase "Detect Full Screen Differences"
// パネルを表示せずに警告をログに記録するように、比較スクリーンのグローバルプロパティを設定します
set the CompareScreenAction to "LogWarning"
Log "変更する前に、キャプチャした矩形が期待どおりに見つかることを確認します"
"Contacts"をクリック -- チュートリアルSutをデフォルトの画面に戻す
CompareScreen名前："tutorialSutMenus"
Log "さあ、チュートリアルSutの画面を変更しましょう"
"Favorites"をクリック
Log "...そして再度CompareScreenを実行"
CompareScreen名前："tutorialSutMenus"
EndTestCase "全画面の違いを検出"

関連：

`The CurrentCharacterCollection`グローバルプロパティ

Default: 10 (または、EggplantのUsabilityタブで設定した値)

Default: 空

Behavior: このプロパティを使用すると、character プロパティを使用して行われるイメージ検索のためのデフォルトのキャラクターコレクションを設定できます（つまり、キャラクターコレクションを対象とした検索）。 currentCharacterCollection に値を設定すると、character 検索から characterCollection プロパティを省略することができます。また、readCharacters 関数の呼び出し時にも characterCollection プロパティを省略することができます。 readCharacters にキャラクターコレクションの名前を指定するか、characterCollection プロパティで指定することで、currentCharacterCollection グローバルプロパティの値を上書きすることができます。

例:

set the currentCharacterCollection to "iPhoneCharacters"

関連:

`The DefaultCaptureScreenSize` グローバルプロパティ

Value: 画像をキャプチャする時点でのSUTの幅と高さを表す値のリスト。(width,height)として指定します。

Default: 空

Behavior: The DefaultCaptureScreenSizeはEggplant Functional v12.20以前にキャプチャされた任意の画像に対して、画像キャプチャ時のSUTのデフォルトスクリーンサイズを設定します。これは画像検索におけるDynamic Scalingで使用します。詳細はDynamic Scalingを参照してください。

例:

set the DefaultCaptureScreenSize to (1024,768)

`The DefaultUseMarkup`グローバルプロパティ

Values： Auto、Manual、または Off

Default: Inner

Behavior: The DefaultUseMarkupはテキストプロパティリストのTextプロパティ内でサポートされているテキストマークアップが認識されるかどうかを決定します。the DefaultUseMarkupがyesに設定されている場合、サポートされているマークアップは生成されたテキスト画像をフォーマットするために使用されます。the DefaultUseMarkupがnoに設定されている場合、マークアップはリテラルテキストとして扱われます。 (マークアップは常にOCRテキストエンジンを使用するテキストプラットフォームでリテラルテキストとして扱われます。) 例:

例:

set the defaultUseMarkup to No

例:

setoption DefaultUseMarkup, Yes

`The FinalSuites` グローバルプロパティ

Value: 一つまたはそれ以上のスイート名

Default: なし

Behavior: The FinalSuitesグローバルプロパティは、スクリプト自身のスイートが検索された後に、スクリプトまたは画像リソースを検索するスイートまたはスイートを決定します。(the InitialSuitesに名前がつけられたスイートが最初に検索され、次にスクリプト自身のスイートが検索され、その後にthe FinalSuitesが検索されます。)

例:

Set the FinalSuites to ("FallBack") //FinalSuites を"FallBack"という名前のスイートに設定します

例:

set the FinalSuites to the folder of SuiteInfo().Path & "common.suite"

ノート

The FinalSuites/InitialSuitesはグローバルプロパティで指定されたスイートをデフォルトのスイートディレクトリから検索します。スイートがデフォルトのスイートディレクトリに存在しない場合、その完全なファイルパスでスイートを参照する必要があります。

例:

set the FinalSuites to "C:\AutomationScripts\common.suite"

ノート

The FinalSuitesは、スクリプト自体のスイートが検索された後に、the FinalSuitesスイートとヘルパースイートが検索される点で、ヘルパースイートと同様の動作をします。

`The ForceScreenRefresh` グローバルプロパティ

Value: True (または On, または Yes), False (または Off, または No)

Default: False

Behavior: The ForceScreenRefreshは、各コマンドの後にEggplant Functionalがビューアウィンドウを更新するかどうかを決定します。

ノート

The ForceScreenRefreshはまれにしか必要とされませんが、スクリプトの実行を大幅に遅くします。しかし、多くの画面アーチファクトを生成したり、VNCサーバーを介してうまく表示しないソフトウェアを実行したりするSUTでは役立つ場合があります。

例:

SetOption ForceScreenRefresh, true

`The HotSpotScaling` グローバルプロパティ

On: すべてのログコマンドとSUTとのすべてのインタラクションが記録されます。

Value: Inner, All, None

Behavior: このプロパティは、スケール画像を検索するときに画像ホットスポットがスケールするかどうかを決定します。値は次のとおりです：

Inner: ホットスポットが画像の検索可能なピクセル内にある場合、それは画像と共にスケールします。ホットスポットが画像からオフセットされている場合、それはスケールされません。
All: ホットスポットは、スケール画像を検索するときに常に比例してスケールします。
None: スケール画像を検索するときにホットスポットはスケールされません。

例:

Set HotSpotScaling to None

例:

params SUTType
If SUTType is "mobile" then set the HotSpotScaling to All //SUTType パラメータ値として"mobile"が渡された場合、HotSpotScaling を All に設定します。

先端

The HotSpotScalingは、画像のスケーリングを行う際に特に関連しています。これはクロスモバイルテストでよく使用されます。

`The ImageUpdate` グローバルプロパティ

Default: Manual

Default： Manual

Behavior: The ImageUpdateグローバルプロパティは、スクリプト実行中にImage Update panelとOCR Update panelがどのように動作するかを決定します：

Auto: Image UpdateとOCR Updateは、自動的に画像とOCRの失敗を修正し、スクリプトの実行を続行します。最初の画像またはOCRの失敗は警告として記録され、任意の修正アクションも警告として記録されます。変更はキャッシュされますが、スクリプトが更新されるまでコミットされません（OCR）または変更が適用されます（画像）。これは特定のスクリプトの実行に対するResultsのActionドロップダウンリストを使用します。
手動: 画像またはOCR検索が失敗すると、Image UpdateパネルとOCR Updateパネルが開きます。修正した画像またはOCR検索で進行するか、またはスクリプトを失敗させることを選択できます。Updateパネルが開いている時間は、Eggplant Functionalの実行オプション設定のSystem Paneで調整できます。手動はEggplant Functional GUIでスクリプトを実行している場合にのみ有効です。
オフ: Image UpdateパネルとOCR Updateパネルは、スクリプト実行中には使用されません。これにより、画像またはOCR検索が失敗した場合にスクリプトがより早く失敗します。

例:

Set the ImageUpdate to Manual

例:

SetOption ImageUpdate, Off

関連:

the ValidateImageFound

ノート

このコマンドは、廃止されたthe ImageDoctor global propertyの代わりに使用されます。

`The InitialSuites` グローバルプロパティ

Value: 一つまたは複数のスイート名

Default: なし

Behavior: The InitialSuites グローバルプロパティは、現在のスクリプトが呼び出すスクリプトまたは画像リソースを探す最初のスイートまたはスイートを決定します。（the InitialSuites に名前が付けられたスイートは、呼び出しスクリプトの自身のスイートよりも優先されます。）

例:

Set the InitialSuites to ("Windows8Common", "Windows8Calculator")

例:

Params SUTModel
if SUTModel contains "iPhone" or SUTModel contains "iPad" then
  set the initialsuites to "NopCommerceiOS.suite"
else
  set the initialSuites to "NopCommerceAndroid.suite"
end if

ノート

The InitialSuites/FinalSuitesは、グローバルプロパティで指定されたスイートをdefault suite directoryで検索します。スイートがデフォルトのスイートディレクトリに存在しない場合、スイートをその完全なファイルパスで参照する必要があります。

例:

set the InitialSuites to "C:\AutomationScripts\NopCommerceAndroid.suite"

`The OpenTestCases` グローバルプロパティ

Value: 結果のプロパティリストのプロパティリスト。例：

(@"Login.script":(Errors:"0", Exceptions:"0", StartTime:"2016-10-10 16:02:20 -0600", Successes:"0", TestCase:"Login.script", Warnings:"0"), WelcomeLoadTime:(Errors:"0", Exceptions:"0", StartTime:"2016-10-10 16:02:20 -0600", Successes:"0", TestCase:"WelcomeLoadTime", Warnings:"0"))

Default: 空

Behavior: The OpenTestCases グローバルプロパティは、その時点までに開いているすべてのテストケースによって収集された情報にアクセスするために使用されます（テストケースとは何かについての情報は、The BeginTestCase and EndTestCase Commandsを参照してください）。

ノート

初期ハンドラ（スクリプト自体）はテストケースと見なされ、the OpenTestCases グローバルプロパティによって1つのテストケースとして報告されます。宣言されたテストケースが開いていない場合、スクリプト（初期ハンドラ）が唯一の開いているテストケースとして報告されます。

例:

BeginTestCase "WelcomeLoadTime"
//いくつかのアクションを実行する
log the OpenTestCases //Accesses information about the current test cases
//必要に応じてさらにアクションを実行します
EndTestCase "WelcomeLoadTime"
log the result //テストケースの終了後に、テストケースの結果プロパティリストを記録します。

先端

テストケースによって作成された結果のプロパティリストは、the resultを使用してテストケースが閉じた後にアクセスすることができます。このアクションは、ケースを閉じるEndTestCaseコマンドの直後に行う必要があります。上記の例では、その方法が示されています。

`The MultipleFoundAction` グローバルプロパティ

Value: UseFirstLocation, ShowPanel, LogWarning, ThrowException。これらの値はそれぞれ First, Panel, Log, Throw と略すことができます。

Behavior: ランタイムで Run > Image Update > When Multiple Occurrences Are Found の設定をオーバーライドするために使用できます。

例:

set the MultipleFoundAction to LogWarning

`The ReadTextSettings` グローバルプロパティ

Value: プロパティリスト

Behavior: The ReadTextSettingsは、ReadText()およびReadTable()関数で使用されるデフォルト設定のプロパティリストです。

例:

Set the readTextSettings to (dpi:96, multiLine: off)

例:

set Characters to "A".."Z" &&& "a".."z" &&& comma // すべての大文字と小文字、およびリストとして変数に格納します。
set the readTextSettings to (validCharacters:Characters) // 文字内のリストを使用して ValidCharacters を示します

例:

if param(1) is "Phone" then // Param(1) は、スクリプトに渡される最初のパラメータ値を参照します。
set the ReadTextSettings to (DPI:200)
  set the HotSpotScaling to all
  set the defaultScale to .5
end if
log readText("StatusUpperLeft","StatusLowerRight") //この関数と後続の readText 関数および readTable 関数は dpi:200 を使用します。

`The RemoteClipboard` グローバルプロパティ

Value: リモートクリップボードの内容

Default: なし

Behavior: The RemoteClipboardは、SUTのクリップボードにアクセスを提供します。このグローバルプロパティを変更することで、SUTのクリップボードの内容を変更します。

例:

setOption RemoteClipboard, "Hello"

例:

set the remoteclipboard to "www.google.com"
Tap "AddressBar"
mousebuttondown 1 // 前のタップが発生した位置でマウスの左ボタンを押したままにします (モバイルでは押す)。
wait 2
mousebuttonup 1 // マウスの左ボタンを放す/押す
Tap "PasteDialog"

先端

RemoteClipboard()関数を使用して、SUTのクリップボードの内容を表示することができます。

先端

SetRemoteClipboard コマンドは、SUTのクリップボードを変更するための別の方法を提供します。

`The RepositionPoint` グローバルプロパティ

Value: 1組のスクリーン座標

Default: SUTの右下隅付近の動的な点

Behavior: the ShouldRepositionMouseがOnに設定されているとき、画像検索中にマウスが再配置される位置をThe RepositionPointが決定します。

正の座標値は画面の左上隅を基準にし、負の座標値は画面の右下隅を基準にします。(the ShouldRepositionMouseも参照してください。)

例:

SetOption RepositionPoint, (1280, 1024)

例:

// このようなコードを使用して、マウスオーバーエフェクトが関心のある要素を覆い隠さないように、マウスカーソルを自動的に移動させる位置に強制します
"AccountDetailsMenuButton"をクリックします
set the ShouldRepositionMouse to true // 下記のWaitFor画像検索の最初のスキャンが失敗した場合、マウスカーソルの位置が自動的にRepositionPointに移動するようにします
set the RepositionPoint to the remoteScreenSize * (.25,.75) // RepositionPointをSUTの左上隅から四半の幅と三分の二の高さに設定します
WaitFor 10, "AccountDetailsSummary"
set the ShouldRepositionMouse to false

先端

Windowsでは、カーソルを画面の右下隅に移動すると、一時的にデスクトップを表示する機能であるPeekがトリガーされ、一般的にオートメーションが妨げられます。Peekトリガーエリア外にthe RepositionPointを変更する、the ShouldRepositionMouseをオフに設定する、またはWindowsのPeekを無効にすることが、Peek機能による中断を防ぐために必要です。

`The SaveRunLogOutput` グローバルプロパティ

Value: True (または On, Yes), False (または Off, No)

Default: False

Behavior: The SaveRunLogOutputは、実行結果からのランログ出力が、実行結果のフォルダにRunLogOutput.txtファイルとして保存されるかどうかを決定します。デフォルトの動作は、ランログは保存されず、ファイルは作成されません。

例:

SetOption SaveRunLogOutput, true

例:

Set the saveRunLogOutput to yes // logfile.txtには表示されないが、ランログには表示される出力、putコマンドなどを別のファイルに保存することを許可します
Set the scriptTracing to yes // ハンドラの入出力のエントリを含む、ランログに追加情報が表示されるようにします
RunWithNewResults "TestCase_BuyItem"

先端

the ScriptTracingによって作成され、the SaveRunLogOutputによって保存される追加情報は、スクリプトデバッグの目的に有用です。

ノート

the SaveRunLogOutputは、Runウィンドウのロギング内容を保存しますので、この機能を使用するにはGUIからEggplant Functionalを実行する必要があります。

`The ScaleFactors` グローバルプロパティ

ノート

注意: The ScaleFactors グローバルプロパティは、以前は the DefaultScale として知られていました。Eggplant Functional 19.2以降、このプロパティはsuiteの設定タブからスイートレベルで設定することができます。

Value: 正の数値、正の数値のリスト、正の数値の範囲、またはそれらの組み合わせ。範囲が指定された場合、"stepping by"または単に"by"をリストに追加し、その後に数値を追加して、Eggplantが指定範囲で検索のスケールを増加させるために使用する増分を指定できます。SenseTalkで範囲を使用する方法の詳細については、Rangesを参照してください。

Default: 空 (実質的には1.0)

Behavior: The scaleFactorsグローバルプロパティは、Eggplant Functionalが画像を検索するスケールを設定します。このスケールは、元のキャプチャサイズに対して相対的です。このグローバルプロパティはインラインスケール設定により上書きされますが、スイートの設定の画像検索のスケール要素フィールドで定義された値、および保存された画像で定義されたスケール(画像ビューア参照)に優先します。Eggplantは、このプロパティに提供された各スケールで指定の画像を検索し、リストされた順に検索します。また、指定の範囲内で画像をさまざまなサイズで検索し、提供された増分により検索サイズを増やします。インラインスケール設定については、画像スケーリングを参照してください。

例:

Set the scaleFactors to .5 // すべての画像を元のサイズの半分にスケーリング

例:

Set the scaleFactors to (.5,1.0,1.5) // リスト内のすべての数値で画像をスケーリング

例:

Set the scaleFactors to (.5to1.5by.25) // .25 (.5,.75,1.0,1.25,1.5) を増分にして、.5 から 1.5 の範囲内のすべての数値で画像をスケーリング

例:

params SUTFormFactor
If SUTFormFactor is "Phone" then set the scaleFactors to (.75,.9) // スクリプトにパラメータ値 "Phone" が渡された場合のみ、デフォルトのスケールを .75 および .9 に設定し、それ以外の場合は 1.0 を使用

先端

1より小さいスケールでの画像検索は通常、より良い結果をもたらしますので、最大バージョンの画像をキャプチャしてスケールダウンすることを推奨します。

先端

追加のスケールで画像を検索すると、スクリプトの実行時間が長くなりますので、追加のスケールを慎重に含めてください。

`The ScriptAnimation` グローバルプロパティ

Values： All（または true）、Off（または false）、または Calls

Default: Off.

Behavior: The ScriptAnimationは、スクリプトが実行される際に、スクリプトがアニメーション化（Runウィンドウで行ごとにハイライト表示）されるかどうかを決定します:

All または true: スクリプトの各行が実行されるときにハイライト表示されます。
Off または false: スクリプトはアニメーション化されません。
Calls: 各スクリプトやハンドラーがハイライト表示されますが、各行は表示されません。

ノート

The ScriptAnimationは、Eggplant FunctionalをGUIモードで使用しているときのみ影響を及ぼします。

例:

Set the ScriptAnimation to Calls

例:

SetOption ScriptAnimation, All

`The ScriptLogging` グローバルプロパティ

Value: On (または true), Actions, Off (または false), minimal, silent

Default: On.

Behavior: The ScriptLoggingは、スクリプトが実行される際に、ログファイルに記録されるイベントを制御します:

On: すべてのログコマンドとSUTとのすべてのインタラクションが記録されます。
Actions: すべてのログコマンドとSUTとのすべてのインタラクションが記録されますが、グローバルプロパティの変更は除かれます。
Off: Only BeginTestCase, EndTestCaseLog, LogError, LogWarning, and LogSuccessコマンドのみが記録されます。
Minimal: Only LogError, LogSuccess, and LogWarning コマンドのみが記録されます。
Silent: ログファイルには何も記録されませんが、警告とエラーはまだカウントされます。

例:

SetOption Scriptlogging, On

例:

あなたのパスワードがプレーンテキストで表示されるのを防ぐために、このようなコードを使用します:

params Password
"PasswordField"をクリックする
TypeText UserName
scriptloggingをSilentに設定する // ロギングをすべて防ぎます
TypeText Password
scriptloggingをOnに設定する // ロギングをデフォルトの振る舞いに戻します
Log "パスワードがタイプされました！"

例:

このようなコードを使用して、repeatループで作業しているときに表示される繰り返しロギングの量を制限します。

scriptLoggingをオフに設定する // スクリプトのロギングをオフに設定します。これにより、ログメッセージがロギングに表示されます。
Log "セットアップウィザードが完了するまで進行します。"
"FinishedButton"が見つかるまで繰り返します
  "nextButton"をクリックします
繰り返し終了
scriptLoggingをオンに設定します

関連:

結果ペイン

`The ScriptTracing` グローバルプロパティ

Value: All (または true), Off (または false), Calls

Default： Off.

Behavior： The ScriptTracingは、スクリプトが実行されている間にスクリプトがトレースされるかどうか（実際の実行の一歩先を進んで実行ウィンドウに行ごとに表示されるかどうか）を決定します。例えば：

put "hello" into var

log var

10/10/16, 12:06:57 PM Log hello

<<< 12:06:57 End handler 1: Login (normal exit)

以下に値を説明します：

Allまたはtrue：スクリプトの各行が実行される前に表示されます。
Offまたはfalse：スクリプトはトレースされません。
Calls：各スクリプトまたはハンドラがトレースされますが、各行ではありません。

ノート

The ScriptTracingは、スクリプトの実行が完了するとデフォルトの値に戻ります。

例：

ScriptTracingをOffに設定する

例:

SetOption ScriptTracing, Calls

ノート

The ScriptTracingは、Eggplant FunctionalのGUIモードでのみ効果があります。ただし、The SaveRunLogOutputもオンに設定されている場合を除きます。

`The SearchRectangle` グローバルプロパティ

Values： 検索矩形の対角線の角を示す2つのイメージ位置または2つの座標ペア。入力形式に関係なく、返り値は (x,y,x,y) として表示されます。

Default： SUTの全画面。

Behavior： このプロパティを使用すると、Eggplant FunctionalがSUT上でイメージを検索する範囲を制限できます。

先端

検索矩形をSUTの全画面にリセットするには、値を空にするか、()を設定するか、fullscreenを設定します。

例：

setoption SearchRectangle, ("DialogUpperLeft",imageLocation("DialogLowerRight") + (50,10)) // DialogUpperLeftのホットスポット位置を基にしてsearchRectangleを設定し、DialogLowerRightのホットスポット位置から右に50ピクセル、下に10ピクセルの調整を加えます

例:

このようなコードを使用して、フラッシュや一時的なUI要素を検出します。このコードは、指示器が存在できる2つの状態それぞれを急速に検索し、両方が存在することを確認します。このコードは、指示器が一度以上交互に変わることを確認します。これにより、指示器が点滅していることが確認できます。

SearchRectangleを("TopLeftFieldBorder", "BottomRightFieldBorder")に設定する //検索範囲を点滅する要素が表示される場所のみに制限します。これにより、スクリーンのより小さな部分をスキャンするため、スキャン頻度を上げることが可能になり、スキャンにかかる時間が短縮されます。
imageSearchDelayを0.1に設定します // 一時的な要素の検出を確認するためにスキャンの頻度を高めます。Eggplantはこの頻度でエリアを検索しようとしますが、エリアが大きい場合や画像コレクションを検索する場合など、Eggplantは自動的に頻度を調整して、各スキャンが完了するのに十分な時間がかかるようにします。
2回繰り返します // 要素の各状態を2回確認し、状態が1回以上変更されたことを確認します。
  WaitFor 1, "GreyElement" // WaitForのimageSearchTimeが1秒で、imageSearchDelayが.1秒なので、画像のスキャンは最大10回まで可能です。
  WaitFor 1, "RedElement"
end repeat
SearchRectangleを空に設定します //searchRectangleをフルスクリーンに戻します
ImageSearchDelayを0.3に設定します

例:

このようなコードを使って、点滅するか一時的なUI要素を検出します

Put imageLocation("OutputUpperLeft") into UL // 一時的な要素が出現するのをトリガーする前に、searchRectangleを定義する画像の位置を変数に格納します。これにより、searchRectangleの設定には検索時間のオーバーヘッドがありません
Put imageLocation("OutputLowerRight") into LR
Click "ConfirmButton" // 一時的な要素が出現する画像をクリックします
Set the searchRectangle to (UL,LR) // 変数ULとLRに格納された座標位置に基づいてsearchRectangleを設定します
WaitFor 10, "ConfirmationIcon"
Click "OKButton"
set the searchRectangle to () // Sets the searchRectangle back to full screen

`The SuiteVariables` グローバルプロパティ

Values: ユーザー定義の変数名（キー）と値を含むプロパティリスト

Default: Empty

Behavior: このプロパティを使用すると、Eggplant Functionalでスイート全体の変数を設定できます。これらの変数は、例えばSenseTalkスクリプトで使用することができますが、APIテストでURL文字列やユーザー資格情報を代替するためにも使用することができます。the suiteVariablesプロパティの一部として格納された変数は、実行コンテキストが開始された時点で即座に値を持つため、ランタイムの一部で値を割り当てる必要はありません。

スイート変数は、特別な、ユーザー定義型の事前定義変数です。これらの変数はスコープがローカルですが、その値はスイートに保存されているため、セッションを超えて利用可能です。スクリプトの実行中に変数の値を変更することができます。これには、直接変数にアクセスしたり、変数に対して操作を行うことが含まれます。このような変更は、the suiteVariablesに保存されている変数の値に影響を与えません。

ノート

SenseTalkでグローバルプロパティを操作する通常の方法に加えて、Egglant Functionalの設定タブのスイート変数セクションでこれらの変数を設定または編集することができます。この方法の使用についての情報は、Creating and Using Suite Variablesを参照してください。

例:

set the suitevariables to (usr1:"bobboson", usr15:"alicealison", pass1:"bob", pass15:"alice")

例:

set the suitevariables.myURL to "www.google.com"

関連:

[定数と事前定義された変数 stk-values.md#constants)
スイート変数の作成と使用

`The TextStyle` グローバルプロパティ

Value: 保存されたテキストスタイルの名前（テキストスタイルオプションのプロパティリスト）

Behavior: このプロパティは、テキスト検索のデフォルトオプション設定を制御します。The textStyleは、そのスタイルの名前（Defaultの代わりに）を設定することで、テキスト設定で設定されたスタイルのいずれかを参照するように設定できます。定義されたスタイル名のいずれにも一致しない名前にthe textStyleを設定すると、それはDefaultスタイルに戻ります。

また、the textStyleをオプション設定のプロパティリストに直接設定することもできます。その場合、それらの設定がテキスト検索に使用されますが、the textStyleはテキスト設定で定義されたスタイルのいずれからも独立して扱われます。

また、textStyle をオプション設定のプロパティリストに直接設定することもできます。その場合、その設定はテキスト検索に使用されますが、textStyle はテキストの設定で定義されたスタイルとは独立して扱われます。

例:

set the textstyle to "Android"

例:

set the textstyle.caseSensitive to yes

例:

set the textstyle to (language:"German", caseSensitive:Yes) -- どの名前付きスタイルにも関連付けられていません

関連:

The CurrentTextPlatform
テキストプリファレンス

`The UsabilityMode` グローバルプロパティ

Value: True (または on または yes), False (または off または no)

Default: False

Behavior: The usabilityMode グローバルプロパティは、Eggplant Functionalがスクリプトをユーザビリティモードで実行するかどうかを決定します。この設定は、スクリプト内で動的に変更でき、スクリプトの一部にのみ適用できます。また、UIからユーザビリティモードでスクリプトを開始した場合でも、このプロパティでユーザビリティモードをオフにできます。

Usabilityモードの完全な情報については、Running Eggplant Functional Tests in Usability Modeを参照してください。

例:

set the usabilityMode to true // スクリプトの実行中にユーザビリティモードをオンにします

例：

スクリプトの一部をユーザビリティモードで実行します：

Click "Web Bowser Icon"
WaitFor 3.5, "Refresh Icon"
Click Image:"Magnifying Glass"

set the usabilityMode to True // ユーザビリティモードをオンにする

TypeText "www.eggplant.io"
TypeText returnKey
WaitFor 5.0, "Eggplant Logo"
WaitFor 3.5, "Refresh Icon"

set the usabilityMode to False // ユーザービリティモードをオフにします

関連:

[The Usability_FeedbackSensitivity](#usability_feedbacksensitivity) グローバルプロパティ
The Usability_LoadTimeWarning グローバルプロパティ
Eggplant の機能的ユーザビリティ設定

`The Usability\_DelayToCheckForFeedback` グローバルプロパティ

Value: 時間値。

Default: 0.5秒 (または、Eggplant PreferencesのUsabilityタブで設定した値)

Behavior: ユーザビリティモードでスクリプトを実行するとき、このプロパティは、Eggplant Functionalがクリックまたはタップ操作の後、視覚的フィードバックのユーザビリティテストのための画面変更をチェックするまでの待ち時間を設定します。

Usabilityモードの完全な情報については、Running Eggplant Functional Tests in Usability Modeを参照してください。

例:

set the usability_delayToCheckForFeedback to 3 // プロパティの値を 3 秒に変更します

例:

set TimeVar to 5 seconds
set the usability_delayToCheckForFeedback to TimeVar // スクリプトからの変数を使用して遅延の値を設定します

関連:

`The usability\_delayToCheckForImageMovement` グローバルプロパティ

Value: 時間値。

Default: 0.7秒（または、EggplantのUsabilityタブで設定した値）

Behavior: Usabilityモードでスクリプトを実行すると、このプロパティは、移動目標のユーザビリティテストの画像チェック間の遅延を決定します。Usabilityモードの詳細情報については、Running Eggplant Functional Tests in Usability Modeをご覧ください。

例:

set the usability_delayToCheckForImageMovement to 4 // プロパティの値を4秒に変更します

例:

スクリプトの一部分の遅延値を変更し、元の値に戻します：

put the usability_delayToCheckForImageMovement into origDelay // プロパティの元の値を変数に入れます
set the usability_delayToCheckForImageMovement to 3 seconds // 遅延の新しい値を設定します

Click "Start"
Click "Web Bowser Icon"
WaitFor 3.5, "Refresh Icon"
Click Image:"Magnifying Glass"

set the usability_delayToCheckForImageMovement to origDelay // 遅延値を元に戻します

関連:

`The Usability\_FeedbackSensitivity` グローバルプロパティ

Value: 1～1000の範囲の数値

Default: Eggplant Functionalのテキスト設定で定義されたデフォルトテキストスタイル。m

Behavior: Usabilityモードでスクリプトを実行するとき、the usability_feedbackSensitivityグローバルプロパティは、画面が変化することを期待して視覚的なフィードバックチェックを通過するために、画面がどれだけ変化しなければならないかを決定します。感度設定が高いほど、画面の変化は少なくて済みます。

ユーザビリティモードに関する詳細な情報は、ユーザビリティモードでのEggplant Functionalテストの実行をご覧ください。

例:

set the usability_feedbackSensitivity to 100 // 感度を高めて、より小さな変化も変化として検出できるようにします

関連:

`The Usability\_LoadTimeWarning` グローバルプロパティ

Value: 時間値。

Default: 3秒 (または、EggplantのUsabilityタブで設定した値)

Behavior: Usabilityモードでスクリプトを実行するとき、このプロパティは、画像やテキストのロードに許される時間の長さを決定します。ロード時間が指定された閾値を超えると、ログに警告が表示されます。

ユーザビリティモードに関する完全な情報については、Running Eggplant Functional Tests in Usability Modeを参照してください。

例：

set the usability_LoadTimeWarning to 5 // プロパティの値を5秒に変更します

関連:

`The Usability\_TimeBetweenForbiddenCheck` グローバルプロパティ

Value: 時間値。

Default: 0.5秒 (または、EggplantのUsabilityタブで設定した値)

Behavior: Usabilityモードでスクリプトを実行し、禁止された画像とテキストのテストが有効になっているとき、このプロパティは、このユーザビリティテストの実行間の最小時間をEggplant Functionalが許可する時間を設定します。

ユーザビリティモードに関する完全な情報については、Running Eggplant Functional Tests in Usability Modeを参照してください。

例：

set the usability_timeBetweenForbiddenCheck to 3 // プロパティの値を3秒に変更します

----------sensetalk

`The ValidateImageFound` グローバルプロパティ

Value: On（または trueまたは yes）、Off（または falseまたは no）、または Always

Default: Off

ノート

デフォルト値を Offから Onに変更することができます。Eggplant Functionalのメインメニューで、Run > Image Updateを選択し、Validate ImageFoundを選択します。このオプションがUIで選択されている限り、the ValidateImageFoundプロパティのデフォルトは Onです。

説明: ImageFound関数がfalseを返すと、the ValidateImageFoundはAuto Updateをトリガーできます。値は以下のとおりです：

On (または true または yes): ImageFoundがfalseを返すとImage Updateパネルを開きますが、Auto Updateが選択されている場合は開きません。
Off (または false または no): ImageFoundがfalseを返すときにImage Updateパネルを開きません。
Always: ImageFoundがfalseを返すとき、Auto Updateが選択されていてもImage Updateパネルを開きます。

例：

params DebuggingMode // このパラメータにはtrueまたはfalseを渡します
if RunningFromCommandLine() and DebuggingMode then // RunningFromCommandLineとDebuggingModeの両方が"true"であるかどうかを確認します
  set the ImageUpdate to "Auto" // ImageUpdateグローバルプロパティをAutoに設定します。ImageNotFoundに対する一致診断がある場合、画像/OCR更新の自動キャッシングが可能になります
  SetOption ValidateImagefound, true
end if

関連情報：

The ImageUpdate
ImageFound 関数

`The ValidateSuccessfulSearches` グローバルプロパティ

Value: Boolean。 True（またはOn、またはYes）、 False（またはOff、またはNo）

Default: False

ノート

Eggplant Functionalのメインメニューからデフォルト値を切り替えることができます。Run > Image Updateに移動し、Validate Successfulを選択します。このオプションがUIで選択されている限り、the ValidateImageFoundプロパティのデフォルトはOnです。

Description: スクリプトに ImageFound(<image_name>)などの imageFound 関数が含まれており、指定されたテキストまたは画像が正常に見つかると、 "Validate Image Found"という検証メッセージが表示された画像更新パネルが表示されます。 説明: スクリプトにimageFound関数（ImageFound(<image_name>)など）が含まれていて、指定されたテキストまたは画像が正常に見つかった場合、Image Updateパネルが表示され、"Validate Image Found"という検証メッセージが表示されます。成功した画像検索の検証は、Eggplant Functionalが正しい画像を見つけていることを確認する必要があるまれな状況で役立つことがあります。たとえば、新しいUI要素に一致するように視覚要素が更新された場合、スクリプトがまだ古い画像の一致を見つけていないことを確認するために、Validate Successful Image Searchesを使用してアプリケーションをレビューできます。

例：

Set the ValidateSuccessfulSearches to On -- このプロパティをオンに設定すると、ImageFound関数がTrueを返すときに原文：

`The DefaultTextStyle`グローバルプロパティ（廃止予定）

ノート

このグローバルプロパティは非推奨です。テキストスタイルを設定するには、Eggplant Functionalの[テキスト設定](/studio/ja/23.5/epf-text-preferences)を参照してください。

Default: テキスト設定で定義されたテキストプラットフォームの名前

Default: 0.5秒 (または、Eggplant PreferencesのUsabilityタブで設定した値)

Behavior: CurrentTextPlatform は、スクリプトで使用されるテキストプラットフォームを決定します。

ノート

このグローバルプロパティはデフォルトでは現在のプラットフォームの名前のみを表示しますが、それでもプロパティリストです。 the TextPlatformsグローバルプロパティと同様に、the CurrentTextPlatformキーに値を割り当てることができます。

例：

SetOption CurrentTextPlatform, "WinXP"

----------sensetalk

set CurrentTextPlatform.generator to "native"

関連:

The TextStyles
テキストプリファレンス

`The DefaultTextStyle`グローバルプロパティ（廃止予定）

Values： テキストスタイルプロパティリスト

Default： 現在のプラットフォームのデフォルトのテキストスタイル

Behavior： The DefaultTextStyleは、現在のテキストプラットフォームのデフォルトのテキストスタイルへのショートカットです。

----------sensetalk

set the defaultTextStyle.TextFont to "Helvetica"

例:

setoption DefaultTextStyle, "StyleOne"

`The ImageDoctor`グローバルプロパティ（廃止予定）

ノート

このプロパティは現在、非推奨です。代わりにThe ImageUpdateを使用してください。

Values： Auto、Manual、または Off

Value: Auto, Manual, Off

説明： The ImageDoctorグローバルプロパティは、スクリプトの実行中にImage Doctorがどのように動作するかを決定します。

Auto： Image Doctorは自動的に画像の失敗を修正し、スクリプトの実行を続けます。(初期の画像の失敗は警告としてログに記録されます。)
Manual： 画像が失敗するとImage Doctorパネルが開きます。修正した画像で進行を選択するか、スクリプトを失敗させることができます。
Off： スクリプトの実行中にImage Doctorは使用されません。

The CaptureScreenImageFormat グローバルプロパティ
The CaptureScreenJPGCompressionQuality グローバルプロパティ
The CaptureScreenScaleFactor グローバルプロパティ
The CollectionFilter グローバルプロパティ
The CommandLineOutput グローバルプロパティ
The CompareScreenAction グローバルプロパティ
The CurrentCharacterCollectionグローバルプロパティ
The DefaultCaptureScreenSize グローバルプロパティ
The DefaultUseMarkupグローバルプロパティ
The FinalSuites グローバルプロパティ
The ForceScreenRefresh グローバルプロパティ
The HotSpotScaling グローバルプロパティ
The ImageUpdate グローバルプロパティ
The InitialSuites グローバルプロパティ
The OpenTestCases グローバルプロパティ
The MultipleFoundAction グローバルプロパティ
The ReadTextSettings グローバルプロパティ
The RemoteClipboard グローバルプロパティ
The RepositionPoint グローバルプロパティ
The SaveRunLogOutput グローバルプロパティ
The ScaleFactors グローバルプロパティ
The ScriptAnimation グローバルプロパティ
The ScriptLogging グローバルプロパティ
The ScriptTracing グローバルプロパティ
The SearchRectangle グローバルプロパティ
The SuiteVariables グローバルプロパティ
The TextStyle グローバルプロパティ
The UsabilityMode グローバルプロパティ
例：
The Usability\_DelayToCheckForFeedback グローバルプロパティ
The usability\_delayToCheckForImageMovement グローバルプロパティ
The Usability\_FeedbackSensitivity グローバルプロパティ
The Usability\_LoadTimeWarning グローバルプロパティ
The Usability\_TimeBetweenForbiddenCheck グローバルプロパティ
The ValidateImageFound グローバルプロパティ
The ValidateSuccessfulSearches グローバルプロパティ
The DefaultTextStyleグローバルプロパティ（廃止予定）
The DefaultTextStyleグローバルプロパティ（廃止予定）
The ImageDoctorグローバルプロパティ（廃止予定）

The CaptureScreenImageFormat グローバルプロパティ​

The CaptureScreenJPGCompressionQuality グローバルプロパティ​

The CaptureScreenScaleFactor グローバルプロパティ​

The CollectionFilter グローバルプロパティ​

The CommandLineOutput グローバルプロパティ​

The CompareScreenAction グローバルプロパティ​

The CurrentCharacterCollectionグローバルプロパティ​

The DefaultCaptureScreenSize グローバルプロパティ​

The DefaultUseMarkupグローバルプロパティ​

The FinalSuites グローバルプロパティ​

The ForceScreenRefresh グローバルプロパティ​

The HotSpotScaling グローバルプロパティ​

The ImageUpdate グローバルプロパティ​

The InitialSuites グローバルプロパティ​

The OpenTestCases グローバルプロパティ​

The MultipleFoundAction グローバルプロパティ​

The ReadTextSettings グローバルプロパティ​

The RemoteClipboard グローバルプロパティ​

The RepositionPoint グローバルプロパティ​

The SaveRunLogOutput グローバルプロパティ​

The ScaleFactors グローバルプロパティ​

The ScriptAnimation グローバルプロパティ​

The ScriptLogging グローバルプロパティ​

The ScriptTracing グローバルプロパティ​

The SearchRectangle グローバルプロパティ​

The SuiteVariables グローバルプロパティ​

The TextStyle グローバルプロパティ​

The UsabilityMode グローバルプロパティ​

例：​

The Usability\_DelayToCheckForFeedback グローバルプロパティ​

The usability\_delayToCheckForImageMovement グローバルプロパティ​

The Usability\_FeedbackSensitivity グローバルプロパティ​

The Usability\_LoadTimeWarning グローバルプロパティ​

The Usability\_TimeBetweenForbiddenCheck グローバルプロパティ​

The ValidateImageFound グローバルプロパティ​

The ValidateSuccessfulSearches グローバルプロパティ​

The DefaultTextStyleグローバルプロパティ（廃止予定）​

The DefaultTextStyleグローバルプロパティ（廃止予定）​

The ImageDoctorグローバルプロパティ（廃止予定）​

`The CaptureScreenImageFormat` グローバルプロパティ

`The CaptureScreenJPGCompressionQuality` グローバルプロパティ

`The CaptureScreenScaleFactor` グローバルプロパティ

`The CollectionFilter` グローバルプロパティ

`The CommandLineOutput` グローバルプロパティ

`The CompareScreenAction` グローバルプロパティ

`The CurrentCharacterCollection`グローバルプロパティ

`The DefaultCaptureScreenSize` グローバルプロパティ

`The DefaultUseMarkup`グローバルプロパティ

`The FinalSuites` グローバルプロパティ

`The ForceScreenRefresh` グローバルプロパティ

`The HotSpotScaling` グローバルプロパティ

`The ImageUpdate` グローバルプロパティ

`The InitialSuites` グローバルプロパティ

`The OpenTestCases` グローバルプロパティ

`The MultipleFoundAction` グローバルプロパティ

`The ReadTextSettings` グローバルプロパティ

`The RemoteClipboard` グローバルプロパティ

`The RepositionPoint` グローバルプロパティ

`The SaveRunLogOutput` グローバルプロパティ

`The ScaleFactors` グローバルプロパティ

`The ScriptAnimation` グローバルプロパティ

`The ScriptLogging` グローバルプロパティ

`The ScriptTracing` グローバルプロパティ

`The SearchRectangle` グローバルプロパティ

`The SuiteVariables` グローバルプロパティ

`The TextStyle` グローバルプロパティ

`The UsabilityMode` グローバルプロパティ

例：

`The Usability\_DelayToCheckForFeedback` グローバルプロパティ

`The usability\_delayToCheckForImageMovement` グローバルプロパティ

`The Usability\_FeedbackSensitivity` グローバルプロパティ

`The Usability\_LoadTimeWarning` グローバルプロパティ

`The Usability\_TimeBetweenForbiddenCheck` グローバルプロパティ

`The ValidateImageFound` グローバルプロパティ

`The ValidateSuccessfulSearches` グローバルプロパティ

`The DefaultTextStyle`グローバルプロパティ（廃止予定）

`The DefaultTextStyle`グローバルプロパティ（廃止予定）

`The ImageDoctor`グローバルプロパティ（廃止予定）