Yêu cầu Tùy chỉnh là gì?
Yêu cầu Tùy chỉnh đề cập đến các cấu hình tùy chỉnh dựa trên các giao diện thương mại hiện có, hoặc đóng gói các giao diện để đáp ứng linh hoạt các nhu cầu kinh doanh của công ty, nhằm thực hiện một loạt các thao tác như lấy giao diện, xác thực dữ liệu, phân tích dữ liệu và kích hoạt sự kiện.
Cách Thiết lập Yêu cầu Tùy chỉnh?
Trong trang thiết kế của biểu mẫu, hãy vào Thuộc tính Biểu mẫu > Sự kiện Giao diện Người dùng (Front-End Event) > Cài đặt：
Các cấu hình của yêu cầu tùy chỉnh như sau:
Loại Yêu cầu Tùy chỉnh là gì?
Khi giá trị trường kích hoạt thay đổi, sẽ tự động kích hoạt các yêu cầu HTTP. Hiện tại, có hai loại yêu cầu được phép:
-
Yêu cầu GET: dùng để lấy dữ liệu từ máy chủ, kết nối tham số (Query hoặc Params) sau URL, ví dụ:
Unknown block type: code
-
Yêu cầu POST: dùng để gửi và nộp dữ liệu có thể xử lý đến các tài nguyên được chỉ định.
URL
URL là địa chỉ máy chủ bạn muốn gửi yêu cầu. Để sử dụng yêu cầu GET, bạn cần đặt tham số vào URL và chèn các trường vào đó để gán giá trị cho tham số.
Các trường được hỗ trợ chèn và định dạng giá trị tương ứng như sau:
|
Tên Trường |
Định dạng phân tích giá trị |
|
Dòng đơn |
Văn bản |
|
Điều khiển số |
Số |
|
Radio |
Văn bản |
|
Checkbox |
Văn bản (Phân cách bằng dấu phẩy) |
|
Chọn đơn |
Văn bản |
|
Chọn nhiều |
Văn bản (Phân cách bằng dấu phẩy) |
|
Ngày & Giờ |
Văn bản (Chuỗi thời gian định dạng UTC) |
|
Thành viên |
Văn bản (Số-thành viên, tên đăng nhập) |
|
Phòng ban |
Văn bản (Phòng ban-mã phòng ban) |
|
Ảnh |
Văn bản (URL ảnh) (Cách nhau bằng dấu cách đối với nhiều URL file) |
|
Tệp đính kèm |
Văn bản (URL tệp đính kèm) (Cách nhau bằng dấu cách đối với nhiều URL file) |
|
Chữ ký |
Văn bản (URL tệp đính kèm) (Cách nhau bằng dấu cách đối với nhiều URL file) |
|
Trường con |
Định dạng điều khiển tương ứng |
Cách Thiết lập Header và Body?
-
Chọn GET, bạn chỉ có thể thiết lập tham số Header.
-
Chọn POST, bạn có thể thiết lập các tham số Header và Body.
Cách thiết lập hai tham số như sau:
Thiết lập Header
Bạn cần thiết lập Tên và Giá trị dưới phần Header trong trang Cài đặt Header/Body. Bạn có thể chèn trường vào Giá trị, các trường được hỗ trợ giống như trong phần "URL".
Mỗi yêu cầu tùy chỉnh có thể thêm tối đa 50 header.
Thiết lập Body
Dựa trên các giao diện khác nhau, bạn có thể chọn JSON hoặc x-www-form-urlencoded dưới tham số Body.
Bạn cần thiết lập Tên và Giá trị dưới phần Body trong trang Cài đặt Header/Body. Bạn có thể chèn trường vào Giá trị, các trường được hỗ trợ giống như trong phần "URL".
Mỗi yêu cầu tùy chỉnh có thể thêm tối đa 50 body.
Định dạng Phản hồi
Có hai định dạng phản hồi: JSON và XML. Cách phân tích chúng như sau:
|
Định dạng Phản hồi |
Phương pháp phân tích |
|
JSON |
JSON Path |
|
XML |
XPath |
JSON Path
Lấy ví dụ phản hồi sau:
Unknown block type: code
Các phản hồi tương ứng nhập bởi JSON Path như sau:
|
Nội dung |
Cách nhập thứ nhất |
Cách nhập thứ hai |
|
"content of result" |
$.result |
$["result"] |
|
"content of target" |
$.testResult.target |
$["testResult"]["target"] |
|
"array 1" |
$.array[0] |
$["array"][0] |
|
"iPad Pro" |
$.data[1].key |
$["data"][1]["key"] |
|
"2" |
$.data[1].value |
$["data"][1]["value"] |
XPath
Lấy ví dụ phản hồi sau:
Unknown block type: code
Các phản hồi tương ứng nhập bởi XPath như sau:
|
Nội dung |
Cách nhập |
|
"content of result" |
/results/result/text() |
|
"content of target" |
/results/testResult/target/text() |
|
"array1" |
/results/array[1]/text() |
|
"iPad Pro" |
/results/data[2]/key/text() |
|
"2" |
/results/data[1]/value/text() |
Cách Thiết lập Phản hồi?
Bạn có thể gán dữ liệu thu được từ Sự kiện Giao diện Người dùng cho các trường của biểu mẫu.
1. Nhấp Nhấp để Thiết lập bên dưới Cài đặt Phản hồi:
2. Nhấp vào Trường biểu mẫu và phản hồi tương ứng và chọn các trường bạn cần đặt phản hồi từ danh sách thả xuống.
3. Để cấu hình luật gán cho các trường phản hồi, bạn có thể gán giá trị trực tiếp hoặc chèn các trường của biểu mẫu:
Cách nhập phản hồi phụ thuộc vào định dạng phản hồi. Nếu định dạng phản hồi là JSON, bạn cần nhập phản hồi bằng JSON Path. Nếu định dạng phản hồi là XML, bạn cần nhập phản hồi bằng XPath.
4. Các trường bạn có thể đặt phản hồi và định dạng phân tích giá trị tương ứng như sau:
|
Tên Trường |
Định dạng phân tích giá trị |
Mô tả |
|
Dòng đơn |
Văn bản |
/ |
|
Dòng nhiều |
Văn bản dài |
/ |
|
Số |
Số |
/ |
|
Ngày & Giờ |
Ngày & Giờ |
/ |
|
Radio |
Văn bản |
/ |
|
Checkbox |
Mảng văn bản |
["Lựa chọn 1", "Lựa chọn 2" ,"Lựa chọn 3"] |
|
Chọn đơn |
Văn bản |
/ |
|
Chọn nhiều |
Mảng văn bản |
["Lựa chọn 1", "Lựa chọn 2" ,"Lựa chọn 3"] |
|
Trường phụ |
Định dạng trường |
Khi trường con kích hoạt sự kiện, các trường phản hồi phải là các trường con cùng một biểu mẫu con. Khi trường biểu mẫu kích hoạt sự kiện, bạn có thể nhập mảng vào biểu mẫu con, số hàng của biểu mẫu con sẽ bằng số phần tử trong mảng. |
