n8n 1.97.0 버전부터 지원되는 서브 워크플로우 전환 기능을 사용할 때, 데이터 타입의 수동 설정, AI 노드 중복 생성, 실행 순서의 v1 기본 적용 및 접근 함수(first, last, all)의 변수명 변화를 확인해야 합니다.
서브 워크플로우 전환 시 기본 요구 사항
서브 워크플로우 전환 기능은 n8n 1.97.0 버전부터 사용할 수 있습니다.
설명 도해 · 하루보탬 Studio
설명 도해 · 하루보탬 Studio
데이터 타입 및 입력/출력 제약
서브 워크플로우의 입력과 출력은 기본적으로 모든 타입을 허용합니다.
설명 도해 · 하루보탬 Studio
데이터 타입 제약을 수동으로 설정해야 하는 노드 위치
데이터 무결성을 위해 필요한 경우 Execute Sub-workflow Trigger 노드와 Edit Fields (set) 노드에서 입력 및 출력의 타입 제약을 수동으로 설정할 수 있습니다.
실행 순서의 변경 사항
새로운 워크플로우는 부모 워크플로우의 설정과 관계없이 v1 실행 순서를 기본으로 적용합니다.
실행 순서 설정 변경 방법
기본으로 적용되는 v1 실행 순서를 이전 설정으로 되돌리려면 설정 메뉴에서 이를 변경할 수 있습니다.
AI 노드 및 특수 함수 호환성 주의사항
AI 도구와 같은 서브 노드를 처리할 때, 전환 전에 해당 노드들을 모두 선택해야 합니다.
설명 도해 · 하루보탬 Studio
설명 도해 · 하루보탬 Studio
AI 에이전트 공유 노드 처리
여러 AI 에이전트와 공유되는 노드가 있는 경우, 전환 전에 해당 노드들을 복제해야 할 수도 있습니다.
접근 함수 사용 시 변수명 변화
first(), last(), all()과 같은 접근 함수를 사용하는 표현식은 서브 워크플로우 문맥으로 전환될 때 변수명이 변할 수 있습니다.
변수 접미사 확인
n8n은 원본 표현의 정보를 유지하기 위해 변수명에 _firstItem, _lastItem, _allItems와 같은 접미사를 추가합니다.
itemMatching 함수 사용 조건
itemMatching 함수를 사용할 때 인덱스 값으로 표현식을 사용할 수 없으며, 반드시 고정된 숫자를 입력해야 합니다.
적용 조건과 확인 범위
- 공식 문서의 처리 단위·지원 조건·실행 순서·제한을 유지한다.
- 실제 업무 실행·비용·성능·절감 효과를 검증했다고 주장하지 않는다.
- n8n 버전 1.97.0 이상부터 지원
- 서브 워크플로우 내 Execute Sub-workflow Trigger 및 Edit Fields (set) 노드에서 타입 설정
- AI 에이전트 공유 노드 중복 생성 필요성
- v1 실행 순서 기본 적용 및 설정 변경 가능성
- accessor 함수 사용 시 변수 접미사(_firstItem, _lastItem, _allItems) 확인
확인일: 2026-09-23T15:00:45.974986+00:00