Versions Compared

Old Version 1

changes.mady.by.user Justin

Saved on

compared with

New Version Current

changes.mady.by.user Nitchakan Maneelam

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
borderColorgreen
borderWidth1
titleBGColor#ddffcc
borderStylesolid
titleDefinition

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 server เพื่อวัตถุประสงค์ในการรวมเพื่อส่งคืนข้อมูลที่เป็นประโยชน์จากแหล่งข้อมูลภายนอกเข้าสู่อินสแตนซ์กระบวนการ

Figure รูปที่ 1: คุณสมบัติเครื่องมือ SOAP Tool Properties

Name
ชื่อ
Description
คำอธิบาย
WSDL URL
Webservice WSDL URL to be called.
จะมีการเรียก URL ของ webservice WSDL
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
และเวอร์ชัน SOAP คือ 1.1

...


Figure รูปที่ 2: SOAP Tool Properties - Store to Form คุณสมบัติเครื่องมือ SOAP – จัดเก็บแบบฟอร์ม

ชื่อคำอธิบาย
NameDescription
 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.
ถ้าข้อมูลที่ส่งกลับมีวัตถุประสงค์เพื่อให้ข้อมูลแบบอาร์เรย์/multirow ให้กำหนดพาธไปยังอาร์เรย์
 Field Mapping
Name
ชื่อ
Description
คำอธิบาย
Field ID
Field ID correspondent to the target form.
รหัสฟิลด์ที่ติดต่อกับแบบฟอร์มเป้าหมาย
XML Object Name
Path to object defined in the Base XML Object Name for Multirow Data above.
เส้นทางไปยังวัตถุที่กำหนดไว้ใน Base XML Object Name for Multirow Data ด้านบน


Figure รูปที่ 3: SOAP Tool Properties - Store to Workflow Variable คุณสมบัติเครื่องมือ SOAP – จัดเก็บไปยังตัวแปรเวิร์กโฟลว์

ชื่อคำอธิบาย
NameDescription
 Workflow Variable Mapping
Name
ชื่อ
Description
คำอธิบาย
Workflow Variable
Workflow Variable name.
ชื่อตัวแปรเวิร์กโฟลว์
XML Object NameXML Object Name path.

 


Figure รูปที่ 4: SOAP Tool Properties - Advanced คุณสมบัติเครื่องมือ SOAP – ขั้นสูง

ชื่อคำอธิบาย
NameDescription
 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.

Code Block
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></n
s1:GetGeoIPResult>
INFO  07 Jun 2013 10:54:37 SoapTool  - {"GetGeoIPResult":{"CountryName":"United States","ReturnCodeDetails":"Success","ReturnCode":"1","IP":"8.8.8.8",
"CountryCode":"USA"}}

 


Example

ตัวอย่าง 1

In the example above, we are making a webservice call to ในตัวอย่างข้างต้นเรากำลังทำการเรียก webservice ไป http://www.webservicex.net/geoipservice.asmx , calling the method เรียกเมดทอด GetGeoIP.

Below is a sample app to make a webservice call to ด้านล่างนี้เป็น app ตัวอย่างที่จะทำให้การเรียก webservice ไป http://www.webservicex.net/airport.asmx?op=GetAirportInformationByCountry.

APP_soapToolSample-2-20131126170202.zip

...

ตัวอย่าง 2

The sample app below contains a SOAP call to the operation name GetStockQuote from โปรแกรมประยุกต์ตัวอย่างด้านล่างประกอบด้วยการเรียก SOAP ไปยังชื่อการดำเนินงาน GetStockQuote จาก 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เมื่อเปิดใช้งานโหมดดีบักผลลัพธ์จะคล้ายกับต่อไปนี้:

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]]

 

 

...