각 루프 태스크에 사용

이 튜토리얼은 문자열 연결에 For Each 루프 태스크를 사용하는 방법을 보여줍니다. 이 튜토리얼에서는 기본 통합과 하위 통합이라는 2가지 통합을 만듭니다. 기본 통합은 문자열 배열을 통해 반복되고 배열의 각 요소에서 연결을 수행하는 하위 통합을 호출합니다. 기본 통합을 실행한 후 연결된 문자열이 출력됩니다.

이 튜토리얼을 완료하려면 다음 작업을 수행합니다.

기본 통합 만들기

새 통합을 만들려면 다음 단계를 수행합니다.

  1. Apigee UI로 이동하고 로그인합니다.
  2. UI 왼쪽 상단의 드롭다운 메뉴를 사용해 조직을 선택합니다.
  3. 개발 > 통합을 클릭합니다.
  4. 새로 만들기를 클릭합니다.
  5. 통합 만들기 대화상자에 이름과 설명을 입력합니다.
  6. 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
  7. 만들기를 클릭하여 통합 디자이너를 엽니다.
  8. 통합 디자이너에서 + 태스크/트리거 추가 > 트리거 > API 트리거를 클릭합니다.
  9. API 트리거 요소를 통합 디자이너로 드래그합니다.
  10. +태스크/트리거 추가 > 태스크 > For Each 루프를 클릭합니다.
  11. For Each 루프 요소를 통합 디자이너로 드래그합니다.
  12. API 트리거 요소에서 연결(에지)을 For Each 루프 요소에 추가합니다.
    1. API 트리거 요소 옆에 연결된 포크 아이콘을 클릭합니다.
    2. 마우스 포인터를 누른 상태에서 마우스 포인터를 For Each 루프 요소 내의 영역으로 드래그합니다.
    3. 마우스 포인터를 놓습니다.

기본 통합에서 변수 만들기

기본 통합에서 다음 변수를 만듭니다.

  • WordArray: 문자열 배열입니다. 배열 값은 연결을 위해 하위 통합으로 전송됩니다.
  • TempString: 임시 문자열 변수입니다.
변수를 만들려면 다음 단계를 수행하세요.
  1. 기본 통합의 메뉴 바에서 VAR을 클릭합니다.
  2. 추가 +를 클릭합니다.
  3. 변수 만들기 대화상자에서 다음 속성을 설정합니다.
    • 이름: WordArray을 입력합니다.
    • 데이터 유형: String Array를 선택합니다.
    • 기본값: Hello, World, Apigee, Integrations를 입력합니다.
  4. 만들기를 클릭합니다.
  5. 추가 +를 클릭합니다.
  6. 변수 만들기 대화상자에서 다음 속성을 설정합니다.
    • 이름: TempString을 입력합니다.
    • 데이터 유형: String을 선택합니다.
  7. 만들기를 클릭합니다.
  8. 확인을 클릭하여 변수 대화상자를 닫습니다.

하위 통합 만들기

이제 문자열을 연결하는 하위 통합(새 통합)을 만듭니다.

하위 통합을 만들려면 다음 단계를 수행하세요.

  1. Apigee UI에서 개발 > 통합을 클릭합니다.
  2. 새로 만들기를 클릭합니다.
  3. 통합의 이름과 설명을 입력한 후 만들기를 클릭합니다.
  4. 통합 디자이너에서 + 태스크/트리거 추가 > 트리거 > API 트리거를 클릭합니다.
  5. API 트리거 요소를 통합 디자이너로 드래그합니다.
  6. +태스크/트리거 추가 > 태스크 > 데이터 매핑을 클릭합니다.
  7. 데이터 매핑 요소를 통합 디자이너로 드래그합니다.
  8. API 트리거 요소에서 연결(에지)을 데이터 매핑 요소에 추가합니다.

하위 통합에서 변수 만들기

하위 통합에서 다음 변수를 만듭니다.

  • SubIntegrationInput: 통합의 입력 변수입니다. 하위 통합이 실행되면 이 변수에 기본 통합의 WordArray 변수 값이 포함됩니다.
  • SubIntegrationOutput: 통합의 출력 변수입니다. 하위 통합이 실행을 완료하면 이 변수에 연결된 문자열이 포함됩니다.
  • SubIntegrationPreviousValue: For Each 루프의 간헐적으로 연결된 문자열을 저장할 입력 변수입니다. 기본 통합에서 이 변수의 값이 전달됩니다.
변수를 만들려면 다음 단계를 수행하세요.
  1. 기본 통합의 메뉴 바에서 VAR을 클릭합니다.
  2. 추가 +를 클릭합니다.
  3. 변수 만들기 대화상자에서 다음 속성을 설정합니다.
    • 이름: VARIABLE_NAME을 입력합니다.
    • 데이터 유형: String을 선택합니다.
  4. 입력 변수인지 아니면 출력 변수인지 지정합니다.
    • SubIntegrationInput 또는 SubIntegrationPreviousValue 변수를 만드는 경우 통합의 입력으로 사용을 선택합니다.
    • SubIntegrationOutput 변수를 만드는 경우 통합 출력으로 사용을 선택합니다.
  5. 만들기를 클릭합니다.
하위 통합에서 각 변수 만들기 단계를 반복합니다.

하위 통합 구성

하위 통합을 구성하려면 다음 단계를 수행하세요.
  1. 데이터 매핑 요소를 클릭하여 구성 창을 표시합니다.
  2. 을 클릭합니다.
  3. 데이터 매핑 편집기에서 다음 안내를 따르세요.
    1. SubIntegrationPreviousValue 변수를 입력 열로 드래그합니다.
    2. SubIntegrationPreviousValue 변수에서 함수 추가를 클릭한 후 CONCAT를 선택합니다.
    3. SubIntegrationInput 변수를 CONCAT 함수로 드래그합니다.
    4. SubIntegrationOutput 변수를 출력 열로 드래그합니다.
  4. 데이터 매핑 편집기를 닫습니다.
  5. 게시를 클릭합니다.

기본 통합 구성 및 실행

이제 기본 통합으로 돌아가 하위 통합을 호출하도록 구성합니다.

기본 통합을 구성하려면 다음 단계를 수행하세요.

  1. 통합 설계자에서 기본 통합을 엽니다.
  2. For Each 루프 요소를 클릭하여 태스크의 구성 창을 표시합니다.
  3. 구성 창에서 다음 속성을 설정합니다.
    • 반복 목록: WordArray를 선택합니다.
    • API 트리거 ID: 하위 통합의 트리거 ID를 입력합니다. 하위 통합의 API 트리거 요소에서 트리거 ID 값을 가져올 수 있습니다.
    • 통합 이름: 하위 통합 이름을 입력합니다.
    • 반복 요소 하위 통합 매핑: SubIntegrationInput을 선택합니다.
    • 응답 매개변수 재정의 매핑:
      • 매핑할 하위 통합 출력 드롭다운에서 SubIntegrationOutput을 선택합니다.
      • 재정의할 통합 변수 드롭다운에서 TempString을 선택합니다.
    • 추가 하위 통합 입력에 매핑:
      • 매핑할 통합 변수 드롭다운에서 TempString을 선택합니다.
      • 매핑할 하위 통합 입력 드롭다운에서 SubIntegrationPreviousValue를 선택합니다.
  4. 게시를 클릭합니다.

기본 통합과 하위 통합이 모두 성공적으로 실행되면 실행 요약 대화상자의 TempString 변수에 연결된 문자열 HelloWorldApigeeIntegrations가 표시됩니다.