노드가 생성한 각 출력 아이템에는 해당 아이템을 생성하는 데 사용된 입력 아이템(또는 아이템들)을 연결하는 메타데이터가 포함됩니다. 이를 통해 이전 아이템으로 거슬러 올라갈 수 있는 아이템 체인이 형성됩니다. 특히 노드가 데이터를 분리하거나 병합하는 경우에는 이해하기 복잡할 수 있습니다. 직접 프로그래밍 방식의 노드를 개발하거나, Code 노드를 사용하는 일부 시나리오에서는 아이템 연결을 이해해야 합니다.

이 문서는 이 기능에 대한 개념적 개요를 제공합니다. 사용 방법에 대한 자세한 내용은 다음을 참조하세요:

• 노드 개발자를 위한 아이템 연결: 노드 개발 시 아이템 연결을 처리하는 방법.
• Code 노드에서 연결 유지하기: Code 노드에서 아이템 연결을 처리하는 방법.
• 아이템 연결 오류: 에디터 UI에서 발생할 수 있는 오류 이해하기.

n8n의 자동 아이템 연결#

노드가 입력 아이템과 출력 아이템의 연결 방식을 제어하지 않는 경우, n8n은 자동으로 아이템을 연결하려고 시도합니다:

• 단일 입력, 단일 출력: 출력이 입력에 연결됩니다.
• 단일 입력, 복수 출력: 모든 출력이 해당 입력에 연결됩니다.
• 복수 입력과 복수 출력:
  • 입력 아이템을 유지하되 순서를 변경하거나 일부를 제거하는 경우, n8n은 올바른 연결 아이템 정보를 자동으로 추가할 수 있습니다.
  • 입력과 출력의 수가 같으면, n8n은 순서대로 아이템을 연결합니다. 즉, output-1은 input-1에, output-2는 input-2에 연결됩니다.
  • 수가 같지 않거나 완전히 새로운 아이템을 생성하는 경우, n8n은 자동으로 아이템을 연결할 수 없습니다.

n8n이 자동으로 아이템을 연결할 수 없고 노드가 아이템 연결을 처리하지 않으면, n8n은 오류를 표시합니다. 자세한 내용은 아이템 연결 오류를 참조하세요.

아이템 연결 예시#

이 예시에서는 아이템 순서가 변경되더라도 n8n이 한 노드의 아이템을 여러 단계 이전으로 연결할 수 있습니다. 이를 통해 영화를 알파벳순으로 정렬하는 노드가 유명 영화 배우를 가져오는 노드의 연결된 아이템 정보에 접근할 수 있습니다.

연결된 아이템에 접근하는 방법은 UI, 표현식, Code 노드를 사용하는지에 따라 다릅니다. 다음 리소스를 참조하세요:

• UI에서 매핑하기
• Code 노드에서 연결 유지하기
• 아이템 연결 오류