Apigee Integration 시작하기

Apigee X 문서입니다.
Apigee Edge 문서 보기

이 빠른 시작에서는 Apigee Integration을 사용하여 샘플 통합을 만드는 방법을 보여줍니다. 아래 단계는 전체 통합을 실행하는 데 필요한 트리거, 태스크, 에지, 변수, 데이터 매핑을 구성하는 방법을 설명합니다. 이 빠른 시작에서는 URL 엔드포인트에서 제품 목록을 가져오고, 데이터를 사용 가능한 형식으로 변환하고, 결과 목록을 이메일로 전송하며 전부 통합 디자이너 내에서 이루어집니다.

시작하기 전에

빠른 시작을 시작하기 전에 Apigee 로그인 사용자 인증 정보와 조직 세부정보를 확인하세요. 이 정보는 디자이너 내에서 Apigee 통합 기능에 액세스하기 위해 필요합니다.

새 통합 만들기

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

  1. Apigee UI로 이동하고 로그인합니다.
  2. UI 왼쪽 상단의 드롭다운 메뉴를 사용해 조직을 선택합니다.
  3. 개발 > 통합을 클릭합니다.
  4. 새로 만들기를 클릭합니다.
  5. 통합 만들기 대화상자에 이름과 설명을 입력합니다. 예를 들면 my-test-integration입니다.
  6. 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
  7. 만들기를 클릭하여 통합 디자이너를 엽니다.

트리거 구성

트리거는 통합을 구성하는 태스크의 시퀀스를 시작하는 데 필요합니다. 사용 가능한 모든 트리거를 사용하여 통합을 시작할 수 있습니다. 빠른 시작을 위해 API 트리거를 사용합니다.

API 트리거를 구성하려면 다음 안내를 따르세요.

  1. 통합 디자이너에서 태스크/트리거 추가 > 트리거를 선택하여 사용 가능한 트리거 목록을 표시합니다.
  2. API 트리거 요소를 통합 디자이너로 드래그합니다.
  3. 디자이너에서 API 트리거 요소를 클릭하여 트리거 구성 창을 엽니다.
  4. Apigee Integration은 트리거 라벨, 트리거 이름, 트리거 ID를 자동으로 채웁니다. 트리거 ID는 머신이 생성하며 값을 수정할 수 없습니다. 그러나 라벨트리거 이름 속성 값은 수정할 수 있습니다.

    속성 변경사항은 자동으로 저장됩니다.

태스크 추가 및 구성

태스크는 변수를 입력으로 사용하고 변수를 출력으로 생성할 수 있는 실행 가능한 단계 집합입니다. 트리거와 마찬가지로 사용 가능한 모든 태스크를 통합에 사용할 수 있습니다. 이 빠른 시작에서는 REST 엔드포인트 호출, 데이터 매핑, 이메일 보내기 태스크를 사용합니다. 각 태스크의 구성 세부정보는 아래 단계에서 설명합니다.

REST 엔드포인트 호출 태스크 구성

