On this page, you’ll find two examples that show how to apply regexes in Ranorex Studio. The first example is a validation, while the second example extracts a value with a Get value action.
In this chapter
The completed sample solution containing the examples on this page is available for download. You are invited to experiment with it. Alternatively, you can follow the instructions below to build your own test solution.
Theme:Regexes applied in Ranorex Studio
Time: Less than 30 min
Unzip the project directory to any folder on your computer
Start Ranorex Studio and open the solution file
If you don’t already have the Demo App on your computer, you can download it here and unpack it to a folder of your choice.
Regexes are often helpful when validating values that change through interaction with the AUT. In this example, we want to validate a dynamically generated image ID that is displayed next to the image.
The ID changes whenever the image is hidden and shown again.
A simple text-based validation would fail here because the ID changes dynamically. A regex, by contrast, can easily deal with it.
Let’s take a look at the validation in Ranorex Studio:
The validation operator is AttributeRegex, as we’re validating with a regex
The Match name depends on the repository item linked to the action. In our case, we validate the Text attribute of the repository item
The regex matches a string that starts with “img_” followed by a 16-digit string consisting of any letters or numbers – this is what the dynamic ID consists of
The validation succeeds whenever the Text attribute of the linked repository item has a value that the defined regex matches.
The Get value action allows you to extract attribute values. Often, you may only want to extract a certain part of a value, e.g. a number. This can be done with a regex.
Start the Demo App and click the tab Test database.
Enter the data for a person and add it to the database.
Suppose we now want to extract a person’s age from the resulting string in the database and assign it to a variable.
The database entry is displayed as a string in the Demo App The person’s age is part of this string.
In Ranorex Studio, this string is represented by the repository item TextLine. The RanoreXPath expression for this repository item uses the attribute accessiblerole with the value ListItem.
We need to use a regex to extract the age from the string. Then we can pass it on to a variable, so it can be used in a validation, for example.
Let’s take a look at the completed Get value action in Ranorex Studio.
The entire action in Ranorex Studio
Action type Get value to extract a value
The linked repository item’s attribute that contains the value
The variable that the value will be assigned to
The regex to extract only the age. In this case, it matches any number with at least one and at most 2 digits, i.e. all numbers from 0-99
Repository item linked to the action
If the Text attribute of the linked repository item contains a number from 0-99, this number is extracted and assigned to the variable $myAge.
In the report, this would look as follows: