Iterator 사용

​

Iterator 사용 시기

​

Iterator 이해하기

1. 배열에서 첫 번째 항목을 가져옵니다
2. 해당 항목으로 Iterator 내부의 모든 액션을 실행합니다
3. 다음 항목으로 이동합니다
4. 모든 항목이 처리될 때까지 반복합니다

​

기본 설정

​

예시: 검색 결과의 모든 사람에게 이메일 보내기

​

1단계: 레코드 검색

1. 레코드 검색 액션을 추가합니다
2. 오브젝트: People
3. 필터: Company가 “Acme Inc”와 같음
4. 이렇게 하면 사람들의 배열이 반환됩니다

​

2단계: 결과 존재 여부 확인

1. 필터 액션을 추가합니다
2. 조건: {{searchRecords.length}}가 0보다 큼
3. 이렇게 하면 결과가 비어 있을 때 발생하는 Iterator 오류를 방지합니다

​

3단계: 이터레이터 추가

1. Iterator 액션을 추가합니다
2. 배열 입력: {{searchRecords}} 선택
3. 이렇게 하면 루프가 생성됩니다

​

4단계: Iterator 내부에 액션 추가

1. Send Email 액션을 추가합니다(Iterator 내부)
2. 받는 사람: {{iterator.currentItem.email}}
3. 제목: 안녕하세요 {{iterator.currentItem.firstName}}!
4. 본문: 현재 항목의 필드를 사용한 개인화 메시지

​

결과

• 사람 1에게 이메일을 보냅니다
• 사람 2에게 이메일을 보냅니다
• … 5명 모두에 대해 계속 진행합니다

​

현재 항목 데이터에 접근하기

​

일반적인 패턴

​

여러 레코드 업데이트

1. Search Records (Tasks, Due Date < Today, Status ≠ Completed)
2. Filter (length > 0)
3. Iterator (searchRecords)
   └── Update Record
       - Object: Tasks
       - Record: {{iterator.currentItem.id}}
       - Status: Late

​

배열에서 레코드 생성

1. Webhook Trigger (receives items array)
2. Filter (items.length > 0)
3. Iterator (trigger.body.items)
   └── Create Record
       - Object: Order Items
       - Name: {{iterator.currentItem.name}}
       - Quantity: {{iterator.currentItem.qty}}
       - Related Order: {{trigger.body.orderId}}

​

루프 내부 조건부 처리

1. Search Records (People)
2. Iterator (searchRecords)
   └── Filter (currentItem.email is not empty)
       └── Send Email
           - To: {{iterator.currentItem.email}}

​

문제 해결

​

”Iterator는 배열을 필요로 합니다”

✅ Correct: {{searchRecords}}
❌ Wrong: {{searchRecords[0]}}

​

Iterator가 실행되지 않음

Filter: {{searchRecords.length}} > 0

​

액션이 너무 많이 실행됨

• Search Records에 더 구체적인 필터를 추가하세요
• Search Records에 한도를 설정하세요(최대 200)
• 추가 조건을 위해 Iterator 내부에 Filter를 추가하세요

​

성능 고려 사항

• 크레딧 사용량: 각 반복은 해당 액션 실행에 크레딧을 소모합니다
• 시간: 큰 배열일수록 처리에 더 오래 걸립니다
• 제한: 매우 큰 작업은 배치 처리하는 것을 고려하세요
• 요청 제한: 반복이 많으면 외부 API 호출이 요청 제한에 걸릴 수 있습니다

​

모범 사례

1. 오류를 피하려면 Iterator 전에 항상 배열 길이를 확인하세요
2. 모든 항목을 처리할 필요가 없는 경우 루프 내부에 필터를 추가하세요
3. 순회 대상을 설명하도록 Iterator 단계의 이름을 바꾸세요
4. 작은 배열로 테스트하세요 대용량 데이터를 처리하기 전에
5. 반복이 예상대로 완료되는지 확인하려면 워크플로우 실행을 모니터링하세요

​

관련 항목

• 워크플로우 액션
• 브랜치 사용 방법
• 워크플로우 FAQ