Skip to content

Commit 16c2ccf

Browse files
authored
Merge pull request #30 from testsigmahq/dev
Added runtime variables and examples to the Data-Driven document.
2 parents c400940 + 77c5d50 commit 16c2ccf

1 file changed

Lines changed: 40 additions & 46 deletions

File tree

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

Lines changed: 40 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -10,89 +10,83 @@ 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)
46-
47-
1. In **Create** or **Edit** test case form and click on **Show additional options**.
42+
## **Enable Data-Driven in test case**
4843

49-
2. Select the **Test data profile** you want to add to your test cases and enable the toggle **Data Driven** as shown below:
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)
5046

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)
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)
5249

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*.
59-
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.
53+
| You can also select a specific dataset if you want to run the profile only once, using data from that dataset.
6154

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.
55+
Data-driven testing allows you to narrow and customize your test case using filters like *iteration*, *set name*, and *parameter*.
6356

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.
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*.
6558

66-
![parameter](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/data-driven-testing/filter_test_case_list.png)
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.
6760

68-
Refer to the below GIF on how to associate a test data profile to a test case
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*.
6962

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)
63+
###
7164

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

73-
---
74-
75-
## [Step 2: Use parameter names in test case](#step-2-use-parameter-names-in-test-case)
76-
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:
68+
[[info | NOTE:]]
69+
| You can use **runtime variables** in **filter values** by entering **$|Washington, DC|**, where *Washington, DC* is a stored variable, as shown in the example above.  
7870

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)
71+
## **Use parameter names in test case**
8072

81-
2. Now an overlay will open with all available parameters in the data profile.
73+
1. Click on **test data** and select **@|Parameter|** from the drop-down list when creating test steps in the test case. 
74+
![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)
8275

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

8579
Now, your test case will use the parameter value from your test data profile.
8680

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)
81+
![using parameter names in test case](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/testdataparameter_dd.gif)
8982

9083
---
9184

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

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:
87+
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**.
9788

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

0 commit comments

Comments
 (0)