REST 엔드포인트 호출 태스크를 구성하려면 다음 안내를 따르세요.

  1. 태스크/트리거 추가 > 태스크를 선택하여 사용 가능한 태스크 목록을 표시합니다.
  2. REST 엔드포인트 호출 요소를 통합 디자이너로 드래그합니다.
  3. 디자이너에서 REST 엔드포인트 호출 요소를 클릭하여 태스크 구성 창을 엽니다. 다음 속성을 설정합니다.
    • 라벨: 이 태스크의 커스텀 이름을 입력합니다. 예를 들어 Call REST Endpoint Task를 입력합니다.
    • 인증: 이 빠른 시작에서는 인증 프로필이 필요하지 않습니다. 다른 사용 사례에 인증 프로필을 사용하는 방법에 대한 상세 설명은 Apigee Integration에서 인증 프로필 만들기를 참조하세요.
    • 태스크 입력: REST 엔드포인트 호출 세부정보를 입력합니다. 여기에 입력한 정보는 REST 엔드포인트 호출 태스크의 입력으로 사용됩니다. 다음 정보를 입력합니다.
      • 엔드포인트 기본 URL: https://apigee-pm4-prod.apigee.net/v1/hipsters/products를 입력합니다. 이 엔드포인트는 각각 id, name, description, picture, price, categories 배열을 포함하는 제품 객체의 배열을 반환합니다.
      • HTTP 메서드: 드롭다운 목록을 사용하여 GET을 선택합니다.
      • 추가 HTTP 헤더: 엔드포인트에 액세스하는 데 필요한 추가 헤더를 입력합니다. 이 빠른 시작에서는 다음 안내를 따릅니다.
        • HTTP 헤더 키 필드에 x-apikey를 입력합니다.
        • 필드에 H7WpkpvdCAC2jSffbmKpQLVduxC6nOO9을 입력합니다.
    • 태스크 출력: 여기에서 Apigee Integration은 REST 엔드포인트 호출의 응답 데이터 출력을 저장할 세 개의 변수를 채웁니다.
      • responseHeader(REST 엔드포인트 호출): 이 변수는 REST 엔드포인트 호출 태스크와 연결된 응답 헤더 데이터를 저장합니다. 변수 데이터는 String(STR) 유형입니다.
      • responseBody(REST 엔드포인트 호출): 이 변수는 REST 엔드포인트 호출 태스크와 연결된 응답 본문 데이터를 저장합니다. 변수 데이터는 String(STR) 유형입니다.
      • responseStatus(REST 엔드포인트 호출): 이 변수는 REST 엔드포인트 호출 태스크와 연결된 응답 상태 데이터를 저장합니다. 변수 데이터는 String(STR) 유형입니다.
    • 태스크 구성 창에서 변수 이름을 클릭하여 각 변수의 세부정보를 확인합니다. 이 빠른 시작에서는 이러한 변수의 기본값을 그대로 둡니다.
    • 나머지 필드는 다음 기본값을 포함해야 합니다.
      • 리디렉션 따르기: True
      • 오류 발생: False
      • 실패 시 재시도
        • 통합이 동기적으로 실행되는 경우: None
        • 통합이 비동기적으로 실행되는 경우: None

    속성 변경사항은 자동으로 저장됩니다.

    완료된 구성은 아래 그림과 일치합니다.

    REST 엔드포인트 트리거 호출

  4. API 트리거 요소의 제어 지점에 마우스를 가져간 뒤 클릭한 다음 REST 엔드포인트 호출 태스크 요소의 제어 지점으로 선을 드래그하여 API 트리거 요소에서 REST 엔드포인트 호출 요소로 에지 연결을 추가합니다. 아래 이미지와 같이 제어 지점과 에지 선이 노란색으로 변경됩니다.

    에지 연결을 보여주는 통합 디자이너

    에지는 API 트리거에서 REST 엔드포인트 호출 태스크로의 제어 흐름을 나타냅니다.

데이터 매핑 태스크 구성

데이터 매핑 태스크를 구성하려면 다음 안내를 따르세요.

  1. 태스크/트리거 추가 > 태스크를 선택하여 사용 가능한 태스크 목록을 표시합니다.
  2. 데이터 매핑 요소를 통합 디자이너로 드래그합니다.
  3. 디자이너에서 데이터 매핑 태스크를 클릭하여 태스크의 구성 창을 엽니다.
  4. 데이터 매핑 편집기 열기를 클릭합니다.

    데이터 매핑 편집기를 사용하면 사용 가능한 변환 함수를 사용하여 원하는 출력 변수에 입력 변수를 매핑할 수 있습니다. 그러면 출력을 다른 통합 태스크 또는 트리거에 변수로 사용할 수 있습니다. 데이터를 변수로 전달하는 방법에 대한 자세한 내용은 Apigee Integration에서 변수 사용을 참조하세요.

    이 빠른 시작에서는 다음 단계를 따라 responseBody(REST 엔드포인트 호출)를 입력으로 사용하여 매핑을 만듭니다.

    1. 편집기 왼쪽의 변수 목록에서 responseBody 칩을 첫 번째 입력 필드로 드래그합니다.
    2. responseBody 칩에서 + 함수 추가를 클릭하여 사용 가능한 함수의 드롭다운 목록을 확인합니다.
    3. 여러 데이터 매핑 함수를 적용하여 입력 변수의 데이터를 변환할 수 있습니다. 여기에서는 페이로드를 JSON으로 변환한 후 응답 배열을 반복하여 이메일 알림에 필요한 제품 이름 목록을 가져올 수 있습니다. responseBody 변수에서 + 함수 추가 기호를 클릭하여 사용 가능한 함수 목록을 엽니다. 다음 함수를 사용합니다.
      • TO_JSON()을 선택하여 responseBody 문자열을 JSON으로 변환합니다.
      • responseBody 변수 칩의 + 함수 추가 기호를 다시 클릭하여 GET_PROPERTY() 함수를 선택하고 연결합니다. 이 함수는 JSON 페이로드에서 속성을 추출합니다. products.name 속성에 이 함수의 매개변수로 전달합니다. 이렇게 하면 다른 제품 정보 없이 제품 이름 목록만 반환합니다. 함수는 다음과 같아야 합니다.
        responseBody(Call REST Endpoint).TO_JSON().GET_PROPERTY(products.name)
      • 함수를 삭제하거나 삭제하려면 - 기호를 클릭합니다. 이렇게 하면 최근에 추가된 함수가 삭제됩니다.
    4. 출력 열의 첫 번째 필드를 클릭하여 변환된 데이터 값을 저장할 새 변수를 만듭니다. 다음 입력란을 작성하세요.
      • 이름: JSONProdNameList를 입력합니다.
      • 데이터 유형: JSON
      • 통합 출력으로 사용을 선택합니다.
      • 만들기를 클릭하여 변수를 만들고 창을 닫습니다. 새로운 JSONProdNameList 변수가 데이터 매핑 편집기 왼쪽에 있는 변수 목록에 표시됩니다.
    5. 데이터 매핑 편집기에서 X를 클릭하여 매핑을 저장하고 편집기를 닫습니다.
    6. 완료된 매핑은 아래 그림과 같이 표시됩니다.

      완료된 데이터 매핑 및 변수의 이미지

  5. REST 엔드포인트 호출 요소의 제어 지점에 마우스를 가져간 뒤 클릭한 다음 데이터 매핑 태스크 요소의 제어 지점으로 선을 드래그하여 REST 엔드포인트 호출 요소에서 데이터 매핑 요소로 에지 연결을 추가합니다. 에지는 REST 엔드포인트 호출 태스크에서 데이터 매핑 태스크로의 제어 흐름을 나타냅니다.

