Cấu hình node - Action Trigger

Trigger kích hoạt workflow khi người dùng nhấn nút action trên giao diện (form toolbar, table row action, table toolbar).

Bảng tham số cấu hình

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
collection	string	Có	—	Collection gắn với trigger, xác định nút action hiển thị trên collection nào
appends	string[]	Không	[]	Danh sách relation cần eager-load kèm bản ghi khi trigger
global	boolean	Không	false	Khi true, nút action hiển thị trên mọi form/table của collection
context	object	Không	{}	Dữ liệu bổ sung truyền vào workflow ngoài record data

Dữ liệu đầu vào (Input)

Tên	Kiểu	Mô tả
data	object	Bản ghi hiện tại kèm relation (nếu cấu hình appends)
user	object	Thông tin người dùng nhấn nút action

Dữ liệu đầu ra (Output)

Tên	Kiểu	Mô tả
result	any	Kết quả trả về từ workflow (chỉ khi chế độ sync)
status	string	Trạng thái thực thi: resolved hoặc rejected

Vị trí đặt nút action

Vị trí	Mô tả	Phù hợp cho
Form toolbar	Nút ở đầu form chi tiết	Thao tác trên bản ghi đang xem
Table row action	Nút trên từng dòng bảng	Thao tác nhanh trên từng bản ghi
Table toolbar	Nút tác vụ hàng loạt	Thao tác trên nhiều bản ghi đã chọn

Lưu ý quan trọng

• Trigger chỉ hoạt động khi user nhấn nút trên giao diện, không hỗ trợ kích hoạt từ API trực tiếp
• Nếu cần trigger từ API, sử dụng plugin Webhook hoặc Request Interceptor thay thế
• Mỗi nút action chỉ bind được một workflow, nhưng workflow đó có thể gọi nhiều subflow
• Field appends ảnh hưởng đến hiệu suất - chỉ load relation thực sự cần thiết
• Kết hợp với node Response Message để gửi thông báo kết quả về client sau khi workflow hoàn tất
• Khi global: true, nút hiển thị ở tất cả view của collection - cẩn thận tránh gây nhầm lẫn cho người dùng