SoapUI Projects

PDF Print E-mail
User Rating:  / 3
Rate this article: PoorBest 

1. SoapUI Projects

In SoapUI your work is organized into projects, which are displayed under the root node in the workspace navigator. A project can contain any number of functional tests, load tests and service simulations required for your testing purposes.

1.1. Project Formats

SoapUI offers two project formats: standalone projects and composite projects.

Standalone projects

Standalone projects are the default project type, and saved as a singe xml-file containing all project artifacts (interfaces, tests, MockServices, scripts, et c.).

Composite projects

Composite projects are aimed ad team testing, and allows several people to work on the project at the same time.

1.2. Project Types

There are three main types of projects in SoapUI: SOAP projects, REST projects, and generic, indicating the main type of service.

It is possible, however, to manually combine service types in projects of any type.

SOAP Projects

SOAP projects are typically created from a WSDL file, or from a single service call.

REST Projects

REST project can be created from WADL file, or directly from an URI and its parameters.

Generic Projects

Generic projects are all-purpose project for services with varied interfaces and methods.

1.3. Adding projects to the Workspace

Projects can be added to the workspace either by creating new projects, or by importing, either a local project file, composite project or packed project, or a remote project.

1.4. New Project

The New Project dialog lets you choose from a number of ways to create a SoapUI project.

New Project Dialog

Option Description
Create project from WSDL definition (SOAP) Takes a WSDL file and creates a SOAP project based on the definition.
Create project from WADL definition (REST) Takes a WADL file and creates a REST project based on the definition.
Create REST project from URI Takes an URI and creates a REST project based on the parameters.
Discover REST API using internal browser Allows you to use the REST Discovery feature to create a project, using the internal browser.
Discover REST API using SoapUI Proxy Allows you to use the REST Discovery feature to create a project, using your client through the SoapUI Proxy.
Create empty project Creates an empty project where you can work from scratch.

Create project from WSDL definition (SOAP)

Takes a WSDL file and creates a SOAP project based on the definition.

New WSDL Project Dialog

SoapUI generates the service and, optionally, a test suite and a mock service.

Create project from WADL definition (REST)

Takes a WADL file and creates a REST project based on the definition.

New WADL Project Dialog

SoapUI will generate the REST service for you, but you will have to add a test suite to it manually.

Create REST project from URI

Takes an URI and creates a [REST project](REST project "REST Project") based on the parameters.

New Project Dialog

Clicking the Import WADL button takes you to the Create WADL project dialog.

Discover REST API using internal browser

Allows you to use the REST Discovery feature to create a project, using the internal browser.

Discover REST API using SoapUI Proxy

Allows you to use the REST Discovery feature to create a project, using your client through the SoapUI Proxy.

Create empty project

Directly creates an empty project where you can work from scratch, and displays the project overview.

1.5. Import Project

Local project file

When you have an existing project file on your computer you can import it into your workspace with the Import Project option in the context or File menu.

Local packed project

When you have an existing project packed as a zip file on your computer, you can import it into your workspace with the Import Packed Project option in the context or File menu.

Local composite project

For composite projects, the import process is the same as for a regular project, with the difference that you select the composite project folder instead of any file inside it. To import composite projects, use the Import Project option in the context or File menu.

Remote project

Remote projects (for example tutorials, demonstrations, bug-reports, etc) can imported via HTTP to the workspace. Use the Import Remote Project option in the context or File menu.

from the workspace popup and specify the URL to the project file; SoapUI will load and import the project just as if it were a regular local projects.

Note: Since it is not possible to save the project file back to the URL, any changes will have to be saved to a local copy.

1.6. Resolve Project

When you import a project, SoapUI does a check of the project to see that it is consistent and has all necessary external dependencies available (a process called “resolving”).

If errors are found, the Resolve Project dialog is displayed showing all errors, and you can resolve them as needed.

If you need to look closer at an item before making decisions, just double-click it in the list, and the correspoinding editor will open.

Resolve Project Dialog

The Resolve Project dialog allows you to handle conflicting resources in your project when you import it.

Resolve Project Dialog

To resolve a potential problem:

  1. Select an appropriate action from the dropdown menu to the right of each item.
  2. Enter parameters or values as needed
  3. Click OK

1.7. Resource Root for project resources

The Resource Root parameter controls how paths are handled for the project resources.

If the project contains references to external resource, they will need to be included with the project when distributed.

resource-root-property

Parameter Description
Any absolute path value Use this absolute path.
${projectDir} Resolves files relative to the project folder.
${workspaceDir} Resolves files relative to the folder containing the workspace file.

This setting will also apply to external files used by the project.

Examples

Let's say you have an excel file "testdata.xls" you access from the project. The folder d:\projects\ contains workspace files and the project folder is "d:\projects\webservice\

Absolute

Specifying an absolute path "d:\data" resolves to "d:\data\testdata.xls".

Project

Specifying "${projectDir}\data" resolves to "d:\projects\data\testdata.xls".

Workspace

Specifying "${workspaceDir}\data" resolves to "d:\projects\webservice\data\testdata.xls".

1.8. Project Encryption

The “Project Password” option in the project properties allows you to easily encrypt the entire contents of the project file;

project-password-property

(when saving the project, the project icon will contain a small ‘E’ to indicate it has been encrypted)

When opening a project that has been saved with a set password, SoapUI will prompt for this to decrypt the project before use.

project-password-prompt

To remove the encryption just clear the project password and save the project.

Extreme Warning! Don’t lose your password; there is no way of recovering an encrypted project file if the password has been lost.