Cấu hình node - JSON Variable Mapping

Node chuyển đổi cấu trúc (shape) object JSON từ dạng này sang dạng khác bằng cách ánh xạ field.

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

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
mappings	array	Có	—	Danh sách rules ánh xạ field
mappings[].source	string	Điều kiện	—	Path nguồn (biến workflow hoặc dot notation). Không cần khi type = constant
mappings[].target	string	Có	—	Tên field đích trong object kết quả
mappings[].type	string	Không	direct	Kiểu chuyển đổi: direct, template, constant
mappings[].value	any	Điều kiện	—	Giá trị cố định (bắt buộc khi type = constant)

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

Tên	Kiểu	Mô tả
result	object	Object mới theo cấu trúc đích

Chi tiết các type mapping

Type	Mô tả	Ví dụ
direct	Copy giá trị từ source path sang target	order.name -> customerName
template	Tạo giá trị bằng cách ghép nhiều biến	"ORD-" + orderId -> ref
constant	Gán giá trị cố định (bỏ qua source)	"digiforce" -> source

Ví dụ mapping rules

Source path	Target field	Type	Kết quả
order.customerName	name	direct	Copy giá trị
user.email	contact_email	direct	Rename field
—	source	constant	Luôn là "digiforce"
order.id	ref	template	"ORD-[order.id]"

Lưu ý quan trọng

• Nếu source path không tồn tại, field đích sẽ là undefined (không gây lỗi)
• Type constant bỏ qua source - luôn gán giá trị cố định cho field đích
• Type template cho phép ghép nhiều biến: "Order #[orderId] - [customerName]"
• Mapping không hỗ trợ transform kiểu dữ liệu - dùng Dynamic Calculation nếu cần chuyển đổi
• Thứ tự mapping rules quan trọng: nếu nhiều rule cùng target, rule sau ghi đè rule trước
• Phù hợp nhất khi chuẩn bị payload trước khi gửi API bên ngoài hoặc tạo audit log