The SOAP Tool allows one to invoke call to webservice for integration purpose to return useful information from external sources into the process instance.
Figure 1: SOAP Tool Properties
| Name | Description |
|---|---|
| WSDL URL | Webservice WSDL URL to be called. |
| Operation Name | Operation Name |
| Username | Credential - Username |
| Password | Credential - Password |
| Parameters | Values in sequence order of the operation parameters. |
SOAP Body (XML) | The XML content of <soap:Body> tag. Parameters setting is ignored when SOAP Body is used. |
SOAP Action | SOAP Action is required when SOAP Body is used and SOAP version is 1.1 |
Figure 2: SOAP Tool Properties - Store to Form
| Name | Description | ||||||
|---|---|---|---|---|---|---|---|
| Form | Target form to store data. | ||||||
| Base XML Object Name for Multirow Data | If returned data is intended to an array / multirow data, define the path to the array. | ||||||
| Field Mapping |
|
Figure 3: SOAP Tool Properties - Store to Workflow Variable
| Name | Description | ||||||
|---|---|---|---|---|---|---|---|
| Workflow Variable Mapping |
|
Figure 4: SOAP Tool Properties - Advanced
| Name | Description |
|---|---|
| Debug Mode | When checked, debug messages will be printed out in the server log for troubleshooting purpose. |
Enable the Debug Mode to for troubleshooting purpose. In the server's console, one will see the returned formatted data as the following.
INFO 07 Jun 2013 10:54:37 SoapTool - <ns1:GetGeoIPResult xmlns:ns1="http://www.webservicex.net/"><ns1:ReturnCode>1</ns1:ReturnCode><ns1:IP>8.8.8.8</ns1:IP><ns1:ReturnCodeDetails>Success</ns1:ReturnCodeDetails><ns1:CountryName>United States</ns1:CountryName><ns1:CountryCode>USA</ns1:CountryCode></ns1:GetGeoIPResult>INFO 07 Jun 2013 10:54:37 SoapTool - {"GetGeoIPResult":{"CountryName":"United States","ReturnCodeDetails":"Success","ReturnCode":"1","IP":"8.8.8.8","CountryCode":"USA"}} |
In the example above, we are making a webservice call to http://www.webservicex.net/geoipservice.asmx, calling the method GetGeoIP.
Below is a sample app to make a webservice call to http://www.webservicex.net/airport.asmx?op=GetAirportInformationByCountry.
APP_soapToolSample-2-20131126170202.zip