워크플로에서 아이템이 연결되는 방식

n8n 워크플로에서 노드 간 아이템 연결이 어떻게 동작하는지 개념적으로 설명합니다.

노드가 생성한 각 출력 아이템에는 해당 아이템을 생성하는 데 사용된 입력 아이템(또는 아이템들)을 연결하는 메타데이터가 포함됩니다. 이를 통해 이전 아이템으로 거슬러 올라갈 수 있는 아이템 체인이 형성됩니다. 특히 노드가 데이터를 분리하거나 병합하는 경우에는 이해하기 복잡할 수 있습니다. 직접 프로그래밍 방식의 노드를 개발하거나, Code 노드를 사용하는 일부 시나리오에서는 아이템 연결을 이해해야 합니다. 이 문서는 이 기능에 대한 개념적 개요를 제공합니다. 사용 방법에 대한 자세한 내용은 다음을 참조하세요: 노드 개발자를 위한 아이템 연결 : 노드 개발 시 아이템 연결을 처리하는 방법. Code 노드에서 연결 유지하기 : Code 노드에서 아이템 연결을 처리하는 방법. 아이템 연결 오류 : 에디터 UI에서 발생할 수 있는 오류 이해하기. n8n의 자동 아이템 연결 # 노드가 입력 아이템과 출력 아이템의 연결 방식을 제어하지 않는 경우, n8n은 자동으로 아이템을 연결하려고 시도합니다: 단일 입력, 단일 출력: 출력이 입력에 연결됩니다. 단일 입력, 복수 출력: 모든 출력이 해당 입력에 연결됩니다. 복수 입력과 복수 출력: 입력 아이템을 유지하되 순서를 변경하거나 일부를 제거하는 경우, n8n은 올바른 연결 아이템 정보를 자동으로 추가할 수 있습니다. 입력과 출력의 수가 같으면, n8n은 순서대로 아이템을 연결합니다. 즉, output-1은 input-1에, output-2는 input-2에 연결됩니다. 수가 같지 않거나 완전히 새로운 아이템을 생성하는 경우, n8n은 자동으로 아이템을 연결할 수 없습니다. n8n이 자동으로 아이템을 연결할 수 없고 노드가 아이템 연결을 처리하지 않으면, n8n은 오류를 표시합니다. 자세한 내용은 아이템 연결 오류 를 참조하세요. 아이템 연결 예시 # 이 예시에서는 아이템 순서가 변경되더라도 n8n이 한 노드의 아이템을 여러 단계 이전으로 연결할 수 있습니다. 이를 통해 영화를 알파벳순으로 정렬하는 노드가 유명 영화 배우를 가져오는 노드의 연결된 아이템 정보에 접근할 수 있습니다. 연결된 아이템에 접근하는 방법은 UI, 표현식, Code 노드를 사용하는지에 따라 다릅니다. 다음 리소스를 참조하세요: UI에서 매핑하기 Code 노드에서 연결 유지하기 아이템 연결 오류