Ranorex Help Center How can we help you?

Data Connectors

In this section you learn about how to define different types of external data sources to be used for test automation.

Manage Data Sources

There are two locations on which you can manage data sources, one for the whole test suite and one for a specific test case. To maintain all data connectors in your test suite, open the data source management dialog by pressing the 'Manage Data Sources...' button.
Open 'Manage Data Sources' dialog from test suite view

Open 'Manage Data Sources' dialog from test suite view

'Manage Data Sources' dialog

'Manage Data Sources' dialog

In this dialog you can add new data connectors of the types described in the next chapters and rename or delete existing data connectors. You can also clone existing data connectors along with all settings made to them.
To add an existing data connector or create a new data connector to one of your test cases, select the desired test case from test suite view and open the data source dialog by pressing the 'Data Source...' button.
Set up data sources for a test case

Set up data sources for a test case

Test case properties dialog shows the currently used data source

Test case properties dialog shows the currently used data source

In this new opened dialog you can create a new data connector by selecting one of the data connector types described in the next chapters from the combo box marked in green. You can also choose an existing data connector by selecting one of the data sources from the combo box marked in red. By pressing the blue marked button, labeled 'Manage Data Sources' the data source management dialog, explained before, will be opened. By pressing the yellow marked button labeled 'Refresh', the data of the actual selected data source will be updated from its source file or database. You can limit the data of your data source by selecting a data range in the area marked orange. To open a dialog showing you the effective data set limited by a range (area marked in orange, e.g. '1-5, 8, 11-13'), press the purple marked button, labeled 'Preview effective data set...'.
Preview the effective data set

Preview the effective data set

In this dialog you can update the effective data set from the data file or database by pressing the green marked button labeled 'Refresh'. You can also export the effective data set to a CSV file by pressing the red marked button, labeled 'Export CSV'.

Kind of Data Connectors

In the following chapters you will learn how to create the different types of data connectors and add them to an existing test case. To do so, select the desired test case and open the data source dialog as described in General Use of Data Connectors. In this dialog choose one of the following data connector types from the combo box labeled 'New'.