クイックリファレンス：プロパティリスト
以下の表は、一般的なEggplant Functionalコマンドで使用できるSenseTalkプロパティをリストアップしたものです。
CaptureScreenプロパティ
| キー | 説明 |
|---|---|
ImageInfo | 画像プロパティリスト |
Increment | 画像に自動的にインクリメントされた数値を追加するかどうか; true または false |
Name | 引用符で囲まれた画像ファイル名とオプションのパス情報 |
Rectangle (または Rect) | キャプチャする矩形の左上と右下の角を示す座標ペア。 |
CaptureScreenの使用についての情報は、CaptureScreen Command を参照してください。
Connectionプロパティ
_connection property list_に含まれるプロパティは、接続の種類によって異なります。
VNCまたはRDP接続のプロパティには、以下が含まれる可能性があります:
| キー | 説明 |
|---|---|
BlendScaledScreen | scaleRemoteScreenがYesのときにVNCサーバーがピクセルの色を混合するかどうか |
Bonjour | SUTがBonjourまたはzeroconfを経由して見つかったかどうか |
ColorDepth | ビューアウィンドウ内のSUTの色深度：8、16、32 |
Connected | Eggplant Functionalが現在SUTに接続されているかどうか |
Height | RDP接続専用。ビューアウィンドウの高さ（ピクセル単位） |
MonitorCount | RDP接続のモニターの数 |
Name | SUTの表示名 |
Password | VNC接続の場合はVNCサーバーのパスワード、RDP接続の場合はWindowsユーザーパスワード |
PortNum | SUT VNCサーバーが使用するポート番号 |
Reverse | 接続がリバース接続であるかどうか（つまり、SUTによって開始される） |
ScaleRemoteScreen | VNCサーバーの寸法が50パーセント縮小されるかどうか |
ScreenSize | SUT画面の幅と高さ |
ServerID (必須) | SUTのホスト名 、IPアドレス、または表示名 |
sshHost | SSHホストのホスト名またはIPアドレス |
sshPassword | SSHホストコンピューター上のユーザーアカウントのパスワード |
sshUser | SSHホストコンピューター上のユーザーアカウント |
Type | SUTへの接続方法。可能な値はRDP、VNC、またはスクリーンショット |
Username | RDP経由で接続する場合のWindowsユーザー名 |
Visible | 接続時にビューアウィンドウが開くかどうか |
Width | RDP接続専用。ビューアウィンドウの幅（ピクセル単位） |
Sauce Labs接続のプロパティには、以下が含まれる可能性があります:
| キー | 説明 |
|---|---|
APIKey | アカウントのSauce Labs APIキー |
App | デバイス上で実行するアプリのURL |
BrowserName | ブラウザの名前。例："Chrome"、"Firefox"など |
BrowserVersion | 特定のブラウザバージョン |
ColorDepth | ビューアウィンドウ内のSUTの色深度：8、16、32 |
Connected | Eggplant Functionalが現在SUTに接続されているかどうか |
DataCenter | 接続するSauce Labsデータセンター |
DeviceName | デバイス識別子。例："Iphone 12"など |
Name | SUTの表示名 |
PlatformName | オペレーティングシステムプラットフォームの名前。例 ："Windows 10"または"Android" |
ScreenResolution | 幅 X _高さ_の形式で表されるブラウザ画面のサイズ。例："1400x1050" |
ScreenSize | SUTスクリーンの幅と高さ（リスト形式） |
Type | Sauce Labs接続の場合、これは"SauceLabs"になります |
URL | ブラウザで接続するサイトのURL |
User | 使用中のSauce Labsアカウントのユーザー名 |
Visible | 接続時にビューアウィンドウが開くかどうか |
接続プロパティリストの使用に関する情報は、Connect CommandとConnectionInfo Functionを参照してください。接続に関する一般的な情報は、Creating Connections to SUTsを参照してください。
Image Properties
| キー | 説明 |
|---|---|
CaptureDate | 画像キャプチャの日付、時間を含む |
CaptureHost | 画像をキャプチャしたSUT |
CaptureLocation | 画像がキャプチャされた時点での画面座標。（この値は変更できません。） |
CaptureScreenSize | 画像キャプチャ時のSUTの画面サイズ（ピクセル単位）、(width,height)として与えられます |
Characters | 文字コレクションからの画像名を指します。詳細については、Image Searches Using a Character Collectionをご覧ください。 |
Cliprectangle | 画像内の四角形を定義する座標。cliprectangleの外側のピクセルは画像の一致には無視されます |
Discrepancy | 画像とビューアウィンドウ内の一致箇所との間に存在しても良いピクセルのパーセンテージまたは絶対数。画像とビューアウィンドウ内の一致箇所との間で異なることができるピクセルのパーセンテージ（パーセント記号付き）またはピクセル数（パーセント記号なし）。 注意：Discrepancyを使用すると、処理が遅くなることがあり、偽陽性の一致が生じる可能性があります。Image UpdateパネルでSearch TypeをSmoothed for Textに設定したり、Image Editorを使用して画像をトリミングしたり、基本画像の複数の許容可能なバージョンを含むImage Collectionを作成するなどのアプローチが推奨されます。現在の画像が不一致検索のみで見つかる場合は、新しい画像をキャプチャすることもできます。 |
HotSpot | 画像内のホットスポットの座標、画像の左上隅に対する相対的な位置 |
ImageDescription | Suite Editor Imagesパネルでの画像の説明。（この値は変更できません。） |
ImageName | 画像ファイルの名前。（ファイル拡張子は使用されません。） |
ImagePath | 画像ファイルのファイルパス。（この値は変更できません。） |
ImageSize | 幅と高さ（ピクセル単位）。（この値は変更できません。 |
ImageTolerance | 画像とビューアウィンドウ内の一致箇所の色値の許容差 |
Pulsing | 検索タイプがパルスを許可するかどうか；trueまたはfalse |
Rotate | 画像が元々キャプチャされた角度とは異なる角度で見つかるべき角度（またはリストまたは範囲の角度）。回転は時計回りです |
Scale | 画像が見つかるべきスケールファクター（または見つかった場合、foundimageinfo()の場合）。詳しくは、Scaling Imagesを参照してください。 |
Searchrectangle | ビューアウィンドウ内に四角形を定義する座標。Eggplant Functionalは、定義された四角形内でのみこの画像を探します |
SearchType | 使用する検索タイプ; 背景に対する耐性 (Tolerant)、テキスト用のスムーズ化 (Smoothed)、画像に対する適応 (Adaptive)、ピクセルへの精密 (Precise)、要素へのパルス (Pulsing)、またはSmooth and Pulsing. |
WaitFor | Eggplant Functionalが指定された画像がSUTに表示されるのを待つ最大時間 |
画像プロパティの使用についての情報は、以下を参照してください:
ReadCharacters関数のプロパティ
| キー | 説明 |
|---|---|
asList | asListがオン(asList:Yes)の場合、ReadCharacters関数は認識された文字の各グループに対して一つの文字列のリストを返します。 |
characterPriority | この文字列には優先度が高い順に文字が含まれています。デフォルト設定は ";:."です。この設定は、同じ位置に2つの文字画像が見つかった場合にどの文字が認識されるかを制御します。例えば、characterPriority:"OC"を使用すると、"O"文字画像が"C"文字画像よりも高い優先度を持ちます。結果として、ReadCharacters関数はOとCの画像が画面の同じ位置に見つかった場合、"C"よりも"O"の文字を使用します。 |
minimumVerticalOverlap | この値は、2つの文字が同じ行にあると考えられる最小のオーバーラップを、ピクセル単位で設定します。2つの文字がminimumVerticalOverlap値よりも多く重なっている場合、ReadCharacters関数はこれらの文字が同じ行に存在すると考えます。 |
maximumHorizontalOverlap | この値は、隣接する文字が同じスペースを占めていると考えられる最大のオーバーラップを、ピクセル単位で設定します。隣接する2つの文字がこの設定よりも多く重なっている場合、ReadCharacters関数はこれらの文字が同じスペースを占めていると考えます。 |
maximumAdjacentGap | この値は、隣接する2つの文字間の最大のギャップを、ピクセル単位で設定します。この設定は、文字間にスペースがないことを前提としています。2つの隣接する文字がこの設定よりも離れている場合、ReadCharacters関数はこれらの文字を非隣接の文字と考えます。 |
maximumSpaceGap | この値は、2つの文字間に暗黙のスペースが存在するための最大のギャップを、ピクセル単位で設定します。2つの文字がこの設定よりも近くに存在する場合、ReadCharacters関数はこれらの文字がスペースで区切られているとは考えません。 |
spaceWidth | この値は、スペース文字の名目上の幅を、ピクセル単位で設定します。ReadCharacters関数は、この設定を使用して、広いスペースギャップに対する返されるスペースの数を決定します。 |
ReadCharacters関数のプロパティの使用についての情報は、ReadCharacters関数を参照してください。ReadCharacters関数は画像検索関数であるため、画像プロパティに示されているプロパティもサポートしています。
ScriptResultsのプロパティ
| キー | 説明 |
|---|---|
Duration | スクリプトが実行された（または実行中である）時間の長さ、秒単位で表されます |
Errors | その実行についてログに記録されたエラーの数 |
Exceptions | Eggplant Functionalが捕捉した例外と未捕捉の例外の数 |
LogFile | ログファイルの名前と絶対パス |
ReturnValue | 戻り値ステートメントの戻り値 |
RunDate | 実行が開始された日時 |
Status | 実行のステータス： Success、Failure、Running |
Warnings | その実行に対してログに記録された警告の数 |
スクリプトの結果についての情報は、ScriptResults関数を参照してください。
SendMailのプロパティ
| キー | 説明 |
|---|---|
Attachment | メールに添付するファイル名、またはファイル名のリスト |
Body (または Message) | メッセージのテキスト |
CC | メッセージのコピーを送信する1つ以上のアドレス。アドレスはカンマで区切ります |
"Content-Type" | MIMEタイプ。HTMLメールの場合、値は text/html を使用します。（デフォルトは text/plain） |
From (一部のメールサーバーで必要) | メッセージを送信するユーザーアカウント |
ReplyTo | 返信が送信されるデフォルトのアドレス |
smtp_host (必須) | メールサーバーのホスト名またはIPアドレス |
smtp_password | メールサーバーへのログイン用のパスワード。smtp_typeが指定されている場合に使用されます |
smtp_port | メールサーバーへの接続に使用するポート。何も指定されていない場合、デフォルトのメールポートである25が使用されます。 |
smtp_transport | メール転送に使用する暗号化方法。Unencrypted、SSL、TLS のいずれか |
smtp_type | メールサーバーが使用する認証スキーム。 Mac上で： None、Plain、Login、CRAM-MD5LinuxとWindows上で： NoneまたはPlain. |
smtp_user | メールサーバー上のユーザーアカウント。smtp_typeが指定されている場合に使用されます |
Subject | メッセージの件名 |
To (必須) | 1つ以上のアドレス。アドレスはカンマで区切ります |
SendMailの使用についての情報は、SendMailコマンドを参照してください。SendMailの設定方法の完全な説明については、メールでのテスト結果の送信 を参照してください。
テキストのプロパティ
共通テキストプロパティ (OCR検索で使用)
| キー | 説明 |
|---|---|
Text | SUT上で見つけたいテキスト文字列（必須）。 |
TextStyle | テキストスタイルの名前、またはスクリプトで定義されたテキストプロパティのリスト |
一般的なOCRテキストプロパティ
ノート
boolean値は、Yes/Noの値を持つトグルスイッチのようなものです。On/Offも受け入れられます。
| プロパティ | 検索 | 読取 | 値 |
|---|---|---|---|
| AggressiveTextExtraction | はい | はい | ブーリアン |
| CaseSensitive | はい | いいえ | ブーリアン |
| Contrast | はい | はい | ブーリアン |
| ContrastColor | はい | はい | 色（Color Values in SenseTalkを参照） |
| ContrastTolerance | はい | はい | 0-100 / デフォルト45 |
| DPI | はい | はい | 整数 |
| EnhanceLocalContrast | はい | はい | ブーリアン |
| ExtraWords | はい | はい | 文字列または単語のリト |
| IgnoreNewLines | はい | いいえ | ブーリアン |
| IgnoreSpaces | はい | いいえ | ブール値 |
| IgnoreUnderscores | はい | いいえ | ブール値 |
| InvertImage | はい | はい | ブール値 |
| Language | はい | はい | OCR言語サポートに指定されている言語名（大文字と小文字を区別） |
| LowResolutionMode | はい | はい | ブール値 |
| Multiline | いいえ | はい | ブール値 |
| PreferDictionaryWords | はい | はい | ブール値 |
| PreferredPattern | はい | はい | 正規表現の文字列 （SenseTalkのパターン使用を参照） |
| PreferredWords | はい | はい | 文字列または単語のリスト |
| ProhibitedWords | はい | はい | 文字列または単語のリスト |
| SearchRectangle | はい | いいえ* | 矩形を定義する座標のペアまたはキャプチャされた画像 |
| TextDifference | はい | いいえ | 整数 |
| TextRotation | はい | はい | 4つの定義済みの値のいずれか |
| Trim | いいえ | はい | ブール値 |
| TrimBorder | いいえ | はい | 整数 |
| TrimColor | いいえ | はい | 色（SenseTalkの色の値を参照） |
| TrimTolerance | いいえ | はい | 整数 |
| TrimWhitespace | いいえ | はい | ブール値 |
| ValidCharacters | いいえ | はい | ブール値 |
| ValidPattern | はい | はい | 正規表現の文字列 (SenseTalkのパターン使用 を参照) |
| ValidWords | はい | はい | 文字列または単語のリスト |
* ReadTextコマンドでSearchRectangleプロパティを設定する必要はありません。なぜなら、ReadTextはデフォルトで矩形を取るからです。このプロパティは、標準的な画像検索で設定することもできます。詳しくは 画像参照 をご覧ください。