Multiple datasets in tests and test suites

You can configure multiple datasets in tests or test suites to provide additional data for variables during a test run. You can combine data from multiple datasets which supports flexible data-driven testing across different scenarios.

Overview

When working with datasets in a test or test suite, you can use a primary dataset along with additional datasets to provide values for variables.

The primary dataset is used as the main data source. Additional datasets provide supporting values when required. Therefore, you can use data from multiple datasets without duplicating test logic.

In Test Editor, you can add additional datasets when configuring tests and test suites.

You can configure multiple datasets in Test Editor as follows:

  • Select a dataset as the primary dataset.
  • Add one or more additional datasets, which are displayed indented under the primary dataset.
  • Add additional datasets only after selecting the primary dataset.
    Note:
    You cannot select the same dataset more than once.

Dataset behavior

The following behavior applies when you assign values to variables:
  • Columns from both primary and additional datasets are available for mapping to variables.
  • If a column name exists in multiple datasets, the value from the first matching dataset is used for mapping to variables. Datasets are considered in the configured order, and the primary dataset is considered first.
  • If the same column exists in multiple datasets, the value from the first matching dataset is used.
  • Additional datasets are used to provide values that are not available in the primary dataset.