데이터 아이템 연결하기

아이템(item) 은 데이터 한 조각이에요. 노드는 아이템을 하나 이상 받아서 처리한 뒤 새 아이템을 출력해요. 그리고 각 아이템은 자신을 만들어낸 이전 노드의 아이템으로 연결돼요.

보통은 이 연결이 자동으로 잘 동작해서 신경 쓸 필요가 없어요. 다만 다음 상황에서는 이 동작을 자세히 이해해야 해요.

Code 노드에서 입력·출력 데이터를 다루는 복잡한 동작을 만들 때
프로그램 방식(programmatic-style) 노드를 직접 만들 때

이 섹션에서는 다음 내용을 다뤄요.

아이템이 워크플로에서 어떻게 연결되는지에 대한 개념 개요
노드 제작자를 위한 아이템 연결에 대한 정보
Code 노드를 쓸 때 이전 노드의 아이템 데이터를 가져오고, 아이템을 연결하기 위해 데이터 경로로 작업하는 방법을 알아야 하는 최종 사용자를 위한 지원
오류 트러블슈팅 가이드

핵심만 짚으면 이래요. 아이템 연결이 필요한 이유는 '이 결과가 어떤 입력에서 왔는지'를 n8n이 계속 추적하기 때문이에요. 분기·병합·반복을 거치며 데이터가 여러 갈래로 나뉘거나 합쳐져도, 특정 출력 아이템이 정확히 어떤 원본 아이템에서 나왔는지 알고 싶을 때 이 연결이 기준이 돼요. 특히 Code 노드에서 여러 아이템을 맘대로 엮을 때 이 연결을 유지하지 않으면 뒤에서 참조가 꼬일 수 있어요.