JSON
Giới thiệu
Trong NocoBase, JSON (JSON) được dùng để lưu dữ liệu có cấu trúc hoặc bán cấu trúc.
Trường JSON phù hợp để lưu các phần phản hồi từ API bên ngoài, cấu hình mở rộng, thuộc tính động và các dữ liệu có cấu trúc không cố định khác. Trường này linh hoạt, nhưng không dễ lọc, kiểm tra và hiển thị như các trường thông thường.
Nếu cấu trúc dữ liệu ổn định, nên tách thành các trường rõ ràng để thuận tiện cho việc cấu hình giao diện, phân quyền, lọc và sử dụng trong workflow.
Trường hợp sử dụng
JSON phù hợp với các trường hợp nghiệp vụ sau:
- Phản hồi thô từ API bên ngoài
- Thuộc tính mở rộng động
- Các đối tượng cấu hình phức tạp
- Lưu tạm dữ liệu không thể tách thành các trường có cấu trúc
Tạo và cấu hình
Trên trang 「Configure fields」 của bảng dữ liệu, nhấp vào 「Add field」 rồi chọn 「JSON」 để tạo trường JSON.
Tên trường sẽ được các khối giao diện, phân quyền, workflow và API tham chiếu sau khi tạo. Hãy xác nhận cách đặt tên trước khi tạo để tránh phát sinh chi phí điều chỉnh cấu hình về sau.
Đặc điểm của trường
Hành vi mặc định của trường JSON như sau:
Chỉnh sửa cấu hình
Sau khi tạo, nhấp vào 「Edit」 bên phải trường để chỉnh sửa cấu hình trường JSON. Việc chỉnh sửa trường chủ yếu nhằm điều chỉnh cách trường được hiển thị và sử dụng trong NocoBase, chẳng hạn như thay đổi tên hiển thị, mô tả, giá trị mặc định, quy tắc kiểm tra hoặc cấu hình riêng của trường.
Nếu trường đến từ bảng đã được đồng bộ trong cơ sở dữ liệu chính, việc chỉnh sửa thường là ánh xạ trường — ánh xạ trường cơ sở dữ liệu sang Field type và Field interface của NocoBase.
Việc chuyển đổi Field type hoặc Field interface không đơn giản chỉ là thay đổi tên hiển thị. Thao tác này ảnh hưởng đến cách lưu trữ trường, thành phần nhập liệu, quy tắc kiểm tra, điều kiện lọc và cách sử dụng biến workflow. Khi có nhiều dữ liệu hiện có, trước tiên hãy xác nhận định dạng dữ liệu có tương thích hay không.
Xóa trường
Nhấp vào 「Delete」 bên phải trường để xóa trường JSON. Trong cơ sở dữ liệu chính, bạn cũng có thể chọn nhiều trường rồi xóa hàng loạt.
Khi xóa trường JSON được tạo trong cơ sở dữ liệu chính, thông thường cột thực tương ứng trong cơ sở dữ liệu và dữ liệu hiện có của cột đó cũng sẽ bị xóa. Khi xóa trường được đồng bộ từ cơ sở dữ liệu hoặc ánh xạ từ nguồn dữ liệu bên ngoài, phạm vi ảnh hưởng phụ thuộc vào nguồn dữ liệu và nguồn gốc của trường tương ứng.
Việc xóa trường có thể ảnh hưởng đến các khối giao diện, biểu mẫu, bộ lọc, phân quyền, workflow, API, việc nhập xuất dữ liệu và dữ liệu hiện có. Trước khi xóa, hãy xác nhận trường đó không còn được các cấu hình nghiệp vụ tham chiếu.
Sử dụng trong cấu hình giao diện
Trường JSON phù hợp để sử dụng trong các tình huống tích hợp và cấu hình mở rộng.
Liên kết liên quan
- Trường — Tìm hiểu về vai trò, phân loại và logic ánh xạ của trường
- Bảng thông thường — Tạo và quản lý trường trong bảng thông thường
- Văn bản nhiều dòng — Lưu nội dung văn bản thuần túy dài
- Công thức — Tính toán kết quả dựa trên các trường