Working with TestRequests

Test-Requests are created from standard requests using their "Add to Testcase" action, either from the request-nodes popup menu och from the request-editors corresponding toolbar button. They extend requests with the possibility to add any number of "Assertions" that will be applied to the response received when submitting the 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:
  • Delete - prompts to remove the test-request from its TestCase.
  • Rename - prompts to rename the test-request.
  • Clone - prompts to clone the RequestStep, the cloned step will be appended to the containing TestCase.

TestRequest Details Tab

The "Details" tab shown in the bottom-left shows the following values when a TestRequest node is selected in the navigation tree
  • Name : the name of the request
  • Encoding : The encoding used by the testrequest
  • Endpoint : The endpoint for the testrequest
  • Username : The username to use if the testrequest requires authentication (editable)
  • Password : The password to use if the testrequest requires authentication (editable)
  • Domain : The domain to use if the testrequest requires NTLM authentication (editable)

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.


Next: Assertions