SOAP Web Services Demo using SOAPUI
Article ID: 40101
Updated On: 04-02-2024
Products
Issue/Introduction
What tool can be used to test Service Desk Manager SOAP Web Service functions?
Environment
Service Desk Manager 17.3 or higher
All Supported Operating Systems
Resolution
SoapUI (Open Source) application can be used to test Service Desk Manager SOAP Web Services
https://www.soapui.org/downloads/soapui/
Sample setup steps:
1. Navigate to https://www.soapui.org/downloads/soapui.html and click download "SoapUI OpenSource"
2. Install SoapUI on any Windows server/workstation that can access the Service Desk Manager SOAP Web service URL.
3. Create your first project with sample queries for all Service Desk Manager method calls.
a. Initial screen
b. Create a new project
c. Provide project name and Web service end-point information
Note: The initial Service Desk SOAP WSDL under the original Axis 1.4 format (assuming default port configuration) is:
http://SERVER.EXAMPLE.COM:8080/axis/services/USD_R11_WebService?wsdl
Starting with RU18, where CXF was introduced, the updated URLs are as follows
The URL for the CXF-based service is:
http://SERVER.EXAMPLE.COM:8080/cxf/services
The URL for the WSDL document is:
http://SERVER.EXAMPLE.COM:8080/cxf/services/USD_WebService?wsdl
Result
d. We will next do a login to establish an SID from which to run SOAP Web Service Call. To do this, drill down to "login" then double click on "Request 1" under the "login" method to create/edit the Request 1 SOAP call.
e. Populate the username and password fields, then click on the green "play" button on the upper left. On the right hand side, click on the "XML" tab to expose the "loginReturn" value. This is the SID value which we will be using to demo a SOAP call.
f. To demonstrate the SOAP calls that can be made, we will query for all call request objects using the doSelect method. To do this, on the left hand side, locate the doSelect method, and double click on "Request 1" under "doSelect".
The resultant XML for the SOAP Envelope will read as the following:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://www.ca.com/UnicenterServicePlus/ServiceDesk">
<soapenv:Header/>
<soapenv:Body>
<ser:doSelect>
<sid>?</sid>
<objectType>?</objectType>
<whereClause>?</whereClause>
<maxRows>?</maxRows>
<attributes>
<!--1 or more repetitions:-->
<string>?</string>
</attributes>
</ser:doSelect>
</soapenv:Body>
</soapenv:Envelope>
g. Modify the above XML to read as:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://www.ca.com/UnicenterServicePlus/ServiceDesk">
<soapenv:Header/>
<soapenv:Body>
<ser:doSelect>
<sid>1664836388</sid>
<objectType>cr</objectType>
<whereClause></whereClause>
<maxRows>-1</maxRows>
<attributes>
<!--1 or more repetitions:-->
<string>ref_num</string>
<string>summary</string>
</attributes>
</ser:doSelect>
</soapenv:Body>
</soapenv:Envelope>
sid: this is the "loginReturn" integer value that was obtained when we first logged in via the above Login method. This number will vary depending on the outcome of the login method
objectType: The object being queried. We are interested in call requests, so this should be "cr"
whereClause: This would be a string to provide specific search parameters. We omit this value for purposes of demonstrating the SOAP call.
maxRows: Maximum number of rows returned. We provide a value of -1 to return ALL rows.
attributes: List of attributes tied to the given object to return results on. In this case, we want the ref_num and summary values returned.
h. Run the method by clicking on the green "play" icon. On the right hand side, click on the "XML" tab to display the results.
Additional Information
A counterpart document on demonstrating REST Web Services calls is available here:
KB Article 45577: REST Web Services Demo using SOAPUI
KB Article 137240: SOAP Logging/Tracing
KB Article 49239: Equivalent demo of the above using Powershell instead of SOAPUI
Feedback
