Giao diện

Cài đặt và sử dụng ​

Cài đặt ​

Plugin @digiforce-nc/plugin-action-import có cả client và server. Kích hoạt qua Plugin Manager.

Khi install, plugin tự động thêm quyền importXlsx vào admin role strategy và đăng ký import handler lên tất cả data source.

Thêm nút Import ​

  1. Mở Schema Editor trên block Table.
  2. Vào Configure actions → chọn Import.
  3. Lưu schema.

Nút Import sẽ xuất hiện trên toolbar bảng. Chỉ hiển thị khi user có quyền importXlsx.

Quy trình nhập dữ liệu ​

Bước 1: Tải template mẫu ​

  1. Nhấn nút Import → modal mở ra.
  2. Nhấn Download Template để tải file Excel mẫu.
  3. File mẫu chứa header với tên cột tương ứng field của collection.

Bước 2: Điền dữ liệu ​

Mở file template trong Excel, điền dữ liệu vào các dòng. Mỗi dòng là một bản ghi.

Mẹo

Giữ nguyên header row — không đổi tên cột. Hệ thống map cột theo tên để xác định field tương ứng.

Bước 3: Upload file ​

Quay lại modal Import, chọn file .xlsx đã điền dữ liệu. Hệ thống hiển thị preview và field mapping.

Bước 4: Validate và import ​

  1. Nhấn Import để bắt đầu.
  2. Server parse file Excel, validate từng dòng.
  3. Nếu có lỗi → hiển thị danh sách dòng lỗi + lý do.
  4. Nếu không lỗi → insert/update bản ghi vào DB.
  5. Hiển thị kết quả: số dòng thành công / thất bại.

Chế độ dry-run ​

Gửi import với explain: true để chỉ validate mà không insert — hữu ích kiểm tra dữ liệu trước khi import thật.

Tùy chỉnh ​

Trong Schema Settings của action Import:

  • Cấu hình field mapping (cột Excel ↔ field collection)
  • Chọn chế độ insert only / upsert
  • Đổi tiêu đề nút