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

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Run a scheduled test suite using a script

# Run a scheduled test suite using a script {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Execute a scheduled UI test suite immediately using a script without having to wait for the scheduled time. You can use this method while trying to automate the process of running a test.

## Before you begin

You've created and scheduled the test suites that you want to run. See [Create an automated test suite](https://www.servicenow.com/docs/IqQdTiwCBWpQFWlZpgw50Q "Group automated tests into a suite you can execute as a batch.") and [Schedule an automated test suite](https://www.servicenow.com/docs/3sSvpzyhf6TQPhtE_ZsAwg "Schedule one or more test suites to run at a specific date and time."), for more information.

Role required: atf_test_admin or atf_test_designer

## About this task

The following steps might not be in line with your software configurations.

## Procedure

1. Spin up a virtual machine (VM) on an operating system with the necessary browsers.
2. Open a browser on the instance and navigate to the Scheduled Client Test Runner.
3. Call the scriptable method `new
   sn_atf.ScheduledRunsExecutor().setScheduleSysId
   ("SYS_ATF_SCHEDULE_SYS_ID_HERE").start();` to run the scheduled suite immediately.  
   To run a test only when the script is called, set the Run field to On Demand in the Schedule form.  
   Note:  
   The `start()` method returns `sys_progress_worker.sys_id` of the progress worker.