---
sourceDocument: Brazil Build or modify applications
sourceDocumentLink: https://www.servicenow.com/docs/r/application-development

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Building and running automated tests with the Automated Test Framework

# Building and running automated tests with the Automated Test Framework {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Basic tasks in the Automated Test Framework.  
To build and run any test, you always perform certain operations:

* [Create a new automated test](https://www.servicenow.com/docs/82jgQEpEPNHxicFbUSSIeA "Create a named automated test containing a series of steps to execute.")
* [Add steps to an automated test](https://www.servicenow.com/docs/0Wb2_WSr5aVjVYd0UP53aw "Create a series of steps for an automated test to run in a specified order.")
* [Run an automated test](https://www.servicenow.com/docs/GV7dSVCU441Z14zfdnylYg "After creating an automated test, run it on a non-production instance.")
* [View the progress of automated tests](https://www.servicenow.com/docs/W3qFPpCdjA3oZmMGlLf5ew "When an automated test is running, view its progress in the Run Test progress dialog.")
* [View test results and automated test results](https://www.servicenow.com/docs/hGWzjpj4cIXsgwbSGcAprw "View test results from completed test and test suite runs. Carefully consider the results of automated test runs and perform any corrective actions required to resolve any revealed issues.")
{#atf-build-overview__uf3_s2c_fy}  
You perform other operations often, but not necessarily for every test.

* For tests involving form steps, you might need to [View results
  screenshots from an automated test](https://www.servicenow.com/docs/hGWzjpj4cIXsgwbSGcAprw "View test results from completed test and test suite runs. Carefully consider the results of automated test runs and perform any corrective actions required to resolve any revealed issues.").
* For some tests, you might need to know about [Passing data from one automated test step to another](https://www.servicenow.com/docs/v90qik0Gq6fEF40pejixqw "Some automated test steps create data that you can use as an input to a subsequent step.").
* Some steps frequently occur in the same sequence in many different tests, so you can [Add a predefined list of steps (template) to an automated test](https://www.servicenow.com/docs/gRR9cbo8SWQM6VB2v4YO6g "With test templates you can add a predefined list of steps to a test. Any list of steps that follows a set pattern makes a good candidate for a template.").
{#atf-build-overview__ul_a23_yms_kfb}
* **[Create a new automated test](https://www.servicenow.com/docs/82jgQEpEPNHxicFbUSSIeA)**   
  Create a named automated test containing a series of steps to execute.
* **[Copy automated test](https://www.servicenow.com/docs/JdepKEo23nA3ub_Wys8p3A)**   
  Copy an existing test, which you can then re-name and modify.
* **[Run an automated test](https://www.servicenow.com/docs/GV7dSVCU441Z14zfdnylYg)**   
  After creating an automated test, run it on a non-production instance.
* **[Implementing breakpoints](https://www.servicenow.com/docs/IABRMhehgUxbK2v_eLyA9w)**   
  Breakpoints allow you to pause your test at any step of a test run in order to troubleshoot and test authoring.
* **[View test results and automated test results](https://www.servicenow.com/docs/hGWzjpj4cIXsgwbSGcAprw)**   
  View test results from completed test and test suite runs. Carefully consider the results of automated test runs and perform any corrective actions required to resolve any revealed issues.
* **[Identify and resolve client errors](https://www.servicenow.com/docs/BKN1X3OJORDgU5J785V_GA#identify-and-resolve-client-errors)**   
  Identify client errors and resolve them in client-side scripts.
* **[UI test steps](https://www.servicenow.com/docs/noB7_8qKDgnpCmg0bQZY0A)**   
  Test user interfaces by mimicking user actions and interacting with the visible components of a page.
* **[Server test steps](https://www.servicenow.com/docs/z5o1rvyM1qpppEXxWFRTyA)**   
  Test business logic and background processes by performing operations on the server.
* **[Attachment test steps](https://www.servicenow.com/docs/ErZ5SGkmBdh4U4Q531116w)**   
  Test an attachment-dependent business rule by uploading an attachment either from a form or from a server-side API call. For example, you can have a business rule that doesn't let you close an incident without an attachment such as a screenshot.
* **[List UI actions test steps](https://www.servicenow.com/docs/f0CO8XIuEYMXDAE1aoowWg)**   
  Select a UI action from a list to perform different actions on a list or a related list.
* **[Parameterized tests](https://www.servicenow.com/docs/ucR1xBIrH2JJGCA~zg0C2g)**   
  Run a test multiple times with different test data for each run. Create parameters to store test data for each test run.
* **[Allowed client errors](https://www.servicenow.com/docs/MMnOr8HZ4eIxWo9GMVnGMg)**   
  Add known client errors to the allowed client errors list to allow tests and steps to continue running when a specific error occurs. Set the report level to specify what the Automated Test Framework does when the error occurs in future tests.
* **[View the progress of automated tests](https://www.servicenow.com/docs/W3qFPpCdjA3oZmMGlLf5ew)**   
  When an automated test is running, view its progress in the Run Test progress dialog.
* **[Passing data from one automated test step to another](https://www.servicenow.com/docs/v90qik0Gq6fEF40pejixqw)**   
  Some automated test steps create data that you can use as an input to a subsequent step.

**Related concepts**   

* [Building and running automated test suites](https://www.servicenow.com/docs/YADpXw3tVCkSNbAjIpPWbg "Run a group of tests in a specific order to test an application or a group of related features.")
* [Cancelling automated tests and test suites](https://www.servicenow.com/docs/3061bYnd1hY0iGLGYHnYZA#atf-cancelling "You can cancel automated tests and automated test suites that are running or are queued to run.")  
**Related tasks**   

* [Auto-generate ATF tests](https://www.servicenow.com/docs/eGyBTYwIIZ7E~nDYkZBHTg "Auto-generate ATF tests by selecting the auto-generate option either from the Auto-generate Tests module or Tests/Suites modules.")