Gợi ý: trước khi chọn loại data source, xác định rõ hướng dữ liệu: vào app (intake), ra ngoài (expose), hay hai chiều. Ghi chú: Trong tài liệu này, Internal portal (cổng nội bộ) bao gồm cả cách gọi request portal (cổng yêu cầu) trong một số ngữ cảnh.
Tổng quan các loại Data source
| Loại | Mục tiêu | Hướng dữ liệu | Dùng khi |
|---|---|---|---|
| Internal portal (Internal portal) | Form nội bộ (request) có kiểm soát quyền | Vào app | Nhân viên nội bộ gửi dữ liệu, cần role gating |
| Public portal | Form công khai | Vào app | Thu thập dữ liệu từ bên ngoài, cần chống spam |
| Webhook portal | Nhận sự kiện/payload từ hệ thống ngoài | Vào app | Hệ thống ngoài đẩy dữ liệu vào app |
| API portal | Cung cấp API đọc/ghi có kiểm soát | Ra ngoài (và/hoặc vào) | Hệ thống ngoài cần pull/push dữ liệu |
| Connected app | Kết nối giữa các app trong Cleeksy | Hai chiều tuỳ cấu hình | Cross-app trong một value slice |
1) Internal / Public portal (các cổng dạng form)
Khi nên dùng
- Dữ liệu chủ yếu đến từ “người nhập”
- Cần chuẩn hoá field theo form
- Cần kiểm soát ai được submit (internal) hoặc chống spam (public)
Điểm cấu hình chính
- Chọn entity đích và field cần nhận
- Map field form → field entity
- Validation ở mức form (bắt buộc, format)
- Quyền submit và giới hạn truy cập
- Internal portal: Cổng nội bộ (Internal portal)
- Public portal: Cổng công khai (Public portal)
2) Webhook portal (cổng webhook)
Khi nên dùng
- Hệ thống ngoài phát sinh sự kiện và cần “đẩy” dữ liệu vào app
- Muốn xử lý theo gần thời gian thực
Điểm cấu hình chính
- Xác định payload tối thiểu cần nhận
- Map payload → field
- Xử lý lỗi và retry (idempotency ở mức thiết kế)
3) API portal (cổng API)
Khi nên dùng
- Hệ thống ngoài cần pull dữ liệu theo điều kiện
- Hoặc cần push dữ liệu có kiểm soát
Điểm cấu hình chính
- Token/authentication cơ bản
- Endpoint patterns (list/get/create/update)
- Filter/parameter cho truy vấn
4) Connected app (kết nối ứng dụng)
Connected app là một loại Data source dùng để kết nối dữ liệu giữa các app trong Cleeksy. Nó thường đi kèm cơ chế chia sẻ dữ liệu giữa app (publish/consume) và các field liên kết (Data Connection/Lookup/Rollup). Liên quan:Quy tắc chọn nhanh
- Cần người nhập dữ liệu → ưu tiên portal (internal/public)
- Cần hệ thống ngoài đẩy dữ liệu → webhook
- Cần hệ thống ngoài truy vấn theo điều kiện → API
- Cần app ↔ app trong Cleeksy → Connected app + publish/consume + liên kết dữ liệu
Bảo mật tối thiểu
- Không đưa token vào nơi công khai
- Chỉ expose field cần thiết (nguyên tắc tối thiểu)
- Dùng validation để chặn dữ liệu lỗi ngay tại cổng