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

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

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

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

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

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

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

値: PNGJPG、または TIFF

デフォルト: PNG

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

例:

set the CaptureScreenImageFormat to JPG

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

値: 1-100 の間の整数デフォルト: 100 (無圧縮;可能な限り無損失)

値: 1~1000の範囲の数値

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

例:

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

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

デフォルト: 1 (フルサイズ)

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

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

ノート

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

例:

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

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

値: NameDescriptionの1つまたは両方を含むプロパティリスト

デフォルト: フィルタなし

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

ノート

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

例:

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

例:

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 CollectionFilterをリセットするには、値を空に設定します。

例:

Set the CollectionFilter to empty

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

値: True(またはOn、またはYes)、False(またはOff、またはNo

デフォルト: False

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

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

例:

Set the CommandLineOutput to On

例:

SetOption CommandLineOutput, Off
先端

The CommandLineOutputrunscript command line optionとしても利用できます。

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

値: ShowPanelLogWarningLogError、またはShowPanelAlways

設定を区別するための略語も許されています:PanelWarningError、またはAlways

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

動作: このグローバルプロパティは、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 "全画面の違いを検出"

関連:

CurrentCharColl

デフォルト: ShowPanel

デフォルト:

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

例:

set the currentCharacterCollection to "iPhoneCharacters"

関連:

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

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

デフォルト:

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

例:

set the DefaultCaptureScreenSize to (1024,768)

----------sensetalk

デフォルト:

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

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

例:

set the defaultUseMarkup to No

例:

setoption DefaultUseMarkup, Yes

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

デフォルト: なし

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

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

例:

Set the FinalSuites to ("FallBack") //Sets the FinalSuites to a suite named "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 グローバルプロパティ

デフォルト: False

値: BooleanTrue(またはOn、またはYes)、 False(またはOff、またはNo

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

ノート

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

例:

SetOption ForceScreenRefresh, true

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

デフォルト: Inner

値: Inner, All, None

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

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

例:

Set HotSpotScaling to None

例:

params SUTType
If SUTType is "mobile" then set the HotSpotScaling to All //Sets the HotSpotScaling to All if "mobile" is passed in as the SUTType parameter value
先端

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

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

デフォルト: Manual

デフォルト: Manual

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

  • Auto: Image UpdateとOCR Updateは、自動的に画像とOCRの失敗を修正し、スクリプトの実行を続行します。最初の画像またはOCRの失敗は警告として記録され、任意の修正アクションも警告として記録されます。変更はキャッシュされますが、スクリプトが更新されるまでコミットされません(OCR)または変更が適用されます(画像)。これは特定のスクリプトの実行に対するResultsActionドロップダウンリストを使用します。
  • 手動: 画像または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 グローバルプロパティ

デフォルト: なし

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

動作: 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 グローバルプロパティ

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

(@"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"))

値: 時間値。

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

ノート

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

例:

BeginTestCase "WelcomeLoadTime"
//Execute some actions
log the OpenTestCases //Accesses information about the current test cases
//Execute further actions if desired
EndTestCase "WelcomeLoadTime"
log the result //Logs the results property list for the test case after it has ended
先端

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

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

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

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

例:

set the MultipleFoundAction to LogWarning

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

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

テキスト設定

例:

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

例:

set Characters to "A".."Z" &&& "a".."z" &&& comma // Stores all uppercase and lower case letters as well as , as a list into a variable
set the readTextSettings to (validCharacters:Characters) // Uses the list inside Characters to indicate the ValidCharacters

例:

if param(1) is "Phone" then // Param(1) refers to the first parameter value passed into the script
set the ReadTextSettings to (DPI:200)
set the HotSpotScaling to all
set the defaultScale to .5
end if
log readText("StatusUpperLeft","StatusLowerRight") //This and subsequent readText and readTable functions will use dpi:200

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

デフォルト: なし

値: プロパティリスト

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

例:

setOption RemoteClipboard, "Hello"

例:

set the remoteclipboard to "www.google.com"
Tap "AddressBar"
mousebuttondown 1 // Holds down the left mouse button (a press on mobile), at the location where the preceding tap occurred
wait 2
mousebuttonup 1 // Releases the left mouse button/press
Tap "PasteDialog"
先端

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

先端

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

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

デフォルト: SUTの右下隅付近の動的な点

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

動作: the ShouldRepositionMouseOnに設定されているとき、画像検索中にマウスが再配置される位置を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 グローバルプロパティ

デフォルト: False

値: On(または trueまたは yes)、Off(または falseまたは no)、または Always

振る舞い: 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の設定タブからスイートレベルで設定することができます。

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

デフォルト: 空 (実質的には1.0)

動作: 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 グローバルプロパティ

デフォルト: Off.

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

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

  • On: すべてのログコマンドとSUTとのすべてのインタラクションが記録されます。
  • Off または false: スクリプトはアニメーション化されません。
  • Calls: 各スクリプトやハンドラーがハイライト表示されますが、各行は表示されません。
ノート

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

例:

Set the ScriptAnimation to Calls

例:

SetOption ScriptAnimation, All

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

デフォルト: On.

値: 時間値。

動作: 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 グローバルプロパティ

デフォルト: Off.

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

動作: 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 グローバルプロパティ

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

デフォルト: SUTの全画面。

動作: このプロパティを使用すると、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 グローバルプロパティ

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

値: 時間値。

挙動: このプロパティを使用すると、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"

関連:

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

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

動作: このプロパティは、テキスト検索のデフォルトオプション設定を制御します。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) -- Not associated with any named style

