Loop Over Items (반복) 노드 가이드

배열 데이터의 각 아이템을 순차적으로 반복 처리하는 노드입니다. 배열 필드를 지정하면 각 아이템을 하나씩 loop 출력으로 보내고, 모든 아이템의 처리가 완료되면 수집된 결과를 done 출력으로 전달합니다.

주요 기능

• 배열 데이터를 개별 아이템으로 분리하여 순차 처리

• 중첩 객체 내 배열 필드 접근 (dot notation)

• 각 아이템에 인덱스 정보 자동 추가 가능

• 루프 완료 후 수집된 결과를 한꺼번에 전달

• 실행 단위별 루프 상태 격리 (동시 실행 안전)

출력 구조

설정 항목

아이템 처리 옵션

사용 예시

배열 필드 반복 처리

주문 데이터에 포함된 items 배열의 각 상품을 개별 처리합니다.

입력 데이터:

{
  "orderId": "ORD-001",
  "items": [
    { "name": "상품A", "price": 10000 },
    { "name": "상품B", "price": 20000 }
  ]
}

설정:

• 배열 필드: items

• 각 아이템 처리: 각 아이템을 개별 출력

loop 출력 (순차적으로):

1. { "name": "상품A", "price": 10000 }

2. { "name": "상품B", "price": 20000 }

중첩 배열 접근

data.results 경로의 배열을 반복 처리합니다.

설정:

• 배열 필드: data.results

인덱스 추가 모드

각 아이템에 순번을 추가합니다.

설정:

• 배열 필드: items

• 각 아이템 처리: 인덱스 추가

• 인덱스 필드명: _index

loop 출력:

1. { "name": "상품A", "price": 10000, "_index": 0 }

2. { "name": "상품B", "price": 20000, "_index": 1 }

루프 내 처리 워크플로우 구성

[데이터 조회] → [Loop Over Items] → (loop) → [개별 처리 노드] → [Loop Over Items로 복귀]
                                   → (done) → [결과 집계 노드]

loop 출력에 연결된 노드의 결과는 다시 Loop Over Items 노드로 돌아와 다음 아이템을 처리합니다. 모든 아이템이 처리되면 done 출력으로 결과가 전달됩니다.

참고 사항

• 배열 필드를 비워두면 입력 아이템 자체가 하나의 배열 요소로 처리됩니다.

• 지정한 필드가 배열이 아닌 경우 오류가 발생합니다.

• 빈 배열이 입력되면 루프를 건너뛰고 즉시 done 출력으로 전달됩니다.

• 동일한 워크플로우가 동시에 여러 번 실행되더라도 각 실행의 루프 상태는 독립적으로 관리됩니다.

• loop 출력에 연결된 마지막 노드의 출력을 다시 Loop Over Items 노드의 입력에 연결해야 루프가 정상적으로 동작합니다.