Application Integration에 지원되는 커넥터를 참조하세요.

For Each 루프 태스크

For Each 루프 태스크를 사용하면 현재(기본) 통합에서 하위 통합으로 반복 호출을 수행할 수 있습니다. 이 태스크는 구성된 배열 변수를 반복하고 배열의 각 요소에 대한 하위 통합을 호출합니다. 하위 통합이 호출된 횟수는 배열 변수의 크기와 같습니다.

API 트리거 ID 및 통합 이름은 실행할 하위 통합을 식별합니다.

또한 태스크를 통해 각 하위 통합 실행에서 응답을 수집하고 다운스트림 태스크에 사용할 수 있도록 현재 통합에 값을 저장할 수 있습니다. 다음 방법 중 하나를 사용하여 응답을 수집할 수 있습니다.

  • 배열 변수에서 각 실행의 응답을 수집합니다. 배열의 각 요소에는 하나의 특정 실행에 대한 응답이 있습니다. 응답을 수집하려면 Collect values from sub-integration output(s) 속성을 구성합니다.
  • 단일 변수에서 모든 실행의 응답을 집계합니다. 응답을 집계하려면 Response parameter override mapping 속성을 구성합니다.

시작하기 전에

구성 속성

다음 표에서는 For Each 루프 태스크의 구성 속성을 설명합니다.

속성 데이터 유형 설명
API Trigger ID 문자열 실행할 하위 통합의 트리거 ID입니다.

이 값은 하위 통합의 API 트리거의 트리거 ID 필드에서 확인할 수 있습니다.

Integration name 문자열 실행할 하위 통합의 이름입니다.
List to iterate 부울, 문자열, 정수, Double 또는 JSON 유형의 배열입니다. 하위 통합을 실행할 값의 목록입니다. 하위 통합은 목록에 있는 각 값을 차례로 실행합니다.

반복 요소 하위 통합 매핑 속성을 설정하면 반복 값을 하위 통합에 전달할 수 있습니다. 이 속성에서 반복 값을 매핑해야 하는 하위 통합의 변수를 지정합니다.
Iteration element sub-integration mapping 해당 없음 현재 반복된 요소를 할당해야 하는 하위 통합의 변수입니다.
Map to additional sub-integration input(s) 해당 없음 현재 통합에서 하위 통합으로 전달할 추가 값입니다.

이 속성 값은 키-값 쌍의 형식입니다. 여기서 키는 현재 통합의 변수이고 값은 하위 통합의 해당 입력 변수입니다. 예를 들어 subIntProductID 하위 통합 변수에 매핑할 productID 변수가 기본 통합에 있다고 가정해 보겠습니다. 매핑할 통합 변수 드롭다운에서 productID를 선택하고 매핑할 하위 통합 입력 드롭다운에서 subIntProductID를 선택합니다.

Collect values from sub-integration output(s) 해당 없음 하위 통합 실행 결과를 수집합니다.

하위 통합이 실행될 때마다 하위 통합 출력을 현재 통합의 배열 변수에 저장할 수 있습니다. 수집할 하위 통합 출력 드롭다운에서 하위 통합 출력 변수를, 수집할 통합 변수 드롭다운에서 현재 통합의 배열 변수를 선택합니다. 배열의 각 요소에는 특정 하위 통합 실행의 응답이 있습니다. 예를 들어 배열 변수가 resultsArray이면 resultsArray[0]에는 첫 번째 실행의 응답이 있고 resultsArray[1]에는 두 번째 실행의 응답이 있습니다.
Response parameter override mapping 해당 없음 하위 통합 실행의 출력 변수를 읽고 현재 통합의 변수에 저장합니다.

매핑할 하위 통합 출력 드롭다운에서 하위 통합 출력 변수를 선택하고 재정의할 통합 변수 드롭다운에서 현재 통합의 해당 변수를 선택합니다. 추가 하위 통합 입력에 매핑 속성의 변수를 매핑하여 현재 통합에서 재정의된 변수를 다음 하위 통합 실행에 전송할 수 있습니다. 따라서 하위 통합 실행의 응답을 누적 집계할 수 있습니다.
Loop metadata JSON 배열 하위 통합 실행 ID, 오류 메시지, 실행 중에 전달된 변수 값과 같은 하위 통합의 실행 세부정보가 있는 출력 변수입니다. 루프 메타데이터에는 current_iteration_count, sub_integration_execution_ids, failure_location, current_element, iteration_element, failure_message 출력 변수를 포함한 변수가 포함됩니다.

