아이템 연결 개념#

노드에 의해 생성된 각 출력 아이템은 노드가 이를 생성하는 데 사용한 입력 아이템(또는 아이템)과 연결된 메타데이터를 포함합니다. 이렇게 하면 이전 아이템에 접근하기 위해 작업할 수 있는 아이템 체인이 생성됩니다. 이는 특히 노드가 데이터를 분할하거나 병합하는 경우 이해하기 복잡할 수 있습니다. 프로그램적 노드를 구축할 때 또는 코드 노드를 사용하는 일부 시나리오에서 아이템 연결을 이해해야 합니다.

이 문서는 이 기능에 대한 개념적 개요를 제공합니다. 사용 세부정보는 다음을 참조하세요:

노드 구축 시 아이템 연결을 처리하는 방법에 대한 세부정보는 노드 제작자를 위한 아이템 연결을 확인하세요.
코드 노드에서 아이템 연결을 처리하는 방법에 대해 알아보려면 코드 노드에서의 아이템 연결을 참조하세요.
에디터 UI에서 발생할 수 있는 오류를 이해하려면 아이템 연결 오류를 확인하세요.

n8n의 자동 아이템 연결#

노드가 입력 아이템과 출력 아이템을 연결하는 방법을 제어하지 않으면 n8n은 아이템을 자동으로 연결하는 방법을 추측하려고 시도합니다:

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

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

아이템 연결 예시#

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

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