Giao diện
Cấu hình nâng cao
AssignFormWidget
AssignFormWidget là giao diện designer để cấu hình bộ giá trị gán. Mỗi entry gồm:
| Thành phần | Mô tả |
|---|---|
| Field selector | Chọn field cần cập nhật từ danh sách field của collection |
| Value input | Nhập giá trị gán — hỗ trợ input tĩnh, biến hệ thống, hoặc JS expression |
| Value type | Loại giá trị: constant, variable, hoặc expression |
RunJS — Dynamic values
Khi giá trị gán chứa JS expression, hệ thống dùng resolveRunJSObjectValues để evaluate trước khi gửi API.
Biến có sẵn trong expression
| Biến | Mô tả |
|---|---|
currentRecord | Bản ghi hiện tại (trong ngữ cảnh row action) |
currentUser | Thông tin user đang đăng nhập |
currentTime | Thời gian hiện tại (ISO string) |
Ví dụ expression
js
// Gán ngày hết hạn = ngày hiện tại + 30 ngày
new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString()js
// Gán người xử lý = user hiện tại
currentUser.idLưu ý
Expression chạy ở client trước khi gửi request. Không truy cập được server-side resources.
Update mode
| Chế độ | Hành vi | Tham số |
|---|---|---|
selected | Cập nhật bản ghi đã chọn | filter chứa danh sách ID |
all | Cập nhật toàn bộ bản ghi khớp filter bảng | filter = filter hiện tại, forceUpdate: true |
Chế độ all cần cẩn thận — có thể ảnh hưởng nhiều bản ghi ngoài trang hiện tại. Hệ thống luôn hiển thị confirm dialog trước khi thực thi.
ACL mapping
| Action | Quyền yêu cầu |
|---|---|
customize:bulkUpdate | update trên collection |
| Hiển thị nút | updateMany |
BulkUpdateFieldsConfig
Component BulkUpdateFieldsConfig cung cấp UI cấu hình danh sách field + giá trị trong designer mode:
- Thêm / xóa field gán
- Kéo thả sắp xếp thứ tự
- Chuyển đổi giữa value type (constant / variable / expression)
- Preview giá trị sẽ được gán