Bỏ qua, đến nội dung

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:

  1. Mở Schema Editor (chế độ thiết kế) trên trang chứa block tương ứng.
  2. Vào Configure actions của block → chọn Bulk Edit (action type customize:bulkEdit).
  3. 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 đổiGiữ 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
selectedChỉ cập nhật các bản ghi đã chọn (theo danh sách ID)
allCậ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

  1. Chọn chế độ cho từng field, nhập giá trị mới nếu chọn Thay thế.
  2. Nhấn Submit — form validate dữ liệu qua Formily schema.
  3. Hệ thống gọi resource.update() với filter chứa danh sách ID đã chọn.
  4. 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.