Skip to content
Parameterized tests › Building and running automated tests with the Automated Test Framework › Automated Test Framework \(ATF\) test building and execution › Automated Test Framework \(ATF\) › Testing and debugging applications › Building applications
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Add parameterized data sets

Add or import test data to specify parameter runtime values.

Before you begin

About this task

A data set, also known as a test run data set, includes runtime data used when the test runs. You can set a value for every parameter available to the current test. Data sets specify the parameter value during test runs.

Test designers can add data sets manually, or import data from a file.

Note: If you create a parameterized test that includes Custom UI test steps, the system only uses the first data set to retrieve components.

Procedure

  1. Navigate to All > Automated Test Framework > Tests.

  2. Open a parameterized test.

  3. In the Test Run Data Sets related list, add or import data sets.

OptionDescription
Add

The New Parameter Value Set form opens. This form includes all parameters available to the current test.

  1. Define the Order field to set the order in which data sets run.
  2. Specify the parameter value when the test runs.
  3. Click Submit.
Import

The Import Test Run Data Sets form opens.

  1. Define the import behavior.
  2. Add: Adds the data in the file to existing test run data sets in the Test Run Data Sets table. For more information, see Add a record in the template.
  3. Replace: Downloads a template that includes any existing data sets in the Test Run Data Sets table. Replaces all existing data sets that have matching Sys IDs in the Test Run Data Sets table with data from the uploaded file. For more information, see Update a record in the template.
  4. In the Upload Test Run Data File section, select Yes to download an Excel template with the required fields, then upload a completed file. Alternately, select No to upload a completed file. Each row in the file becomes an entry in the Test Run Data Sets table.

What to do next

Click Run Test. Automated Test Framework runs each parameterized test once per data set, using the same test steps and execution order. For example, if a parameterized test has five data sets, Automated Test Framework runs the test five times, once for each data set.

Parameterized tests display test results by the execution order of the data sets. Open each test result record to view the test details.

Parent Topic:Parameterized tests