실패 경로와 되돌리기 (오류·보상)

일이 틀어졌을 때의 경로도 프로세스에 그려 둡니다. 서브프로세스 안의 오류 종료를 경계에서 받아 「재견적 요청」으로 보냅니다. 외부 API 호출에 실패한 서비스 작업은 「수기 심사」 업무로 돌립니다. 보상 던지기로 앞 단계부터 다시 하게 합니다.

무엇을 · 왜#

정상 경로만 그린 프로세스는 실패하면 멈춥니다. 공급사가 견적을 거절하거나, 신용 조회 API가 내려가 있거나, 결재자가 「처음부터 다시」를 고르는 일은 예외가 아니라 업무의 한 갈래입니다. BPMN은 이런 갈래를 오류 이벤트와 보상 이벤트로 표현합니다.

따라 하기#

1. 오류 종료와 오류 경계. 튜토리얼/오류보상/공급사견적을 엽니다. 서브프로세스 「공급사 견적」 안에서 「공급사 회신 입력」 뒤 게이트웨이가 공급사응답 == 거절이면 오류 종료 「견적 거절(오류)」로 갑니다. 서브프로세스 테두리의 오류 경계 「거절됨」이 이 오류를 받아 「재견적 요청」으로 보냅니다.

   

2. 거절해 보기. 최구매의 업무 목록에서 「공급사 회신 입력」을 열고 「응답」에 거절을 넣어 완료합니다. 업무 목록에 「재견적 요청」이 옵니다.

   

3. 서비스 작업의 오류 경계. 튜토리얼/오류보상/신용조회실패를 엽니다. 서비스 작업 「신용 조회」(모의 API GET /credit, 21장)에 오류 경계 「조회 실패」가 붙어 「수기 심사」로 갑니다. 모의 API를 POST /admin/fail?on=1로 503을 돌려주게 해 둡니다.
4. API가 실패하면. 최구매가 「거래 요청」을 완료합니다. API는 503을 돌려주지만 완료는 거절되지 않습니다. 완료 뒤 열리는 인스턴스 화면의 「인스턴스 업무 히스토리」에 「신용 조회」가 Failed(담당자 system)로 남고, 업무 목록에 「수기 심사」가 옵니다. 오류 경계가 없었다면 완료 요청 자체가 HTTP 500으로 거절되고 인스턴스가 「거래 요청」에 머물렀을 것입니다.

   

5. 보상 던지기. 튜토리얼/오류보상/견적다시에서 「견적 승인」 뒤 게이트웨이가 결정 == 재견적이면 보상 던지기 이벤트 「견적 다시」로 갑니다. 패널의 「보상 작업 선택」이 견적 요청입니다.

   

6. 되돌려 보기. 윤팀장이 「견적 승인」에서 「결정」에 재견적을 넣어 완료하면, 최구매에게 「견적 요청」이 다시 옵니다. 관리자 화면 「히스토리」에서 앞의 「견적 요청」·「견적 승인」이 보상(COMPENSATED)으로 남은 것을 봅니다.

   

설정 레퍼런스#

오류 종료와 오류 경계#

<bpmn:subProcess id="Sp" name="공급사 견적">
  …
  <bpmn:endEvent id="SpErr" name="견적 거절(오류)"><bpmn:errorEventDefinition id="SpErr_def"/></bpmn:endEvent>
</bpmn:subProcess>
<bpmn:boundaryEvent id="Err" name="거절됨" attachedToRef="Sp"><bpmn:errorEventDefinition id="Err_def"/></bpmn:boundaryEvent>

<!-- 서비스 작업에 붙인 오류 경계 -->
<bpmn:serviceTask id="Credit" name="신용 조회">…</bpmn:serviceTask>
<bpmn:boundaryEvent id="Err" name="조회 실패" attachedToRef="Credit"><bpmn:errorEventDefinition id="Err_def"/></bpmn:boundaryEvent>

오류 이벤트 패널은 자리 표시만 있고 설정 칸(오류 코드·이름)이 없습니다. 어떤 오류든 같은 경계로 갑니다.

서비스 작업이 실패했을 때#

보상 던지기#

<bpmn:intermediateThrowEvent id="Comp" name="견적 다시">
  <bpmn:extensionElements><uengine:properties><uengine:json>
    {"compensateTask":{"name":"견적 요청","tracingTag":"Quote"}}
  </uengine:json></uengine:properties></bpmn:extensionElements>
  <bpmn:compensateEventDefinition id="Comp_def"/>
</bpmn:intermediateThrowEvent>

관리자 화면의 「이 위치로 되돌리기」(되돌리기와 실패한 작업 다루기)와 같은 일을 사람이 선택하는 대신 프로세스 흐름에서 실행합니다.

입력 칸 → 변수#

「공급사 회신 입력」의 「응답」과 「견적 승인」의 「결정」은 작업 입력 칸을 변수로 옮겨 게이트웨이가 읽게 했습니다(작업 입력값과 데이터 매핑).

{"_type":"org.uengine.kernel.HumanActivity","eventSynchronization":{"eventType":"",
  "attributes":[{"name":"응답","className":"String"}],
  "mappingContext":{"mappingElements":[{"argument":{"text":"공급사응답"},"direction":"out","variable":{"name":"[Arguments].응답"}}]}}}

알려진 제약#

• 오류 코드·이름으로 경계를 나눌 수 없습니다. 오류 종료·경계 패널에 설정 칸이 없습니다.
• 보상은 BPMN의 보상 처리기·보상 경계가 아니라 「지정 작업으로 되돌리기」입니다. 외부 시스템에 이미 반영한 일(결제, ERP 승인)을 취소하려면 되돌아간 뒤의 흐름에 취소 작업을 직접 넣어야 합니다.
• 서비스 작업에 오류 경계가 없으면 실패가 어디에도 「실패」 상태로 남지 않습니다. 운영에서 실패를 찾아야 하는 호출에는 오류 경계를 붙이세요.

확인 문제#