Automated Test Framework roles

  • Release version: Yokohama
  • Updated January 30, 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 includes predefined roles that control access and permissions for managing and executing automated tests. These roles enable customers to assign appropriate privileges to users based on their responsibilities within test creation, editing, execution, and configuration.

    Show full answer Show less

    Key Roles and Their Permissions

    • ATF Test Administrator (atftestadmin)
      • Full management capabilities including creating, editing, deleting tests and test steps.
      • Access to view and configure test runners, test results, step configurations, and ATF properties.
      • Can execute user tests and manage test suites comprehensively.
      • Not an elevated role; assigned directly to users without requiring elevation.
      • Contains sub-roles such as impersonator and personalizedictionary to support its functions.
    • ATF Test Designer (atftestdesigner)
      • Can create, edit, delete tests and test steps but only view ATF properties (no editing rights).
      • Access to test runners, test results, and test suites for execution and management.
      • Not an elevated role and not assigned to default groups.
      • Includes the impersonator role for additional permissions.
    • ATF Workspace Designer (atfwsdesigner)
      • Manages authentication settings for REST endpoints used in tests, including basic and mutual authentication.
      • Includes the atftestdesigner and webserviceadmin roles, enabling test design and web service administration.
      • Not an elevated role and not assigned to any default groups.

    Subscription and Elevation Considerations

    • None of the described roles are elevated roles; they are assigned directly to users without requiring elevation procedures.
    • Roles like atftestadmin and atftestdesigner may be subject to subscription management—ServiceNow customers should coordinate with their account representatives and follow Subscription Management guidelines to allocate these roles properly.

    Practical Implications for ServiceNow Customers

    Assigning the correct ATF roles allows customers to control who can create, edit, execute, and configure automated tests within their ServiceNow environment. Understanding the distinctions between these roles helps in delegating responsibilities effectively while maintaining security and compliance with subscription policies.

    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.