Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Introduction

English
The SOAP Tool allows one to invoke call to webservice for integration purpose to return useful information from external sources into the process instance.

SOAP Tool Properties

Configure SOAP Tool

Image Added

Figure 1: SOAP Tool Properties

Screens (Click to viewImage Removed

Figure 1: SOAP Tool Properties

NameDescription
WSDL URLWebservice WSDL URL to be called.
Operation NameOperation Name
UsernameCredential - Username
Password Credential - Password
ParametersValues 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



Store To Form

Image Added

Figure 2: Store To Form Properties

NameDescriptionScreens (Click to view)
 FormTarget form to store data.

Image Removed

Figure 2: Store To Form Properties

 Base XML Object Name for Multirow DataIf returned data is intended to an array / multirow data, define the base path of the array.
 Field Mapping
NameDescription
Field IDField ID correspondent to the target form field.
XML Object Name

Path to child object defined in the Base XML Object Name for Multirow Data above.

Else, just the XML Object Name itself.



Store To Workflow Variable

Image Added

Figure 3: Store To Workflow Variable Properties

Screens (Click to view)
NameDescription
 Workflow Variable Mapping
NameDescription
Workflow VariableWorkflow Variable name.
XML Object NameXML Object Name path.




Advanced

...

Image Added

Figure

...

4: Advanced Properties

NameDescriptionScreens (Click to view)
 Debug Mode

When checked, debug messages will be printed out in the server log for troubleshooting purpose.

In the server 's consolelog, one you will see the observe returned formatted data as the following:

Code Block
INFO  20 Feb 2020 02:14:56 org.joget.plugin.enterprise.SoapTool  
- {"NumberToWordsResult":"six hundred and seventy eight "}

Image Removed

Figure 4: Advanced Properties

Tutorials

Example 1

In the example above, we are making a webservice call to  http://www.webservicex.net/geoipservice.asmx , calling the method GetGeoIP.




Download Demo App

Demo app to make a web service call to httpsBelow is a sample app to make a webservice call to http://www.webservicexcrcind.net/airport.asmx?op=GetAirportInformationByCountry.

APP_soapToolSample-2-20131126170202.zip

Example 2

The sample app below contains a SOAP call to the operation name GetStockQuote from http://www.restfulwebservices.net/wcf/StockQuoteService.svc?wsdl

APP_webservice1-1-20161123115423.jwa

When Debug Mode is enabled, the output will be similar to the following:

...

com/csp/samples/SOAP.Demo.CLS?wsdl, to call the method GetListByName.