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

Yêu cầu

Plugin @digiforce-nc/plugin-action-import-pro yêu cầu hai plugin đã cài trước:

Plugin bắt buộc	Vai trò
`plugin-action-import`	Plugin import cơ bản (được mở rộng)
`plugin-async-task-manager`	Quản lý async job, notification

Cài đặt

Kích hoạt plugin qua Plugin Manager. Sau khi cài, plugin override handler import của plugin-action-import — modal Import trên giao diện tự động hoạt động với chế độ async khi cần.

Cách hoạt động

Plugin tự động quyết định chế độ sync hoặc async dựa trên số dòng trong file:

Điều kiện	Chế độ	Hành vi
Số dòng < ngưỡng	Sync	Import đồng bộ, kết quả ngay (giống plugin cơ bản)
Số dòng >= ngưỡng	Async	Tạo background job, user theo dõi tiến trình real-time

Ngưỡng được cấu hình qua biến môi trường IMPORT_AUTO_MODE_THRESHOLD.

Sử dụng (async mode)

Nhấn nút Import → modal mở ra.
Tải template, điền dữ liệu, upload file (giống plugin cơ bản).
Nhấn Import → nếu vượt ngưỡng, hệ thống thông báo "đang xử lý trong nền".
Background job chạy: parse, validate, insert/update từng batch.
Tiến trình cập nhật real-time (x/total dòng đã xử lý).
Khi hoàn tất, user nhận notification kèm báo cáo kết quả.

Báo cáo kết quả

Sau khi import hoàn tất (cả sync và async):

Thông tin	Mô tả
Tổng số dòng	Tổng dòng dữ liệu trong file Excel
Thành công	Số dòng insert/update thành công
Lỗi	Số dòng lỗi kèm danh sách chi tiết
Chi tiết lỗi	Dòng số mấy, field nào, lý do gì

Giao diện không thay đổi

Modal Import trên giao diện vẫn giống hệt plugin cơ bản. Hệ thống tự quyết định sync/async dựa trên kích thước file.