Quick Reference: Property Lists

The following tables list SenseTalk properties that you can use with common Eggplant Functional commands.

Assert Command Properties

Key

Description

assertionBehavior

The default behavior for assert commands. Options are Error, Warning, or Pause

assertionsEnabled

Specifies if Eggplant Functional runs assert commands. Defaults to True. If set to False, Eggplant Functional ignores assert commands

assertionPassCount

Global counters that increment each time an assert command runs. The counters are assertionFailCount, assertionErrorCount, assertionWarningCount, and assertionExceptionCount. Each failure increments both the assertionFailCount and also one of the assertionErrorCount, assertionWarningCount, or assertionExceptionCount counters

For information about using the Assert command, see Assert Command.

CaptureScreen Properties

Key

Description

ImageInfo

An image property list

Increment

Whether to append an automatically incremented number to the image; true or false

Name

An image file name and optional path information, in quotation marks

Rectangle (or Rect)

A pair of diagonal locations indicating a rectangle to capture

For information about using CaptureScreen, see CaptureScreen Command.

Connection Properties

Key

Description

Bonjour

Whether or not the SUT was found via Bonjour or zerconf

ColorDepth

The color depth of the SUT in the Viewer window: 8, 16, 32

Connected

Whether or not Eggplant Functional is currently connected to the SUT

Name

The display name of the SUT

Password

Password of the SUT's VNC server

PortNum

Port number used by the SUT VNC server

Reverse

Whether or not the connection is a reverse connection (i.e., initiated by the SUT)

ScreenSize

The width and height of the SUT screen

ServerID (required)

SUT host name, IP address, or display name

sshHost

Host name or IP address of an SSH host

sshPassword

Password of the user account on the SSH host computer

sshUser

User account on the SSH host computer

Type The method to use to connect to the SUT. Possible values are RDP, VNC, or screenshot

Visible

Whether or not the Viewer window opens upon connection

For information about using the Connect command, see Connect Command. For general information about connections, see Creating Connections to SUTs.

Image Properties

Key

Description

CaptureDate

The date of image capture, including the time

CaptureHost

The SUT from which the image was captured

CaptureLocation

Screen coordinates of the image when it was captured. (This value cannot be changed.)

CaptureScreenSize

Screen size of the SUT in pixels at time of image capture, given as (width,height)

Characters Refers to image names from a character collection. See Image Searches Using a Character Collection for more information.

Cliprectangle

Coordinates that define a rectangle within the image; any pixels outside the cliprectangle are disregarded for image matching

Discrepancy

The percentage or absolute number of pixels that may differ between an image and a match in the Viewer window. The percentage of pixels (with a percent sign) or number of pixels (with no percent sign) by which the image and a match in the Viewer window can differ.

Note: Discrepancy can be slow to use and can result in false positive matches. Preferable approaches include setting the Search Type to Smooth in the Image Update panel, cropping the image using the Image Editor, or creating an Image Collection that includes several acceptable versions of a basic image. You can also capture a new image if the current image can only be found using a discrepancy search.

HotSpot

Coordinates of the hot spot within the image, relative to the top-left corner of the image

ImageDescription

The images description in the Suite Editor Images pane. (This value cannot be changed.)

ImageName

Name of the image file. (File extension is not used.)

ImagePath

File path of the image file. (This value cannot be changed.)

ImageSize

Width and height in pixels. (This value cannot be changed.)

ImageTolerance

The acceptable difference between color values in an image and a match in the Viewer window

Pulsing

Whether the search type allows for pulsing; true or false

Rotate

A degree of rotation (or list or range of degrees) that the image should be found at, if you expect an image to appear at a different angle than was originally captured. Rotation is clockwise

Scale

The scale factor at which the image is to be found (or was found, as in the case of foundimageinfo()). For more information, see Scaling Images.

Searchrectangle

Coordinates that define a rectangle in the Viewer window. Eggplant Functional only looks for this image within the defined rectangle

SearchType

The search type to be used; Tolerant of Background (Tolerant), Smoothed for Text (Smoothed), Adaptive to Image (Adaptive), Precise to Pixel (Precise), Pulsing to Element (Pulsing), or Smooth and Pulsing.

WaitFor

The maximum time Eggplant Functional waits for the given image to appear on the SUT

For information about using image properties, see:

ReadCharacters() Function Properties

