레인과 담당자 (그룹·역할·선점)

레인 하나는 역할 하나입니다. 레인에 사용자 이름을 적으면 그 사람에게, Keycloak 그룹과 역할을 설정하면 해당하는 사람 모두에게 작업이 배정되고, 선점 방식이면 먼저 가져간 사람이 맡습니다.

무엇을 · 왜#

BPMN의 레인(lane)은 풀(pool)을 가로로 나눈 구역입니다. 표준에서는 「이 구역의 일은 이 부서가 한다」는 도식상의 구분이며, Camunda는 담당자를 사용자 작업의 assignee·candidateGroups 속성으로 따로 정합니다.

uEngine6에서는 레인이 곧 역할(Role)입니다. 레인 이름이 역할 이름이 되고, 레인 안의 사람 작업은 그 역할을 맡은 사람에게 갑니다. 역할에 실제 담당자를 연결하는 규칙은 레인의 확장 속성 JSON(roleResolutionContext)에 적습니다.

그룹 작업을 누가 맡을지는 배분 규칙(dispatchingOption)이 정합니다.

• 선점(1, racing): 후보 모두의 업무 목록에 보이고, 한 사람이 「선점」하면 그 사람의 작업이 됩니다. 다른 사람의 목록에서는 사라집니다. Camunda의 claim과 같습니다.
• 라운드로빈(2): 후보에게 돌아가며 배정합니다. 이 장에서는 다루지 않습니다.

groupName은 Keycloak 그룹 이름, scope는 Keycloak realm 역할입니다. 가온가전에서는 결재 권한자만 속한 그룹 구매결재와 역할 purchase-lead를 씁니다(윤팀장만 해당). 사용자·그룹·역할을 만드는 법은 사용자·그룹·역할 (Keycloak)에 있습니다.

따라 하기#

1. 정의 열기. 홍길동(hong)으로 튜토리얼/레인/구매결재를 엽니다. 레인 「요청자」와 「팀장」이 있습니다. 오른쪽 위 연필 아이콘으로 편집 잠금을 겁니다.
2. 레인 패널 보기. 「팀장」 레인의 왼쪽 띠를 더블클릭합니다. 「배분 범위」는 「기관 + 권한」, 「배분 규칙」은 「선점」, 기관은 구매결재, 권한은 purchase-lead로 보입니다.

   

3. 목록은 고정값. 「기관」 칸의 목록을 펼치면 Keycloak의 가온가전 그룹이 아니라 이 브랜치에 고정된 값만 나옵니다. 그래서 그룹·역할은 아래 「설정 레퍼런스」의 JSON을 정의에 직접 적어 배포합니다.
4. 사용자 직접 지정의 함정. 「사용자 직접 지정」을 누르면 Keycloak 사용자 목록이 나옵니다. 여기서 고르면 이메일(yoon@gaon.example)이 저장되는데, 업무 목록은 사용자 이름(yoon)으로 찾기 때문에 그 작업은 누구의 목록에도 뜨지 않습니다. 패널은 저장하지 않고 닫고, 자물쇠 아이콘(「저장 없이 잠금 해제」)으로 잠금을 풉니다.

   

5. 요청하기. 최구매(choi)로 같은 정의를 열고 「실행」을 누릅니다. 「구매 요청」 칸에 품목 노트북 3대, 금액 2400000을 넣고 「완료」를 누릅니다. 첫 레인 「요청자」에는 설정이 없으므로 실행한 최구매가 요청자가 됩니다.

   

6. 최구매에게는 안 보임. 최구매의 업무 목록에는 「구매 결재」가 없습니다. 최구매는 구매결재 그룹에 속하지 않기 때문입니다.
7. 선점. 윤팀장(yoon)의 업무 목록에는 「구매 결재」가 담당자 없는 그룹 작업으로 있습니다. 카드의 체크 상자를 고르고 「선택 1건 선점」을 누르면 「다중 선점 결과」에 「총 1건 중 성공 1건」이 뜨고, 작업의 담당자가 yoon이 됩니다.

   

