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

In previous SoapUI tutorial we discussed SoapUI and SoapUI Pro installations. Now in this 4th tutorial of this SoapUI training series we will start with actual SoapUI usage on a test project:

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.

SoapUI Project WSDL

Working with SoapUI Projects:

Creating a new project by adding the WSDL:

#1. Open SoapUI application and follow the instructions to proceed with the license process

#2. Click New SOAP Project option from 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 currency converter URL. i.e. http://www.webservicex.com/CurrencyConvertor.asmx?wsdl. (There are many other sample WSDL urls available. Please check for the open source Web services available for variety)

#5. The remaining setting can be left default and then click OK. The below WSDL processing progress shows up (Note: internet connection is mandatory for this to work)

SOAPUI Project 1

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

The URL we used in this tutorial can be called from anywhere through 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:

SOAPUI Project 2

Project creation done!

Adding a 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 dialog appears on the screen.

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

SOAPUI Project 3

#5. Click OK

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

SOAPUI Project 4

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 image for an enlarged view)

SOAPUI Project 5

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

SOAPUI Project 6

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 a 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, 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 image for an enlarged view)

SOAPUI Project 7

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

(Click on image for an enlarged view)

SOAPUI Project 8

To this we received an unknown error messages because our input was wrong. The same error messages 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. It 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, test suite will be a root node that has to be created explicitly and test cases can be added under it and to test cases we can add test steps. It is a tree structure of sorts. If the test suites are well built, a bunch of webservices 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 a TestSuite during project creation:

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

------------

SOAPUI Project 9

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

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

#4. Based on the services 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 below after creating the test suites.

SOAPUI Project 10

#6. Now we have two test suites. Each test suite will contain test steps, load test step and security test step as below:

SOAPUI Project 11

As discussed earlier, test steps go under the test case. 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 in the right side of the navigator panel.

(Click on image for an enlarged view)

SOAPUI Project 12

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

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

(Click on image for an enlarged view)

SOAPUI Project 13

Adding new TestCases to already existing TestSuites:

#1. Right click on the test suite name

SOAPUI Project 14

#2. Enter the TestCase name and click OK

SOAPUI Project 15

SOAPUI Project 16

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

SOAPUI Project 17

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

SOAPUI Project 18

#5. In the following wizard, we can rename the request if required, with the other settings as default click OK SOAPUI Project 19

#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 the response.

(Click on image for an enlarged view)

SOAPUI Project 20

#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 seen as below.

(Click on image for an enlarged view)

SOAPUI Project 21

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 its components: Right click on the respective object and select “Rename” option from the context menu, enter a new name and click OK. To delete, choose the remove option from the menu and confirm the deletion. Once deleted, the operation cannot be undone.

Conclusion:

Every project must contain 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:

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

Please post your questions and comments for us below.

Recommended reading

30 comments ↓

#1 patil sv

Hi, I am using soapui and its very nice and easy to learn tool.

#2 Sumitra

hi, my question is
can we execute test suit at once and record the result?

#3 Karunagara Pandi

@Sumitra: Yes, we can get the reports after executed the test suite.

#4 Priyadharshini

Hi,

How to import the test results of a test suite?

#5 Ramadevi

When I am creating project, it shows error like this. Pl help.error loading WSDL

Error loading [ http://wwww.we services.com/currency converter.asmx?wsdl]:
Org.apache.xmlbeans.XmlException:org.apache.xmlbeans.XmlException:error:Unexpected character: ‘1’

#6 Swati Seela

@Priyadharshini: You can export the result by clicking on the “Export this log to a file..” option that you see in the Test logs section. It is the last one of the 3 tiny icons displayed

#7 Priyadharshini

Thank you Swati! I got it! :)

#8 Priyadharshini

ThankYou Swati!

#9 Karunagara Pandi

@Ramadevi

Please make sure the following before you use the URL:

1. Make sure the URL is valid

Note: I can see some of the errors in the URL
a. “wwww”
b. “we” services.com …. (it should be “webservices”)

2. Your Internet connection should be Active / Connected

Thanks

#10 kanika

Hi,
First of all thankyou for posting the tutorials.
I did this tutorial . But i didnot understand why we have conversion rate under currency converter soap ui and currency convertor soap ui12. what is is use??

#11 Gaurav Khurana

Why do we add Test case when its just creating a copy of the same service.

e.g. currency converter has a web service called conversion Rate..
So when we are adding a test case,, its also coming up with same web-service or we can leave it empty,, So its like copying a step and creating a new one…

is it just for giving different input data we add another test case?

#12 sopan

Hi,
Is it possible to test web services with only website url

#13 Felix

Hi i got a question:

I created many Teststeps and i want to add something lika an exptionhandling e.g. when testStep3 fails jump to testStep12 and execute the remaining TestSteps ist that possible? thanks!

#14 Bhanu

@Felix:

Yes,you can skip. Simply,double click on Test case(not test step).
Click on Settings button and uncheck Abort on Error checkbox.

#15 John

Hi,

I have been trying the currency tutorial from several sites. Each time I run it, I get a -1 rather than a conversion rate.

-1

This is a great tutorial BTW, just want to get the correct results :) Am I doing something wrong?

Thanks!!

#16 Bill

I am also getting -1
(Just like @John.)

#17 zishan paya

Very well explained
But i think web service url is change. I am getting -1 response for valid currency UST -> INR

#18 Dhananjay

I tried with currency converter web service but its returning value -1 instead of conversion rate for valid From and To entries.
Can you please suggest how to proceed with or need to change some parameter from Developer tool?

#19 GOVINDA

please send me a PDF to kirankirru02@gmail.com , if any one having grovy scripting usage criteria and syntax scenarios, declarations and methods etc…

#20 Subash Patil

Great work, very well explained, and the content is extremely clear.

Thanks a lot,

#21 Thanks for the general info.

I tried with currency converter web service but its returning value -1 instead of conversion rate for valid From and To entries.

I am using WSDL as provided from your guide: http://www.webservicex.com/CurrencyConvertor.asmx?wsdl

Is above link still good to use? If not, could you please update with a current working one?

Thank you!

#22 Martijn

Very helpfull, thanx.

The webservice from the example isn’t working correctly anymore. Try using this one for example:

http://currencyconverter.kowabunga.net/converter.asmx?WSDL

#23 Apeksha

In this example –
currencyconverter above WSDL
User the date format as “YYYY-MM-DD” to get correct response.

My Request looked like this :


USD

INR
2016-12-05

#24 Karunagara Pandi

@Thanks for the general info:

Please use the following link for testing purpose. There are many samples here…

http://www.webservicex.com/CurrencyConvertor.asmx?op=ConversionRate

#25 Karunagara Pandi

@Kanika:

For understanding purpose of SOAP UI tool, we have used such sample free webservices.

Its not mandatory to use this link if you have any alternative.

Thanks

#26 Seetesh Pandey

Thans Team for giving such impotent in simplest way.

#27 Seetesh Pandey

Thanks Team for giving such impotent in simplest way.

#28 felogg

Hi, each WS i try is asking me for a login. user, password, port.

#29 vishwajeet

Can anyone suggest me some other useful WSDLs than one mentioned above again and again for search method from a database. Help soon , i m in need of it.

#30 Megha

http://www.webservicex.com/CurrencyConvertor.asmx?wsdl

Does the above URL still works ?
I am unable to load the URL while creating a new SOAP project and it gives me the error:
java.lang.exception.Failed to load URL

Can anyone please update ?

Leave a Comment