Automated Test Framework roles

  • Release version: Australia
  • Updated March 12, 2026
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Automated Test Framework roles

    The Automated Test Framework (ATF) provides specific roles to manage testing within ServiceNow. These roles include ATF Test Administrator, ATF Test Designer, and ATF Workspace Designer, each with distinct permissions and capabilities essential for effective test management.

    Show full answer Show less

    Key Features

    • ATF Test Administrator [atftestadmin]:
      • Create, edit, and delete Automated Test Framework properties, tests, and test steps.
      • View and execute user tests, test suite results, and related pages.
      • Has permission to create and edit step configuration records.
    • ATF Test Designer [atftestdesigner]:
      • View Automated Test Framework properties (no editing rights).
      • Similar permissions to the ATF Test Administrator for managing tests and test suites.
    • ATF Workspace Designer [atfwsdesigner]:
      • View or set basic or mutual authentication for REST endpoints requiring authentication.

    Key Outcomes

    By utilizing these roles, ServiceNow customers can efficiently manage and execute automated testing, ensuring a streamlined testing process. Each role is designed to empower users with the necessary permissions to enhance their testing capabilities while maintaining security protocols through elevated role management. Understanding these roles helps teams leverage the full potential of the Automated Test Framework in their workflows.

    Automated Test Framework is installed with these roles.

    ATF test administrator [atf_test_admin]

    To learn more about managing per-user subscriptions, see Managing per-user subscriptions in Subscription Management and contact your account representative.

    Create or edit Automated Test Framework properties. Has permission to:
    • View the tests page
    • Create/edit/delete tests
    • Create/edit/delete test steps
    • View the step config page
    • View the test runner page
    • View the test suite results, test results and result items pages
    • Execute user tests
    • View, create, edit, delete and execute test suites
    • Create/edit step config records
    • Create/edit Automated Test Framework properties
    Contains Roles
    List of roles contained within the role.
    • impersonator
    • personalize_dictionary
    Groups
    List of groups this role is assigned to by default.
    None
    Elevated
    Whether the role is an elevated role. Elevated roles aren’t assigned to users or groups, and must be used by elevation. For details, see Elevate to a privileged role.
    No.
    Special considerations
    None.

    ATF test designer [atf_test_designer]

    To learn more about managing per-user subscriptions, see Managing per-user subscriptions in Subscription Management and contact your account representative.

    View Automated Test Framework properties only (can't create or edit properties). Has permission to:
    • View the tests page
    • Create/edit/delete tests
    • Create/edit/delete test steps
    • View the step config page
    • View the test runner page
    • View the test suite results, test results and result items pages
    • Execute user tests
    • View, create, edit, delete and execute test suites
    • View Automated Test Framework properties
    Contains Roles
    List of roles contained within the role.
    impersonator
    Groups
    List of groups this role is assigned to by default.
    None
    Subscription
    Whether the role is a chargeable user role that requires allocation of users with this role to subscriptions.
    Elevated
    Whether the role is an elevated role. Elevated roles aren’t assigned to users or groups, and must be used by elevation. For details, see Elevate to a privileged role.
    No.
    Special considerations
    None.

    ATF workspace designer [atf_ws_designer]

    To learn more about managing per-user subscriptions, see Managing per-user subscriptions in Subscription Management and contact your account representative.

    View or set the basic or mutual authentication needed for REST endpoints that require authentication.

    Contains Roles
    List of roles contained within the role.
    • atf_test_designer
    • web_service_admin
    Groups
    List of groups this role is assigned to by default.
    None
    Subscription
    Whether the role is a chargeable user role that requires allocation of users with this role to subscriptions.
    No.
    Elevated
    Whether the role is an elevated role. Elevated roles aren’t assigned to users or groups, and must be used by elevation. For details, see Elevate to a privileged role.
    No.
    Special considerations
    None.