Workspaces / Projects

The soapui Workspace

soapui uses the same workspace/project metaphor as for example eclipse;

  • Workspace information is maintined in the ${user.home}/default-soapui-workspace.xml file. If you want to use multiple workspaces specify another filename (for example "my-soapui-workspace.xml") as the only command-line argument to soapui, the corresponding file will be created/used instead.
  • Any number of projects can be added to the workspace.
The following actions are available from the workspace-nodes right-button menu (and from the main "File" menu):
  • New WSDL Project : Prompts to create a new WSDL project:
    • A name for the project is required
    • A filename to which the project is to be saved. This defaults to <project-name>-soapui-project.xml. Put this file anywhere you want.
  • Import Project : Prompts for a filename for an existing soapui-project. The project will be added to the current workspace

soapui WSDL Projects

Internally, soapui abstracts the actual nature of projects and their contained interfaces, tests, etc.. opening for support of other service-definitions/protocols than WSDL/SOAP (check out the com.eviware.soapui.model package). Currently though, the only implementation for these interfaces is for WSDL 1.1 and the SOAP/HTTP binding (as required by Basic Profile 1.0). Therefore, all actions and functionality described will be in regard to this implementation.

A soapui WSDL project contains the following items:

  • A number of Interfaces each corresponding to a SOAP/HTTP Binding for a defined PortType
  • A number of Test-Suites containing TestCases for these Interfaces' Operations

soapui projects are saved in a self-contained xml-file upon creation (as described above). This file can be safely moved around, checked into CVS, sent by email, etc. It only has file-system references if an interface/WSDL has been imported from a local file (not recommended due to this limitation). When obtaining an existing soapui project file, this can be added to the current workspace with the "Import Project" workspace action as described above

Project Actions

The following actions are available from the project nodes' right-button menu:
  • Add WSDL from URL - Prompts for a WSDL URL that will be parsed and imported accordingly
  • Add WSDL from file - Prompts for a local WSDL file that will be parsed and imported accordingly
  • New Test Suite - Prompts to create a new TestSuite in the selected project.
  • Rename - Prompts to rename the selected project, the new name will be shown in the navigation tree. The filename of the project will be unaffected
  • Remove - Prompts to remove the selected project from the workspace. The project-file will not be deleted and could be imported back into the workspace subsequently


Next: Interfaces and Operations