Skip to content

Commit 3fbb732

Browse files
Added examples and runtime variables
1 parent 9f34e38 commit 3fbb732

1 file changed

Lines changed: 41 additions & 43 deletions

File tree

src/pages/tutorials/test-cases/data-driven-testing.md

Lines changed: 41 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -10,89 +10,87 @@ contextual_links:
1010
- type: section
1111
- name: "Contents"
1212
- type: link
13-
name: "Prerequisites"
14-
url: "#prerequisites"
13+
name: "Enable Data-Driven in test case"
14+
url: "#enable-data-driven-in-test-case"
1515
- type: link
16-
name: "Step 1: Associate data profile with a test case"
17-
url: "#step-1-associate-data-profile-with-a-test-case"
16+
name: "Use parameter names in test case"
17+
url: "#use-parameter-names-in-test-case"
1818
- type: link
19-
name: "Step 2: Use parameter names in test case"
20-
url: "#step-2-use-parameter-names-in-test-case"
21-
- type: link
22-
name: "Step 3: Run data driven test case"
23-
url: "#step-3-run-data-driven-test-case"
19+
name: "Run data driven test case"
20+
url: "#run-data-driven-test-case"
2421
---
2522

2623
---
2724

28-
Instead of hard-coding different values to test the same scenario with different test data, you can use Data Driven testing. In Testsigma, you can
25+
This tutorial walks you through data-driven testing and how to enable it in the test case. This can involve using external test data profiles as a source within the project to drive its behaviour. The goal is to increase the effectiveness and efficiency of testing by automating repetitive tasks and ensuring comprehensive test coverage. In Testsigma, you can
26+
2927

30-
1. Import or read the test data and/or expected output data from external files or data sources, then
28+
1. The test data and expected output data can be imported or read from external sources.
3129

32-
2. Feed this data into your automated test cases so that you don't need to hard-code the test data into the Test Steps definition.
30+
2. Using this data, you can avoid hardcoding the test data into the Test Steps definition in your automated test cases.
3331

34-
The test steps iterates itself and subsequent rows of data are fed to the test steps as input.
32+
Test steps iterate and feed subsequent rows of data into them as input.
3533

3634
---
3735

38-
> ## [Prerequisites:](#prerequisites)
36+
### **Prerequisites**
3937

