Code Node 마스터하기: 데이터 처리, API 호출 및 파일 생성 - n8n 워크플로우

n8n 내에서 커스텀 JavaScript 활용을 원하는 개발자 및 기술 사용자
표준 n8n 노드만으로는 불가능한 복잡한 데이터 변환 또는 집계가 필요한 사용자
n8n 코드 노드의 다양한 실행 모드(항목별 vs. 전체 일괄)를 이해하고자 하는 자동화 전문가
커스텀 스크립팅 기술을 향상시키기 위해 n8n 템플릿을 활용하는 모든 사람

n8n 코드 노드는 플랫폼에서 가장 강력한 도구라고 할 수 있으며, 사용자가 자신의 n8n 워크플로우에 커스텀 JavaScript 로직을 직접 삽입할 수 있게 해줍니다. 이 특정 n8n 워크플로우는 코드 노드의 네 가지 핵심 사용 사례를 시연하는 실습 가이드 역할을 합니다:

1. 항목 보강: 개별 항목에 대한 새로운 필드(나이, 전체 이름 등) 계산.


2. 외부 통합: 내장 헬퍼를 사용하여 외부 API에 비동기 HTTP 요청 수행.


3. 데이터 집계: 수신된 모든 데이터 요약 (예: 평균 연령 계산).


4. 파일 생성: 집계된 JSON 입력으로부터 바이너리 데이터(CSV 보고서 등) 생성.

이 n8n 템플릿을 따라가면 사용자는 기본적인 플로우 구성에서 벗어나 강력하고 동적인 자동화를 스크립팅하는 단계로 빠르게 전환할 수 있습니다.

이 포괄적인 n8n 워크플로우는 수동 n8n 트리거(튜토리얼 시작)로 시작하여 여러 논리 단계를 거치며, 각 단계는 코드 노드의 다른 측면을 강조합니다:

1. 데이터 초기화: 1. 샘플 데이터 n8n 노드가 사용자 객체 목록을 초기화합니다. 2. 사용자 분할 n8n 노드는 각 사용자가 개별 항목이 되도록 하여 '항목별' 처리를 위해 데이터를 준비합니다.


2. 항목별 변환 (로컬): 3. 각 사용자 처리 코드 n8n 노드는 각 사용자 항목에 대해 실행됩니다. JavaScript 날짜 함수를 사용하여 사용자의 fullName과 정확한 age를 계산합니다.


3. 항목별 변환 (외부 API): 4. 외부 데이터 가져오기 (고급) 코드 n8n 노드는 항목별로 계속 실행됩니다. 사용자의 이름을 기반으로 외부 API(genderize.io)를 호출하기 위해 this.helpers.httpRequest를 사용하는 방법을 시연하여 성별 확률 정보로 데이터를 보강합니다.


4. 집계: 5. 평균 연령 계산 코드 n8n 노드는 '전체 항목 일괄 실행' 모드로 전환됩니다. $items() 함수를 사용하여 이전 단계의 모든 결과에 접근하고 총 사용자 수와 평균 연령을 포함하는 단일 요약 출력을 계산합니다. 이는 대규모 데이터셋을 다룰 때 n8n 노드의 중요한 기능입니다.


5. 파일 생성 (전문가): 마지막 6. 바이너리 파일 생성 (전문가) 코드 n8n 노드는 데이터를 다시 집계하고, CSV 문자열을 생성한 다음, this.helpers.prepareBinaryData를 사용하여 해당 문자열을 n8n 워크플로우 내에서 바로 사용할 수 있는 바이너리 보고서 파일로 변환합니다.

이 n8n 워크플로우를 설치하고 테스트하려면 다음 단계를 따르세요:

1. JSON 복사: 제공된 n8n 워크플로우 JSON 코드를 복사합니다.


2. n8n으로 가져오기: n8n 인스턴스에서 '새로 만들기'를 클릭하고 'JSON에서 가져오기'를 선택합니다. 코드를 붙여넣고 '가져오기'를 클릭합니다.


3. 로직 검토: 코드 n8n 노드에 첨부된 포스트잇 메모를 확인하여 JavaScript 코드 및 실행 모드에 대한 설명을 검토합니다.


4. 실행: 시작 n8n 트리거가 수동 트리거이므로, '워크플로우 실행'을 클릭한 다음 '튜토리얼 시작'을 클릭하여 n8n 워크플로우를 단계별로 실행합니다.


5. 출력 검사: 각 코드 n8n 노드의 출력을 확인하여 데이터 구조가 개별 항목에서 JSON 메타데이터와 바이너리 CSV 파일을 모두 포함하는 단일 집계 보고서로 어떻게 변경되는지 관찰합니다. 이 특정 n8n 템플릿은 외부 자격 증명이 필요하지 않습니다.

튜토리얼 시작 (수동 트리거): 이 n8n 워크플로우를 수동으로 실행하기 위한 시작 트리거 지점입니다.
1. 샘플 데이터 (Set n8n 노드): 튜토리얼의 입력 역할을 하는 사용자 객체 샘플 배열로 워크플로우를 초기화합니다.
2. 사용자 분할 (Split Out n8n 노드): 사용자 배열을 포함하는 단일 항목을 여러 개별 항목으로 변환하는 필수 n8n 노드로, 후속 코드 n8n 노드가 항목별로 처리할 수 있게 합니다.
3. 각 사용자 처리 (Code n8n 노드): 현재 항목에 대한 파생 데이터(fullName, age)를 계산하는 기능입니다. 주요 설정: 모드는 항목별 실행(Run Once for Each Item)으로 설정되어 있습니다.
4. 외부 데이터 가져오기 (고급) (Code n8n 노드): 현재 사용자에 대한 외부 데이터(성별 추측)를 가져오기 위해 await this.helpers.httpRequest를 사용하여 비동기 작업을 시연하는 기능입니다. 주요 설정: 모드는 항목별 실행(Run Once for Each Item)으로 설정되어 있습니다.
5. 평균 연령 계산 (Code n8n 노드): 이전 모든 항목의 데이터를 집계하는 기능입니다. $items()와 JavaScript reduce를 사용하여 평균 연령을 계산합니다. 주요 설정: 모드는 전체 항목 일괄 실행(Run Once for All Items)으로 설정되어 있습니다.

• 6. 바이너리 파일 생성 (전문가) (Code n8n 노드): 집계된 데이터로부터 CSV 보고서를 생성하고 this.helpers.prepareBinaryData를 사용하여 바이너리 파일로 변환하는 기능입니다. 주요 설정: 모드는 전체 항목 일괄 실행(Run Once for All Items)으로 설정되어 있습니다.