Working with the QuerySurge™ Scenario Queue

Versions: 8.0+

IN THIS SECTION

• The Scenario Queue
• Scheduling a One-time Scenario Execution
• Scheduling a Scenario via the Command Line
• Opening a Scenario
• Searching for a Scenarios
• Scenario Queue Paging Toolbar

The Scenario Queue

---

Scenarios are collections of Test Suites that are scheduled for execution. These executions can be configured to run immediately, at predefined future date and time, or on a recurring basis.

If you'd like to see a list of all of your Scenarios (regardless of run state), you can do so by navigating to the Run Dashboard and viewing the Scenario Queue. You can create or schedule new Scenarios from here, as well.

 TOP OF PAGE

Scheduling a One-time Scenario Execution

---

To schedule and run one or more Test Suites together, you can create a one-time Scenario execution. Scenarios can be executed right away, or scheduled to execute at a future date and time of your choosing. Please note that while one-time Scenario executions can be scheduled to run at a future date and time, they are qualitatively different than Recurring Schedules.

1. You can create a one-time Scenario execution from the Test Suite panel in the Scheduling view or the Run Dashboard. In either case, click the button to open the wizard.
   
   Alternatively, you can click the down-arrow on the right side of the button and select One-time Execution. This bypasses the Schedule Type selection card shown above.
   
2. Select the One-time radio button and click the Next button to advance to the next card.
   
3. Enter a Scenario Name.
4. Use the and buttons to add and remove Test Suites from the Scenario.
5. Optionally, select a date and time from the Set All Dates to menus.
6. Optionally, select an Agent from the Set All Agents as menu.
7. Optionally, select or add Asset Tags to the Scenario.
   
8. Click the Save button.

Scenario Settings

1. Set All Dates to specifies the date and time each Test Suite in the Scenario will begin executing.
2. Set All Agents as specifies the Agent that will execute each Test Suite in the Scenario.
3. Asset Tags allow you to tag a Scenario with one or more values. You can select an existing tag, or create a new one. You may also check the Include Inherited Suite Tags box to include tags that might already be associated with any of the added Test Suites.

Adding Test Suites

1. Use the button to add a Test Suite to the Scenario.
2. Use the dropdown menu in the Test Suite column to to select from a list of available Test Suites.

Individual Test Suite Settings

1. Agent specifies the Agent that will execute the Test Suite. You have the option to select a different Agent for each Test Suite in a Scenario.
2. Scheduled Date & Time of Run specifies the date and time the Test Suite will begin executing. You have the option to select a different date and time to start each Test Suite in a Scenario.

Removing Test Suites

1. Select one or more Test Suites to remove.
2. Use the button to remove the selected Test Suite(s).

NOTE: Each Test Suite you add to your Scenario will be assigned to Any Agent and will run Now. These are the default settings unless you choose a specific Agent or Schedule Date & Time of Run. As discussed, these settings can be configured at the Scenario or individual Test Suite level. This is where you can configure any elaborate scheduling of your test executions. To view your execution once it begins running, navigate to the Run Dashboard.

NOTE: Any Agents you assign to a Scenario or an individual Test Suite must be online and available before your executing can proceed.

 TOP OF PAGE

Scheduling a Scenario via the Command Line

---

A Scenario may also be scheduled on-the-fly via QuerySurge's command line execution interface. This means that an external process or script can trigger a QuerySurge execution based on an external event.

A use case for this would be one in which, at the end of an ETL process (or at the end of an ETL leg), a script is run to trigger a QuerySurge execution of tests designed to verify the ETL. For further details, please see our article on Using the Command Line.

Opening a Scenario

---

To open a Scenario, select it in the Scenario Queue on the left side of the Run Dashboard.

If the Scenario has already completed, its data will be loaded in the center panel. Otherwise, the real-time status will be displayed.

 TOP OF PAGE

Searching for a Scenario

---

As your Scenario Queue grows, it can be helpful to be able to search for a specific Scenario in the list. To do so, click the button to expand the search and filter criteria panel.

There are a number of criteria by which you can search.

• Name contains filters the queue to include only Scenarios whose names contain the entered text.
• Status filters the queue to include only Scenarios whose run states match one of these following.
  • All Scenarios
  • Executing Scenarios
  • Completed Scenarios
  • Not Started Scenarios
  • Killed Scenarios
• Schedule Date From and Scheduled Date To filters the queue to include only Scenarios whose execution times fall within the provided range.

 TOP OF PAGE

Scenario Queue Paging Toolbar

---

As your Scenario Queue grows over time, you can use the Paging Toolbar to easily navigate to previously executed Scenarios. You can move from page to page, or configure how many Scenarios to display on each page.

 TOP OF PAGE