40-
> 1. You should know [how to create a test data profile](https://testsigma.com/docs/test-data/create-data-profiles/).
41-
> 2. You should know [how to create a test case](https://testsigma.com/docs/test-cases/manage/add-edit-delete/).
38+
You'll need to know how to create a [test cases](https://testsigma.com/docs/test-cases/manage/add-edit-delete/#creating-a-test-case), [test data profile](https://testsigma.com/docs/test-data/create-data-profiles/#create-a-test-data-profile), and [runtime variable](https://testsigma.com/docs/test-data/types/runtime/#how-to-use-runtime-test-data-in-test-steps).
4239

4340
---
4441

45-
## [Step 1: Associate data profile with your test case](#step-1-associate-data-profile-with-you-test-case)
42+
## **Enable Data-Driven in test case**
4643

47-
1. In **Create** or **Edit** test case form and click on **Show additional options**.
44+
1. On the **Create** or **Edit** test case page, click on **Show additional options** to unhide the features.
45+
![unhide the feature](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/dd_showhideadvanced.png)
4846

49-
2. Select the **Test data profile** you want to add to your test cases and enable the toggle **Data Driven** as shown below:
47+
2. Select the **Test data profile** from the drop-down menu and turn on the **Data driven** toggle.
48+
![Toggle to enable data driven testing](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/dd_enabledd.png)
5049

51-
![Toggle to enable data driven testing](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/data-driven-testing/test_data_profile_associate.png)
52-
53-
Enabling the data-driven toggle will enable the test to run multiple times based on the number of rows available in Test Data Profile. For. If the data profile has 5 rows(sets) the test will run 5 times automatically using each data set(row) everytime.
50+
Enabling the data-driven toggle will allow the test to run multiple times based on the number of rows in the Test Data Profile. If the data profile has five rows (sets), the test will run five times automatically, using each data set (row) every time.
5451

5552
[[info | Note:]]
56-
| You can also select a specific data set if you want to run only once using data from a specific data set in the profile.
57-
58-
If you enable the data driven testing in your test case you can narrow and customize the various data sets from your test data profile that are being used in your test case using the filters *iteration*, *parameter*, *set name*.
53+
| You can also select a specific dataset if you want to run the profile only once, using data from that dataset.
5954

60-
* Iteration: This type of filtering is applicable only to sequential data sets. The data sets can be filtered using the filter operations greater than,less than, or between.
55+
Data-driven testing allows you to narrow and customize your test case using filters like *iteration*, *set name*, and *parameter*.
6156

62-
* Set name: This type of filtering is applicable for non sequential data sets. Here the data sets are filtered by data set names using the operations between, equals, contains, starts with, ends with. Any data set names containing the set name or part of it are used in the test case.
57+
* **Iteration:** This type of filtering applies only to sequential data sets. The data sets can be filtered using the filter operations *greater than*, *less than*, and *between*.
6358

64-
* Parameter:This type of filtering is applicable for non sequential data sets. Here the data sets are filtered using parameters used in data sets.
59+
* **Set name:** This type of filtering applies to non-sequential data sets. Here, the data sets are filtered by their names using the operations *between*, *equals*, *contains*, *starts with*, and *ends with*. Any data set names containing the set name, or part of it are used in the test case.
6560

66-
![parameter](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/data-driven-testing/filter_test_case_list.png)
61+
* **Parameter:** This type of filtering applies to non-sequential data sets. Here, the data sets are filtered using parameters used in the data sets. Here, filter operations are using *Equals*, *Contains*, *Start With*, *Ends With*, *Is Empty*, and *Is Not Empty*.
6762

68-
Refer to the below GIF on how to associate a test data profile to a test case
6963

70-
![test case data driven](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/data-driven-testing/create_data_driven_test_case.gif)
64+
###
7165

66+
3. Click **Create** or **Update** once the data driven is enabled.
67+
![test case data driven](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/create_data_driven_test_case.gif)
7268

73-
---
69+
[[info | NOTE:]]
70+
| You can use **runtime variables** in **filter values** by entering **$|Maharashtra|**, where *Maharashtra* is a stored variable, as shown in the example above.  
7471

75-
## [Step 2: Use parameter names in test case](#step-2-use-parameter-names-in-test-case)
7672

77-
1. Back in your test cases, while creating test steps, click on *test data* and select *@|Parameter|* from the drop down as shown below:
73+
---
7874

79-
![Choose the test data parameter to use in your test step](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/data-driven-testing/select_parameter.png)
75+
## **Use parameter names in test case**
8076

81-
2. Now an overlay will open with all available parameters in the data profile.
77+
1. Click on **test data** and select **@|Parameter|** from the drop-down list when creating test steps in the test case. 
78+
![Choose the test data parameter to use in your test step](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/dd_parametertestdata.png)
8279

83-
![Replace with parameter values](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/data-driven-testing/associate_parameter_name.png)
80+
2. An overlay screen will open, displaying all available parameters in the test data profile.
81+
![Replace with parameter values](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/dd_parameters.png)
8482

8583
Now, your test case will use the parameter value from your test data profile.
8684

87-
Refer to the below GIF on how to use parameter names in test cases
88-
![using parameter names in test case](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/data-driven-testing/using_data_profile.gif)
85+
![using parameter names in test case](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/testdataparameter_dd.gif)
8986

9087
---
9188

92-
## [Step 3: Run Data Driven Test Case](#step-3-run-data-driven-test-case)
89+
## **Run Data Driven Test Case**
9390

94-
1. Click on Run Now on the top right corner and select the test machine/device details
95-
96-
2. Once the test run is complete you will get results for each of the data sets. Like in the screenshot below:
91+
1. Click on **Run Now** in the top right corner, and the **Ad-hoc Run** screen will appear. Select the **test machine/device** and click **Run Now**.
9792

93+
2. Once the test run is complete you will get results for each of the data sets.
9894
![run result status of your test dat sets](https://docs.testsigma.com/images/tutorials/data-driven-testing/run-status-test-data-profiles.png)
95+
96+
---

0 commit comments

Comments
 (0)