Đặt biến (Set variable)

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).

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}

Mẹo

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ệ.

Ghi chú

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:

1. vars.tong_gia_tri ← Tham chiếu → nodes.tro_ly_ai.output.tong_gia_tri
2. 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ử