Code 노드의 itemMatching()을 사용한 데이터 복원 - n8n 워크플로우

이 자동화는 다음 사용자에게 이상적입니다:
고급 스크립팅 기술을 배우는 n8n 개발자.
복잡한 n8n 워크플로우 전반에서 데이터 계보(Data Lineage)를 보존할 안정적인 방법이 필요한 사용자.
데이터 상관관계를 위해 아이템 인덱스를 유지해야 하는 모듈형 n8n 템플릿을 구축하는 엔지니어.
n8n 실행 컨텍스트 내 데이터 조작에 대한 더 깊은 이해를 원하는 모든 사람

복잡한 n8n 워크플로우를 구축할 때 데이터 스트림을 변환하거나 필터링해야 하는 경우가 많으며, 이 과정에서 때때로 원본 필드(이메일 또는 ID 등)가 일시적으로 손실될 수 있습니다. 이 특정 n8n 워크플로우는 Code n8n 노드에서 사용할 수 있는 내장 함수인 itemMatching()을 사용하여 강력한 해결책을 제공합니다.

이 n8n 자동화의 가치는 데이터 무결성을 보장하는 데 있습니다. 초기 데이터가 생성된 후 공격적으로 데이터를 정리하고(이름만 유지), 마지막으로 아이템 인덱스 상관관계를 사용하여 원본 이메일 주소를 정확하게 검색하고 복원하는 시나리오를 시뮬레이션합니다. 이 접근 방식은 고급 데이터 조작에 필수적이며, n8n 워크플로우의 여러 단계에 걸쳐 데이터 아이템을 연결하기 위해 n8n 스크립팅 환경에서 사용할 수 있는 가장 강력한 기능 중 하나를 보여줍니다.

이 n8n 워크플로우는 네 가지 뚜렷한 단계로 작동합니다:

1. 초기화 (수동 트리거): 사용자가 '워크플로우 실행'을 클릭하면 n8n 트리거가 프로세스를 시작합니다.


2. 데이터 생성: Customer Datastore (n8n training) n8n 노드가 이름과 이메일 주소를 포함한 샘플 고객 레코드 목록을 생성합니다. 이를 통해 초기 데이터 스트림이 설정됩니다.


3. 데이터 축소: Edit Fields (Set) n8n 노드는 의도적으로 고객 이름을 제외한 모든 필드를 제거합니다. 이는 데이터가 간소화되고 원본 컨텍스트가 사라진 것처럼 보이는 일반적인 시나리오를 시뮬레이션합니다.


4. 데이터 복원 (Code 노드): 마지막 n8n 노드인 Python Code 노드가 핵심 로직을 실행합니다. 축소된 데이터 아이템들을 순회합니다. 각 아이템에 대해 itemMatching(i) 메서드를 사용하여 'Customer Datastore' n8n 노드에서 나온 원본 데이터를 참조하고, 인덱스 i를 기반으로 해당하는 이메일 주소를 가져옵니다. 그런 다음 검색된 이메일은 restoreEmail이라는 새 필드 아래에 현재 아이템에 다시 추가됩니다. 이 강력한 기술은 n8n 워크플로우 전반에 걸쳐 데이터 일관성을 보장합니다.

이 n8n 템플릿을 배포하려면 다음 단계를 따르십시오:

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


2. n8n 인스턴스를 열고 'Workflows' 섹션으로 이동합니다.


3. 'New' 또는 'Import from JSON'을 클릭하고 코드를 붙여넣습니다.


4. 실행: 이 n8n 워크플로우는 수동 n8n 트리거와 목업 데이터 노드(교육 목적)를 사용하므로 외부 인증 정보가 필요하지 않습니다.


5. 'When clicking "Execute Workflow"' n8n 노드에서 'Execute Workflow' 버튼을 클릭하여 아이템 매칭 로직이 실행되는 것을 확인하십시오. 최종 Code n8n 노드의 출력을 검토하여 이메일 주소가 성공적으로 복원되었는지 확인하십시오.

이 n8n 워크플로우는 다음과 같은 주요 n8n 노드 유형을 활용합니다:

When clicking "Execute Workflow" (수동 트리거):
기능: 테스트 및 개발을 위한 시작 n8n 트리거 역할을 합니다.
주요 설정: 구성이 필요 없습니다. 요청 시 n8n 워크플로우를 시작합니다.

Customer Datastore (n8n training):
기능: 소스 데이터 스트림을 제공하기 위해 샘플 데이터(이름과 이메일을 가진 고객)를 생성합니다.
주요 설정: 작업(Operation)은 getAllPeople로 설정되고 returnAll이 체크됩니다.

Edit Fields (Set):
기능: 이 n8n 노드는 데이터 변환을 수행하여 수신되는 아이템을 'name' 필드만 유지하도록 축소합니다. 이는 우리가 수정하려는 데이터 손실 시나리오를 시뮬레이션합니다.
주요 설정: name 필드만 포함하며, 다른 모든 필드를 삭제하기 위해 입력 옵션을 none으로 설정합니다.

Code (Python):
기능: itemMatching() 메서드가 사용되는 중요한 n8n 노드입니다. 현재 아이템 인덱스를 'Customer Datastore'의 원본 인덱스와 상관시켜 원본 이메일을 가져옵니다.
주요 설정: 다음 Python 로직을 사용합니다:

for i,item in enumerate(input.all()):
          input.all()[i].json.restoreEmail = ('Customer Datastore (n8n training)').itemMatching(i).json.email
        return input.all();