예시

다음 섹션에서는 특정 시나리오에서 For Each 루프 태스크를 구성하고 사용하는 방법을 자세히 설명합니다. 다음 예에서는 다양한 사용 사례의 구성 단계를 보여줍니다.

각 요소 반복 및 전달

["P1", "P2", "P3"]과 같은 값이 포함된 productIds라는 배열 변수가 있는 기본 통합이 있다고 가정해 보겠습니다. 각 제품 ID에 대해 GetProductDetails라는 하위 통합을 호출하려면 다음과 같이 For Each 루프 태스크를 구성합니다.

  • 반복할 목록을 productIds로 설정합니다.
  • 반복 요소 하위 통합 매핑을 설정하여 productIds의 현재 요소를 GetProductDetails의 변수(예: subIntProductId)에 매핑합니다.

그러면 GetProductDetails의 각 실행이 productIds에서 하나의 제품 ID를 수신합니다.

하위 통합 출력 수집

이전 예와 마찬가지로 GetProductDetails이 productInfo이라는 출력 변수에 JSON 객체를 반환한다고 가정합니다.

각 하위 통합 실행에서 모든 productInfo 출력을 수집하고 기본 통합 내의 배열 변수에 요소로 저장하려면 다음 단계를 따르세요.

  • 하위 통합 출력에서 값 수집을 구성합니다.
  • 수집할 하위 통합 출력에서 productInfo을 선택합니다.
  • 수집할 통합 변수에서 기본 통합의 배열 변수(예: allProductDetails)를 선택합니다.

루프가 완료되면 allProductDetails는 각 요소가 하나의 하위 통합 실행에서 가져온 productInfo JSON인 배열입니다.

응답 재정의로 결과 집계

목록의 각 항목에 대해 하위 통합 (예: GetProductDetails)을 호출하는 기본 통합이 있고 모든 항목의 총 가격을 계산한다고 가정해 보겠습니다. 각 하위 통합 실행에서 반환된 숫자 값을 합산하려면 다음 단계를 따르세요.

  • 하위 통합이 출력 변수 itemPrice에 값을 반환하는지 확인합니다.
  • 기본 통합에서 totalPrice 변수를 0로 초기화합니다.
  • 응답 매개변수 재정의 매핑을 구성합니다.
    • itemPrice (하위 통합)를 totalPrice (기본 통합)에 매핑합니다.
  • 추가 하위 통합 입력에 매핑 섹션에서 다음 안내를 따르세요.
    • totalPrice(기본 통합)를 하위 통합의 입력 변수(예: currentTotal)에 매핑합니다.
  • 하위 통합의 로직에서 기본 통합에서 수신한 currentTotal에 현재 항목의 가격을 추가합니다. 그런 다음 itemPrice이라는 출력 변수에 이 새로운 합계를 반환합니다. 이 프로세스는 누적 집계를 만듭니다.

추가 입력 전달

하위 통합 GetProductDetails에 기본 통합의 currency 코드가 필요한 경우 다음을 수행하세요.

  • 추가 하위 통합 입력에 매핑 섹션에서 다음 안내를 따르세요.
    • 기본 통합 변수 currencyCode를 하위 통합 입력 변수 subIntCurrency에 매핑합니다.
  • 이 currencyCode는 하위 통합의 모든 실행에 전달됩니다.

다음 샘플 통합을 살펴보고 앞 섹션에서 설명한 개념의 실용적인 단계별 가이드와 실행 가능한 예시를 확인하세요.

권장사항

For Each 루프 태스크에 적용되는 사용량 한도에 대한 자세한 내용은 사용량 한도를 참조하세요.

오류 처리 전략

태스크의 오류 처리 전략은 일시적인 오류로 인해 태스크가 실패할 경우 수행할 태스크를 지정합니다. 오류 처리 전략을 사용하는 방법과 다양한 유형의 오류 처리 전략에 대한 자세한 내용은 오류 처리 전략을 참조하세요.

할당량 및 한도

할당량 및 한도에 대한 자세한 내용은 할당량 및 한도를 참조하세요.

다음 단계