Create a parameterized test

  • Release version: Xanadu
  • Updated August 1, 2024
  • 1 minute to read
  • 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.
      Field Description
      Name Enter a name for the test.
      Active Enable
      Enable parameterized testing Enable
      Description Enter 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.
      2. 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.
      3. Click Submit.

    What to do next

    Add a parameter to a test step