How to Create and Execute Your First SoapUI Project Using WSDL – SoapUI Tutorial #4

This is the 4th tutorial of this SoapUI training series.  Here, you will learn how to create and execute your first SoapUI project using WSDL. 

In the previous SoapUI tutorial, we discussed the SoapUI and SoapUI Pro installations. 

You will learn

1. Creating SOAP project- adding WSDL during creation or after
2. Request and Response verification 
3. Working with TestSuites, TestCases and TestSteps

Let’s get started.

How to Create and Execute Your First SoapUI Project Using WSDL 

Working with SoapUI Projects

Creating a new project by adding WSDL

#1. Open the SoapUI application and follow the instructions given below to proceed with the licensing process

#2. Click on the New SOAP Project option from the File menu or press CTRL+N shortcut key.

#3. Enter the project name (meaningful one is better)

#4. Then specify the valid WSDL URL in the given text box. Let’s use the currency convertor URL. i.e. http://www.webservicex.com/CurrencyConvertor.asmx?wsdl. (There are many other sample WSDL URLs available. Please check for open source web services available for variety)

#5. The remaining settings can be left as default. Click OK. The below WSDL processing progress shows up (Note: A good internet connection is mandatory for this to work)

#6. Once WSDL URL processing has been successful, the SOAP project will be created along with the service requests.

The URL we used in this tutorial can be called from anywhere through the Internet. This web service is hosted on a web server and on calling the URL the hosted server is searched and SoapUI project gets loaded with the services contained within it as you can see below:

Project creation is done!

Adding WSDL to an existing project

#1. Right-click on the Project Name in the Navigator panel

#2. Click Add WSDL option or hit CTRL + U

#3. Add WSDL dialogue will appear on the screen.

#4. Enter a valid WSDL URL in the text field as seen below:

#5. Click OK

#6. The URL is processed and the respective services get loaded into the SOAP project as shown below:

Executing Services & Response Verification

#1. Expand the CurrencyConvertorSoap in the tree (click on the +)

#2. Double Click Request1 (the service name, this can be changed if needed)

Please take a look at the screenshot for more information: (Click on the image for an enlarged view)

#3. Click on the XML tab from the request section. It will show the input request for currency convertor web service as shown here in the screenshot below. (Click on the image for an enlarged view)

In the above screen question mark (?) symbols are in the input request. These are the input parameters for the currency convertor web service.
When run/start  icon is clicked, SoapUI will call the currency convertor web service along with the input parameters that were provided in the request. Then, the web server will receive these input parameters and process them. Once done, the server will send the response back to SoapUI.

Sometimes the response may contain error messages. For example, while processing the input request, a server may be down or Internet connection could not be established from our side. During that time, we will get a response that is an exception.

For instance, let us enter USD for <<From Currency>> and INR for <<To Currency>> with valid values as below and call the service. As can be seen below, the correct response is obtained.

(Click on the image for an enlarged view)

To test a negative scenario, let me change the <<From Currency>> as the US and execute the service.

(Click on the image for an enlarged view)

We received an unknown error message because our input was incorrect. The same error message will be shown in the error log tab.

TestSuite, TestCase and TestStep in SoapUI

A test suite is a common repository that contains a number of test cases. This is a collection of Test cases that represent the application flow. Test cases are the descriptive data about the application flow. Each test case contains individual actions called Test steps.

In SoapUI, the test suite will be a root node that has to be created explicitly and test cases can be added to it. We can add test steps to the test cases. It is a tree structure of sorts. If the test suites are well built, a bunch of web services can be executed in one go. These test suites can be used for smoke, performance, regression testing, etc. Once executed, SoapUI Pro generates a report for analyzing results.

Adding TestSuite during project creation

#1. Click on the New SoapUI Project option (or press CTRL + N) from the File menu. Check the options listed above and click OK.

#2. Another pop-up to set the test case details will be displayed, set the properties as shown below, and click OK

#3. Enter the TestSuite name. By default, a sample name will be automatically assigned and that can be changed. Let’s say it is: CurrencyConvertorSoap_TestSuite1 and click OK

#4. Based on the service count under the project, it will add that many test suites. Multiple test suites can be created.

#5. Finally, the project tree will look like the one below after creating the test suites.

#6. We now have two test suites. Each test suite will contain test steps, load test steps and security test steps as shown below:

As discussed earlier, the test steps go under test cases. Within the test steps, the actual web service steps get added. If you double-click on the service name, it opens the request and response sections on the right side of the navigator panel.

(Click on the image for an enlarged view)

#7. In the input request, replace the ‘?’ with valid input data.

#8. Click on the run icon to execute the test suite. The response can be seen on the right side of the screen as shown below:

(Click on the image for an enlarged view)

Adding new TestCases to already existing TestSuites

#1. Right-click on the test suite name

#2. Enter the TestCase name and click OK

#3. Test steps can be added to the test case by right clicking on the test steps and then clicking on the Add Step: Test Request option from the context menu as shown below and follow the steps through.

#4. After choosing the name, choose the service name from the drop-down if needed or it can be left empty and click OK

#5. In the following wizard, we can rename the request if required, with the other settings as default

click on OK

#6. The input request name can be seen under the test steps. When the request name is double-clicked, the same input request and response section will open (Click XML tab to see the input and response requests).

#7. Enter the input data and execute the service to receive a response.

(Click on the image for an enlarged view)

#8. To execute all the test cases together, double-click on the test suite name and click Start Icon

The list of test cases in the test suite and their execution statuses can be as seen below.

(Click on the image for an enlarged view)

Additional Information

• Cloning objects: Only Test suites, test cases and test steps can be cloned. Right click on the particular tree node and then click Clone test suite or test case or test step.
• Rename or delete projects and their components: Right click on the respective object and select “Rename” option from the context menu, enter a new name and click on “OK.” To delete, choose the remove option from the menu and confirm the deletion. Once deleted, the operation cannot be undone.

Conclusion

Each project must contain a service request(s). Test suites are particularly useful for executing bulk requests at once, but otherwise individual requests might suffice for simpler tests.

Next Tutorial: In the upcoming tutorial, we will work on understanding Assertions in SoapUI. We will learn the following:

• Brief Introduction of Assertions
• Contains and Not Contains Assertions
• XPath Assertions
• XQuery Assertions

Please post your questions and feedback in the comments section below. We would love to hear from you.