atf-testing

Automated Test Framework (ATF) for ServiceNow

ATF provides automated testing capabilities for ServiceNow applications, enabling regression testing and continuous integration.

ATF Architecture

Test Hierarchy

Test Suite: Incident Management Tests
├── Test: Create Incident
│   ├── Step 1: Impersonate User
│   ├── Step 2: Open New Record
│   ├── Step 3: Set Field Values
│   ├── Step 4: Submit Form
│   └── Step 5: Assert Values
├── Test: Assign Incident
│   └── Steps...
└── Test: Resolve Incident
    └── Steps...

Key Tables

Table	Purpose
sys_atf_test	Test definitions
sys_atf_step	Individual test steps
sys_atf_test_suite	Test suite groupings
sys_atf_test_suite_test	Suite-test relationships
sys_atf_test_result	Test execution results

Test Step Types

Common Step Types

Step Type	Purpose	Example
Impersonate	Run as specific user	Test as ITIL user
Open a New Form	Create new record	New incident form
Open an Existing Form	Edit record	Open INC0010001
Set Field Values	Populate fields	Set priority, description
Click a UI Action	Trigger button	Click "Save"
Assert Field Values	Validate values	Priority = 1
Run Server Side Script	Execute script	Custom validation
Wait	Pause execution	Wait for async

Creating Tests

Basic Test Structure (ES5)

// Create a new ATF test
var test = new GlideRecord("sys_atf_test")
test.initialize()
test.setValue("name", "Test: Create High Priority Incident")
test.setValue("description", "Verify high priority incident creation workflow")
test.setValue("active", true)
test.setValue("application", "global") // or scoped app sys_id
var testSysId = test.insert()

// Add test steps
function addTestStep(testId, order, stepType, config) {
  var step = new GlideRecord("sys_atf_step")
  step.initialize()
  step.setValue("test", testId)
  step.setValue("order", order)
  step.setValue("step_config", stepType)

  // Set step-specific configuration
  for (var key in config) {
    if (config.hasOwnProperty(key)) {
      step.setValue(key, config[key])
    }
  }

  return step.insert()
}