항목 연결

프로그래밍 방식의 노드에만 적용

이 가이드는 프로그래밍 방식(programmatic-style)의 노드에 적용됩니다. 선언적 방식(declarative-style)을 사용하는 경우, n8n이 자동으로 paired items을 처리합니다.

n8n의 항목 연결(item linking)을 사용하면 현재 항목보다 앞에 있는 항목의 데이터를 참조할 수 있습니다. n8n은 특정 출력 항목이 어떤 입력 항목에서 생성되었는지 알아야 합니다. 이 정보가 없으면 다른 노드에서 사용되는 표현식이 올바르게 동작하지 않을 수 있습니다. 따라서 노드 개발자는 반환하는 모든 항목이 항목 연결을 지원하도록 해야 합니다.

이 개념은 프로그래밍 방식의 노드(트리거 노드를 포함)에서 적용됩니다. 하지만 선언적 방식의 노드를 개발할 때는 항목 연결을 고려할 필요가 없습니다. 노드 스타일에 대한 자세한 내용은 노드 개발 접근 방식 선택 문서를 참고하세요.

먼저 항목 연결 개념 문서를 읽어보세요. 이 문서에서는 항목 연결의 개념적 개요와 n8n이 자동으로 항목을 연결할 수 있는 시나리오를 설명합니다.

항목 연결을 수동으로 처리해야 하는 경우, 노드에서 반환하는 각 항목에 pairedItem을 설정하세요.

// 들어오는 항목의 pairedItem 정보를 사용
newItem = {
	"json": { . . . },
	"pairedItem": {
		"item": item.pairedItem,
		// 선택 사항: 사용할 입력을 지정
		// 여러 입력을 결합하는 노드의 경우 설정 필요
		"input": 0
	}
};

// 또는 인덱스를 수동으로 설정
newItem = {
	"json": { . . . },
	"pairedItem": {
		"item": i,
		// 선택 사항: 사용할 입력을 지정
		// 여러 입력을 결합하는 노드의 경우 설정 필요
		"input": 0
	}
};