Using Data Driven Tests and Jobs in TestProject
Data driven testing, repeat iterations using different data sets
Data driven testing is a powerful test automation concept that helps you leverage existing tests to quickly give you a lot of coverage for a particular variable. TestProject supports this approach and makes it easy to turn any test in the system into a data driven test. Data driven tests are tests that run multiple times, but with different values for some of the variables in the test. For example if you wanted to test that the username field on a login page could handle several different types of inputs you could create a separate test for each input, or you could use a data driven tests to drive the same login test multiple times, but just using a different username input each time.
This tutorial will walk you through a specific example of creating a data driven test in TestProject so that you can see how to get started with using this powerful concept.
This tutorial will work off of a simple login test using the TestProject sample site. You can follow along with a tutorial that shows you how to create that test in the documentation section on creating a web test.
Once you have a test setup, the first thing you will need to do is to parameterize the variable that you want to use to drive the test. In this example that will be in the input to the full name field of the login form. To do that open the test in the test editor by clicking on it in the project view. You can then open the parameters panel for that test from the more menu.
Access Test Parameters
You can then add a new parameter with the plus button at the bottom of the panel.
Add new parameter
Fill in the name, description and value for the parameter and click on the add button to add it to your test.
Fill in the parameter details
This parameter is now ready to be used in the test. Navigate to the test step where you want to use it and click on that step in the step editor. Find the Input parameters section on the editing panel and click on the plus beside the input parameter you are interested in.
Click on the Step then choose "Use Parameter" on the input field
Clear any text already entered and then choose the parameter you created from the list of parameters.
Pick a Parameter
This will add the parameter as a variable in the input field and you can click on the check mark at the bottom of the panel to apply the change.
Apply changes
Click on the Save button on the test step panel and you will now have your input field parameterized.
In order to run a data driven test, you will need to create the data that you want to use and add it to the system. An easy way to get started with that is to go to the test you want to generate data for and use the more menu on it to download a CSV Parameters Template.
When testing the same application set the Parameter ApplicationURL to Private like in the image below before generating a Template. Setting a Parameter to private will hide it when providing a Data Source. do the same for every parameter you are not planning to override with the data source.
Setting Parameters to private
Create CSV Parameters Template
This will download a .csv file to your computer with headers for each of the parameters you have defined in your test. You can open the file in Excel or any other spreadsheet editing program and add in rows for each input you want to add.
Fill in the data
Once you have added the data that you want you can save the file as a .csv file again and upload it back into the TestProject app. To do that, go to the Data Sources menu option and choose to Add a data file.
Add a Data Source
Choose the .csv file you created and give it a name on click on Create. This will add the file to the system as an input source that you can use
Now that there is a data source in your project you can use it to drive your test. Click on Run icon for the test and choose the agent and platform that you will run the test on.
Run a Test
On the next page, you will be prompted for fill in the parameters for that test. To run a data driven test, enable the Override default input parameters option.
Override default input parameters
You can then select the data source you previously added and click on run. The test will run once for each row that you have added in the .csv file using the input for that row.