하위 워크플로우 변환#

기능 가용성

n8n 버전 1.97.0부터 모든 플랜에서 사용 가능합니다.

하위 워크플로우 변환을 사용하여 워크플로우를 재사용 가능한 부분으로 리팩터링합니다. 다른 노드를 참조하는 표현식은 자동으로 업데이트되고 워크플로우 실행 트리거 노드에 매개변수로 추가됩니다.

개념에 대한 일반적인 소개는 하위 워크플로우를 참조하십시오.

하위 워크플로우용 노드 선택#

워크플로우의 일부를 하위 워크플로우로 변환하려면 변환하려는 원본 워크플로우의 노드를 선택해야 합니다.

유효한 노드 그룹을 선택하여 이 작업을 수행합니다. 선택은 연속적이어야 하며 최대 하나의 시작 노드와 하나의 끝 노드에서 나머지 워크플로우에 연결되어야 합니다. 선택은 다음 조건을 충족해야 합니다.

트리거 노드를 포함해서는 안 됩니다.
선택 항목의 단일 노드만 선택 항목 외부의 노드에서 들어오는 연결을 가질 수 있습니다.
- 해당 노드는 여러 개의 들어오는 연결을 가질 수 있지만 단일 입력 분기만 가질 수 있습니다(예를 들어 병합 노드가 될 수 없음을 의미함).
- 해당 노드는 선택 항목의 다른 노드에서 들어오는 연결을 가질 수 없습니다.
선택 항목의 단일 노드만 선택 항목 외부의 노드로 나가는 연결을 가질 수 있습니다.
- 해당 노드는 여러 개의 나가는 연결을 가질 수 있지만 단일 출력 분기만 가질 수 있습니다(예를 들어 If 노드가 될 수 없음).
- 해당 노드는 선택 항목의 다른 노드로 나가는 연결을 가질 수 없습니다.
선택 항목에는 입력 및 출력 노드 사이의 모든 노드가 포함되어야 합니다.

워크플로우의 일부를 하위 워크플로우로 변환하는 방법#

캔버스에서 원하는 노드를 선택합니다. 캔버스 배경을 마우스 오른쪽 버튼으로 클릭하고 하위 워크플로우로 변환을 선택합니다.

염두에 두어야 할 사항#

대부분의 하위 워크플로우 변환은 문제 없이 작동하지만 염두에 두어야 할 몇 가지 주의 사항과 제한 사항이 있습니다.

입력 및 출력에 대한 유형 제약 조건을 수동으로 설정해야 합니다: 기본적으로 하위 워크플로우 입력 및 출력은 모든 유형을 허용합니다. 하위 워크플로우의 하위 워크플로우 실행 트리거 노드 및 필드 편집(설정) 노드에서 예상 유형을 설정할 수 있습니다(레이블은 반환이며 하위 워크플로우에 출력이 있는 경우에만 포함됨).
AI 노드에 대한 제한된 지원: AI 도구와 같은 하위 노드를 처리할 때 모두 선택해야 하며 변환 전에 다른 AI 에이전트와 공유된 모든 노드를 복제해야 할 수 있습니다.
v1 실행 순서 사용: 새 워크플로우는 상위 워크플로우의 설정에 관계없이 v1 실행 순서를 사용합니다. 설정에서 다시 변경할 수 있습니다.
first(), last() 및 all()과 같은 접근자 함수에는 추가적인 주의가 필요합니다: 이러한 함수를 사용하는 표현식은 항상 하위 워크플로우 컨텍스트로 깔끔하게 변환되지 않습니다. n8n은 기능을 보존하기 위해 변환을 시도할 수 있지만 새 컨텍스트에서 의도한 대로 작동하는지 확인해야 합니다.

하위 노드 매개변수 접미사

n8n은 이러한 함수에서 액세스하는 변수 이름에 _firstItem, _lastItem 및 _allItems와 같은 접미사를 추가합니다. 이는 항목 순서가 하위 워크플로우 컨텍스트에서 다를 수 있으므로 원래 표현식에 대한 정보를 보존하는 데 도움이 됩니다.

itemMatching 함수에는 고정된 인덱스가 필요합니다: itemMatching 함수를 사용할 때 인덱스 값에 표현식을 사용할 수 없습니다. 고정된 숫자를 전달해야 합니다.