Screenshot command

Captures an image of the current screen display, in the selected format. The digital screenshot included in the report. Additional configurations include capturing an analog image, saving the image in the repository, and reducing the image resolution for long scripts that result in large reports.

Use this function to see how the application looks at any given time during a script run. For additional time saving, enable the Grid label advanced parameter to generate a separate view mode with customizable screenshot labels.

You can also use this command for dynamic image validation during runtime. This means that during runtime, a device screenshot image can be saved to the repository and then compared to the current screen on the device to validate what was expected.

Parameters

Name Type Possible values Description

Device ID*

Device

 

The device for this command.

Screen source

String

Primary | Camera

The source for retrieving the screen content, which can be a digital screen image (primary) or an analog screen image (camera).

Repository key

Media

 

The full repository path, including directory and file name, where the screenshot is saved.

When using commands that utilize files from the repository, the paths to the files are specified as repository keys. A repository key consists of the subarea and the path to the file.

For example, to specify a file called myImage.jpg stored in the images folder located in the PRIVATE subarea, specify the key as PRIVATE:images/myImage.jpg.

You can select a file that already resides in the Perfecto repository or select a file from your computer that is then uploaded to the Perfecto repository. To learn more about the Perfecto repository, see Manage the repository. Click the Select media link, browse to the file, and then click SELECT.

Image format

String

jpg | bmp | png

The image format.

Report image resolution

String

High | Medium | Low

The image resolution.

Consider reducing the resolution in very long scripts that result in large report files.

Grid label

String

 

The column name to be used for grid view in the report.

Selecting this parameter creates the grid report.

Comment

String

 

Adds a comment to the script.

On-fail Result*

Condition

Ignore | Break | Continue | Abort | Catch

The behavior when the command fails.

* Mandatory parameter