Test Suites

The Test Suites view is shown in the Test Management Perspective and the Spy Perspective. It shows the current test suite (in a combobox), a list of the suite's test cases, a list of the current test case's resources, and a list of the test suite's resources.

{}

The Test Suites view

The test suite can be changed by interacting with the combobox. To the right of the combobox are some toolbar buttons. These are the New Test Suite toolbar button ({} ) which invokes the New Test Suite action, the Open Test Suite toolbar button ({} ) which invokes the Open Test Suite action, the Test Suite Settings toolbar button ({} ) which makes the Test Suite Settings view visible, and the Object Map ({} ) toolbar button which makes the Object Map view visible.

The Test Cases list also has toolbar buttons to its right. The first is the New Script Test Case ({} ) button which creates a new empty test case into which a new test script can be recorded, and the second is the Run Test Suite toolbar button ({} ) which runs every test case in the test suite one after the other. To run an individual test case on its own, click the Run Test Case toolbar button ({} ) to the right of the test case you want to run. To record a new test case click the Record Test Case toolbar button ({} ) to the right of the test case you want to record—be aware that if you use this on a non-empty test case the existing test script will be completely replaced. You can always use the Undo action immediately after to fix this. If you want to insert an extra recorded snippet into an existing test case, use the Record Snippet action. To view or edit a test script in an Editor view, click or double-click it, depending on your Squish IDE preferences.

The Test Case Resources and Test Suite Resources panels are structurally and functionally the same: the difference is that the former is concerned with test case specific resources and the latter with resources shared by the entire test suite. So we will describe them together as "Resources".

The Resources have two toolbar buttons to their right. The first is a New Test Script File toolbar button ({} ) which when clicked creates a new empty test script file, and the second is a New Test Data File toolbar button ({} ) which when clicked creates a new empty test data file. To view or edit a shared script or test data file simply click it (or double-click it, depending on your Squish IDE preferences) and a suitable editor view will appear.

To make use of a shared test script you must use the source(filename) function. And to access test data use the test data functions described in Test Data Functions.

The Test Cases list and the Resources panels also have context menus with delete and rename options amongst others. If there is at least one test case present the Test Cases list's context menu has a Create Template from Testcase option. If this option is invoked it will pop up a Create Test Case Template dialog—simply enter the template's name and click the OK button to create a template that is an exact copy of the currently highlighted test case. The template is stored in the Test Case Template Directory; this directory can be changed in the Pref­er­ences dialog's Squish pane's Test Creation child pane. To create a new test case based on the template, i.e., to create a new test case that's initially an exact copy of the template use the New dialog's Squish Test Case from Template option. (See also Creating a New Template.)