Page tree

Skip to end of metadata
Go to start of metadata

You can add, review, reorganize, modify, and extend tests, tests suites, and related files on SOAtest Server directly from the Test Scenarios page. To access this page, open the API Testing module and select Test Scenarios (or click the Tests top-of-page link in an Environment diagram in Edit mode).

In this section:

Reviewing Test Assets

The test assets available on each server will be shown in the upper left panel of the Test Scenarios page. The hierarchy and contents of suites, tools, and files here is based on the SOAtest Test Case Explorer. You can filter this list by entering search terms (keywords, metadata and tags) in the search bar above the asset tree.

To view an overview of a .tst, test suite, file, or tool:

  • Select the associated item in the left panel.

Note that you can download files by clicking the link to the right of the Filepath field:

Refreshing Test Assets

To refresh the assets available in CTP (e.g., to see assets recently added from SOAtest desktop):

  1. In the left pane, select the SOAtest server whose assets you want to refresh.
  2. Choose Refresh Server from the page-level action menu.

Editing Test Asset Names and Properties

To edit asset names, file names, or descriptions:

  1. Using the tree in the left pane, select the page that shows the asset, file, or description you want to edit.
  2. Make the desired changes.
  3. Click Save.

Reordering Test Scenario Children

To reorder the test suites and tests within a test scenario:

  1. Using the tree in the left pane, select the test scenario you want to reorder.
  2. In the test scenario page, drag and drop the children tests and test suites into the desired order.
  3. Click Save.

Tip: Moving Tests Up or Down the Test Scenario Hierarchy

To move tests up or down the test scenario hierarchy, use the editing (copy/paste/delete) functionality in the test scenario tree.

Adding Folders

To add a folder for organizing test scenarios (.tst files):

  1. In the left pane, select the server or existing folder where you want the new folder added.
  2. Choose Create Folder from the page-level action menu.
  3. (Optional) Modify the name of the newly-created folder.

The folder will be added to the specified SOAtest server.
You can copy/paste test scenarios (.tst files) into the new folder.

Uploading Files

To upload any files that would be helpful for your testing efforts (existing .tsts, data sources, etc.):

  1. In the left pane, select the server or folder where you want the file added.
  2. Choose Upload File from the page-level action menu.
  3. Use the file chooser to specify which file you want uploaded. If a .tst with the same name already exists and CTP is connected to SOAtest 9.10.3 or newer, proceeding will replace the file. See Replacing Test Files.

The file will be added to the specified SOAtest server.

Replacing Test Files

You can upload a new version of an existing .tst file without affecting associated jobs. The replacement .tst must have the same name as the original .tst file. This functionality is supported for SOAtest 9.10.3 and newer.

  1. Click on the folder containing the .tst file you want to replace.
  2. Choose Upload File from the page-level action menu.
  3. Browse for you file and click Replace.


Tagging Test Assets

You can tag test assets to categorize them in whatever manner is useful for you and your team. Tags can be entered in the Test Scenarios tree search bar to filter results. You can also click a test scenario tag’s hyperlink to focus the Test Scenarios tree on assets marked with that tag.

To add tags:

  1. In the tags area of your test scenario, click the Edit button.
  2. Enter a tag name or a comma-separated list of tag names, then click Add.
  3. Click the Apply button.
  4. Save the changes to the test scenario.

Once the tag is applied, you can click the tag to quickly access all test scenarios with that same tag.

Tagging Tips

You can search by tag in the search bar above the Test Scenarios tree, as well as the main CTP search bar.

To quickly add multiple tags, separate tag names with a comma.

To delete a tag, hover over it, then click the X button.

Adding and Configuring Variables

You can define a set of variables (referred to in SOAtest as an "environment") to be referenced within your test scenario. See Working with Variables for information on how to add and configure variables in test scenarios.

Modifying Tools

You can modify settings for commonly-used API Testing tools (such as REST Client, SOAP Client, Diff, and XML/JSON Assertor, and XML/JSON Data Bank tools) directly from CTP. Advanced settings, as well as configurations for other tools, can be accessed from SOAtest desktop.
For details, see:

Deleting Test Assets

To permanently delete a test asset (e.g., tst, test suite, variable set, file, data source or tool) from both CTP and the SOAtest server upon which it is hosted:

  • Hover over the item you want to delete, then click the Delete icon.

Copying Assets

You can copy and paste assets (test scenarios, tools, data sources, variable sets, files, etc.) as needed.


To copy:

  • Hover over the asset you want to copy, then click the Copy icon.

After you click Copy, you will see Paste icons added to any of the places where the copied asset can be pasted.

Note that the asset being copied has a highlighted Copy icon. If you want to cancel the copy action, click this highlighted icon.


To paste the asset:

  • Click the Paste icon at the location where you want the asset pasted.
  • No labels