> ## 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.

# Chia sẻ dữ liệu (Publish/Consume)

> Tra cứu cơ chế publish/consume và cách dùng đúng.

Trang này là bảng tra cứu nhanh về **publish/consume** để chia sẻ dữ liệu giữa các app.

Mục tiêu:

* Làm rõ vai trò **provider app** (app nguồn) và **consumer app** (app sử dụng)
* Làm rõ “điểm rơi” khi dùng Data Connection/Lookup/Rollup
* Nhắc các lưu ý quyền và phạm vi dữ liệu

***

## Khái niệm chính

* **Dataset (tập dữ liệu chia sẻ)**: phần dữ liệu được chọn từ entity (và có thể kèm điều kiện/field)
* **Provider app**: app publish dataset
* **Consumer app**: app sử dụng dataset thông qua field liên kết (Data Connection/Lookup/Rollup)
* **Data source (cổng dữ liệu) – data source**: kênh dùng để chia sẻ dataset giữa các app trong Cleeksy

***

## Luồng đúng

### 1) Provider app: publish dataset

* Chọn entity nguồn
* Chọn field được phép chia sẻ (nguyên tắc tối thiểu)
* (Tuỳ cấu hình) thêm điều kiện lọc dữ liệu được chia sẻ
* Chia sẻ qua Data source loại **data source**

### 2) Consumer app: dùng dataset khi cấu hình field liên kết

Trong consumer app, khi tạo field:

* **Data Connection**: chọn dataset (từ data source đã được chia sẻ) để liên kết record
* **Lookup**: tham chiếu field từ record đã liên kết
* **Rollup**: tổng hợp dữ liệu từ các record liên kết

> Lưu ý: “consume” thường diễn ra **ngay trong lúc cấu hình field** (chọn dataset/data source để dùng), không cần một bước tách rời trước đó.

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)
* [Tra cứu (Lookup)](/build-apps/data-modeling/lookup)
* [Tổng hợp (Rollup)](/build-apps/data-modeling/rollup)

***

## One-way vs Two-way (hướng dẫn nhanh)

* **One-way (một chiều)**: consumer liên kết/đọc hoặc gửi dữ liệu theo thiết kế một chiều
  Dùng khi: cần ranh giới ownership rõ, tránh vòng lặp đồng bộ

* **Two-way (hai chiều)**: hai bên có liên kết cập nhật/đồng bộ theo thiết kế
  Dùng khi: có nhu cầu đồng bộ trạng thái giữa hai bên và đã kiểm soát rõ ràng

Liên quan: [Ownership & chia sẻ dữ liệu (Data ownership & sharing)](/foundations/data-ownership-sharing)

***

## Lưu ý quyền

* Field nào được chia sẻ
* App nào được chia sẻ quyền **đọc/ghi** dữ liệu

***

## Lỗi thường gặp

* Không thấy dataset/data source để chọn
  → provider chưa publish hoặc chưa chia sẻ đúng phạm vi

* Lookup/Rollup ra trống
  → Filter có thể được thiết lập chưa phù hợp

Liên quan: [Liên kết dữ liệu (Data connections)](/troubleshooting/data-connections)