이메일 보내기 태스크 구성

이메일 보내기 태스크를 구성하려면 다음 안내를 따르세요.

  1. 통합 디자이너에서 태스크/트리거 추가 > 태스크를 선택하여 사용 가능한 태스크 목록을 표시합니다.

    이 단계에서는 이메일 보내기 태스크를 사용합니다.

  2. 이메일 보내기 요소를 통합 디자이너로 드래그합니다.
  3. 디자이너에서 이메일 보내기 요소를 클릭하여 태스크 구성 창을 엽니다. 다음 속성을 설정합니다.
    • 수신자: 이메일 주소를 입력합니다. 이 이메일을 사용하여 통합 완료를 확인합니다.
    • 제목: Email from Apigee Integrations를 입력합니다.
    • 이메일 본문: 데이터 매핑 태스크에서 이전에 생성된 JSONProdNameList 변수를 선택합니다.
    • 나머지 옵션은 기본 구성에서 남겨둘 수 있습니다.

    속성 변경사항은 자동으로 저장됩니다.

    완료된 구성은 아래 그림과 일치합니다.

    이메일 태스크 구성

  4. 데이터 매핑 요소의 제어 지점에 마우스를 가져간 뒤 클릭한 다음 이메일 보내기 태스크 요소의 제어 지점으로 선을 드래그하여 데이터 매핑 요소에서 이메일 보내기 요소로 에지 연결을 추가합니다. 제어 지점과 에지 선이 노란색으로 변경됩니다. 에지는 데이터 매핑 태스크에서 이메일 보내기 태스크로의 제어 흐름을 나타냅니다.

통합 테스트

새 통합을 테스트하려면 다음 단계를 따르세요.

  1. 통합 디자이너 툴바에서 게시 버튼을 클릭합니다. 통합을 게시하면 툴바에 테스트 버튼이 활성화됩니다.
  2. 테스트를 클릭한 후 API 트리거를 선택합니다.
  3. 게시 및 테스트 확인 대화상자에서 게시 및 테스트를 클릭합니다.

테스트에 대한 자세한 내용은 통합 테스트를 참조하세요.

성공적으로 완료되면 통합에서 이메일 보내기 태스크에 지정된 이메일 주소로 제품 이름 목록이 포함된 이메일을 전송합니다. 이메일 클라이언트에서 이메일 수신 여부를 확인합니다.

통합에서 전송된 이메일에는 다음과 비슷한 본문이 포함됩니다.

["Vintage Typewriter", "Vintage Camera Lens", "Home Barista
Kit", "Terrarium", "Film Camera", "Vintage Record Player", "Metal Camping
Mug", "City Bike", "Air Plant"]

이메일의 내용을 확인하는 것 외에도 로그를 검사하여 지정된 통합의 상태와 페이로드를 확인할 수 있습니다. 로그를 보려면 다음 안내를 따르세요.

  1. 통합 디자이너의 툴바에서 로그를 클릭합니다.
  2. 실행 로그 페이지에서 통합 실행 시도에 대한 세부정보를 볼 수 있습니다. 각 항목에는 다음을 포함하여 실행 시도에 대한 세부정보가 포함됩니다.
    • 통합 이름
    • 실행 ID
    • 상태
    • 시작 시간
    • 기간
    • 통합 ID
    • 트리거 ID
  3. 실행된 통합 옆의 확장 화살표(>)를 클릭하여 통합에 있는 태스크 및 변수의 확장된 목록과 태스크 상태 및 변수 페이로드를 확인합니다.

수고하셨습니다. Apigee Integration로 통합을 성공적으로 구성 및 배포했습니다.

다음 단계