Giao diện
Cấu hình nâng cao
Schema settings
Khi mở Schema Settings của action Bulk Edit trong designer, các tùy chọn chính:
| Tùy chọn | Mô tả |
|---|---|
| Update mode | selected (chỉ bản ghi đã chọn) hoặc all (toàn bộ filter) |
| Form fields | Chọn field nào xuất hiện trong form chỉnh sửa |
| Linkage rules | Điều kiện hiện/ẩn nút dựa trên trạng thái bảng |
BulkEditField — Chế độ field
Component BulkEditField render mỗi field trong form với selector chế độ:
| Giá trị nội bộ | Hiển thị | Hành vi khi submit |
|---|---|---|
unchanged | Không thay đổi | Bỏ qua field, không gửi trong payload |
replace | Thay thế | Gửi giá trị mới nhập |
clear | Xóa | Gửi null |
Khi toàn bộ field ở chế độ unchanged, payload rỗng và request không được gửi.
Xử lý submit chi tiết
BulkEditActionDecorator wrap toàn bộ form logic:
- Thu thập các field có chế độ khác
unchanged. - Build payload
valuestừ giá trị form. - Gọi
resource.update()vớifilter(danh sách ID hoặc filter hiện tại) vàforceUpdate: true. - Sau khi thành công: đóng popup, gọi
service.refresh()trên block cha.
Dual stack: Classic vs uiCore
Plugin hỗ trợ hai hệ thống render form song song:
| Stack | Component chính | Khi nào áp dụng |
|---|---|---|
| Formily schema | BulkEditFormWidget dùng Formily | Collection sử dụng schema cũ (classic) |
| uiCore widgets | BulkEditActionWidget | Collection sử dụng uiCore mới |
Hệ thống tự phát hiện stack phù hợp dựa trên cấu hình schema của collection. Không cần chọn thủ công.
ACL mapping
Plugin map action sang quyền core:
| Action | Quyền yêu cầu | Ghi chú |
|---|---|---|
customize:bulkEdit | update | Map trực tiếp sang quyền update của collection |
| Hiển thị nút | updateMany | Nút chỉ render khi user có quyền cập nhật nhiều bản ghi |
Cấu hình quyền trong Roles & Permissions → chọn collection → bật update / updateMany.