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

# giao diện (Views & UI)

> Khắc phục lỗi hiển thị và cấu hình view/record layout.

Trang này tổng hợp lỗi phổ biến khi dùng **views** và **record layout**.

Liên quan:

* [Tổng quan giao diện](/build-apps/ui-views/views-overview)
* [Bố cục bản ghi (Record layout)](/build-apps/ui-views/record-layout)

***

## Checklist nhanh

1. Người dùng có quyền xem entity/field không?
2. View có filter mặc định đang chặn dữ liệu không?
3. Field có bị ẩn trong view/record layout không?
4. Với Kanban/Gantt: field dùng để group/timeline có đúng kiểu dữ liệu không?

***

## 1) Grid view không thấy field

### Nguyên nhân thường gặp

* Field chưa được thêm vào view
* Field bị ẩn theo role
* Field thuộc section khác trong record layout (nhưng chưa đưa vào grid)

### Cách xử lý

* Builder thêm field vào view
* Kiểm tra quyền xem field theo role

***

## 2) Kanban view không nhóm đúng

### Nguyên nhân thường gặp

* Kanban chỉ hỗ trợ group theo **Status** (trạng thái theo bước workflow). Nếu chọn field khác (ví dụ Single select), hệ thống chưa hỗ trợ group theo field đó.
* Giá trị **Status** chưa chuẩn hoá (trống hoặc sai) nên cột Kanban không hiển thị đúng.

### Cách xử lý

* Đảm bảo entity có field **Status** và workflow đang dùng Status đó để điều phối bước.
* Chuẩn hoá dữ liệu Status (bổ sung giá trị còn thiếu, tránh để trống).
* Nếu cần phân loại phụ, dùng Single select để lọc/hiển thị trong grid hoặc record layout (Kanban chưa hỗ trợ group theo Single select).

***

## 3) Gantt view không hiển thị hoặc lệch thời gian

### Nguyên nhân thường gặp

* Field timeline không phải Date/Datetime
* Thiếu start/end hoặc thiếu scheduled date/time
* Quyền xem field thời gian bị chặn

### Cách xử lý

* Đảm bảo timeline dùng Date/Datetime
* Kiểm tra dữ liệu thời gian có bị trống không

***

## 4) Record layout hiển thị “lạ” hoặc không lưu

### Nguyên nhân thường gặp

* Field bắt buộc nhưng không hiển thị trong layout
* Validation yêu cầu format nhưng người dùng nhập sai
* Trình duyệt cache layout cũ

### Cách xử lý

* Builder đảm bảo các field bắt buộc xuất hiện trong layout
* Người dùng thử refresh mạnh hoặc đăng nhập lại

***

## 5) View chậm hoặc khó dùng

Gợi ý tối thiểu:

* Giảm số field hiển thị trong grid
* Tách view theo mục tiêu (queue theo trạng thái/role)
* Dùng filter để giảm khối lượng dữ liệu hiển thị