Bỏ qua, đến nội dung

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

Cài đặt

Plugin @digiforce-nc/plugin-action-bulk-update thường được cài sẵn. Nếu chưa có, kích hoạt qua trang Plugin Manager.

Plugin hoạt động hoàn toàn ở client — server chỉ có stub.

Thêm action Bulk Update

  1. Mở Schema Editor trên trang chứa block dạng Table.
  2. Vào Configure actions → chọn Bulk Update (action type customize:bulkUpdate).
  3. Lưu schema.

Cấu hình giá trị gán (Assign Values)

Khác với Bulk Edit (user tự chọn field tại runtime), Bulk Update yêu cầu designer cấu hình trước bộ giá trị sẽ được gán:

  1. Mở Schema Settings của action Bulk Update.
  2. Vào phần Assign field values — giao diện AssignFormWidget.
  3. Thêm từng field cần cập nhật và nhập giá trị gán.

Giá trị có thể là:

LoạiMô tả
Giá trị tĩnhText, số, ngày cố định
Biến hệ thốngcurrentUser, currentTime
JS expressionBiểu thức JavaScript được resolve bởi resolveRunJSObjectValues

Sử dụng

Chọn bản ghi

Tick checkbox trên Table để chọn bản ghi cần cập nhật.

Xác nhận (Confirm modal)

Nhấn nút Bulk Update → hiển thị Confirm modal với nội dung xác nhận. User nhấn OK để thực thi.

Luồng xử lý

  1. Hệ thống resolve dynamic values (nếu có JS expression).
  2. Gọi resource.update() với:
    • filter: danh sách ID đã chọn (mode selected) hoặc filter hiện tại (mode all)
    • values: bộ giá trị đã cấu hình
    • forceUpdate: true
  3. Bảng tự refresh sau khi thành công.

Ví dụ thực tế

Đổi trạng thái hàng loạt: Cấu hình action với assign value status = "completed". User chọn 50 đơn hàng → nhấn Bulk Update → xác nhận → tất cả đơn chuyển sang "completed".

Gán người phụ trách: Assign value assignee = currentUser.id. Khi nhấn, tất cả bản ghi chọn sẽ được gán cho user hiện tại.

Tùy chỉnh nút

Trong Schema Settings của action:

  • Đổi tiêu đề và icon
  • Thêm linkage rules
  • Chỉnh confirm message
  • Xem / sửa JSON schema