Automated Test Framework roles

  • Release version: Zurich
  • Updated July 31, 2025
  • 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) in ServiceNow Zurich release includes specific roles to manage and execute automated testing capabilities. These roles control permissions for creating, editing, executing, and managing tests and related configurations within the platform. Understanding these roles helps customers assign appropriate access levels to users based on their responsibilities in the testing process.

    Show full answer Show less

    ATF Roles and Their Capabilities

    • ATF Test Administrator (atftestadmin)
      • Full control over ATF properties, tests, test steps, step configurations, and test suites
      • Can create, edit, delete, and execute tests and test suites
      • Access to test runner and result pages
      • Includes impersonator and personalizedictionary roles
      • Not an elevated role; assigned directly to users
      • No special considerations
    • ATF Test Designer (atftestdesigner)
      • Can create, edit, delete, and execute tests and test suites
      • View-only access to ATF properties (cannot create or edit)
      • Includes impersonator role
      • Not an elevated role; assigned directly to users
      • No special considerations
    • ATF Workspace Designer (atfwsdesigner)
      • Manages authentication settings for REST endpoints used in testing
      • Includes atftestdesigner and webserviceadmin roles
      • Not an elevated role; assigned directly to users
      • No special considerations

    Practical Considerations for ServiceNow Customers

    When implementing ATF, assign roles based on users’ needs:

    • Use ATF Test Administrator for users who require full control over test creation and configuration.
    • Assign ATF Test Designer to users focused on designing and executing tests without modifying ATF properties.
    • Grant ATF Workspace Designer to users responsible for managing authentication for REST endpoints involved in testing.

    None of these roles are elevated roles, meaning they are directly assignable without elevation processes. Also, managing per-user subscriptions may be necessary, so consult your account representative for subscription allocation related to these roles.

    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.