---
sourceDocument: Yokohama Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/application-development

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama 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: Yokohama
* 
* Updated January 30, 2025
* 
* ![](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://servicenow-prod.fluidtopics.net/aLVf2SV6WQwflz5nvRIxfQ "Group automated tests into a suite you can execute as a batch.") and [Schedule an automated test suite](https://servicenow-prod.fluidtopics.net/fhHssok5mQiuhcLf~DcfCQ "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.