Category: Documentation

In case there are multiple possible anchor areas in the system under test and you need to check if at least one of them can be found on the device screen, you can use .

This function searches for every possible anchor area and saves the result in a runtime variable with . In the end, you can either throw or not throw an error, depending on the value of the runtime variable.

Insert multi-check into a test.

Make sure you are in mode.

1. Use to search for the first anchor area.
2. Click .
3. Enter the following PHP command to save the result of the find to a runtime variable:

EVAL set("some_var_name")

4. Use to search for the second anchor area.
5. Enter the following PHP command to save the combined result of this and all previous finds to the runtime variable:

EVAL set("some_var_name", $CLIPBOARD=="True" || get("some_var_name")=="True")

6. Repeat step 4 and 5 for every possible anchor area.
7. Enter the following PHP command to throw an error if none of the previous finds was successful:

EVAL get("some_var_name") || error("a custom error message") 

Jumps

JUMP(T/F)any name

… some more actions …

TAG#any name

Loops

TAG#any name

… some more actions …

JUMP (T/F)any name

Sub – Return

With JUMP sub:test you set the base of the following jump session
The command makes you jump to the TAG #sub:test
With the Jump #return:test you jump back to the place where you started (set the baseline)

JUMPsub:any name

… some more actions …

TAG#sub:any name

… some more actions …

JUMP#return:any name

In case it’s not possible to select or copy a text, use button in mode. Optical Character Recognition will extract all characters that are selected and copy them into a Clipboard content.

Make sure the Editor is in mode.

1. Select a stable Anchor Area.
2. Draw a swipe over coded or changing content. Editor automatically switches to mode.
3. Click on to change swipe action into OCR action. The recognized area, marked in green rectangular, is copied to Clipboard content. 
4. Click Play it to confirm and record the action.

In order to make a test fail due to changes in data, click Editor->Control->EVAL to insert a PHP code evaluation.

See How to evaluate a PHP commands to manipulate variables and clipboard (Experimental feature) for details on EVAL action.

EVAL error("Text 'Step 1' not found.")

Makes the test fail with “Text ‘Step 1’ not found.” as error message:

Example:

If we would like to assert that the clipboard contains value “Testing” use

EVAL $CLIPBOARD=="Testing"||error("myerror")

If you need to calculate days, you can perform that using the EVAL action.

See How to evaluate a PHP commands to manipulate variables and clipboard (Experimental feature) for details on EVAL action.

PHP syntax

Reference: https://php-legacy-docs.zend.com/manual/php5/en/function.date

date(format, date);

Code samples:

date('d.m.Y',strtotime("- 10 Days"))
date('d.m.Y',strtotime("yesterday"))
date('d.m.Y',strtotime("tomorrow"))
date('d.m.Y',strtotime("+ 3 weeks"))
date('d.m.Y',strtotime("- 2 Months"))
date('d.m.Y',strtotime("now"))
date('d.m.Y',strtotime("next Saturday"))
date('d.m.Y',strtotime("last Year"))

Example

1) Set a value to variable “days_before” in Editor->Data :
“days_before” = 10

2) Use EVAL in a test step with this constant:

EVAL "".date('d.m.Y', strtotime("-".${"days_before"}." Days") )

Running this EVAL action on today’s date 23.04.2022 results in a clipboard value 13.04.2022