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).
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):
- In the left pane, select the SOAtest server whose assets you want to refresh.
- Choose Refresh Server from the page-level action menu.
Editing Test Asset Names and Properties
To edit asset names, file names, or descriptions:
- Using the tree in the left pane, select the page that shows the asset, file, or description you want to edit.
- Make the desired changes.
- Click Save.
Reordering Test Scenario Children
To reorder the test suites and tests within a test scenario:
- Using the tree in the left pane, select the test scenario you want to reorder.
- In the test scenario page, drag and drop the children tests and test suites into the desired order.
- 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.
To add a folder for organizing test scenarios (.tst files):
- In the left pane, select the server or existing folder where you want the new folder added.
- Choose Create Folder from the page-level action menu.
- (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.
To upload any files that would be helpful for your testing efforts (existing .tsts, data sources, etc.):
- In the left pane, select the server or folder where you want the file added.
- Choose Upload File from the page-level action menu.
- Use the file chooser to specify which file you want uploaded.
The file will be added to the specified SOAtest server.
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:
- In the tags area of your test scenario, click the Edit button.
- Enter a tag name or a comma-separated list of tag names, then click Add.
- Click the Apply button.
- 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.
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.
A variable set (called an "environment" in SOAtest) is a collection of variables that can be referenced within fields of your test scenario. For example, you might want to have the WSDL, host, and port point to different values for different test environments. When you specify these settings with variables (rather than hard-coding them in the tests), it is much easier to reuse the same test scenario across multiple environments.
If a .tst uses variable sets, you can specify how they are set within a specific Environment Manager component instance or test job. For example, you can run a test scenario with one set of variables against a performance testing environment, then run that exact same test scenario with another set of variables against a UAT environment.
Adding Variable Sets
To add a variable set to an existing .tst file:
- In the left pane, select the .tst where you want the new variable set added.
- Choose Add Variable Set from the page-level action menu.
- (Optional) Modify the name of the newly-created variable set.
The variable set will be added to the test tree.
If multiple variables sets are added, a Variables folder will be automatically created to contain them.
Configuring Variable Values
To configure variable values, use the controls available in the Variable Set page.
If you want to mask a variable value, click the key icon to the right of the value field.
- Values that were entered and masked in this UI can be unmasked (if they were not yet saved) by clicking the key icon.
- Values that were entered and masked in SOAtest cannot be unmasked by clicking the key icon.
- Masking functionality requires SOAtest 9.9 or higher
Setting the Active Variable Set
There are two ways to set the active variable set: from the test scenario page, and from the variable set page.
Note that the currently-active variable set is marked with a special icon:
From the Test Scenario Page
To set the active variable set from the test scenario page:
- Open the page for the test scenario / .tst you want to configure.
- Select the desired variable set from the Active variables box.
From the Test Scenarios Page
To set the active variable set from the variable set page:
- Open the page for the variable set you want to make active.
- Check Set as active.
Configuring the Variables for a Test Job
When you create a test job, you’ll have the option of using the variables from the active variable set or adjusting the values as needed.
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.
You can copy and paste assets (test scenarios, tools, data sources, variable sets, files, etc.) as needed.
- 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.