SOAPUI Tutorial for SOAP Web Service Testing

1. What is a Web Service?

A Web Service is any software code that is available over the internet and is used to transfer XML messages or data using Web Protocols like HTTP. For example., the client sends a request to the server over the network and a specific port where Web Service is hosted and waits for a response. Once the response is received, communication got completed.

1.1. Features of Web Service:

• It uses XML for message communication.
• It is platform-independent.
• It can be available over the Internet or private network.
• It can also process complex documents and not just messages.

1.2. Types of Web Services:

There are three types of Web Services that are used for client-server communication:

1. SOAP Web Service (Simple Object Access Protocol)
2. REST Web Service (Representational State Transfer)
3. WSDL (Web Service Description Language)

2. What is SOAP Protocol?

SOAP stands for Simple Object Access Protocol. It is defined by the W3C standard that allows communication between two applications. Each message in this protocol contains an XML document containing data that is transferred between the client and the server.

2.1. SOAP Protocol Features

1. It is an XML-based protocol.
2. It is language and platform-independent.
3. HTTP can be used for transporting SOAP requests and responses.
4. Messages can be broadcast using SOAP Protocol.

2.2. SOAP Message Format

A SOAP message can be an XML document that contains the following elements:

• Envelope - It defines the beginning and end of the message.
• Header - It is an optional part of the SOAP message and is used in processing the message at an intermediary point or at the endpoint. 
• Body - It is the actual XML message and a mandatory element.
• Fault - It is the optional element that contains the faults or errors information that occurred during the processing of the message. There are some sub-elements present for the fault:
• <faultcode>
• <faultstring>
• <faultactor>
• <detail>

Please note that all these specifications can be changed or modified with new SOAP Protocol versions. For updated specifications on SOAP Message format please refer following links: 

• https://www.w3.org/2001/12/soap-envelope
• https://www.w3.org/2001/12/soap-encoding

2.3 SOAP Message Structure Example

<?xml version="1.0"?>  
<SOAP:Envelope  
xmlns:SOAP="http://www.w3.org/2003/05/SOAP-envelope/"  
SOAP:encodingStyle="http://www.w3.org/2003/05/SOAP-encoding">  

	<SOAP:Header>  
		...  
	</SOAP:Header>  
  
	<SOAP:Body>  
		...  
	<SOAP:Fault>  
		...  
	</SOAP:Fault>  

</SOAP:Body>  
  
</SOAP:Envelope>

3. What is SOAPUI?

SOAPUI is an open-source tool for testing Web Services. These services can be SOAP Web Services, RESTFUL Services, or HTTP-based services. SOAPUI is a very popular tool and has more than 3 million downloads. A lot of community support and knowledge is available online for this tool. There is also a commercial version available for this tool with extra functionality called READYAPI.

3.1. Types of Testing SOAPUI can perform: 

1. Functional Testing
2. Load Testing 
3. Security Testing
4. Regression Testing 

You can create a functional test and run it as a load test in SOAPUI.

3.2. Protocols & Technologies SOAPUI Supports:

1. SOAP – Simple Object Access Protocol
2. WSDL – Web Service Definition Language
3. REST – Representational State Transfer
4. HTTP – Hyper Text Transmission Protocol
5. HTTPS – Hyper Text Transmission Protocol Secured
6. AMF – Action Message Format
7. JDBC – Java Database Connectivity
8. JMS – Java Messaging Service

3.3. Installing SOAPUI

SoapUI is cross-platform and is written in JAVA, so it runs on most operating systems, It supports several Windows Versions, Mac, and multiple Linux platforms. SoapUI requires a 1.6+ version of the JRE (Java Runtime Environment), at least 1 GB of memory is recommended, and about 100 MB of disk space.

3.3.1. Installing on Linux

1. Download the Linux binary from http://www.soapui.org/
2. Unzip it in a directory of your choice
3. And run $ bin/soapui.sh

3.3.2. Installing on Windows/MAC

1. Download the installer from download for Windows.
2. Installation is pretty straightforward, start it by just double-clicking on the installer.
3. It will ask you to select the destination folder, select and continue.
4. The next step asks you to select the components you want to install, go with the default selections.
5. On the next screen, it asks you to install SOAPUI tutorials, you can add or skip it.
6. Few more basic options will come and that's it. Finished!

4. Working with SOAPUI Interface

4.1. Main Window

1. Main Toolbar
2. Icons Toolbar
3. Navigator Pane - Expandable tree display of workspace content.
4. Properties Pane - Predefined workspace properties.
5. Log Inspectors

4.2 Create Your First SOAP Project

1. Click on 'New SOAP Project' to create a new project.

2. Enter a name for your project.

3. Enter the WSDL file path - 

