Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • Now Platform App Engine
Table of Contents
Choose your release version
    Home Orlando Now Platform App Engine Now Platform App Engine Application tools Automated Test Framework (ATF) Test step categories List and Related List

    List and Related List

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    List and Related List

    Validate the functionality and visibility of records and UI actions in lists and related lists.

    Validate Related List Visibility

    Validate the visibility of the selected related lists on a form.

    Table 1. Inputs
    Field Description
    Execution order Integer specifying the order in which the test executes this step.

    As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

    Application Application scope in which the system runs this step.
    Active Option to activate this test step for use.
    Test Name of the test that you're adding the step to.
    Step config Name of the step.
    Notes Notes about the test step.
    Table Name of the table of the parent form where related list visibility is validated.
    Visible List of related lists to assert as visible.
    Not visible List of related lists to assert as not visible.

    Apply Filter to List

    Apply a filter to a list to find the required record.

    Table 2. Inputs
    Field Description
    Execution order Integer specifying the order in which the test executes this step.

    As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

    Active Option to activate this test step for use.
    Application Application scope in which the system runs this step.
    Test Name of the test that you're adding the step to.
    Step config Name of the step.
    Notes Notes about the test step.
    List type Option to select the type of list.
    • List
    • Related list
    Assert Type Specifies the assertion on executing the test step:
    • At least one matching record found: The step succeeds if there is at least one matching record.
    • No matching record found: The step fails if there is any matching record.
    • One matching record found: The step succeeds if there is exactly one matching record.
    Table

    If the List type is List, this field is the table of the opened list.

    If the List type is Related list, this field states the name of the table of the parent form where the list belongs.

    Related List The related list to apply a filter to.
    Note: This field is available when Related list is selected from List type.
    List filter Filter conditions to apply to the list.
    Table 3. Outputs
    Field Description
    first_record The first record found in the list after applying the indicated filter.

    Validate Record Present in List

    Validate the presence of a record in a list. A valid form must be open and the list containing the record must be visible to proceed.

    Table 4. Inputs
    Field Description
    Execution order Integer specifying the order in which the test executes this step.

    As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

    Application Application scope in which the system runs this step.
    Active Option to activate this test step for use.
    Test Name of the test that you're adding the step to.
    Timeout Number of seconds allowed before the step fails. If the validation fails, the system repeats the step until it reaches the duration of the timeout. If the validation fails after the timeout duration has passed, the step fails.
    Step config Name of the step.
    Notes Notes about the test step.
    List type Option to select the type of list.
    • List
    • Related list
    Assert type Specifies the assertion on executing the test step:
    • Record is present in the list
    • Record is not present in the list
    Table Name of the parent table where the list belongs.
    Related list The related list which has the record to validate.
    Note: This field is available when Related list is selected from List type.
    Record The record whose presence is validated.

    Open a Record in List

    Open a specific record in a list.

    Table 5. Inputs
    Field Description
    Execution order Integer specifying the order in which the test executes this step.

    As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

    Application Application scope in which the system runs this step.
    Active Option to activate this test step for use.
    Test Name of the test that you're adding the step to.
    Step config Name of the step.
    Notes Notes about the test step.
    List type Option to select the type of list.
    • List
    • Related list
    Table Name of the parent table where the list belongs.
    Related List The related list which has the record to open.
    Note: This field is available when Related list is selected from List type.
    Record The record to be opened.

    Validate List UI Action Visibility

    Validate that a UI action is visible in a list. If you're impersonating a user, the visibility of a UI action can change depending on the user being impersonated.

    Table 6. Inputs
    Field Description
    Execution order Integer specifying the order in which the test executes this step.

    As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

    Application Application scope in which the system runs this step.
    Active Option to activate this test step for use.
    Test Name of the test that you're adding the step to.
    Step config Name of the step.
    Notes Notes about the test step.
    List type Option to select the type of list.
    • List
    • Related list
    Table Name of the table of the parent form.
    Related List The related list which has the UI actions.
    Note: This field is available when Related list is selected from List type.
    Visible List of UI actions to assert as visible.
    Not visible List of UI actions to assert as not visible.

    Click a List UI Action

    Select a list UI action in a list on a form.

    Table 7. Inputs
    Field Description
    Execution order Integer specifying the order in which the test executes this step.

    As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

    Application Application scope in which the system runs this step.
    Active Option to activate this test step for use.
    Test Name of the test that you're adding the step to.
    Step config Name of the step.
    Notes Notes about the test step.
    List type Option to select the type of list.
    • List
    • Related list
    Table Name of the table where the UI action belongs.
    Related list The related list which has the UI actions.
    Note: This field is available when Related list is selected from List type.
    List action The list UI action to be clicked.
    Action type The type of UI action to be clicked.
    Apply to The record on which the UI action is applied.
    Assert type The assertion made by the step when executed.
    • None: Click a UI action and continue without making an assertion.
    • Page reloaded or redirected: Click a UI action, and assert that the page was reloaded or redirected. This assert type doesn't assert form submission.
    Record The record to which the UI action is applied.
    Note: This field appears when you choose Single record in the Apply to field.

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      List and Related List

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      List and Related List

      Validate the functionality and visibility of records and UI actions in lists and related lists.

      Validate Related List Visibility

      Validate the visibility of the selected related lists on a form.

      Table 1. Inputs
      Field Description
      Execution order Integer specifying the order in which the test executes this step.

      As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

      Application Application scope in which the system runs this step.
      Active Option to activate this test step for use.
      Test Name of the test that you're adding the step to.
      Step config Name of the step.
      Notes Notes about the test step.
      Table Name of the table of the parent form where related list visibility is validated.
      Visible List of related lists to assert as visible.
      Not visible List of related lists to assert as not visible.

      Apply Filter to List

      Apply a filter to a list to find the required record.

      Table 2. Inputs
      Field Description
      Execution order Integer specifying the order in which the test executes this step.

      As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

      Active Option to activate this test step for use.
      Application Application scope in which the system runs this step.
      Test Name of the test that you're adding the step to.
      Step config Name of the step.
      Notes Notes about the test step.
      List type Option to select the type of list.
      • List
      • Related list
      Assert Type Specifies the assertion on executing the test step:
      • At least one matching record found: The step succeeds if there is at least one matching record.
      • No matching record found: The step fails if there is any matching record.
      • One matching record found: The step succeeds if there is exactly one matching record.
      Table

      If the List type is List, this field is the table of the opened list.

      If the List type is Related list, this field states the name of the table of the parent form where the list belongs.

      Related List The related list to apply a filter to.
      Note: This field is available when Related list is selected from List type.
      List filter Filter conditions to apply to the list.
      Table 3. Outputs
      Field Description
      first_record The first record found in the list after applying the indicated filter.

      Validate Record Present in List

      Validate the presence of a record in a list. A valid form must be open and the list containing the record must be visible to proceed.

      Table 4. Inputs
      Field Description
      Execution order Integer specifying the order in which the test executes this step.

      As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

      Application Application scope in which the system runs this step.
      Active Option to activate this test step for use.
      Test Name of the test that you're adding the step to.
      Timeout Number of seconds allowed before the step fails. If the validation fails, the system repeats the step until it reaches the duration of the timeout. If the validation fails after the timeout duration has passed, the step fails.
      Step config Name of the step.
      Notes Notes about the test step.
      List type Option to select the type of list.
      • List
      • Related list
      Assert type Specifies the assertion on executing the test step:
      • Record is present in the list
      • Record is not present in the list
      Table Name of the parent table where the list belongs.
      Related list The related list which has the record to validate.
      Note: This field is available when Related list is selected from List type.
      Record The record whose presence is validated.

      Open a Record in List

      Open a specific record in a list.

      Table 5. Inputs
      Field Description
      Execution order Integer specifying the order in which the test executes this step.

      As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

      Application Application scope in which the system runs this step.
      Active Option to activate this test step for use.
      Test Name of the test that you're adding the step to.
      Step config Name of the step.
      Notes Notes about the test step.
      List type Option to select the type of list.
      • List
      • Related list
      Table Name of the parent table where the list belongs.
      Related List The related list which has the record to open.
      Note: This field is available when Related list is selected from List type.
      Record The record to be opened.

      Validate List UI Action Visibility

      Validate that a UI action is visible in a list. If you're impersonating a user, the visibility of a UI action can change depending on the user being impersonated.

      Table 6. Inputs
      Field Description
      Execution order Integer specifying the order in which the test executes this step.

      As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

      Application Application scope in which the system runs this step.
      Active Option to activate this test step for use.
      Test Name of the test that you're adding the step to.
      Step config Name of the step.
      Notes Notes about the test step.
      List type Option to select the type of list.
      • List
      • Related list
      Table Name of the table of the parent form.
      Related List The related list which has the UI actions.
      Note: This field is available when Related list is selected from List type.
      Visible List of UI actions to assert as visible.
      Not visible List of UI actions to assert as not visible.

      Click a List UI Action

      Select a list UI action in a list on a form.

      Table 7. Inputs
      Field Description
      Execution order Integer specifying the order in which the test executes this step.

      As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.

      Application Application scope in which the system runs this step.
      Active Option to activate this test step for use.
      Test Name of the test that you're adding the step to.
      Step config Name of the step.
      Notes Notes about the test step.
      List type Option to select the type of list.
      • List
      • Related list
      Table Name of the table where the UI action belongs.
      Related list The related list which has the UI actions.
      Note: This field is available when Related list is selected from List type.
      List action The list UI action to be clicked.
      Action type The type of UI action to be clicked.
      Apply to The record on which the UI action is applied.
      Assert type The assertion made by the step when executed.
      • None: Click a UI action and continue without making an assertion.
      • Page reloaded or redirected: Click a UI action, and assert that the page was reloaded or redirected. This assert type doesn't assert form submission.
      Record The record to which the UI action is applied.
      Note: This field appears when you choose Single record in the Apply to field.

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login