Trang này hướng dẫn dùng một REST API connector đã tạo ở Workspace trong từng Nhân sự số. Nếu chưa có Connector, xem Kết nối Custom API trên Space để tạo trước.
Lối vào
Nhân sự số của tôi → mở Nhân sự số → Dựng Nhân sự số → panel Cấu hình → mục Kết nối → dấu +.Gắn Connector vào Nhân sự số
1
Mở mục Kết nối của Nhân sự số
Mở Nhân sự số, ở màn hình Dựng Nhân sự số chọn panel Cấu hình, nhấn dấu + ở mục Kết nối.
2
Chọn kiểu tài khoản
Chọn Dùng chung (một tài khoản của Workspace) hoặc Theo người dùng (tài khoản riêng của mỗi người).
3
Tích Connector rồi nhấn Xong
Custom Connector nằm chung danh sách với Connector có sẵn. Tích Connector cần dùng rồi nhấn Xong. Nút Tạo connector mới ở góc dưới mở cùng hộp thoại tạo REST API như trên trang Kết nối.
4
Mở rộng Connector để xem các thao tác
Connector xuất hiện trong mục Kết nối kèm kiểu tài khoản và số ngoại lệ. Nhấn vào dòng Connector để xem tài khoản đang dùng và quyền của từng thao tác.
Với Dùng chung, phần Tài khoản cho biết Nhân sự số đang dùng tài khoản nào. Nhấn biểu tượng đổi tài khoản để chọn tài khoản khác, Thêm tài khoản hoặc Quản lý tài khoản.
Trên một Nhân sự số, mỗi Connector chỉ gắn được theo một kiểu. Connector đã gắn kiểu Dùng chung sẽ hiện nhãn Đã thêm trong hộp chọn Theo người dùng. Muốn đổi kiểu, gỡ Connector rồi gắn lại.
Đặt quyền cho từng thao tác
Mỗi thao tác có ba mức quyền:
Số ngoại lệ cạnh tên Connector cho biết có bao nhiêu thao tác đang khác mức mặc định. Ví dụ dưới đây đặt Huỷ đơn hàng về Chặn để Nhân sự số không thể huỷ đơn.
Chạy thử Nhân sự số với Connector
1
Gửi yêu cầu ở tab Chạy thử
Mở tab Chạy thử và gửi một yêu cầu cần đến API, ví dụ: Tạo đơn hàng cho khách Trần Thị B, tổng tiền 250000.
2
Duyệt hoặc từ chối thao tác
Với thao tác ở mức Hỏi, thẻ Cần bạn phê duyệt hành động hiện tên thao tác và các tham số Nhân sự số định gửi. Nhấn Duyệt để gọi API. Nhấn Từ chối để không gọi, có thể nhập Lý do từ chối để Nhân sự số điều chỉnh.
3
Xem tham số và kết quả
Sau khi Nhân sự số trả lời, mở Đã gọi N công cụ rồi mở tên công cụ để xem Tham số đã gửi và Kết quả API trả về.
Thay đổi Connector trong Nhân sự số được tự động lưu vào bản nháp. Người dùng cuối chỉ thấy thay đổi sau khi bạn Publish phiên bản mới của Nhân sự số.
Gỡ Connector khỏi Nhân sự số
Nhấn biểu tượng thùng rác ở dòng Connector trong mục Kết nối. Connector được gỡ ngay, không có hộp thoại xác nhận. Connector vẫn còn trong Workspace và có thể gắn lại bất cứ lúc nào.Khi Connector được import lại ở Space, thao tác bị xoá hoặc đổi tên trong tài liệu mới không còn trong Nhân sự số. Mở lại mục Kết nối của Nhân sự số để kiểm tra quyền và chạy thử lại.
Lỗi thường gặp
Xem thêm
Kết nối Custom API trên Space
Tạo, sửa, import lại và xoá Connector.
Kết nối (Connectors)
Cách gắn Connector có sẵn và các mức quyền cho công cụ.