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

샘플 통합 사용해 보기

Google Cloud 프로젝트에서 Application Integration을 처음 설정할 때 Application Integration은 기본적으로 ExampleIntegration-EcomOrderProcessing이라는 게시되지 않은 샘플 통합을 만듭니다.

샘플 통합 보기

샘플 통합을 보려면 다음을 수행하세요.

Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.
Application Integration으로 이동
탐색 메뉴에서 통합을 클릭합니다. 통합 페이지가 표시됩니다.
이름이 ExampleIntegration-EcomOrderProcessing인 통합을 클릭합니다.
샘플 통합은 다음 레이아웃과 비슷한 통합 편집기에서 열립니다.

전자상거래 샘플 통합

이 샘플 통합을 사용하여 Application Integration의 다양한 트리거, tasks, 개념을 실습할 수 있습니다.

샘플 통합은 다음 주문 처리 작업을 구현하는 기본 전자상거래 백엔드 시나리오를 보여줍니다.

API 엔드포인트에서 다음 주문 요청 페이로드를 수신합니다.

{
  "order_no": "12345",
  "buyer_id": "raambo",
  "line_items": [
    {
      "line": 1,
      "sku": "tr100",
      "vendor": "Internal",
      "quantity": 1,
      "price_per_unit": 10
    },
    {
      "line": 2,
      "sku": "tbz",
      "vendor": "External",
      "quantity": 24.0,
      "price_per_unit": 1
    }
  ]
}

주문 페이로드를 추출하고 총 주문 금액을 계산합니다.
총 주문 금액이 $100보다 크거나 같은지 확인합니다. '예'인 경우, 추가 승인을 받고 계속 진행합니다.
주문 항목에 외부 공급업체가 있는지 확인합니다. 있다면 REST API 호출을 사용하여 공급업체에 세부정보를 보냅니다.
총 주문 금액, 필터링된 외부 공급업체 항목, 해당 HTTP 응답 상태가 포함된 주문 응답을 보냅니다.

다음 표에는 ExampleIntegration-EcomOrderProcessing에 사용되는 모든 트리거, 태스크, 에지 조건이 나와 있습니다.

구성요소	구성		설명
API 트리거 (OrderProcessAPITrigger)	트리거 ID: `api_trigger/ecom-order-processing_API_1`		모든 주문 요청에 대해 통합을 호출합니다.
데이터 매핑 태스크 (총 주문 가격 찾기)	입력	출력	`order_request` JSON 입력 변수를 추출하고 FOR_EACH 매핑 함수를 사용하여 모든 주문 항목을 반복하여 총 주문 금액을 계산합니다. 총 주문 금액은 GET_PROPERTY 및 MULTIPLY 매핑 함수를 사용하여 `quantity`와 `price_per_item` 항목을 곱하여 계산됩니다. 그러면 최종 값이 double 데이터 유형으로 변환되고 `total_order_value` 출력 변수에 저장됩니다.
데이터 매핑 태스크 (총 주문 가격 찾기)	orders_request.line_items .FOR_EACH(~obj1->~obj1 .GET_PROPERTY("quantity") .TO_DOUBLE() .MULTIPLY(~obj1 .GET_PROPERTY("price_per_unit") .TO_DOUBLE())) .TO_DOUBLE_ARRAY() .SUM()	`total_order_value`
에지 조건 (기준을 초과하는 총 OrderValue)	조건: `$total_order_value$ >= $threshold_order_value$`		총 주문 금액이 $100보다 크거나 같은지 확인합니다. 그렇다면 승인 태스크에 제어가 전달됩니다.
에지 조건 (기준 미만의 TotalOrderValue)	조건: `$total_order_value$ < $threshold_order_value$`		총 주문 금액이 $100 미만인지 확인합니다. 그렇다면 외부 항목 필터링 태스크에 제어가 전달됩니다.
승인 태스크 (승인)	수신자: `Enter the approver's email address` 이 샘플 통합을 테스트하기 위해 이메일을 사용하여 통합이 성공적으로 완료되었는지 확인할 수 있습니다. 참고: Google Cloud 프로젝트에서 수신자 필드에 제공된 모든 이메일 주소에 Application Integration 승인 담당자 IAM 역할을 부여해야 합니다. IAM 역할 부여에 대한 자세한 내용은 액세스 권한 부여, 변경, 취소를 참조하세요.		1명 이상의 통합 사용자에게 승인 요청 이메일을 보냅니다. 이 이메일에는 사용자가 요청을 직접 승인하거나 거부할 수 있는 통합 링크가 포함되어 있습니다.
데이터 매핑 태스크 (외부 항목 필터링)	입력	출력	`order_request` JSON 입력 변수를 추출하고 FILTER 매핑 함수를 사용하여 외부 공급업체가 있는 모든 주문 항목을 필터링합니다. 그러면 필터링된 값이 `filtered_external_items` 출력 변수에 저장됩니다.
데이터 매핑 태스크 (외부 항목 필터링)	orders_request .GET_PROPERTY("line_items") .FILTER(~obj1->~obj1 .GET_PROPERTY("vendor") .TO_STRING() .EQUALS("External"))	`filtered_external_items`
For Each 루프 태스크 (For Each 루프)	반복할 목록: `filtered_external_items` API 트리거 ID: `api_trigger/ecom-order-processing_API_2` 통합 이름: `ExampleIntegration-EcomOrderProcessing`		`filtered_external_items` 변수를 반복하고 배열의 각 요소에 대한 하위 통합을 호출합니다. 또한 `rest_call_response_status`에 있는 각 실행의 응답을 수집합니다. 여기서 배열의 각 요소에는 하나의 특정 실행에 대한 응답이 있습니다.
API 트리거 (ExternalOrders 보고)	트리거 ID: `api_trigger/ecom-order-processing_API_2`		filtered_external_items에 있는 각 요소에 대해 하위 통합을 호출합니다.
REST 엔드포인트 호출 태스크 (REST 엔드포인트 호출)	엔드포인트 기준 URL: `https://mocktarget.apigee.net/echo` HTTP 메서드: `POST` 요청 본문: `sub_integration_input`		https://mocktarget.apigee.net/echo에 REST 호출을 수행합니다.