関連:

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

デフォルト: False

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

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

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

例:

set the usabilityMode to true // Turns on Usability Mode during a script run

例:

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

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

set the usabilityMode to True // Turns on Usability Mode

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

set the usabilityMode to False // Turns off Usability Mode

関連:

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

デフォルト: 0.5秒 (または、Eggplant PreferencesのUsabilityタブで設定した値)

デフォルト: 0.5秒 (または、Eggplant PreferencesのUsabilityタブで設定した値)

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

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

例:

set the usability_delayToCheckForFeedback to 3 // Changes the value of the property to 3 seconds

例:

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

関連:

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

デフォルト: 0.7秒(または、EggplantのUsabilityタブで設定した値)

デフォルト: 0.7秒(または、EggplantのUsabilityタブで設定した値)

動作: 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 グローバルプロパティ

デフォルト: 10 (または、EggplantのUsabilityタブで設定した値)

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

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

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

例:

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

関連:

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

デフォルト: 3秒 (または、EggplantのUsabilityタブで設定した値)

値: 時間値。

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

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

例:

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

関連:

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

デフォルト: 0.5秒 (または、EggplantのUsabilityタブで設定した値)

値: AutoManual、または Off

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

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

例:

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

関連:

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

デフォルト: Off

値: All(または true)、Off(または false)、または Calls

ノート

デフォルト値を 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 ValidateSuccessfulSearches グローバルプロパティ

デフォルト: False

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

ノート

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

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

例:

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

The CurrentTextPlatform

ノート

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

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

All または true: スクリプトの各行が実行されるときにハイライト表示されます。

説明: ImageUpdateグローバルプロパティは、スクリプト実行中のImage Updateの動作を設定します。

ノート

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

例:

SetOption CurrentTextPlatform, "WinXP"
set CurrentTextPlatform.generator to "native"

関連:

The DefaultTextStyleグローバルプロパティ(廃止予定)

値: テキストスタイルプロパティリスト

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

例:

set the defaultTextStyle.TextFont to "Helvetica"

例:

setoption DefaultTextStyle, "StyleOne"

The ImageDoctorグローバルプロパティ(廃止予定)

ノート

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

値: AutoManual、または Off

値: Auto, Manual, Off

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

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