Cấu hình nâng cao

Threshold tuning

IMPORT_AUTO_MODE_THRESHOLD

Ngưỡng quyết định chế độ sync/async:

Giá trị	Hành vi
Thấp (VD: 200)	Nhiều import chuyển sang async — giảm tải server nhưng user phải chờ
Cao (VD: 20000)	Hầu hết import chạy sync — phản hồi nhanh nhưng rủi ro timeout

Đặt giá trị phù hợp dựa trên cấu hình server và độ phức tạp validate/association:

IMPORT_AUTO_MODE_THRESHOLD=1000

Mẹo

Collection có nhiều relation field và validate phức tạp nên đặt ngưỡng thấp hơn vì mỗi dòng mất nhiều thời gian xử lý.

Workflow skip

Cờ skipWorkflow bỏ qua workflow hooks (afterCreate, afterUpdate) trong sync path:

Giá trị	Hành vi
true	Bỏ qua workflow — import nhanh hơn đáng kể
false (mặc định)	Workflow hooks vẫn được kích hoạt

Hữu ích khi import dữ liệu migration lớn mà không cần trigger workflow (VD: gửi email, tạo log).

Lưu ý

Chỉ hoạt động ở sync path. Async path luôn qua pipeline bình thường.

Validation nâng cao

Import Pro kế thừa toàn bộ validation logic từ plugin cơ bản và bổ sung:

Tính năng	Mô tả
Batch validation	Validate theo batch thay vì từng dòng — tối ưu hiệu năng
Error aggregation	Gom tất cả lỗi thay vì dừng ở lỗi đầu tiên
Detailed report	Báo cáo chi tiết: dòng, field, lý do, giá trị gốc

Tích hợp Async Task Manager

Tính năng	Mô tả
Job queue	Import job được đưa vào hàng đợi
Real-time progress	Cập nhật tiến trình sau mỗi batch (x/total dòng)
Notification	Thông báo cho user khi hoàn tất
Error download	Cho phép tải file báo cáo lỗi chi tiết

Xử lý association trong async mode

Async mode xử lý association tương tự sync nhưng theo batch:

1. Mỗi batch dòng được parse và resolve association.
2. Nếu association không tìm thấy, dòng đó được ghi nhận lỗi nhưng batch tiếp tục.
3. Cuối cùng, báo cáo tổng hợp tất cả lỗi association.