×
Menu

Working with Ranorex

Here are some best practice tips for working with Ranorex and aqua. This page will show how to use one repository in several test cases. First, create a new test case in aqua and add a test step with a Ranorex script. This script will contain the repository.
Create a namespace to identify the repository.
 
Open Ranorex as external editor and create a new repository in Ranorex.
Save the repository in the module folder.
Take note of the folder where the repository is saved. The path should look like this:
<some path>\aqua_Automation\TCxxxxxx\_001_CommonRepository\CommonRepository.rxrep
Hover over the repository to see the path (see screenshot below).
This repository can be used in another test step as follows: first add a new test step in aqua. Now open Ranorex with the External Editor button.
In Ranorex choose Open from Disk to select the repository created earlier.
Browse to the path where the repository file was saved.
Now we want to also use our repository in another test case. To do so, we add the script containing the repository to the aqua script library.
Now, we create a new test case and open the script library (Show Library button). Then, just drag the script to the white area in the test step.
Add another step with a Ranorex script to the new test case and open this step in Ranorex. Use the repository by selecting Open from Disk and browsing to the folder where the repository is stored (note: This is the folder of the first test case).
Ranorex will ask you to choose a reference for the repository. Choose Link repository to project. The repository is now shared between the two test cases. Any changes you make to the repository within this test case will be reflected in the other test case.
In this way, one repository can be used in all your test cases being tested in the same system under test.
 
Note: If more than one test case referencing the repository is opened in aqua, it will be write-protected.