샘플 통합 게시 및 테스트

통합을 게시하려면 통합 편집기 툴바에서 게시를 클릭합니다.

통합이 성공적으로 게시되면 게시된 통합의 실행 로그를 보고 검사할 수 있습니다. 로그를 보려면 이 통합의 실행 로그 보기를 클릭합니다. 실행 로그 페이지가 나타납니다.

통합 편집기에서 테스트

샘플 통합을 테스트하려면 다음을 수행합니다.

통합 편집기 툴바에서 테스트를 클릭한 다음 OrderProcessAPITrigger를 선택합니다.
통합 테스트 창이 나타납니다.

orders_request 입력 변수를 수정하라는 메시지가 표시됩니다. 이 테스트 목적으로 quantity 값을 240으로 업데이트할 수 있습니다. 업데이트 orders_request 입력 변수는 다음과 같이 표시됩니다.

    {
      "order_no": "12345",
      "buyer_id": "raambo",
      "line_items": [
        {
          "line": 1,
          "sku": "tr100",
          "vendor": "Internal",
          "quantity": 1,
          "price_per_unit": 10
        },
        {
          "line": 2,
          "sku": "tbz",
          "vendor": "External",
          "quantity": 240,
          "price_per_unit": 1
        }
      ]
    }

통합 테스트를 클릭합니다.

업데이트된 orders_request 수량이 200을 초과하는 경우, 샘플 통합은 승인 태스크의 수신자 필드에 지정된 이메일 주소로 승인 요청 이메일을 전송합니다. 승인이 수신되면 통합 주문 작업이 성공적으로 완료된 것입니다.

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

다음을 수행하여 실행 로그를 검사하고 지정된 통합의 상태와 페이로드를 확인합니다.

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

REST API 호출을 사용하여 테스트

참고: 다음 테스트 사례에서는 일반적으로 Linux 및 macOS 운영체제에 사전 설치되는 curl을 사용합니다. curl이 없으면 curl 릴리스 및 다운로드 페이지에서 다운로드할 수 있습니다.

테스트 사례 1: 기본 입력으로 요청 보내기

  curl -X POST -H "Content-Type: application/json" -d '{"trigger_id":"api_trigger/ecom-order-processing_API_1"}' 'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME:execute' -H "Authorization: Bearer $(gcloud auth print-access-token)"

테스트 사례 2: 커스텀 입력으로 요청 보내기

  curl -X POST -H "Content-Type: application/json" -d '{ "triggerId": "api_trigger/ecom-order-processing_API_1", "inputParameters": { "orders_request": { "jsonValue": "{\n \"order_no\": \"12345\",\n \"buyer_id\": \"raambo\",\n \"line_items\": [{\n \"line\": 1.0,\n \"sku\": \"tr100\",\n \"vendor\": \"Internal\",\n \"quantity\": 1.0,\n \"price_per_unit\": 10.0\n }, {\n \"line\": 2.0,\n \"sku\": \"tbz\",\n \"vendor\": \"External\",\n \"quantity\": 24.0,\n \"price_per_unit\": 2.0\n }]\n}" } } }' 'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME:execute' -H "Authorization: Bearer $(gcloud auth print-access-token)"

다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트의 ID
LOCATION: 통합 위치. Application Integration 위치를 참조하세요.
INTEGRATION_NAME: 통합의 이름

테스트 출력

API는 모든 통합 출력 변수 값이 포함된 통합 실행 응답을 반환합니다.

할당량 및 한도

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