Giao diện
Cài đặt và sử dụng
Cài đặt
Plugin @digiforce-nc/plugin-action-bulk-edit thường được cài sẵn trong bản phân phối chính. Nếu chưa có, kích hoạt qua trang Plugin Manager trong admin panel.
Plugin hoạt động hoàn toàn ở client — server chỉ có stub, không cần cấu hình backend riêng.
Thêm action Bulk Edit
Action Bulk Edit có thể gắn vào các block dạng Table, Gantt hoặc Map:
- Mở Schema Editor (chế độ thiết kế) trên trang chứa block tương ứng.
- Vào Configure actions của block → chọn Bulk Edit (action type
customize:bulkEdit). - Lưu schema.
Action sẽ xuất hiện trên toolbar của block. Nút chỉ hiển thị khi người dùng có quyền updateMany trên collection tương ứng.
Sử dụng
Chọn bản ghi
- Trên Table: tick checkbox từng dòng hoặc chọn tất cả qua checkbox ở header.
- Trên Gantt / Map: sử dụng cơ chế chọn tương ứng của block.
Mở popup Bulk Edit
Nhấn nút Bulk Edit trên toolbar → popup hiển thị form chỉnh sửa hàng loạt.
Form chỉnh sửa (Bulk Edit Form)
Form hiển thị danh sách field của collection. Mỗi field có 3 chế độ:
| Chế độ | Mô tả |
|---|---|
| Không thay đổi | Giữ nguyên giá trị cũ — field bị bỏ qua |
| Thay thế | Ghi đè bằng giá trị mới nhập trong form |
| Xóa | Đặt giá trị field thành null |
Chế độ cập nhật (Update mode)
| Chế độ | Hành vi |
|---|---|
| selected | Chỉ cập nhật các bản ghi đã chọn (theo danh sách ID) |
| all | Cập nhật tất cả bản ghi khớp filter hiện tại (kèm forceUpdate: true) |
Xác nhận và gửi
- Chọn chế độ cho từng field, nhập giá trị mới nếu chọn Thay thế.
- Nhấn Submit — form validate dữ liệu qua Formily schema.
- Hệ thống gọi
resource.update()với filter chứa danh sách ID đã chọn. - Popup đóng, bảng tự refresh hiển thị dữ liệu mới.
Tùy chỉnh nút
Trong Schema Settings của action (actionSettings:bulkEdit), bạn có thể:
- Đổi tiêu đề nút
- Thêm linkage rules (hiện/ẩn theo điều kiện)
- Xem / chỉnh JSON schema
- Xóa action khỏi block
Mẹo
Nếu danh sách field trong form quá dài, hãy vào Schema Editor bên trong popup Bulk Edit để ẩn bớt các field không cần thiết.