Trường dữ liệu

Mỗi trường trên một Thực thể có một Kiểu cố định. Khóa (key) và Kiểu của một trường bị khóa ngay khi trường được lưu lần đầu — chỉ Nhãn, Mô tả và mức Nhạy cảm còn đổi được sau đó.

Danh mục kiểu trường

Kiểu	Lưu trữ gì	Cài đặt chính
text (Văn bản)	Chuỗi ký tự tự do — tên, mã số, ghi chú	Định dạng hiển thị: email · URL · điện thoại · văn bản đa dạng thức (richtext)
number (Số)	Giá trị số	Định dạng: tiền tệ · phần trăm · thời lượng · đánh giá (rating); số chữ số thập phân, dấu phân tách
boolean (Đúng/sai)	Cờ có/không	Không có cài đặt bổ sung
date (Ngày)	Ngày trên lịch	Định dạng hiển thị: dd/mm/yyyy · mm/dd/yyyy · ISO · dài · tháng + năm · tương đối
datetime (Ngày giờ)	Ngày và giờ	Cùng các định dạng của date, cộng thêm Kiểu giờ (12 giờ / 24 giờ)
enum (Danh sách — chọn một)	Một giá trị trong tập lựa chọn cố định	Danh sách lựa chọn: mỗi lựa chọn có giá trị lưu trữ, nhãn hiển thị tùy chọn và màu
multi_select (Chọn nhiều)	Nhiều giá trị từ cùng một tập lựa chọn	Cùng cơ chế lựa chọn như enum, nhưng bản ghi lưu một mảng giá trị
reference (Tham chiếu)	Trỏ tới một bản ghi ở thực thể khác	Thực thể đích (cố định sau khi tạo); tên liên kết ngược tùy chọn; nếu đích là Người dùng/Nhóm — giới hạn theo nhóm
reference_list (Danh sách tham chiếu)	Trỏ tới nhiều bản ghi ở thực thể khác	Giống reference
file (Tệp)	Một hoặc nhiều tệp đính kèm (lưu dưới dạng id tệp)	Số tệp tối đa (mặc định 10); định dạng hiển thị “hình ảnh”
formula (Công thức)	Tính từ các trường khác của cùng bản ghi; lưu khi ghi, chỉ đọc	Biểu thức; Kiểu kết quả — quyết định định dạng hiển thị và toán tử lọc kế thừa
auto_number (Số tự động)	Số chạy theo phạm vi, cấp khi tạo bản ghi; chỉ đọc và cố định ngay khi có giá trị	Khóa phạm vi; Mẫu mã số — cả hai sửa được sau khi tạo; chỉ áp dụng cho các mã cấp về sau

Ghi chú

formula và auto_number là hai kiểu duy nhất mà hệ thống tự ghi giá trị — không thể sửa trực tiếp trên bản ghi. Không có kiểu trường “tính toán” (computed) nào khác ngoài formula; đây chính là kiểu đó.

Sửa mẫu của trường số tự động

Cả hai mẫu đều sửa được sau khi tạo trường, nhưng chỉ ảnh hưởng tới các mã cấp về sau:

• Các mã đã cấp giữ nguyên đúng nội dung lúc cấp. Hệ thống chỉ lưu mã đã kết xuất — không còn con số riêng để tạo lại.
• Khóa phạm vi mới sẽ bắt đầu bộ đếm mới từ 1, nên một mã mới có thể trùng với mã đã cấp theo phạm vi cũ. Nếu điều đó quan trọng, hãy đưa thêm yếu tố phân tách (năm, phòng ban) vào khóa.
• Sửa mẫu cũng là cách gỡ hai lỗi từ chối: “trường X đang được số tự động Y sử dụng” khi xóa trường, và “không thể đổi đích của trường tham chiếu … khi có số tự động đi qua nó” khi trỏ lại tham chiếu. Hãy bỏ đọc trường đó trong mẫu rồi thử lại.

Bắt buộc & Nhạy cảm

Hai cờ này áp dụng cho hầu hết các kiểu trường, độc lập với Kiểu:

• Bắt buộc — không thể tạo bản ghi khi trường này để trống. Không đặt được cho formula hoặc auto_number, vì giá trị của chúng do hệ thống tự ghi chứ không phải người dùng nhập.
• Nhạy cảm — giá trị bị che với người đọc không có quyền entity.read.sensitive. Một trường nhạy cảm tự động không thể tìm kiếm nhanh hay tạo facet (tránh lộ giá trị qua phân bố). Nếu một formula đọc trường nhạy cảm, bản thân nó cũng phải đánh dấu Nhạy cảm — quy tắc này được kiểm tra khi lưu.

Định dạng hiển thị

Định dạng chỉ ảnh hưởng đến cách giá trị hiển thị — bộ lọc, sắp xếp và giá trị lưu trữ không đổi.

