> ## Documentation Index
> Fetch the complete documentation index at: https://learn.cleeksy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cổng dữ liệu (Data source)

> Tổng quan các loại Data source để nhận và chia sẻ dữ liệu.

Data source (cổng dữ liệu) là **cấu hình “điểm kết nối”** để một app có thể **nhận dữ liệu vào** hoặc **cung cấp dữ liệu ra** một cách có kiểm soát.

Trong Cleeksy DOP:

* **Entity trong app** là nơi lưu dữ liệu vận hành (source of truth / nguồn dữ liệu chuẩn).
* **Data source** là “cổng” giúp dữ liệu đi vào/đi ra khỏi app, hoặc kết nối giữa các app.

***

## 1) Data source dùng để làm gì?

* **Nhận dữ liệu vào** (submit/push): người dùng hoặc hệ thống khác gửi dữ liệu vào app.
* **Cung cấp dữ liệu ra** (pull/read): hệ thống khác lấy dữ liệu từ app theo phạm vi được phép.
* **Kết nối giữa các app**: gửi/bàn giao hoặc đọc dữ liệu giữa các app nội bộ.

***

## 2) Các loại Data source trong Cleeksy DOP

### Request portal (cổng nội bộ)

Biểu mẫu/luồng để người dùng nội bộ submit dữ liệu theo quyền truy cập được kiểm soát.

### Public portal (cổng công khai)

Biểu mẫu để người ngoài hệ thống submit dữ liệu (khách hàng/đối tác…), có kiểm soát field và truy cập.

### Connected app (kết nối ứng dụng)

Kết nối giữa các app trong Cleeksy DOP để:

* **submit** dữ liệu sang app khác
* và/hoặc **pull** dữ liệu từ app khác (tuỳ cấu hình)

Liên quan: [Kết nối ứng dụng (Connected app)](/build-apps/integrations/connected-app)

### Integration: Webhook & API (tích hợp)

* **Webhook**: hệ thống ngoài đẩy dữ liệu/sự kiện vào app theo thời gian thực.
* **API**: trao đổi có cấu trúc:
* GET: cung cấp dữ liệu ra
* POST/PUT: nhận dữ liệu vào
* Upload: nhận đính kèm theo cấu hình

Liên quan:

* [Webhook portal (cổng webhook)](/build-apps/integrations/webhook-portal)
* [API portal (cổng API)](/build-apps/integrations/api-portal)

***

## 3) Quy tắc chọn đúng loại Data source (decision rules)

* Người dùng submit theo form nội bộ → Request portal
* Người ngoài submit → Public portal
* Kết nối giữa các app nội bộ:
* gửi/bàn giao hoặc đọc dữ liệu giữa app → Connected app
* Tích hợp hệ thống ngoài:
* event-driven / push → Webhook
* đồng bộ có cấu trúc → API

***

## 4) Ví dụ: Purchase Request → Procurement (bàn giao)

* Procurement tạo Data source loại **Connected app** để nhận submission.
* Purchase Request dùng **Data Connection (một chiều)** để submit dữ liệu sang Procurement khi Approved.

Liên quan: [Kết nối dữ liệu một chiều (Data Connection one-way)](/build-apps/data-modeling/data-connection-one-way)