Làm Chủ Nút Code n8n: Xử Lý Dữ Liệu, Gọi API và Tạo File - Quy trình làm việc n8n

Các nhà phát triển và người dùng kỹ thuật muốn tận dụng JavaScript tùy chỉnh trong n8n.
Người dùng cần thực hiện các phép biến đổi hoặc tổng hợp dữ liệu phức tạp mà các nút n8n tiêu chuẩn không thể làm được.
Chuyên gia tự động hóa muốn tìm hiểu các chế độ thực thi khác nhau của nút Code n8n (Chạy cho Từng Mục so với Chạy một Lần cho Tất Cả).
Bất kỳ ai sử dụng các mẫu n8n để nâng cao kỹ năng viết kịch bản (scripting) tùy chỉnh của mình.

Nút Code n8n có thể được xem là công cụ mạnh mẽ nhất trên nền tảng này, cho phép người dùng chèn logic JavaScript tùy chỉnh trực tiếp vào luồng công việc n8n của họ. Luồng công việc n8n cụ thể này đóng vai trò là hướng dẫn thực hành, minh họa bốn trường hợp sử dụng quan trọng của nút Code n8n:

1. Làm giàu Dữ liệu (Item Enrichment): Tính toán các trường mới (như tuổi và họ tên đầy đủ) cho từng mục dữ liệu.


2. Tích hợp Bên ngoài: Thực hiện các yêu cầu HTTP bất đồng bộ tới API bên ngoài bằng cách sử dụng các hàm trợ giúp tích hợp sẵn.


3. Tổng hợp Dữ liệu: Tóm tắt tất cả dữ liệu đầu vào (ví dụ: tính tuổi trung bình).


4. Tạo Tệp: Tạo dữ liệu nhị phân (như báo cáo CSV) từ dữ liệu JSON tổng hợp đầu vào.

Bằng cách làm theo mẫu n8n này, người dùng có thể nhanh chóng chuyển từ việc xây dựng luồng cơ bản sang viết các kịch bản tự động hóa mạnh mẽ và linh hoạt.

Luồng công việc n8n toàn diện này bắt đầu bằng một kích hoạt thủ công của n8n (Bắt đầu Hướng dẫn) và tiến hành qua nhiều giai đoạn logic, mỗi giai đoạn làm nổi bật một khía cạnh khác nhau của nút Code n8n:

1. Khởi tạo Dữ liệu: Nút n8n 1. Dữ liệu Mẫu khởi tạo một danh sách các đối tượng người dùng. Nút n8n 2. Tách Người dùng đảm bảo rằng mỗi người dùng trở thành một mục riêng lẻ, chuẩn bị dữ liệu cho quá trình xử lý theo 'Từng Mục' (Per Item).


2. Biến đổi Trên Từng Mục (Cục bộ): Nút Code n8n 3. Xử Lý Từng Người Dùng chạy cho mỗi mục người dùng. Nó tính toán họTênĐầyĐủ và tuổi chính xác của người dùng bằng cách sử dụng các hàm ngày tháng của JavaScript.


3. Biến đổi Trên Từng Mục (API Bên ngoài): Nút Code n8n 4. Lấy Dữ liệu Bên ngoài (Nâng cao) tiếp tục chạy trên từng mục. Nó minh họa cách sử dụng this.helpers.httpRequest để gọi một API bên ngoài (genderize.io) dựa trên tên người dùng, làm giàu dữ liệu bằng xác suất giới tính.


4. Tổng hợp: Nút Code n8n 5. Tính Tuổi Trung Bình chuyển sang chế độ 'Chạy Một Lần Cho Tất Cả Các Mục' (Run Once for All Items). Nó sử dụng hàm $items() để truy cập tất cả các kết quả từ các bước trước và tính toán một đầu ra tóm tắt duy nhất chứa tổng số người dùng và tuổi trung bình. Đây là chức năng quan trọng của nút n8n khi xử lý các tập dữ liệu lớn.


