ใช้ Web Service Task เพื่อเรียกใช้ Rest API หรือบริการ Soap
Web Service task ใช้เพื่อเรียกใช้บริการเว็บภายนอกโดยใช้ Rest API หรือ Soap Web Service
panel การกําหนดค่า Web Service task มี 4 แท็บเพื่อกําหนดคุณสมบัติ
แท็บ General ประกอบด้วยข้อมูลทั่วไป เช่น title, task id, description etc.
ใช้เพื่อกำหนดค่าและแมป Business Object สำหรับอินพุตและเอาต์พุตสำหรับโหนด
Property
Mandatory
Default
Description
Web Service Type
Yes
SOAP
เพื่อเลือกประเภทบริการเว็บ มี 2 ประเภท ดังนี้ SOAP และ REST
ค่าสำหรับ Setting มีดังนี้
SOAP
เมื่อ SOAP ถูกเลือกเป็น Web Service Type ผู้ใช้ต้องป้อนข้อมูลเกี่ยวกับการเรียกบริการ Soap ใน panel SOAP
Property
Mandatory
Default
Description
Source Type
Y
Url
ผู้ใช้สามารถเลือกรับคําจํากัดความ WSDL จาก URL หรือ File
use environment
N
Unchecked
หากผู้ใช้เลือกใช้ environment checkbox ระบบจะแสดงรายการ environment variables ให้ผู้ใช้เลือก ผู้ใช้สามารถตั้งค่า WSDL URL ในหน้าจอการตั้งค่า environment variables และเลือกตัวแปรใน configuration panel
WSDL URL
Y, when SOAP using URL.
ถ้าผู้ใช้เลือก URL เป็น Source Type URL WSDL คือ URL ไปยังตําแหน่งไฟล์ WSDL หากผู้ใช้เลือกใช้ environment ให้เลือก environment variable ที่สอดคล้องกับ URL WSDL
WSDL File
Y, SOAP using WSDL File
หากผู้ใช้เลือก File เป็น Source Type ไฟล์ WSDL สำหรับ Web Service จะถูกเรียกใช้
XSD File
N
หากผู้ใช้เลือก File เป็น Source Type Subject ของ WSDL file.
Operation
Y
operation คือ method ที่จะเรียกใช้บริการนั้น
End Point
Y
endpoint คือ URL ที่บริการนั้นสามารถเข้าถึงได้โดยแอพพลิเคชันไคลเอนต์
Authentication
N
ข้อมูลการรับรองความถูกต้องสำหรับการตรวจสอบสิทธิ์ HTTP
Username
N
ชื่อผู้ใช้ (Username) สำหรับการตรวจสอบสิทธิ์ หากผู้ใช้เลือกใช้environment ให้เลือก environment variable ที่ตรงกับชื่อผู้ใช้
Password
N
รหัสผ่าน (Password) สำหรับการตรวจสอบสิทธิ์ หากผู้ใช้เลือกใช้environment ให้เลือก environment variable ที่ตรงกับชื่อรหัสผ่าน
panel SOAP มีปุ่ม "Choose WSDL" เพื่ออัปโหลดไฟล์ WSDL หรือปุ่ม "Choose XSD" เพื่ออัปโหลดไฟล์ XSD เมื่อผู้ใช้เลือก WSDL หรือ XSD ผู้ใช้สามารถคลิกปุ่ม Get Operation เพื่อรับการดําเนินการที่เป็นไปได้ทั้งหมดจากบริการ SOAP ปุ่ม คือ Get Endpoint การรับจุดสิ้นสุดจากบริการ SOAP
REST
เมื่อเลือก REST เป็น Web Service Type ผู้ใช้ต้องป้อนข้อมูลเกี่ยวกับการเรียก Rest API บน panel REST
Property
Mandatory
Default
Description
use environment
N
Unchecked
หากผู้ใช้เลือกใช้ environment checkbox ระบบจะแสดงรายการ environment variables ให้ผู้ใช้เลือก ผู้ใช้สามารถตั้งค่า REST URL ในหน้าจอการตั้งค่า environment variable และเลือกตัวแปรใน panel การกำหนดค่า
REST URL
Y
URL สําหรับเรียก Rest API หากผู้ใช้เลือกใช้ environment ให้เลือกenvironment variables ที่สอดคล้องกับ REST URL
Http Type
Y
การดําเนินการกับคําขอ HTTP
Accept Header
Y
ประเภทของข้อความที่ Rest API ยอมรับ
Content Type
Y
Content Type คือชุดข้อความตอบกลับ เมื่อเรียกใช้ Rest API.
Authentication
N
ข้อมูลรับรองการรับรองความถูกต้อง สำหรับการรับรองความถูกต้อง HTTP ผู้ใช้สามารถเลือกระหว่าง Basic & IAM2
Username
N
หากผู้ใช้เลือก Authentication เป็น Basic ใช้ Username สำหรับการรับรองความถูกต้อง
Password
N
หากผู้ใช้เลือก Authentication เป็น Basic ใช้ Password สำหรับการรับรองความถูกต้อง
Header - Key
N
Header - Key เพิ่มเติมหากผู้ใช้เลือกใช้ environment ให้เลือก environment variables ที่สอดคล้องกับ KEY
Header - Value
N
Header - Value เพิ่มเติมหากผู้ใช้เลือกใช้ environment ให้เลือก environment variables ที่สอดคล้องกับ Value
ทั้งแท็บ SOAP และ REST มีปุ่ม "Open Mapping Parameter" การคลิกที่ปุ่ม "Open Mapping parameter" จะเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าจอ Mapping Parameter ซึ่งผู้ใช้สามารถคลิกที่ Mapping Parameter Input line หรือ Mapping Parameter Output line เพื่อแมปพารามิเตอร์สําหรับงาน Web Service นี้
คุณสามารถแมปพารามิเตอร์อินพุตและพารามิเตอร์เอาต์พุตของบริการ SOAP โดยใช้การแมป XPath โปรดดูตัวอย่างด้านล่างของ wsdl ตัวอย่าง
ตอนนี้เพื่อแมป xpath สําหรับแต่ละพารามิเตอร์อินพุต
สําหรับชื่อฟิลด์ "title" คุณต้องสร้าง xpath สําหรับพารามิเตอร์การแมปดังนี้
Method 1:
Parameter Name : title
XPath : /Operation_in/book/title
Parameter Type : String
Method 2:
Parameter Name : title
XPath : //book/title
Parameter Type : String
Method 3:
Parameter Name : title
XPath : //title
Parameter Type : String
XPath Syntax expression
Expression
Description
nodename
เลือกโหนดทั้งหมดที่มีชื่อ "nodename"
/
เลือกจาก root node
//
เลือกโหนดในเอกสารจากโหนดปัจจุบันที่ตรงกับส่วนที่เลือกไม่ว่าจะอยู่ที่ใด
.
เลือกโหนดปัจจุบัน (current node)
..
เลือก parent ของ current node
@
เลือก attributes
nodename[index]
เลือก index ชอง element
ปุ่ม Add Row ใช้เพื่อเพิ่ม header key ให้กับบริการ REST ไอคอนถังขยะ (Trash) ทางด้านขวาคือการลบแถว header ที่มีอยู่
