Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a parameterized test

Build a test that uses variables to store test data.

Before you begin

Role required: atf_test_admin, atf_test_designer, or admin

Procedure

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

  2. Click New.

    A blank Test record opens.

  3. On the form, fill in the fields.

    FieldDescription
    NameEnter a name for the test.
    ActiveEnable
    Enable parameterized testingEnable
    DescriptionEnter a description for the test.
  4. Click Save.

    Parameterized testing related lists appear.

  5. Create a parameter to hold test run data.

    A parameter is a variable that stores a particular type of test data. Each parameter has a unique label and a data type. For example, you can create a parameter to store the Sys ID of a reference field or the integer value of a choice field.

    1. In the Parameter Definitions related list, add a parameter.

      • Add Exclusive Parameters: Adds a parameter available to this test only.
      • Add Shared Parameters: Adds a parameter available to any parameterized test.
        1. Define the name of the variable and the data type.

      When creating parameters for a form, the parameter data type must match the field data type. For example, if you are creating a parameter to test a reference field on a form, you must create a parameter of type Reference. For more information on ServiceNow AI Platform data types, see Field types.

    2. Click Submit.

What to do next

Add a parameter to a test step

Parent Topic:Parameterized tests