첫 프로세스 만들고 실행하기

관리자 홍길동이 모델러에서 「구매 요청 → 결재」의 두 단계 프로세스를 그려 저장합니다. 이를 실행하고 업무 목록에서 작업을 끝낸 뒤 관리자 화면에서 완료를 확인합니다.

무엇을 · 왜#

프로세스 정의는 BPMN 2.0으로 그린 업무 흐름입니다. 정의를 실행할 때마다 인스턴스가 하나씩 생기고, 인스턴스는 흐름에 따라 사람이 처리할 작업을 만듭니다. 담당자는 업무 목록에서 자신의 작업을 열어 완료합니다.

이 장에서 쓰는 BPMN 요소는 다섯 가지입니다.

사용자 작업에는 아규먼트를 둘 수 있습니다. 아규먼트는 해당 작업 화면의 입력 칸입니다. 정의에는 작업 속성 JSON의 eventSynchronization.attributes로 저장됩니다. 아규먼트 값을 프로세스 변수에 저장하는 방법(데이터 매핑)은 작업 입력값과 데이터 매핑에서 다룹니다.

이 장의 프로세스는 레인이 하나이고 담당자 규칙을 두지 않습니다. 그래서 「구매 요청」과 「결재」가 모두 시작한 사람(홍길동)에게 갑니다. 결재를 다른 사람(윤팀장)에게 보내는 방법은 레인과 담당자에서 다룹니다.

따라 하기#

hong / 1234로 http://localhost:8288에 로그인한 상태에서 시작합니다.

1. 새 프로세스를 엽니다. 주소 /definitions/chat을 열면 기본 템플릿이 나옵니다. 풀 「Process」, 레인 「Lane 1」 안에 「Start」 → 「User Task」 → 「End」가 이어져 있습니다.

   

2. 첫 작업을 「구매 요청」으로 바꿉니다. 「User Task」를 두 번 눌러 속성 패널을 엽니다. 「이름」을 구매 요청으로 바꾸고, 「아규먼트」 아래 입력 칸에 품목을 적고 Enter를 누릅니다. 다음 칸에 금액을 적고, 타입을 「정수」로 고른 뒤 Enter를 누릅니다. 패널 오른쪽 위의 디스켓 아이콘을 눌러 저장합니다.

   

3. 「결재」 작업을 덧붙입니다. 먼저 「End」를 오른쪽으로 끌어 자리를 만듭니다. 「구매 요청」을 한 번 누르면 옆에 컨텍스트 패드가 뜹니다. 「작업 덧붙이기」(사용자 작업 모양)를 누르면 새 작업이 「구매 요청」과 「End」 사이에 추가됩니다. 새 작업을 두 번 눌러 이름을 결재로 바꾸고, 아규먼트 결재의견(문자열)을 추가합니다.

   

4. 저장합니다. 오른쪽 위의 디스켓 아이콘을 누르면 「프로세스 저장」 대화상자가 뜹니다. 「아이디」에 튜토리얼/빠른시작/구매결재, 「이름」에 구매 결재를 넣고 「저장」을 누릅니다. 아이디는 폴더를 포함한 경로이고, 파일은 definitions/튜토리얼/빠른시작/구매결재.bpmn으로 저장됩니다.

   

5. 실행합니다. 저장해도 주소는 /definitions/chat 그대로입니다. /definitions/튜토리얼/빠른시작/구매결재를 열고 오른쪽 위 재생 아이콘(「실행」)을 누릅니다. 「Process 실행」 창에 첫 작업 「구매 요청」의 입력 칸 「품목」·「금액」이 나옵니다. 노트북 5대, 1500000을 넣고 「완료」를 누릅니다. 이때 인스턴스가 만들어지고 첫 작업이 끝납니다.

   

6. 업무 목록에서 결재합니다. 업무 목록(/todolist)의 「진행 중」 칸에 「결재」 카드가 있습니다. 카드에는 작업 번호(TaskId)와 인스턴스 번호(InstId)가 적혀 있습니다. 카드를 눌러 열고 「결재의견」에 승인합니다를 적은 뒤 「완료」를 누릅니다.

   

7. 관리자 화면에서 확인합니다. 완료한 작업은 업무 목록의 「완료됨」 칸에 나타나지 않습니다(이 브랜치의 결함). 관리자 화면(/admin)의 「인스턴스 목록」에서 방금 실행한 인스턴스 「구매 결재__<날짜>」의 상태는 「Completed」입니다. 인스턴스를 열고 「히스토리」 탭을 누르면 「구매 요청」과 「결재」가 모두 COMPLETED입니다.

   

설정 레퍼런스#

패널 칸과 정의#

저장된 정의(발췌)#

<bpmn:process id="Process_1" isExecutable="true" name="구매 결재">
  <bpmn:extensionElements>
    <uengine:properties><uengine:json>{"definitionName":"구매 결재","version":"0.1",…}</uengine:json></uengine:properties>
  </bpmn:extensionElements>
  <bpmn:laneSet id="LaneSet_1">
    <bpmn:lane id="Lane_1" name="Lane 1">…</bpmn:lane>
  </bpmn:laneSet>
  <bpmn:userTask id="UserTask_1" name="구매 요청">
    <bpmn:extensionElements>
      <uengine:properties json="{&quot;_type&quot;:&quot;org.uengine.kernel.HumanActivity&quot;,
        &quot;eventSynchronization&quot;:{&quot;eventType&quot;:&quot;&quot;,&quot;attributes&quot;:[
          {&quot;name&quot;:&quot;품목&quot;,&quot;className&quot;:&quot;String&quot;,&quot;isKey&quot;:false,&quot;isCorrKey&quot;:false},
          {&quot;name&quot;:&quot;금액&quot;,&quot;className&quot;:&quot;Integer&quot;,&quot;isKey&quot;:false,&quot;isCorrKey&quot;:false}],
        &quot;mappingContext&quot;:{&quot;mappingElements&quot;:[]}}}"/>
    </bpmn:extensionElements>
  </bpmn:userTask>
  <bpmn:userTask id="Activity_…" name="결재">…결재의견(String)…</bpmn:userTask>
</bpmn:process>

uengine:properties의 json 속성은 XML 안에 들어가므로 따옴표가 "로 바뀌어 저장됩니다. 읽기 쉽게 풀면 아래와 같습니다.

{"_type": "org.uengine.kernel.HumanActivity",
 "eventSynchronization": {"eventType": "",
   "attributes": [{"name": "품목", "className": "String",  "isKey": false, "isCorrKey": false},
                  {"name": "금액", "className": "Integer", "isKey": false, "isCorrKey": false}],
   "mappingContext": {"mappingElements": []}}}

화면에서 호출하는 API#

같은 일을 API로만 하는 방법은 API로 같은 일 하기에 있습니다.

알려진 제약#

확인 문제#