Documentation

This page contains information about EyeAutomate.

Manual

Click here to open the manual in HTML format.

Training Material

Click here to download the certified tester course in PDF format.

Visual Script

A visual script consists of text commands, images, data and widgets. Below is one example.

This is an example of a simple but well documented visual script.

Steps are used to improve the readability.

Note that the Click command waits up to 30 seconds, by default, for an image to appear.

A Check command is used to verify that we got the correct price. The selected area inside the image is verified in detail while the rest is used to locate the image.

Data-Driven Script

A data-driven script contain parameters. The script below is repeated until all data rows have been used.

This is an example of a reliable, readable and maintainable script.

The script is delayed by checking and waiting for images.

The images only contain enough information to be unique.

Parameters are used instead of hard coded values and images.

Introduction

An introduction to the basic commands in EyeAutomate.

Clicks on a location identified by an image. Will wait, up to 30 seconds, for the image to appear. Click the image in the script and use the Properties dialog to adjust the target location within the image.

The Move command moves the mouse cursor to the target location. Will wait, up to 30 seconds, for the image to appear. Use MoveRelative to move relative the last location.

Checks that an image, or a part of an image, exists. Will wait, up to 30 seconds, for the image to appear. Click on the image in the script and use the Properties dialog to select the target area that should be checked in more detail. The target area is verified in more detail than the rest of the image. Checks are also useful for delaying the script run and are a better option than using Sleep.

The Type command simulates keyboard input. Note that you should make sure that the target widget has the keyboard focus. Use the Paste command to add and paste text from the clipboard.

The Call command Calls another script. Provide any number of parameters to the called script. Note that all parameters and settings are automatically inherited by a called script.

Delay the script for a static number of milliseconds. Use a Check instead, if possible, since static delays either slow down the script execution when too long or result in an unreliable script if too short.

Perform a block of commands if an image is visible on screen or an expression is valid.

Note that you might need a Check before the If command since is does not wait for the image to appear.

Repeat one or more commands for each row in a Data file. A Data file conforms to the CSV format.

The first row, in the Data file, should contain the parameter names. Any common column delimiter, like comma, tab, semicolon, colon or pipe, can be used.

The StartWeb command opens a website in your default web browser.

Find locates all matching coordinates of an image. The Repeat command can be used to iterate through all found locations. The MatchCount parameter contains the number of matches found and the MatchLocationX parameter the actual location of match X. Note that there is a target area around the entire image in this example since the image to find is small.

Repeat as long as an image is visible or disappears using the While or WhileNot command. Note that it is recommended to select an area to check in more detail inside the image.

You may optionally use an expression instead of an image.

The StartFile command opens an executable or a file associated with an executable.

Script Examples

Script examples provided by Certified EyeAutomate Testers.