사용자 지정 코드를 사용한 다중 바이너리 파일의 Base64 인코딩 - n8n 워크플로우

Base64 인코딩을 엄격하게 요구하는 API에 여러 파일을 업로드해야 하는 개발자.
표준 n8n 노드 이상의 고급 바이너리 파일 조작이 필요한 n8n 사용자.
파일 변환 작업을 위한 강력한 n8n 템플릿을 찾는 자동화 전문가.
데이터 처리를 위해 n8n 코드 노드의 기능을 활용하는 데 관심이 있는 모든 사람.

이 특화된 n8n 워크플로우 템플릿은 일반적인 통합 문제를 해결합니다: 압축된 보관소에 포함된 여러 바이너리 파일을 처리하고 API 소비를 위해 Base64 문자열로 변환하는 것입니다. 표준 n8n 노드는 단일 파일 Base64 인코딩은 잘 처리하지만, 일괄 처리는 사용자 지정 로직이 필요합니다. 이 n8n 워크플로우는 파일 다운로드, 압축 해제, 그리고 추출된 바이너리를 반복하고 필요한 인코딩을 수행하기 위해 JavaScript를 실행하는 정교하게 제작된 n8n 노드를 결합하여 강력한 솔루션을 제공합니다. 압축된 데이터를 자주 다루고 콘텐츠를 효율적으로 변환해야 한다면 이 n8n 템플릿은 여러분의 툴킷에 필수적입니다.

전체 프로세스는 간단한 수동 n8n 트리거로 시작되어 테스트 및 배포가 용이합니다.

1. 시작: '워크플로우 실행' 버튼 클릭 시 n8n 트리거가 자동화 실행을 시작합니다.


2. 다운로드: HTTP 요청 n8n 노드가 처리할 샘플 ZIP 파일을 다운로드합니다.


3. 압축 해제: 후속 압축 해제(Unzip) n8n 노드가 다운로드한 바이너리 파일을 자동으로 처리하여 내용을 풀고, 내부에서 발견된 각 파일에 대해 별도의 항목을 출력하며, 각 항목에 고유한 바이너리 속성을 부여합니다.


4. 인코딩 (사용자 지정 코드): 핵심 기능은 'base64로 인코딩' 코드 n8n 노드에 있습니다. 이 노드는 사용자 지정 JavaScript를 사용하여 압축 해제 n8n 노드가 생성한 여러 바이너리 항목을 반복합니다. 각 항목에 대해 내장된 this.helpers.getBinaryDataBuffer 함수를 사용하여 파일 데이터를 버퍼로 안전하게 검색합니다. 이 버퍼는 Base64 문자열로 변환되며, 결과는 후속 n8n 노드에서 사용하기 쉽도록 깔끔하게 구조화되어 파일 경로와 인코딩된 데이터를 제공합니다.

이 강력한 n8n 워크플로우 템플릿을 사용하려면 다음 단계를 따르세요:

1. 가져오기: 제공된 JSON 데이터를 복사하여 n8n 인스턴스로 이동합니다.


2. '새로 만들기'를 클릭한 다음 'JSON에서 가져오기'를 클릭하고 코드를 붙여넣습니다.


3. 자격 증명 불필요: 이 특정 n8n 워크플로우는 공개 URL과 내부 n8n 노드(HTTP 요청, 코드, 수동 트리거)를 사용하므로 외부 자격 증명이 필요하지 않습니다.


4. 실행: '워크플로우 실행' n8n 트리거 버튼을 클릭하여 프로세스를 즉시 테스트합니다.


5. 사용자 지정: 'n8n 데모 웹사이트 zip 다운로드' n8n 노드를 수정하여 특정 ZIP 파일 소스 URL을 가리키도록 하여 n8n 워크플로우를 필요에 맞게 조정합니다. 대상 API가 다른 출력 구조를 요구하는 경우, 코드 n8n 노드 내의 JavaScript를 적절히 조정하십시오.

이 n8n 워크플로우는 파일 처리 및 변환을 위해 다음 세 가지 주요 n8n 노드에 의존합니다:

'워크플로우 실행' 클릭 시 (수동 트리거 n8n 트리거)
기능: 주문형 n8n 워크플로우의 시작점 역할을 합니다.
주요 구성: 간단한 수동 n8n 트리거 역할을 하므로 구성이 필요하지 않습니다.

n8n 데모 웹사이트 zip 다운로드 (HTTP 요청 n8n 노드)
기능: 원격 GitHub 리포지토리에서 소스 ZIP 파일을 다운로드합니다. 이는 처리에 필요한 바이너리 데이터를 제공합니다.
주요 구성: 응답 형식은 file로 설정되어 데이터를 바이너리로 처리하도록 하는 것이 중요합니다. URL은 https://github.com/n8n-io/n8n-demo-website/archive/refs/heads/main.zip으로 설정됩니다.

압축 해제 (Compression n8n 노드)
기능: 다운로드한 ZIP 파일을 압축 해제합니다. 이는 하나의 입력 항목(ZIP)을 여러 출력 항목(ZIP 내부의 파일)으로 변환하여 다음 n8n 노드에서 일괄 처리할 준비를 하므로 매우 중요합니다.
주요 구성: 압축 해제를 위해 기본 설정을 사용합니다.

base64로 인코딩 (Code n8n 노드)
기능: 압축 해제 n8n 노드가 생성한 모든 바이너리 파일을 반복합니다. 사용자 지정 JavaScript와 n8n 도우미(this.helpers.getBinaryDataBuffer)를 사용하여 각 파일의 원시 버퍼를 검색한 다음 해당 버퍼를 Base64 문자열로 변환하여 결과를 구조화된 JSON 배열로 컴파일합니다.
주요 구성: n8n 워크플로우 내 단일 단계에서 여러 바이너리 파일을 효율적으로 처리하도록 보장하는 Base64 인코딩을 위한 사용자 지정 로직을 포함합니다.