Biểu thức trong n8n là gì
Biểu thức n8n cho phép bạn tham chiếu dữ liệu một cách động thay vì hardcode giá trị. Khi bạn kết nối các node với nhau, dữ liệu chảy từ node này sang node kế tiếp dưới dạng các đối tượng JSON. Biểu thức cung cấp cho bạn cách để truy xuất vào JSON đó và lấy ra chính xác giá trị cần thiết — hoặc chuyển đổi nó trước khi truyền tiếp.
Mọi biểu thức trong n8n đều được bao bọc trong cặp dấu ngoặc nhọn kép. Bên trong dấu ngoặc, bạn viết mã JavaScript-compatible, và n8n sẽ đánh giá nó tại runtime khi workflow thực thi.
Biểu thức đó đọc trường email từ dữ liệu đầu vào của node hiện tại. Đơn giản, nhưng pattern này là nền tảng cho mọi thứ bạn sẽ làm với việc ánh xạ dữ liệu.
Các biến quan trọng bạn sẽ sử dụng hằng ngày
n8n cung cấp một số biến tích hợp bên trong biểu thức. Nắm được ba biến sau là đủ cho phần lớn các workflow thực tế.
Đầu tiên là $json, tham chiếu đến đối tượng dữ liệu của item hiện tại. Nếu node trước đó trả về một bản ghi người dùng, $json.name sẽ cho bạn trường tên của người dùng đó.
Thứ hai là $node, cho phép bạn truy xuất ngược về bất kỳ node nào đã được đặt tên trong workflow. Biến này hữu ích khi bạn cần dữ liệu từ một node không phải là node ngay trước đó.
Thứ ba là $now, trả về timestamp hiện tại dưới dạng đối tượng DateTime của Luxon. Bạn có thể gọi trực tiếp các phương thức của Luxon trên đó.
n8n đóng gói sẵn Luxon để thao tác ngày tháng và cũng cung cấp toàn bộ thư viện chuẩn JavaScript, vì vậy các phương thức xử lý chuỗi, Math và các tiện ích JSON đều hoạt động bên trong expression.
Chuyển đổi dữ liệu bằng Expression
Expression không chỉ dùng để đọc giá trị — bạn có thể chuyển đổi chúng ngay tại chỗ. Các pattern phổ biến bao gồm nối chuỗi, định dạng số, điều kiện và thao tác mảng.
Xây dựng họ tên đầy đủ từ hai trường:
Một điều kiện đơn giản để đặt giá trị dự phòng khi một trường có thể bị thiếu:
Định dạng ngày đang ở dạng Unix timestamp:
Node Set là nơi tự nhiên nhất để sử dụng các expression này. Hãy thêm nó vào giữa hai node bất cứ khi nào bạn cần đổi tên trường, kết hợp giá trị hoặc loại bỏ các trường không cần ở phía sau.
Mapping dữ liệu giữa các Node
Mapping dữ liệu nghĩa là kết nối output của node này với input của node khác. Trong giao diện n8n, bạn có thể kéo trực tiếp một trường vào tham số đích và n8n sẽ tự viết expression cho bạn. Nhưng hiểu được nội dung nó tạo ra sẽ giúp bạn sửa khi có lỗi xảy ra.
Khi một node trả về nhiều item, $json sẽ tham chiếu đến từng item riêng lẻ khi n8n lặp qua. Vì vậy, nếu node trước đó trả về 50 dòng, mỗi expression sẽ được đánh giá 50 lần — một lần cho mỗi item. Đây là hành vi mặc định và không yêu cầu cấu hình thêm.
Nếu bạn cần gộp tất cả các mục vào một cấu trúc duy nhất — ví dụ, để tạo một mảng email từ tất cả các dòng — hãy dùng node Code với $input.all().
Node Code chạy toàn bộ JavaScript và là công cụ phù hợp khi một biểu thức bên trong tham số trường trở nên quá phức tạp để đọc.
Những lỗi thường gặp và cách tránh
Lỗi thường xuyên nhất là tham chiếu đến một trường không tồn tại, dẫn đến trả về undefined và có thể âm thầm làm hỏng các node phía sau. Luôn sử dụng bảng xem trước (preview) của trình chỉnh sửa biểu thức — nó hiển thị giá trị đã được xử lý trước khi bạn lưu.
Một lỗi phổ biến thứ hai là quên rằng $json đề cập đến đầu vào của node hiện tại, chứ không phải đầu ra của nó. Nếu bạn đang ở trong một node Set và muốn lấy dữ liệu từ hai bước trước, hãy dùng $node["NodeName"].json thay thế.
Lỗi thứ ba là xử lý $now như một chuỗi thông thường. Thực tế đây là một đối tượng Luxon, nên việc so sánh trực tiếp nó với một chuỗi ngày tháng sẽ không hoạt động. Hãy chuyển đổi cả hai về cùng một kiểu dữ liệu trước.
Tóm tắt
Biểu thức chính là cách các workflow n8n trở nên linh hoạt. Mẫu cốt lõi — hai dấu ngoặc nhọn bao quanh một biểu thức JavaScript đọc từ $json, $node, hoặc $now — xử lý được hầu hết các tình huống. Sử dụng node Set cho việc ánh xạ và đổi tên trường đơn giản, và chuyển sang node Code khi logic trở nên phức tạp. Luôn kiểm tra biểu thức trong bảng xem trước trước khi chạy workflow thực tế.
Bài kiểm tra cuối bài
Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.