AGILITEST offers its users to practice Data-Driver Testing as much to configure test campaigns as to adapt a script to its context and optimize test coverage via its dataset.
This goes through a specific function: The Agilitest editor allows you to pass a CSV file as a parameter of a sub-script call. Thereafter, during the replay of the test, the sub-script will be called as many times as there are lines in the CSV file, passing as input variables of the sub-script the values of the columns of each line.
How to use a CSV file for data-driven testing
Here's how to do it:
- Select the src/assets/data directory in the project explorer
- Right-click and select "Create CSV file"
- Enter the name of the CSV file: the file is created empty in the src/assets/data tree
- Double click on the file to edit it: Agilitest edits your empty file
- You can click on "Add parameter" to add a column to your file, and on "Add iteration" to add a line.
Subsequently, you can enter values directly in the cells that have been created.
- Create an action of type "Sub-script call"
- Drag the CSV file directly from the "Project Explorer" area to your new "Call script" action: Agilitest takes this new CSV file into account when calling the sub-script.
Once this file is completed, you can retrieve the variables in your sub-script by using the $param() function and passing the index of the column of the parameter that interests you.
For example: $param(0) returns the value of the first column.
- Tip 1: You can combine $param calls with other text boxes to generate more complex texts. The above example will generate a button identifier "Btn1" from the value "1" passed as input.
- Tip 2: You can give a default value in the $param function as a second variable, this allows you to use the sub-script as a directly usable script. Btn $param(2,1) will return Btn1 if the script was not called by a parent script.
- Tip 3: To start testing your script, you can start by calling your subscript by passing hardcoded parameters.
The video below summarizes the steps to create a CSV file and iterate over it with a sub-script.
To go further, you can consult our article on the interest of exploiting data-driven testing with Agilitest and which offers a webinar video on the subject.