Câu hỏi thường gặp — Spreadsheet

Sử dụng

Khác gì với Table Block thông thường?

Đặc điểm	Table Block	Spreadsheet
Mục đích	Hiển thị dữ liệu Collection	Bảng tính tự do hoặc kết nối Collection
Chỉnh sửa	Qua form/modal	Inline — click đúp ô
Copy/Paste	Không	Có — từ Excel, Google Sheets
Formula	Không	Có (qua spreadsheet engine)
Chia sẻ URL	Không	Có — public/private URL
Lưu trữ	Collection records	JSONB trong bảng spreadsheet

Có thể paste dữ liệu từ Excel không?

Có. Copy vùng dữ liệu trong Excel → chọn ô bắt đầu trong Spreadsheet → Ctrl/Cmd + V. Dữ liệu giữ nguyên cấu trúc hàng/cột.

Spreadsheet có tự động lưu không?

Có. Mọi thay đổi được lưu trực tiếp vào Database (field content kiểu JSONB). Không có nút Save riêng.

Có giới hạn kích thước spreadsheet không?

Kích thước tối đa phụ thuộc vào cấu hình JSONB của Database:

• PostgreSQL: JSONB có thể lưu tới ~1GB per record
• MySQL: JSON tối đa ~4GB nhưng thực tế phụ thuộc max_allowed_packet

Tuy nhiên, hiệu năng giảm rõ rệt khi spreadsheet lớn (> 10,000 ô). Khuyến nghị giữ spreadsheet ở kích thước vừa phải.

Chia sẻ

Chế độ chia sẻ hoạt động thế nào?

Chế độ	Mô tả
Private	Chỉ người có quyền mới truy cập
Public (view)	Ai có link đều xem được (chỉ đọc)
Public (edit)	Ai có link đều chỉnh sửa được

URL chia sẻ: https://your-domain.com/spreadsheet/<spreadsheetId>

Route /spreadsheet/:id có cần đăng nhập không?

Route đăng ký với skipAuthCheck: true — người truy cập không cần đăng nhập cho chế độ public. Tuy nhiên, action spreadsheet:getData yêu cầu loggedIn — dữ liệu chỉ trả về cho người đã đăng nhập.

Cẩn thận: Nếu bật chế độ public edit, bất kỳ ai có link đều có thể chỉnh sửa dữ liệu. Chỉ dùng cho dữ liệu không nhạy cảm.

Kết nối Collection

Plugin dgRecords là gì?

dgRecords là plugin tích hợp sẵn cho phép kết nối spreadsheet với Collection. Dữ liệu từ Collection được hiển thị trong spreadsheet và có thể đồng bộ hai chiều.

Có thể tạo custom function không?

Có. Plugin hỗ trợ đăng ký function tùy chỉnh cho spreadsheet engine. Xem hướng dẫn chi tiết trong trang Cài đặt và sử dụng.

Lỗi thường gặp

Sửa dữ liệu nhưng báo lỗi?

Kiểm tra:

1. Quyền edit trên Collection spreadsheet — cần snippet ui.spreadsheet
2. Kết nối Database ổn định — spreadsheet lưu trực tiếp, lỗi kết nối gây mất dữ liệu
3. Version conflict — nếu nhiều người sửa cùng lúc, có thể xảy ra xung đột

Spreadsheet hiển thị trắng

• Kiểm tra @digiforce-nc/spreadsheet đã được cài đặt đúng
• Kiểm tra browser console cho lỗi JavaScript
• Thử tải lại trang (hard refresh: Ctrl + Shift + R)