Definition

เครืองมือ SOAP อนุญาตให้ผู้ใช้เรียกใช้บริการ web server เพื่อวัตถุประสงค์ในการรวมเพื่อส่งคืนข้อมูลที่เป็นประโยชน์จากแหล่งข้อมูลภายนอกเข้าสู่อินสแตนซ์กระบวนการ

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

ชื่อคำอธิบาย
WSDL URLจะมีการเรียก URL ของ webservice WSDL
Operation Nameชื่อการดำเนินงาน
Usernameข้อมูลประจำตัว-ชื่อผู้ใช้
Passwordข้อมูลประจำตัว- รหัส ผ่าน
Parametersค่าในลำดับของพารามิเตอร์การดำเนินงาน
SOAP Body (XML)
เนื้อหา XML ของแท็ก <soap: Body> การตั้งค่าพารามิเตอร์จะถูกละเว้นเมื่อใช้ SOAP Body
SOAP Action
จำเป็นต้องใช้ SOAP Action เมื่อใช้ SOAP Body และเวอร์ชัน SOAP คือ 1.1


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

ชื่อคำอธิบาย
 Formแบบฟอร์มเป้าหมายเพื่อเก็บข้อมูล
 Base XML Object Name for Multirow Dataถ้าข้อมูลที่ส่งกลับมีวัตถุประสงค์เพื่อให้ข้อมูลแบบอาร์เรย์/multirow ให้กำหนดพาธไปยังอาร์เรย์
 Field Mapping
ชื่อคำอธิบาย
Field IDรหัสฟิลด์ที่ติดต่อกับแบบฟอร์มเป้าหมาย
XML Object Name
เส้นทางไปยังวัตถุที่กำหนดไว้ใน Base XML Object Name for Multirow Data ด้านบน


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

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


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

ชื่อคำอธิบาย
 Debug Modeเมื่อตรวจสอบข้อความดีบั๊กจะถูกพิมพ์ออกมาในล็อกของเซิร์ฟเวอร์เพื่อการแก้ไขปัญหา

เปิดใช้งานโหมดดีบักเพื่อวัตถุประสงค์ในการแก้ไขปัญหา ในการควบคุมของเซิร์ฟเวอร์จะเห็นข้อมูลการจัดรูปแบบที่ส่งกลับเป็นดังต่อไปนี้

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"}}


ตัวอย่าง 1

ในตัวอย่างข้างต้นเรากำลังทำการเรียก webservice ไป http://www.webservicex.net/geoipservice.asmx , เรียกเมดทอด GetGeoIP.

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

APP_soapToolSample-2-20131126170202.zip

ตัวอย่าง 2

โปรแกรมประยุกต์ตัวอย่างด้านล่างประกอบด้วยการเรียก SOAP ไปยังชื่อการดำเนินงาน GetStockQuote จาก http://www.restfulwebservices.net/wcf/StockQuoteService.svc?wsdl

APP_webservice1-1-20161123115423.jwa

เมื่อเปิดใช้งานโหมดดีบักผลลัพธ์จะคล้ายกับต่อไปนี้:

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