승인 태스크

승인 태스크를 사용하면 승인 기반 통합을 구성할 수 있습니다. 또한 통합 흐름을 제어할 수 있습니다.

승인 태스크를 사용하여 통합 사용자 1명 이상에게 승인 요청 이메일을 보낼 수 있습니다. 이 이메일에는 사용자가 요청을 직접 승인하거나 거부할 수 있는 통합 링크가 포함되어 있습니다.

통합 실행 중에 컨트롤이 승인 태스크에 도달하면 실행이 중지되고 승인 태스크 이후의 모든 태스크가 정지됩니다. 사용자가 승인 요청을 직접 승인하거나 거부할 때만 통합이 실행을 재개합니다.

승인 태스크는 다음과 같은 목적에 사용할 수 있습니다.

  • 사용자 승인이나 거부에 따라 통합을 정지하고 분기합니다.
  • 지정된 기간까지 통합을 정지합니다.
  • 통합을 디버깅하는 중단점으로 사용합니다.

승인 태스크, 정지 태스크, 타이머 태스크 비교

세 가지(승인, 일시중지, 타이머) 태스크는 통합 일시중지 및 재개와 비슷한 기능을 수행합니다. 하지만 미묘한 차이가 있습니다. 다음 표에서는 세 가지 태스크의 차이점을 설명합니다.

승인 태스크 정지 태스크 타이머 태스크
통합의 자동 재개를 지원하지 않으며 통합을 재개하려면 수동으로 개입해야 합니다. 통합의 수동 및 자동 재개를 모두 지원합니다. 수동으로 개입하여 일시중지를 취소하지 않으면 통합은 일시중지 시간 제한이 만료된 후에 자동으로 재개를 실행합니다. 통합 자동 재개만 지원합니다. 일시중지 제한 시간이 만료되면 통합 실행이 자동으로 재개됩니다.
API 호출을 통해 통합을 재개할 수 없습니다. 통합 UI를 사용하여 일시중지를 수동으로 해결해야 합니다. 통합에 Suspensions API를 사용하여 통합을 재개할 수 있습니다. 통합 자동 재개만 지원합니다.
통합이 일시중지(정지)되면 사용자에게 알림이 전송됩니다. 통합이 일시중지(정지)되면 사용자에게 알림이 전송되지 않습니다. 통합이 일시중지(정지)되면 사용자에게 알림이 전송되지 않습니다.
통합을 재개하기 전에 조건부 검사를 수행할 수 있는 출력 변수(부울)를 지원합니다. 그러나 출력 변수에는 true 또는 false 값만 있을 수 있습니다. 통합을 재개하기 전에 조건부 검사를 수행할 수 있는 출력 변수(문자열)를 지원합니다. 임의의 값을 출력 변수로 설정할 수 있습니다. 출력 변수를 지원하지 않습니다.

승인 태스크 구성

승인 태스크를 구성하려면 다음 안내를 따르세요.

  1. Apigee UI에서 Apigee 조직을 선택합니다.
  2. 개발 > 통합을 클릭합니다.
  3. 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.

    새 통합을 만드는 경우:

    1. 통합 만들기 대화상자에 이름과 설명을 입력합니다.
    2. 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
    3. 만들기를 클릭합니다.

    통합 디자이너 페이지에서 통합이 열립니다.

  4. 통합 설계자 탐색 메뉴에서 +태스크/트리거 추가 > 태스크를 클릭하여 사용 가능한 태스크 목록을 봅니다.
  5. 승인 태스크 요소를 클릭하고 통합 편집기에 배치합니다.
  6. 디자이너에서 승인 태스크 요소를 클릭하여 승인 태스크 구성 창을 봅니다.
  7. 다음 표의 설명대로 태스크의 구성 속성을 사용하여 표시된 필드를 구성합니다.

    모든 변경사항은 자동으로 저장됩니다.

구성 속성

다음 표에서는 승인 태스크의 구성 속성을 설명합니다.

속성 데이터 유형 설명
Recipients 문자열 배열 작업이 정지되면 알림이 전송되는 이메일 주소입니다. 여러 이메일 주소를 쉼표로 구분하여 입력합니다.
Custom notification message 문자열 작업이 정지되면 이메일 알림에 포함할 커스텀 메시지입니다. 값은 리터럴 또는 변수일 수 있습니다. 변수에서 커스텀 메시지를 사용할 수 있으면 VAR를 클릭하고 변수를 선택합니다.
Reminder frequency (in hours) 정수 리마인더 알림의 빈도입니다.

정지가 해결되지 않은 상태인 경우 승인된 사용자에게 정지를 해결하도록 요청하는 리마인더 이메일 알림을 보낼 수 있습니다.

Time until expiration (in hours) 정수 정지 기간입니다.

시간 내에 정지가 해결되지 않으면 기본적으로 정지가 거부됩니다.

On expiration 부울 정지가 만료된 후에 취해야 할 조치입니다.

정지를 거부하거나 정지를 해제할 수 있습니다. 기본적으로 정지는 거부됩니다.

isApproved (Approval) 부울 해결 후 정지 상태인 출력 변수입니다.

정지가 승인되면 isApproved 변수가 True로 설정되고 정지가 거부되면 False로 설정됩니다.

오류 처리 전략

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