Đặt biến (Set variable)

Gán giá trị vào biến quy trình (vars.*) để dùng lại ở các bước tiếp theo.

Mục đích

Bước Đặt biến (Set variable) cho phép bạn lưu một giá trị vào không gian biến vars.* của quy trình. Sau khi bước này chạy xong, bất kỳ bước nào phía sau đều có thể đọc biến đó qua bộ chọn biến.

Khi nào dùng

Tính toán hoặc chuẩn hóa một giá trị một lần rồi dùng lại ở nhiều nhánh.
Gộp nhiều kết quả trước đó thành một biến duy nhất trước khi gửi email hoặc ghi bản ghi.
Đặt một cờ logic (ví dụ: vars.da_duyet = true) để bước Quyết định (Decision) kiểm tra.
Lưu dữ liệu trung gian trong vòng lặp Lặp theo phần tử (ForEach).
Làm điểm gom của một nhánh song song trước bước Hợp nhất (Join): nối mọi hành động của một bước phê duyệt vào một bước Đặt biến, rồi chỉ bước này vào Hợp nhất. Dùng vào việc này, bước có thể để trống danh sách gán.

Cài đặt chính

Mỗi bước Đặt biến có thể có nhiều phép gán. Mỗi phép gán gồm:

Trường	Mô tả
Tên biến (target)	Tên biến đích trong `vars.*`. Có thể chọn từ danh sách biến đã khai báo hoặc nhập tên mới.
Loại giá trị	Chọn một trong ba loại: Tham chiếu, Biểu thức, hoặc JSON trực tiếp (xem bảng dưới).
Giá trị	Nội dung tuỳ theo loại: đường dẫn, mẫu template, hoặc JSON.

Ba loại giá trị

Loại	Khi nào dùng	Ví dụ
Tham chiếu (Reference)	Lấy nguyên giá trị từ một bước trước — kể cả object/mảng.	`nodes.buoc_ai.output.tong_tien`
Biểu thức (Expression / Template)	Ghép chuỗi hoặc tính toán đơn giản dùng cú pháp `{{ }}`.	`{{ nodes.don_hang.output.san_pham }} — {{ nodes.don_hang.output.so_luong }} cái`
JSON trực tiếp (Literal)	Gán một giá trị cố định: số, chuỗi, đối tượng, hoặc mảng.	`{"trang_thai": "cho_duyet", "uu_tien": 1}`

Nếu chọn JSON trực tiếp, hãy đảm bảo nội dung nhập đúng định dạng JSON. Hệ thống sẽ báo lỗi ngay bên dưới ô nhập nếu JSON không hợp lệ.

Khi biến đích đã được khai báo trong phần Biến quy trình, bộ chọn loại giá trị sẽ tự giới hạn về kiểu phù hợp (ví dụ: biến kiểu object chỉ cho phép chọn tham chiếu trả về object).

Ví dụ

Trong quy trình Đề xuất mua sắm, sau khi bước Trợ lý AI phân tích đơn hàng, bạn thêm bước Đặt biến với hai phép gán:

vars.tong_gia_tri ← Tham chiếu → nodes.tro_ly_ai.output.tong_gia_tri
vars.nhan_uu_tien ← Biểu thức → {{ nodes.tro_ly_ai.output.tong_gia_tri > 50000000 ? "Ưu tiên cao" : "Thường" }}

Bước Quyết định phía sau kiểm tra vars.tong_gia_tri để chọn người phê duyệt phù hợp, và bước Gửi email dùng vars.nhan_uu_tien để điền vào tiêu đề thư.

Xem thêm: Biến quy trình · Bước Quyết định · Bước Lặp theo phần tử