{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":1737,"path":"application-development/automated-test-framework-atf/atf-sched-suite-steps.md","title":"Schedule an automated test suite","bundle":null,"doc_type":null,"release":"australia","body":"\n# Schedule an automated test suite\n\nSchedule one or more test suites to run at a specific date and time.\n\n## Before you begin\n\nYou must have created the test suites you want to schedule.\n\nRole required: atf\\_test\\_admin or atf\\_test\\_designer\n\n## About this task\n\nTo schedule a test suite, you need three components:\n\n-   A test suite record\n-   A schedule record specifying when you want the system to run the test suite\n-   A scheduled suite run record that associates the test suite to run with the schedule for running it\n\nFor more information about the capabilities of and requirements for scheduled test suites, see [Working with scheduled test suites](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-sched-suites.md).\n\n## Procedure\n\n1.  Navigate to **All** > **Automated Test Framework** > **Schedules**.\n\n    The system displays the list of existing test suite schedules.\n\n2.  To create a new schedule, click **New**.\n\n    The system displays the Suite Schedule record form.\n\n3.  On the [Suite Schedule record form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-suite-schedule-record.md), enter the name of the schedule, the frequency with which to run associated suites, the time at which to run associated suites, and the timezone for this schedule.\n\n4.  Specify a condition that must be met for running associated test suites by selecting **Conditional**, then fill in the **Condition** text box with the appropriate script.\n\n5.  Add a test suite to run by navigating to the Scheduled Suites related list, then clicking **New**.\n\n    The system displays the [Scheduled Suite Run](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-suite-sched-run-record.md) record form.\n\n6.  On the [Scheduled Suite Run](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-suite-sched-run-record.md) record form enter the appropriate data.\n\n    1.  Enter the test suite to run.\n\n    2.  If the suite contains UI steps, enter any client constraints you wish to apply \\(such as browser to use\\).\n\n        For more information on client constraints, see [Scheduled Suite Run](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-suite-sched-run-record.md).\n\n    3.  Add to the record's watchlist users you want the system to inform \\(by email\\) when the scheduled suite has finished.\n\n    4.  Click **Submit**.\n\n7.  Add more test suites to this schedule by repeating steps 5 and 6.\n\n8.  Click **Update**.\n\n9.  If your suite includes any test steps that work with a form – or any other element on the client side, open a browser window for running the client portion of the scheduled tests.\n\n    1.  Review [Browser recommendations and requirements](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-test-runners.md) for all tests and suites, as well as those that apply only to scheduled suite runs.\n\n    2.  In the **Navigator**, right-click **Scheduled Client Test Runner**, and then click the option to open in a separate tab or window, as you prefer.\n\n    3.  Leave open the browser window that's running the client test runner and return to the browser window that contains the **Navigator**.\n\n\n**Parent Topic:**[Building and running automated test suites](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-suites-overview.md)\n\n"}}