Kiểu	Các định dạng khả dụng
text	email, url, phone, richtext
number	currency (kèm mã tiền tệ), percent (giá trị lưu chính là con số phần trăm, không nhân/chia lại), duration (đơn vị lưu giây/phút/giờ + kiểu hiển thị: dạng người-đọc “2h 5m”, h:mm, hoặc h:mm:ss), rating (điểm tối đa, mặc định 5, tối đa 10)
date / datetime	dd_mm_yyyy, mm_dd_yyyy, iso, long, month_year, relative; datetime có thêm Kiểu giờ 12h/24h
file	image (hiển thị dạng ảnh thu nhỏ)
formula	Kế thừa các định dạng của Kiểu kết quả đã khai báo (ví dụ kết quả kiểu number thì dùng được currency, percent, …)

boolean, enum, multi_select, reference, reference_list và auto_number không có tùy chọn định dạng hiển thị riêng — giá trị luôn hiển thị nguyên trạng (mã số của auto_number đã được định hình sẵn bởi Mẫu mã số của chính nó, xem bên dưới).

Khóa định danh — sửa được, lập lại chỉ mục ở chế độ nền

Khóa định danh (Identity key) là một hoặc nhiều trường quyết định hai bản ghi có “trùng nhau” không — dùng khi thao tác Upsert của bước Bản ghi thực thể cần tìm-hoặc-tạo bản ghi theo giá trị nghiệp vụ thay vì id nội bộ. Bạn thiết lập nó tại panel Khóa định danh trong Trình tạo thực thể, và có thể thêm nhiều khóa (mỗi khóa là một cách so khớp độc lập).

Thay đổi khóa trên thực thể đã có bản ghi

Thêm một khóa, hoặc đổi các trường cấu thành một khóa, đồng nghĩa với việc phải lập lại chỉ mục cho mọi bản ghi hiện có. Việc này chạy ở chế độ nền:

1. Khóa được lưu ở trạng thái đang lập chỉ mục. Trong lúc đó khóa đã được khai báo nhưng chưa dùng để so khớp được — thao tác Upsert theo khóa này sẽ bị từ chối, thay vì trả lời dựa trên một chỉ mục còn dang dở (điều đó sẽ tạo ra bản trùng của một bản ghi mà quá trình lập chỉ mục chưa kịp chạm tới).
2. Khi hoàn tất, khóa chuyển sang hoạt động và Upsert chạy bình thường.
3. Nếu dữ liệu hiện có chứa giá trị trùng lặp cho khóa, quá trình dừng lại và khóa bị đánh dấu thất bại, kèm số lượng trùng lặp tìm được. Hãy sửa dữ liệu rồi bấm Lập lại chỉ mục.

Đổi tên khóa hoặc xóa hẳn một khóa thì không cần lập lại chỉ mục và có hiệu lực ngay.

Quy trình đã xuất bản sẽ theo khóa mới

Sau khi khóa thay đổi, các quy trình đã xuất bản sẽ so khớp theo định nghĩa mới mà không cần xuất bản lại. Đây là chủ ý — khóa là quy tắc duy nhất trên dữ liệu dùng chung, và ràng buộc của bước (“so khớp theo khóa Email”) không đổi; chỉ có ý nghĩa của “khóa Email” là đổi. Nếu vẫn so khớp theo hình dạng cũ thì đơn giản là sẽ không tìm thấy bản ghi nào.

Tham chiếu & liên kết ngược

Trường reference / reference_list trỏ tới một Thực thể đích — được chọn khi thêm trường và cố định sau đó.

• Liên kết ngược (tùy chọn) — đặt một Tên chiều ngược (khóa + nhãn hiển thị) để bản ghi ở Thực thể đích liệt kê ngược lại các bản ghi trỏ tới nó, qua record.<đích>.<chiều ngược>. Ví dụ: thực thể Hóa đơn có trường tham chiếu tới Nhà cung cấp với chiều ngược hoa_don — xem một bản ghi nhà cung cấp, mục Liên quan sẽ liệt kê mọi hóa đơn trỏ tới nó.
• Trỏ tới Người dùng hoặc Nhóm — không phải một kiểu trường riêng, mà chỉ là một reference/reference_list có Thực thể đích là Thực thể hệ thống Người dùng hoặc Nhóm. Khi đó:
  • Không thể đặt liên kết ngược — hai thực thể hệ thống này không nhận trường liên kết ngược tùy chỉnh.
  • Panel đổi thành hai bộ chọn Chỉ người trong nhóm / Loại trừ người trong nhóm, giới hạn danh sách chọn của trường theo (hoặc ngoài) thành viên các nhóm đã chọn. Máy chủ kiểm tra lại ràng buộc này khi ghi giá trị, không chỉ ở giao diện.

Xem thêm Thực thể hệ thống về Người dùng và Nhóm.

Trường hiển thị (display field)

Trường nào titles một bản ghi trên danh sách, thẻ và tiêu đề chi tiết là một cài đặt riêng biệt, cấu hình ở tab Cài đặt của Thực thể — không phải một thuộc tính của kiểu trường. Xem View và cài đặt duyệt.

---

Xem thêm Tổng quan về Thực thể để quay lại phần tổng quan.