---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/application-development

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Build and run your first automated test

# Build and run your first automated test {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

Follow these step-by-step instructions to create and run your first automated
test. This test creates a new user record.
* The Automated Test Framework (com.glide.automated_testing_framework) plugin must be activated. It is activated by default on zBoot or upgrade.{#atf-tut-build-first__m14_tc1_xx}
* If necessary, enable test execution. For instructions, see [Enable or disable executing Automated Test Framework tests](https://servicenow-prod.fluidtopics.net/issftcAG~Wg6pCHCmQrkqg "Allow or prevent tests and test suites from executing on this instance.").  
  Nota:  
  By default, the system property that is used to run automated tests is disabled to prevent you from accidentally running these tests on a production system. To avoid data corruption or an outage, run tests only on development, test, and other non-production instances.
* Role required: admin
{#atf-tut-build-first__jv1_tc1_xx}

## Create new test {#ariaid-title2}

Create a new automated test record.

### Antes de Iniciar

Role required: atf_test_admin or admin

### Procedimento

1. Navigate to AllAutomated Test FrameworkTests. {#atf-tut-create-first-test__nds_rbn_zx}
2. Click New. {#atf-tut-create-first-test__pds_rbn_zx}
3. On the Test new record form, enter a name for your test in the Name field.  
   The system identifies this test by this name whenever it displays a list of tests (for example, under the Tests module).  

   <br />

   {#atf-tut-create-first-test__tds_rbn_zx}
4. In the Description field, enter a description for your test. {#atf-tut-create-first-test__vds_rbn_zx}
5. Click Save. {#atf-tut-create-first-test__xds_rbn_zx}
{#atf-tut-create-first-test__conref-create-new-test}

### Resultado

The system creates a new test record and returns to the list of tests. For more information about creating new automated tests, see [Create a new automated test](https://servicenow-prod.fluidtopics.net/VkE2aCDIQSD4kaMdMv2iIg "Create a named automated test containing a series of steps to execute.").

## Add the first step to the new test {#ariaid-title3}

Add the first of three steps to the automated test.

### Antes de Iniciar

Role required: atf_test_admin or admin

### Procedimento

1. Navigate to AllAutomated Test FrameworkTests.
2. Click the test that should contain the new test steps.
3. In the Test Steps related list at the bottom of the Test form, click Add Test Step.
4. In the middle column, click the row for the step type Open a new form, then select Next.  

   <br />

   The system displays the Add Test Step form for the Open a new form step. {#atf-tut-create-first-step__ifd_cn4_xx}
5. From the Table field, select the User \[sys_user\] table and click Submit.  

   <br />

   The system creates the new step and returns to the test record. {#atf-tut-create-first-step__cmt_dp4_xx}
6. Click Update. {#atf-tut-create-first-step__hxy_4gw_1y}
{#atf-tut-create-first-step__conref-add-step-11}{#atf-tut-create-first-step__w5k_kdg_xx}

### Resultado

The system creates a new test record and returns to the list of tests. For more information about adding steps to automated tests, see [Add steps to an automated test](https://servicenow-prod.fluidtopics.net/RMUgLrgF2WwPys478zXGuQ "Create a series of steps for an automated test to run in a specified order.").

### O que Fazer Depois

For some ideas on how to continue learning about the Automated Test Framework, see [Next steps with the Automated Test Framework](https://servicenow-prod.fluidtopics.net/hBWx95rcqCiQoZT0bNZLTQ "After you feel comfortable creating and running simple tests, explore the more advanced features of the Automated Test Framework.").

## Add the second step to your automated test {#ariaid-title4}

Add the second of three steps to the automated test.

### Antes de Iniciar

Role required: atf_test_admin or admin

### Procedimento

1. Click the test that should contain the new test steps.
2. In the Test Steps related list at the bottom of the Test form, click Add Test Step.
3. In the middle column, click Set Field Values, then click Next.  
   The system displays the Add Test Step form for the Set values step. {#atf-tut-create-second-step__any_2t4_xx}
4. In the field values section, set Last name to <kbd class="ph userinput" id="atf-tut-create-second-step__pk5_3p4_xx">Test</kbd> and First name to <kbd class="ph userinput" id="atf-tut-create-second-step__ycr_jp4_xx">Otto</kbd> (or other names of your choice).  

   <br />

   {#atf-tut-create-second-step__uz2_jp4_xx}
5. Click Submit.
{#atf-tut-create-second-step__ewl_ks4_xx}

### Resultado

The system creates the new step and returns to the test record. For more information about adding steps to automated tests, see [Add steps to an automated test](https://servicenow-prod.fluidtopics.net/RMUgLrgF2WwPys478zXGuQ "Create a series of steps for an automated test to run in a specified order.").

## Add the third step to your test {#ariaid-title5}

Add the last of three steps to the automated test.

### Antes de Iniciar

Role required: atf_test_admin or admin

### Procedimento

1. Click the test that should contain the new test steps.
2. In the Test Steps related list at the bottom of the Test form, click Add Test Step.
3. In the middle column, click Submit a Form, then click Next.  
   The system displays the Add Test Step form for the Submit a form step. {#atf-tut-create-third-step__y1p_mt4_xx}
4. Leave all values as set by default and click Submit.  

   <br />

   The system creates the new step and returns to the test record. The test record should now show the three steps you just added.  

   {#atf-tut-create-third-step__bk5_vt4_xx}
5. Click Update.
{#atf-tut-create-third-step__t1p_mt4_xx}

### Resultado

The system returns to the list of tests. For more information about adding steps to automated tests, see [Add steps to an automated test](https://servicenow-prod.fluidtopics.net/RMUgLrgF2WwPys478zXGuQ "Create a series of steps for an automated test to run in a specified order.").

## Run your test {#ariaid-title6}

After adding test steps, run and monitor the progress of the automated
test.

### Antes de Iniciar

Role required: atf_test_admin or admin

### Procedimento

1. If necessary to view the Tests list, click Tests. {#atf-tut-run-first-test__i25_tgk_yx}
2. Click the row containing the test you just created.  
   The system displays the Test form. {#atf-tut-run-first-test__rfx_rgk_yx}
3. Click Run Test.  
   Because this test includes a form step (any step involving a UI), the system displays a dialog box asking you to choose among any currently-running test clients or start a new test runner. To continue, select start a new test runner and click Run Test. {#atf-tut-run-first-test__zrb_xgk_yx}
{#atf-tut-run-first-test__m2q_rfk_yx}

### Resultado

The system displays the Run Test progress dialog. For more information about running automated tests, see [Run an automated test](https://servicenow-prod.fluidtopics.net/LLFvSTUqc7sP5_Pg5AUa9w "After creating an automated test, run it on a non-production instance.").

## Monitor test progress and view test results {#ariaid-title7}

Monitor the progress of the automated test and view its test results.

### Antes de Iniciar

Role required: atf_test_admin or admin

### Por Que e Quando Desempenhar Esta Tarefa

If needed, you can cancel a test even while it's running. For more information, see [Cancelling automated tests and test suites](https://servicenow-prod.fluidtopics.net/CLhJRYHIUhm2V7W2Wpi_hw#atf-cancelling "You can cancel automated tests and automated test suites that are running or are queued to run.").

### Procedimento

1. Monitor the progress of the test in the Run Test progress dialog.  
   Nota:  
   If your test creates data, the system rolls back that data after all steps in the test complete. {#atf-tut-mon-prog-vw-rslts__vgt_vlk_yx}
2. When complete, click Go to Results on the Run Test progress dialog to display the Test Results list, where you can [view and analyze the results.](https://servicenow-prod.fluidtopics.net/jkbnoNHUgyQBnrNlhzG2lw "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-tut-mon-prog-vw-rslts__x52_xlk_yx}
{#atf-tut-mon-prog-vw-rslts__ugt_vlk_yx}