8. 완료. 카드를 열어 「결재의견」을 적고 「완료」를 누릅니다. 화면이 인스턴스(구매 결재_<번호>, 「Completed」)로 넘어가고, 「인스턴스 업무 히스토리」에 「구매 요청」(choi)과 「구매 결재」(yoon)가 COMPLETED로 남습니다. 업무 목록에서는 카드가 사라집니다.

   

설정 레퍼런스#

레인 패널 ↔ JSON#

패널에서 저장하면 위 JSON이 org.uengine.hwlife.overriding.BoundRoleResolutionContext의 base로 한 번 더 감싸여 저장됩니다. 직접 적을 때는 감싸지 않아도 됩니다.

배포한 정의(발췌)#

<bpmn:laneSet id="LaneSet_1">
  <bpmn:lane id="Lane_Requester" name="요청자">          <!-- 설정 없음: 실행한 사람 -->
    <bpmn:flowNodeRef>StartEvent_1</bpmn:flowNodeRef>
    <bpmn:flowNodeRef>Task_Request</bpmn:flowNodeRef>
  </bpmn:lane>
  <bpmn:lane id="Lane_Lead" name="팀장">
    <bpmn:extensionElements>
      <uengine:properties json="{&quot;roleResolutionContext&quot;:{&quot;_type&quot;:&quot;org.uengine.five.overriding.IAMRoleResolutionContext&quot;,&quot;groupName&quot;:&quot;구매결재&quot;,&quot;scope&quot;:&quot;purchase-lead&quot;},&quot;dispatchingOption&quot;:1}" />
    </bpmn:extensionElements>
    <bpmn:flowNodeRef>Task_Approve</bpmn:flowNodeRef>
    <bpmn:flowNodeRef>EndEvent_1</bpmn:flowNodeRef>
  </bpmn:lane>
</bpmn:laneSet>

JSON만 펼쳐 쓰면 다음과 같습니다. 아래쪽은 사용자 직접 지정 설정입니다.

{"roleResolutionContext": {"_type": "org.uengine.five.overriding.IAMRoleResolutionContext",
                           "groupName": "구매결재", "scope": "purchase-lead"},
 "dispatchingOption": 1}

{"roleResolutionContext": {"_type": "org.uengine.kernel.DirectRoleResolutionContext", "endpoint": "yoon"}}

사람 작업에는 레인 이름을 role로 적어 둡니다({"_type":"org.uengine.kernel.HumanActivity","role":"팀장", …}). 파일로 배포할 때는 definitions/와 archive/<정의>.bpmn/<버전>.bpmn에 같은 파일을 두고 POST /definition-changes로 알립니다(버전과 배포).

API#

# 시작할 때 레인의 사람을 정해 줄 수 있습니다(설정 없는 레인). 값은 사용자 이름입니다.
curl -X POST http://localhost:9294/instance -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"processDefinitionId":"튜토리얼/레인/구매결재","roleMappings":[{"name":"요청자","endpoints":["choi"]}]}'

# 내 할 일(그룹 작업 포함)
curl http://localhost:9294/worklist/search/findToDo -H "Authorization: Bearer $TOKEN"

업무 목록의 「선택 N건 선점」은 POST /instance/multi-claim을 ESB 봉투 형식으로 호출합니다. (작업 화면의 「선점하기」는 담당자를 이메일로 저장해 작업이 목록에서 사라지므로 쓰지 않습니다 — 업무 목록에서 일하기 알려진 제약.)

{"header": {"emnb": "yoon", "belnOrgnCode": "구매결재"},
 "payload": {"dvsnVal": "0", "bswrList": [{"fncgBpmTaskLstId": "<taskId>", "fncgBpmPcesIntcId": "<instId>"}]}}

emnb는 선점하는 사람, belnOrgnCode는 작업의 그룹, dvsnVal은 0 선점 · 1 선점 해제입니다.

알려진 제약#

확인 문제#