09 July 2009 - 3.0 user guide eclipse intellij netbeans maven download nightly forum bugs blog sf.net eviware


Eviware Logo

Web Service 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;

Generate TestSuite in soapUI

  • 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
Start soapUI Testing
Did you know?

In soapUI Pro you can see how well your TestSuites tests your Web Services. soapUI Pro is the the only tool around using TestSuite Coverage.

If test quality matters, try soapUI Pro.

Try soapUI pro to soap test

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.
  • Export - export this TestSuite
  • Import Test Case - prompts for Test Case to import to this TestSuite
  • Online Help - Displays this page in an external browser

TestSuite Details Tab

  • Name : the name of the current TestSuite

Clone TestSuite

Selecting to clone a TestSuite from the TestSuite menu displays the following dialog:

Clone TestSuite dialog in soapUI for Functional Testing

If selecting to clone to another project, soapUI will prompt to clone required interfaces to that project as well.

If selecting not to clone the description, you will be able to add a new description.

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 left to right are:

  • 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

Running a number of TestCases in a TestSuite

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:

Create a Report Dialog

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

'Report from running a Functional Test Suite

TestSuite Coverage

TestSuit Coverage is an Unique Functionality for soapUI (soapUI Pro only) that allows you to see how much of the Web Services are being covered by you tests. In everyday work this let's you improve your test by adding assertions for uncovered elements as well as shows which elements are unused in your test suites.

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.

TestSuite Coverage Report


Next: Functional Web Service Testing - TestCases