Development · Lesson

Automated Test Framework

Quick answer

The Automated Test Framework (ATF) lets you build repeatable tests of your instance, forms, catalog items, REST APIs, workflows, so an upgrade or a new update set doesn't silently break what already worked. It turns regression testing from days of manual clicking into an automated pass/fail run.

Key takeaways

Tests and test steps
Test Suites & scheduling
Where and how to run it
Why it matters for upgrades
Common mistakes

The Automated Test Framework (ATF) lets you build repeatable tests of your instance, forms, catalog items, REST APIs, workflows, so an upgrade or a new update set doesn't silently break what already worked. It turns regression testing from days of manual clicking into an automated pass/fail run.

Tests and test steps

A Test is a sequence of Test Steps chosen from a large catalog. Steps pass data down the chain, so step 3 can act on the record step 2 created:

Form steps

Open a new/existing record, set field values, submit, assert field state.

Server steps

Run a server script, query a record, assert a value.

Catalog steps

Order an item, set variables, assert the request/RITM.

REST steps

Call a REST API and assert the response.

Impersonate

Run subsequent steps as a specific user, test ACLs.

Test Suites & scheduling

Group related tests into a Test Suite and schedule it, for example, run the full regression suite automatically after every upgrade in the sub-prod instance, and read the pass/fail report before promoting.

Where and how to run it

Run ATF only in sub-production. There is an explicit property to enable it, and it must never be on in production, tests create and modify real records. A dedicated test browser session runs the UI steps.

Why it matters for upgrades

ServiceNow ships two family releases a year. A maintained ATF suite makes upgrade regression testing repeatable and fast, the difference between a confident upgrade and a nervous one. It is also the safety net that lets you accept new features without fear of silent breakage.

Common mistakes

Enabling ATF in production.
Writing brittle tests tied to exact UI text that changes each release.
Building tests once and never maintaining them as configuration evolves.
Testing only the happy path and missing the failure branches.

Want to learn this properly?

Our live, instructor-led ServiceNow Training covers this hands-on, with real projects and a certification path.

See the course Ask a question

Check your understanding

ATF is mainly used to:
- A. Catch regressions and test config
- B. Discover servers
- C. Send email
Show answer
A. Catch regressions and test config
ATF automates regression testing of your configuration.
Related tests are grouped into a:
- A. Test suite
- B. Business rule
- C. Portal
Show answer
A. Test suite
Test suites group tests to run together.
You should run ATF on:
- A. Production
- B. A sub-production instance
- C. Nowhere
Show answer
B. A sub-production instance
Run ATF on non-production instances to avoid side effects.

Frequently asked questions

What does the term Automated Test Framework refer to in ServiceNow?

What is another point to note about Automated Test Framework?

Group related tests into a Test Suite and schedule it, for example, run the full regression suite automatically after every upgrade in the sub-prod instance, and read the pass/fail report before promoting.

What tends to go wrong with Automated Test Framework?

Enabling ATF in production. Writing brittle tests tied to exact UI text that changes each release. Building tests once and never maintaining them as configuration evolves.