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

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

• 노드 제작자를 위한 아이템 링킹: 노드를 빌드할 때 아이템 링킹을 처리하는 방법에 대한 세부 정보를 다룹니다.
• Code node에서 링킹 보존하기: Code node에서 아이템 링킹을 처리하는 방법을 배웁니다.
• 아이템 링킹 오류: 편집기 UI에서 발생할 수 있는 오류를 이해합니다.

n8n의 자동 아이템 링킹#

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

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

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

아이템 링킹 예시#

이 예시에서는 아이템 순서가 변경되었음에도 불구하고 n8n이 한 노드의 아이템을 여러 단계 이전까지 거슬러 연결하는 것이 가능합니다. 즉, 영화를 알파벳순으로 정렬하는 노드가 유명 영화배우를 가져오는 노드의 연결된 아이템에 대한 정보에 접근할 수 있습니다.

연결된 아이템에 접근하는 방법은 UI, 표현식, 또는 Code node 중 무엇을 사용하는지에 따라 다릅니다. 다음 리소스를 살펴보세요.

• UI에서 매핑하기
• Code node에서 링킹 보존하기
• 아이템 링킹 오류