Giao diện
Cài đặt và sử dụng
Yêu cầu
Plugin @digiforce-nc/plugin-action-export-pro yêu cầu hai plugin đã cài trước:
| Plugin bắt buộc | Vai trò |
|---|---|
plugin-action-export | Plugin export cơ bản (được mở rộng) |
plugin-async-task-manager | Quản lý async job, notification, file storage |
Cài đặt
Kích hoạt plugin qua Plugin Manager. Sau khi cài, plugin override handler export của plugin-action-export — nút Export trên giao diện hoạt động tự động với chế độ mới.
Cách hoạt động
Plugin tự động quyết định chế độ sync hoặc async dựa trên ngưỡng số bản ghi:
| Điều kiện | Chế độ | Hành vi |
|---|---|---|
| Số bản ghi < ngưỡng | Sync | Export đồng bộ, tải file ngay (giống plugin cơ bản) |
| Số bản ghi >= ngưỡng | Async | Tạo background job, user nhận thông báo khi file sẵn sàng |
Ngưỡng được cấu hình qua biến môi trường EXPORT_AUTO_MODE_THRESHOLD.
Sử dụng Export XLSX (async mode)
- Nhấn nút Export trên toolbar bảng.
- Nếu vượt ngưỡng, hệ thống thông báo "đang xử lý trong nền".
- Background job chạy: query dữ liệu, tạo XLSX file.
- Khi hoàn tất, user nhận notification qua async task manager.
- Nhấn vào notification hoặc vào Async Tasks → tải file XLSX.
Sử dụng Export Attachments (ZIP)
Plugin bổ sung action exportAttachments — xuất tất cả file đính kèm của các bản ghi đã lọc thành archive ZIP:
- Thêm nút Export Attachments vào toolbar (qua Schema Editor).
- Nhấn nút → hệ thống tạo async job (luôn chạy async).
- Worker đọc tất cả file đính kèm, nén thành ZIP.
- Nhận notification khi hoàn tất → tải file ZIP.
Giao diện không thay đổi
User không cần phân biệt sync/async — hệ thống tự quyết định. Nút Export trên toolbar vẫn giống hệt plugin cơ bản.