Automated Test Framework roles

  • Release version: Xanadu
  • Updated August 1, 2024
  • 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 specific roles designed to manage and execute automated tests effectively. These roles provide varying levels of access and capabilities to support test creation, execution, and configuration within the platform.

    Show full answer Show less

    Key Roles and Their Capabilities

    • ATF Test Administrator (atftestadmin)
      • Full permissions to create, edit, delete, and execute tests, test steps, and test suites.
      • Can view and modify Automated Test Framework properties and step configuration records.
      • Access to test runner and results pages.
      • Does not require elevation and is not assigned to any default groups.
    • ATF Test Designer (atftestdesigner)
      • Can create, edit, delete, and execute tests, test steps, and test suites.
      • Has view-only access to Automated Test Framework properties (cannot edit).
      • Access to test runner and results pages.
      • Not an elevated role and not assigned to default groups.
      • Requires subscription allocation as it is a chargeable user role.
    • ATF Workspace Designer (atfwsdesigner)
      • Can view or configure authentication settings (basic or mutual) for REST endpoints requiring authentication.
      • Includes roles atftestdesigner and webserviceadmin within it.
      • Not an elevated role and not assigned to default groups.
      • Does not require subscription allocation.

    Practical Considerations for ServiceNow Customers

    • Assign roles based on required test framework capabilities—administrators for full control, designers for test creation and execution, and workspace designers for REST authentication configurations.
    • None of these roles are elevated; hence, they can be assigned directly to users without requiring role elevation steps.
    • Subscription management is relevant for some roles, so coordinate with your account representative to manage per-user subscriptions properly.
    • These roles are not assigned to default groups; role assignment must be managed explicitly to control access.

    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.