15 January 2008 - 2.0.1 home user-guide eclipse intellij netbeans maven PDF files forums bugs sourceforge eviware.com






TestSuites

A TestSuite serves as container for an arbitrary number of TestCases. When running a TestSuite the contained TestCases can be executed either in sequence or in parallel as described below.

Generating TestSuites

Selecting the "Generate TestSuite" option from the Interface menu prompts to generate a complete TestSuite for the selected interface. The dialog contains the following options;

  • TestSuite - select if to generate into an existing TestSuite or create a new one
  • Style - there are 2 different styles:
    1. One TestCase for each Operation - creates a TestSuite with one TestCase for each operation
    2. Single TestCase with one Request for each Operation - create just that!
  • Request Content - there are 2 alternatives:
    1. Use existing Requests in Interface - uses the existing requests as TestRequests
    2. Create new Empty Requests - creates new empty requests with optional content in the created TestRequests
  • Operations - Select those operations you want to generate for
  • Generate LoadTest - Creates a default LoadTest for each generated TestCase

TestSuite Actions

The following actions are available from the TestSuite nodes' right-button menu:
  • Open TestSuite Editor - Opens the TestSuite Runner described below
  • Disable/Enable TestSuite - Disables/Enables the TestSuite
  • New TestCase - prompts to create a new TestCase in the TestSuite
  • Clone TestSuite - prompts to clone the entire TestSuite, including all TestCases/TestSteps
  • Launch TestRunner - opens the dialog for launching the command-line TestRunner
  • Rename - prompts to rename the TestSuite
  • Remove - prompts to remove the TestSuite from its project. All contained TestCases will be removed also.
  • Online Help - Displays this page in an external browser

TestSuite Details Tab

The "Details" tab shown in the bottom-left shows the following values when the TestSuite node is selected in the navigation tree
  • Name : the name of the current TestSuite

TestSuite Runner

Double Clicking a TestSuite in the navigator opens the TestSuite Runner containing a list of the contained TestCases and a toolbar. A Progress Bar is displayed for each TestCase, double-clicking a TestCase opens the associated TestCase editor. If a TestCase is currently being load tested its Progress Bar displays this and the TestCase will not be run during TestSuite execution.

The available toolbar buttons are (left to right):

  • Run : Runs selected TestCases
  • Cancel : Cancels ongoing runs
  • New TestCase : Prompts to create a new TestCase in this TestSuite
  • Run in Sequence : Toggles if the TestCases should be run in sequence
  • Run in Parallel : Toggles if the TestCases should be run in parallel
  • Create Report (soapUI Pro only) : Exports a HTML Report for the last TestSuite run (see below)

The run in sequence/parallel state is preserved and also applied when running a TestSuite using one of the command line tools or the maven plugin.

After the progress bar the comes a List of the contained TestCases follows by a number of Inspectors for the TestCase (left to right):

  • Description : an arbitrary description for the TestSuite
  • Properties : TestCase properties
  • Setup Script : A groovy script to run when the TestSuite is run
  • TearDown Script : A groovy script to run when the TestSuite finishes

The TestSuite log window at the bottom shows all step/run results for the last TestSuite run

Generating Reports

soapUI Pro supports the generation of reports from within the TestSuite editor. The reports show a summary of all executed TestCases and diagnostic information for failed assertions.

Selecting the "Create Report" button in toolbar opens the following dialog for exporting the last results to an HTML report:

After specifying the output folder and format, the report will be created and opened in an external browser:

TestSuite Coverage

The TestSuite Coverage tab contains the same Coverage information as available in the Project Coverage Panel. Enabling Coverage and running the TestSuite will dynamically calculate/update the messages exchanged during the tests and add their Coverage information to the Coverage Panel. See the Project Coverage document for details.


Next: TestCases