Schedule and Kick Off Test Automation in qTest Launch

Elite users are able to schedule Test Execution jobs for Test Runs, Requirements and Test Cases in qTest Launch. Additionally, the jobs can be scheduled to run hourly, daily, multiple weekdays or monthly.  Important:

  • This article is for qTest Launch 1.4.1 which is compatible with qTest 9.6.x. If you are using qTest Launch 1.5.1 or later that comes with qTest 9.7.x, refer to Schedule and Distribute Test Automation in qTest Launch 1.5.1. 

  • You can only schedule jobs to run hourly in Launch and those hourly jobs will not be shown in the qTest Manager legacy 'Job View' in Automation Settings. 

To schedule your Test Execution in Launch. do the following:

  1. In Launch. select Schedule Tests,  and the "Schedule Test Runs: Select Cases" dialog displays.

  2. Enter the name of the newly scheduled job in the Schedule Name field.

  3. Select your qTest Manager Project.

  4. Select a Host - Agent from a specific host to execute the job. Note, that only online hosts having Universal Agentassociated with the selected project will display.

  5. Filter objects to schedule tests by project and project type:

    • Requirements

    • Test Cases

    • Test Runs

  6. Once the object filter is chosen, you can search for object(s) by name. Objects that match the filter or the search criteria are shown in the left panel under the tree structure.

  7. Move the object to the right panel which displays the objects that are being scheduled to run.

    • To move individual items, select the blue plus sign icon.

    • To move multiple objects, 'ctrl+click' and select the name of the objects and then the Add to Test Run button.

  8. Select a folder location for the Test Results by selecting the Change button.

  9. The Change Test Result Folder dialog opens and displays the Releases and/or Test Cycles in a tree structure for the currently selected project.

  10. If there is a Release or Test Cycle selected earlier, and it still exists, it will be automatically selected in the tree view.

  11. Select a Release/Cycle and CONFIRM LOCATION to save.

    You can only select a destination for test results if the selected object type is either Requirements or Test Cases. In other words, if you selected Test Runs as the object type, the results are submitted to the selected Test Runs, so no location needs to be set up for the test results.

  12. Choose the appropriate execution schedule type:

    • Run Now- for immediate execution

    • Schedule Runs- to schedule for the future

      1. In the Schedule Test Run: Set Schedule modal, choose the Select Date on the calendar to schedule the start date. Today's date will be the default.

      2. Select Time to begin running the schedule.

      3. If you want the schedule to repeat, select the Repeat checkbox, and choose the repeat cadence from the drop-downs.

        • Note: the hourly repeat option is only available if you're scheduling for Automation Host 2.2 or later

      4. Select the appropriate End time radio buttons. 

      5. The number of test cases scheduled to run will display, along with the Host and Agent information. 

      6. Select Run Now for immediate execution of your schedule, or Confirm Scheduling to begin your schedule on the selected date/time you chose earlier. 

Maintenance Hints:

  • You cannot edit a scheduled job.  You would need to cancel the currently scheduled job and create a new one.

  •  If you do not want a scheduled job to run anymore, simply cancel it.