5. Tạo Tệp (Chuyên gia): Nút Code n8n cuối cùng 6. Tạo Tệp Nhị Phân (Chuyên gia) tổng hợp dữ liệu một lần nữa, tạo ra một chuỗi CSV và sử dụng this.helpers.prepareBinaryData để chuyển đổi chuỗi đó thành một tệp báo cáo nhị phân sẵn sàng sử dụng trong luồng công việc n8n.

Để cài đặt và kiểm tra luồng công việc n8n này, vui lòng làm theo các bước sau:

1. Sao chép JSON: Sao chép mã JSON luồng công việc n8n được cung cấp.


2. Nhập vào n8n: Trong phiên bản n8n của bạn, nhấp vào 'Mới' (New) và chọn 'Nhập từ JSON' (Import from JSON). Dán mã và nhấp vào 'Nhập' (Import).


3. Xem xét Logic: Xem các ghi chú dán (sticky notes) đính kèm trên các nút Code n8n để biết giải thích về mã JavaScript và các chế độ thực thi.


4. Thực thi: Vì trình kích hoạt n8n ban đầu là Kích hoạt Thủ công (Manual Trigger), hãy nhấp vào 'Chạy Luồng Công Việc' (Run Workflow) và sau đó nhấp vào 'Bắt đầu Hướng dẫn' (Start Tutorial) để thực thi luồng công việc n8n từng bước một.


5. Kiểm tra Đầu ra: Kiểm tra đầu ra của từng nút Code n8n để quan sát cách cấu trúc dữ liệu thay đổi, từ các mục riêng lẻ đến một báo cáo tổng hợp duy nhất chứa cả siêu dữ liệu JSON và tệp CSV nhị phân. Không yêu cầu thông tin xác thực bên ngoài cho mẫu n8n cụ thể này.

Bắt đầu Hướng dẫn (Kích hoạt Thủ công): Điểm kích hoạt n8n ban đầu để chạy luồng công việc n8n này một cách thủ công.
1. Dữ liệu Mẫu (Nút Set n8n): Khởi tạo luồng công việc với một mảng đối tượng người dùng mẫu, đóng vai trò là đầu vào cho hướng dẫn.
2. Tách Người dùng (Nút Split Out n8n): Nút n8n thiết yếu chuyển đổi mục duy nhất chứa mảng người dùng thành nhiều mục riêng lẻ, cho phép các nút Code n8n tiếp theo xử lý chúng lần lượt từng cái một.
3. Xử Lý Từng Người Dùng (Nút Code n8n): Chức năng là tính toán dữ liệu dẫn xuất (họTênĐầyĐủ, tuổi) cho mục hiện tại. Cấu hình chính: Chế độ được đặt thành Chạy Một Lần Cho Mỗi Mục (Run Once for Each Item).
4. Lấy Dữ liệu Bên ngoài (Nâng cao) (Nút Code n8n): Chức năng là minh họa các hoạt động bất đồng bộ bằng cách sử dụng await this.helpers.httpRequest để lấy dữ liệu bên ngoài (dự đoán giới tính) cho người dùng hiện tại. Cấu hình chính: Chế độ được đặt thành Chạy Một Lần Cho Mỗi Mục (Run Once for Each Item).
5. Tính Tuổi Trung Bình (Nút Code n8n): Chức năng là tổng hợp dữ liệu từ tất cả các mục trước đó. Nó sử dụng $items() và reduce của JavaScript để tính toán tuổi trung bình. Cấu hình chính: Chế độ được đặt thành Chạy Một Lần Cho Tất Cả Các Mục (Run Once for All Items).

• 6. Tạo Tệp Nhị Phân (Chuyên gia) (Nút Code n8n): Chức năng là tạo báo cáo CSV từ dữ liệu tổng hợp và chuyển đổi nó thành tệp nhị phân bằng cách sử dụng this.helpers.prepareBinaryData. Cấu hình chính: Chế độ được đặt thành Chạy Một Lần Cho Tất Cả Các Mục (Run Once for All Items).