Web Service Task

ใช้ Web Service Task เพื่อเรียกใช้ Rest API หรือบริการ Soap

วัตถุประสงค์

Web Service task ใช้เพื่อเรียกใช้บริการเว็บภายนอกโดยใช้ Rest API หรือ Soap Web Service

คุณสมบัติการกําหนดค่า Web Service Node

panel การกําหนดค่า Web Service task มี 4 แท็บเพื่อกําหนดคุณสมบัติ

General

แท็บ General ประกอบด้วยข้อมูลทั่วไป เช่น title, task id, description etc.

Business Object

ใช้เพื่อกำหนดค่าและแมป Business Object สำหรับอินพุตและเอาต์พุตสำหรับโหนด

Web Service Parameter

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

ปุ่ม Add Row ใช้เพื่อเพิ่ม header key ให้กับบริการ REST ไอคอนถังขยะ (Trash) ทางด้านขวาคือการลบแถว header ที่มีอยู่

ทั้งแท็บ 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