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
グローバルプロパティ
値: PNG
、JPG
、または 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
グローバルプロパティ
値: Name
とDescription
の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 CommandLineOutput
はrunscript command line optionとしても利用できます。
The CompareScreenAction
グローバルプロパティ
値: ShowPanel
、LogWarning
、LogError
、またはShowPanelAlways
設定を区別するための略語も許されています:Panel
、Warning
、Error
、または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 "全画面の違いを検出"
関連:
CompareScreen
コマンド- * [Eggplant FunctionalでのUIテストにおけるCompare Screenの使用](/studio/ja/23.3/epf-compare-screen-ui-testing)
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 DefaultUseMarkup
がyes
に設定されている場合、サポートされているマークアップは生成されたテキスト画像をフォーマットするために使用されます。the DefaultUseMarkup