08 May 2007 - 1.7.1 home user-guide eclipse jbossws intellij netbeans maven 1.X/2.X PDF files forums bugs sourceforge






Vote for soapUI at the WSJ Readers' Choice awards in the

'Best Web Services Utility' and

'Best Web Services Testing Tool'

categories

TestRequests

Test-Requests extend standard requests with the possibility to add any number of "Assertions" that will be applied to the response received for the request.

Test-Requests are either created from standard requests using their "Add to Testcase" action or from the TestCase Editors popup menu with the "Insert Step -> Test Request" option (shown to the right), which will prompt for which Interface/Operation the request should be create for.

In either case, a dialog will also prompt to add certain standard assertions so this must not be done manually for each request;

Test-Requests are submitted either manually through their editors submit actions or when running the TestCase containing the request. The requests response is validated against a requests assertions and the requests icon changes to reflect the result of the validations; green=all validations ok, red=some validation(s) failed. A grey background icon indicates that the request has not yet been submitted for validation, a white background indicates that the TestRequest lacks assertions

TestRequest Actions

The following actions are available from the test-request nodes' right-button menu:
  • Open Editor - opens the Test Request Editor described below
  • Rename - prompts to rename the test-request
  • Delete - prompts to remove the test-request from its TestCase
  • Select Operation - selects the interface operation in the Navigator that this request comes from
  • Clone - prompts to clone the RequestStep, the cloned step will be appended to the containing TestCase
  • Online Help - Displays this page in an external browser

TestRequest Details Tab

The "Details" tab shown in the bottom-left shows the same properties when a TestRequest node is selected in the navigation tree as for a standard request; see the Request Details Tab for more detailed information

The TestRequest Editor

Double-clicking a TestRequest in either the navigator or the TestCase Editor Pane opens the requests editor which is more or less a copy of the standard Request Editor with the following exception:

  • The second toolbar-button "Add to Testcase" has been replaced with "Add Assertion" which prompts to add an assertion to the TestRequest
  • The clone action now clones the TestRequest and appends the cloned request to the containing TestCase
  • Under the request/response panes there is a now a tabbed pane containing 2 tabs; the "Assertions" tab and the "Request Log" tab (both described below).

All other editing/submittal/validation functionality is the same as in the request editor

The Assertions Tab

The Assertions tab lists the assertions that have been configured for the TestRequest. Double-clicking an assertion in the list opens that assertions' configuration dialog (if available). Any number of assertions can be added, often it may be relevant to add the same type of assertion multiple times with different configurations.

A colored circle next to the assertion indicates the status of the assertion in regard to the last received response; red=assertion failed together with error message(s), green=assertion ok, grey=assertion has not been performed.

The following actions are available from the assertion lists right-button menu:
  • Add Assertion - prompts to add a new assertion to the list.
  • Rename - prompts to rename the assertion.
  • Remove - prompts to remove the assertion.
  • Configure - opens the assertions' configuration dialog (if available).

The Request Log Tab

The Request Log tab simply shows a history of submit/response times and response-sizes for the TestRequest. This can come in handy if you want to manually compare response times or sizes over time.

Request Result Viewer

When executing a Request Step from within a TestCase (or associated LoadTest) the actual request/result and associated properties for that request can be viewed by opening a "Request Result Viewer" either from the TestCase editors log list or from a LoadTest editors log by double-clicking the associated log entry. Sent/Received attachments are currently not saved to preserve memory.

The viewer shows 3 tabs:

  • Request Properties - shows request and reponse properties for the request
  • Request Message - shows the actual request message sent, including expanded properties, inline files and MTOM/XOP Includes..
  • Response Message - shows the response message received


Next: Assertions