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工具允许一个调用调用web服务集成宗旨来回报来自外部源的有用信息到流程实例。
Figure 1: SOAP Tool Properties
图1：SOAP工具属性
| 名称 | 描述 | 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.
| 要调用的Webservice WSDL URL。 | |
| 操作名称 | 操作名称 |
| 用户名 | 凭据 - 用户名 |
| 密码 | 凭据 -密码 |
| 参数 | 按操作参数的顺序排列值。 |
SOAP Body（XML） | <soap：Body>标签的XML内容。使用SOAP Body时忽略参数设置。 |
SOAP操作 | 使用SOAP Body且SOAP版本为1.1时，SOAP Action是必需的 |
图2：SOAP工具属性 - 存储到表单
| 名称 | 描述 | ||||||
|---|---|---|---|---|---|---|---|
| 形成 | 目标表单来存储数据。 | ||||||
| 多行数据的基础XML对象名称 | 如果返回的数据用于数组/多行数据，请定义数组的路径。 | ||||||
| 字段映射 |
|
图3：SOAP工具属性 - 存储到工作流程变量
| 名称 | 描述 | ||||||
|---|---|---|---|---|---|---|---|
| 工作流变量映射 |
|
图4：SOAP工具属性 - 高级
| 名称 | 描述 |
|---|---|
| 调试模式 | 选中后，将在服务器日志中打印出调试消息，以进行故障排除。 |
启用调试模式来解决问题。在服务器的控制台中，将会看到返回的格式化数据如下。
| Code Block |
|---|
INFO |
| Code Block |
|---|
INFO 07 Jun 2013 10:54:37 SoapTool 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></n s1:GetGeoIPResult> INFO INFO 07 Jun 2013 10:54:37 SoapTool SoapTool - {"GetGeoIPResult":{"CountryName":"United States","ReturnCodeDetails":"Success","ReturnCode":"1","IP":"8.8.8.8", "CountryCode":"USA"}} |
例1
在上面的例子中，我们正在调用
Example 1
In the example above, we are making a webservice call to http://www.webservicex.net/geoipservice.asmx, calling the method GetGeoIP.的webservice调用 方法 GetGeoIP。
下面是一个示例应用程序，使Web服务调用 Below is a sample app to make a webservice call to http://www.webservicex.net/airport.asmx?op=GetAirportInformationByCountry.。
APP_soapToolSample-2-20131126170202.zip
Example 2
例2
下面的示例应用程序包含来自 The sample app below contains a SOAP call to the operation name GetStockQuote from http://www.restfulwebservices.net/wcf/StockQuoteService.svc?wsdl.的操作名称GetStockQuote的SOAP调用 。
APP_webservice1-1-20161123115423.jwa
When Debug Mode is enabled, the output will be similar to the following:当启用调试模式时，输出将类似于以下内容：
| Code Block |
|---|
INFO 23 Nov 2016 18:51:47 SoapTool - <ns1:GetStockQuoteResult xmlns:a="http://www.restfulwebservices.net/DataContracts/2008/01" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns1="http://www.restfulwebservices.net/ServiceContracts/2008/01"><a:Symbol>IBM</a:Symbol><a:Last>162.67</a:Last><a:Date>11/22/2016</a:Date><a:Time>4:01pm</a:Time><a:Change>-0.10</a:Change><a:Open>163.00</a:Open><a:High>163.00</a:High><a:Low>161.95</a:Low><a:Volume>2770899</a:Volume><a:MktCap>154.68B</a:MktCap><a:PreviousClose>162.77</a:PreviousClose><a:PercentageChange>-0.06%</a:PercentageChange><a:AnnRange>116.90 - 165.00</a:AnnRange><a:Earns>12.27</a:Earns><a:PE>13.25</a:PE><a:Name>International Business Machines</a:Name></ns1:GetStockQuoteResult>
INFO 23 Nov 2016 18:51:47 org.joget.plugin.enterprise.SoapTool - {"GetStockQuoteResult":{"High":"163.00","Earns":"12.27","MktCap":"154.68B","Symbol":"IBM","Time":"4:01pm","Change":"-0.10","Date":"11/22/2016","PreviousClose":"162.77","Open":"163.00","Name":"International Business Machines","Last":"162.67","Low":"161.95","Volume":"2770899","PE":"13.25","PercentageChange":"-0.06%","AnnRange":"116.90 - 165.00"}}
INFO 23 Nov 2016 18:51:47 org.joget.workflow.shark.WorkflowAssignmentManager - [processId=134992_webservice1_process1, processDefId=webservice1#6#process1, participantId=requester, next user=[admin]]
|