• http://www.dataaccess.com/webservicesserver/numberconversion.wso?WSDL

4. And click OK.

5. SOAPUI will create the project from the WSDL provided in the navigator bar.

6. Expand the NumberToDollars and then double-click on Request 1. It will display the following XML file on the right side:

7. Now you have to replace the '?' in <web:dNum>?</web:dNum> field with a number let's say 2 and press the green 'execute' arrow on the top left of the XML view.

8. And a response will be returned for this request, in the response you would see that 2 would be converted to 'two dollars' (you can select any of the two modes like xml or raw for the request and response):

Great! You just have done your first test of a SOAP Web Service using WSDL.

Similarly, you can test the remaining web service 'NumberToWords' by replacing the '?' with the corresponding value and executing it, and checking the response.

4.3 What is a WSDL?

WSDL, or Web Service Description Language, is an XML-based definition language. It’s used for describing the functionality of a SOAP-based web service.

WSDL files are the core of testing SOAP-based services. SoapUI uses WSDL files to generate test requests, assertions, and mock services. WSDL files define various aspects of SOAP messages:

• Any element or attribute is allowed multiple times
• The required elements and attributes
• Optional elements and attributes
• The specific order of elements or attributes

WSDL file can be seen as a contract between the provider and the consumer of the service. SoapUI supports the 1.1 version of the WSDL specification and corresponding bindings for SOAP versions 1.1 and 1.2.

We have already created a project from the WSDL file in section 4.2 of this article. 

4.4 SOAPUI Test Case, Test Step, Test Suite, Logs Pane, and Assertions

Let me explain each of these elements of SOAPUI in more detail:

1. Test Case:

A test case is a container that holds one or more test steps. It allows you to define a set of tests that will be executed together. Each test case has a name, description, and configuration options, including settings for timeouts, authentication, and headers. You can create multiple test cases to cover different scenarios and variations of your web service.

2. Test Step:

A test step is an individual action that is performed as part of a test case. There are several types of test steps in SOAPUI, including:

i. REST Request: A REST request sends an HTTP request to a web service and receives a response.

ii. SOAP Request: A SOAP request sends an XML-based SOAP message to a web service and receives a iii. SOAP response.

iv. JDBC Request: A JDBC request sends a SQL query to a database and receives a response.

v. Groovy Script: A Groovy script step allows you to write custom code to manipulate test data, perform complex calculations, or customize test behavior.

vi. Delay: A delay step pauses the test execution for a specified time period.

Each test step has its own configuration options, such as endpoint URL, HTTP method, request headers, request body, and assertions.

3. Test Suite:

A test suite is a collection of related test cases. It allows you to organize your tests and run them together. You can create multiple test suites to cover different aspects of your web service, such as functional testing, performance testing, or security testing. Test suites have their own configuration options, such as test case order, parallel execution, etc. 

4. Logs Pane:

The Logs pane provides a detailed view of the test execution process. It shows the request and response messages, as well as any errors or warnings that occur during the test. The logs can be helpful in debugging issues or identifying areas for improvement in your tests.

The Logs pane can be filtered by severity level, such as errors, warnings, or information messages. This allows you to focus on specific areas of interest during the testing process.

5. Assertions:

Assertions are used to validate the results of a test step. They allow you to specify expected values and compare them to the actual values returned by the service.

4.5 SOAPUI Properties

SOAPUI, properties are used to store data that can be shared between different parts of a test case or between different test cases. They are essentially variables that can be used to store values that may change during the execution of a test.

Here are some key points about properties in SOAPUI:

1. Defining Properties: Properties can be defined at various levels, including the project level, the test suite level, the test case level, and the test step level. This allows you to define properties that are specific to a particular test or that can be shared across multiple tests.

2. Setting Property Values: Property values can be set in a variety of ways. For example, you can set the value of a property manually in the SOAPUI user interface, or you can use a script to set the value programmatically. You can also set property values dynamically based on the results of a previous test step or based on input data from a file.

3. Using Properties in Test Steps: Properties can be used in test steps to substitute variable values in requests, headers, or other elements. This can be useful when testing services that require dynamic input values, such as timestamps or user IDs.

4. Reading Property Values: You can also read the value of a property at any point in a test using a script. This allows you to check the value of a property and take action based on its value.

5. Property Expansion: SOAPUI supports property expansion, which allows you to use a property reference in a request or script and have the value of the property automatically substituted at runtime.

In summary, properties in SOAPUI are a powerful tool for managing data and making tests more flexible and reusable. They allow you to store and manipulate data at various levels of a test, and they can be used to create dynamic test scenarios that can adapt to changing input values.

Author

Vaneesh Behl

Passionately writing and working in Tech Space for more than a decade.