Key Description
asList When asList is on (asList:Yes), the ReadCharacters() function returns a list of strings, one for each group of recognized characters.
characterPriority This string contains priority characters, in high-to-low order. The default setting is ";:.". This setting controls which character is recognized if two character images are found in the same location. For example, using characterPriority:"OC" gives the "O" character image a higher priority than the "C"character image. The result is that the ReadCharacters() function uses the letter "O" rather than the letter "C" if both the O and C images are found at the same location on the screen.
minimumVerticalOverlap This value sets the minimum overlap, in pixels, allowed for two characters to be considered to be on the same line. If the two characters overlap more than the minimumVerticalOverlap value, the ReadCharacters() function considers these characters to reside on the same line.
maximumHorizontalOverlap This value sets the maximum overlap, in pixels, allowed for adjacent characters to be considered as occupying the same space. If two adjacent characters overlap more than this setting, the ReadCharacters() function considers these characters to be occupying the same space.
maximumAdjacentGap This value sets the maximum gap, in pixels, allowed between two adjacent characters. This setting assumes no space between characters. If two adjacent characters reside further apart than this setting, the ReadCharacters() function considers these characters to be non-adjacent characters.
maximumSpaceGap This value sets the maximum gap, in pixels, for an implied space to exist between two characters. If two characters reside closer together than this setting, the ReadCharacters() function does not consider these characters to be separated by a space.
spaceWidth This value sets the nominal width, in pixels, of a space character. The ReadCharacters() function uses this setting to determine the number of spaces returned for wide space gaps.

For information about using the ReadCharacters() function properties, see the ReadCharacters() Function. The ReadCharacters() function is an image search function, so it also supports the properties shown in Image Properties.

Results Properties

Key

Description

Duration

The length of time the script ran (or has been running) given in seconds

Errors

A count of errors logged for that run

Exceptions

A count of the Eggplant Functional caught and uncaught exceptions raised

LogFile

The name and absolute path of the Log file

ReturnValue

The returned value of any return statements

RunDate

The date and time the run was started

Status

The status of the run: Success, Failure, or Running

Warnings

A count of the warnings logged for that run

For information about script results, see the ScriptResults() Function.

SendMail Properties

Key

Description

Attachment

A filename or list of filenames to attach to the email

Body (or Message)

The text of the message

CC

One or more addresses to which a copy of the message is sent, separated by commas

"Content-Type"

A mime type. For HTML email, use the value text/html. (The default is text/plain.)

From (required by some mail servers)

The user account sending the message

ReplyTo

The default address to which a reply is sent

smtp_host (required)

The hostname or IP Address of the mail server

smtp_password

The password for log in to the mail server; used if an smtp_type is specified

smtp_port

The port used to connect to the mail server. Port 25, the default mail port, is used if nothing is specified.

smtp_transport

The encryption method used for mail transport, either Unencrypted, SSL, or TLS

smtp_type

The authentication scheme used by the mail server.
On Mac: None, Plain, Login, or CRAM-MD5.
On Linux and Windows: None or Plain.

smtp_user

The user account on the mail server; used if an smtp_type is specified

Subject

The subject line for the message

To (required)

One or more addresses, separated by commas

For information about using SendMail, see the SendMail Command. For a fuller explanation of setting up SendMail, see Sending Test Results via Email.

TextPlatform Properties

Key

Description

Engine

The text engine used by the platform

Generator

The text-image generator (TIG) used by the platform. (The Generator property is deprecated. Instead, use Engine.)

Name

Name of the text platform

Styles

A property list for each of the platform’s text styles

For information about TextPlatform, see The TextPlatforms section of Eggplant Functional Global Properties.

Text Properties

Common Text Properties (used for both OCR and TIG)

Key

Description

Text

The text string that you want to find on the SUT. (Required.)

TextPlatform

The name of the platform on which your text will be found

TextStyle

Either the name of a text style, or a list of text properties defined in a script

Generic (OCR) text properties

Key

Description

CaseSensitive

Whether text searches consider case

Contrast

Whether the SUT display is internally seen as a two-color image

ContrastColor

The color that is considered the primary color when contrast is on

ContrastTolerance

The maximum per-channel difference allowed for a pixel to be seen as the contrast color

DPI The DPI property refers to the DPI (dots per inch) of the SUT display
EnableAggressiveTextExtraction Enable this property if you want OCR to extract as much text from the image as possible
EnhanceLocalContrast Enable this property if you want OCR to automatically increase the local contrast of the image
IgnoreNewLines Enable this property to have OCR searches ignore new lines during a search while not affecting the text actually read by OCR
IgnoreSpaces Enable this property to set OCR text searches to disregard spaces in your text string

Language

The language of text OCR will read

SearchRectangle

A specific area of the screen to be searched by the OCR function

TextRotation

Reads rotated and upside-down text, specified a with the values of Clockwise, CounterClockwise, UpsideDown

ValidCharacters

The set of characters that an OCR search can return

ValidPatterns

Allows the use of regular expressions for matching words; for more information, see ValidPatterns

ValidWords

The words (or character strings) that can be returned by the OCR search

 

This topic was last updated on October 09, 2019, at 10:49:39 AM.

Eggplant icon Eggplantsoftware.com | Documentation Home | User Forums | Support | Copyright © 2019 Eggplant