다른 앱 화면을 작업으로 (URL 작업)

URL 작업은 다른 시스템의 화면을 BPM 작업 화면 안에 iframe으로 띄웁니다. 주소에 <%instance.corrkey%> 같은 값의 자리를 두면 인스턴스마다 해당 건의 화면이 열립니다. 작업은 외부 앱이 이벤트나 REST로 끝냅니다.

무엇을 · 왜#

ERP의 입고 전표나 계정계의 계좌개설처럼 이미 다른 시스템의 화면에서 처리하는 업무가 있습니다. 같은 입력 칸을 BPM 폼으로 다시 만들 필요 없이, 그 화면을 작업 안에 띄우고 BPM은 「누가, 언제, 다음은 무엇」만 맡습니다. Camunda의 외부 폼(external form, formKey에 URL)과 비슷하지만, uEngine6는 작업 화면 안에 그 주소를 직접 엽니다.

URL 작업의 업무 화면에는 「완료」 버튼이 없습니다. 일을 끝냈다는 사실은 그 화면을 제공하는 외부 앱이 알려 줘야 합니다.

따라 하기#

1. 작업 패널. 홍길동으로 튜토리얼/URL작업/발주서확인을 열고 연필 아이콘을 누른 뒤 「발주서 확인」을 더블클릭합니다. 「데이터 처리 방식」이 「외부 어플리케이션」이고, 「URL」 칸에 http://localhost:8288/erp/#/r/purchase_order/<%instance.corrkey%>가 있습니다. 그 아래 「이벤트 키」와 「+ 이벤트 추가」는 이 작업을 이벤트로 끝낼 때 씁니다(작업을 이벤트로 끝내기). 저장하지 않고 닫은 뒤 자물쇠 아이콘으로 잠금을 풉니다.

   

2. 인스턴스 시작. 정회계가 상관 키에 ERP 발주서 id를 넣어 시작합니다(첫 작업의 레인이 정회계이므로 시작하는 사람도 정회계여야 합니다). 작업 항목의 tool이 urlHandler:http://localhost:8288/erp/#/r/purchase_order/<발주서 id>로 바뀐 것을 확인할 수 있습니다.

   curl -X POST http://localhost:9294/instance -H "Authorization: Bearer $JUNG_TOKEN" -H 'Content-Type: application/json' \
     -d '{"processDefinitionId":"튜토리얼/URL작업/발주서확인","correlationKeyValue":"<ERP 발주서 id>",
          "roleMappings":[{"name":"회계","endpoints":["jung"]}]}'
   

3. 작업 열기. 정회계(jung)의 업무 목록에서 「발주서 확인」을 엽니다. 오른쪽에 ERP 발주서 P00001(공급사 바람부품, 에어서큘레이터 60개, 3,000,000원)이 그대로 뜹니다. ERP 웹은 같은 게이트웨이 뒤(/erp/)에 있어 같은 출처로 열립니다. ERP는 iframe 안에서 메뉴 없는 임베드 모드로 표시됩니다. ERP 로그인은 ERP가 따로 확인합니다(정회계는 ERP에도 로그인해 있어야 합니다).

   

4. 끝내기. 이 화면에는 「완료」가 없습니다. 외부 앱이 일을 마치면 이벤트나 REST로 작업을 끝냅니다. 이 장에서는 REST로 끝냈습니다. 업무 목록에서 카드가 사라지고 인스턴스가 끝납니다.

   

   curl -X POST http://localhost:9294/work-item/<taskId>/complete -H "Authorization: Bearer $JUNG_TOKEN" -H 'Content-Type: application/json' -d '{"parameterValues":{}}'
   

설정 레퍼런스#

정의(발췌)#

{"_type": "org.uengine.kernel.URLActivity", "role": "회계",
 "url": "http://localhost:8288/erp/#/r/purchase_order/<%instance.corrkey%>",
 "description": {"text": "ERP 발주서의 공급사·수량·금액을 확인합니다"}}

이벤트로 끝내려면 eventSynchronizations를 추가합니다(ERP 예제의 「입고 처리」).

"eventSynchronizations": [{"eventType": "PickingValidated",
  "attributes": [{"name": "poId", "className": "String", "isKey": true, "isCorrKey": true}]}]

주소 안의 자리#

같은 출처와 다른 출처#

# keycloak-gateway application.yml — 프런트 catch-all(/**) 보다 앞에
- id: erp-web
  uri: http://localhost:5302
  predicates:
    - Path=/erp, /erp/**

업무 화면은 iframe 안의 앱이 보내는 postMessage 중 주소와 같은 출처에서 온 것만 받고, 메시지의 eventType이 작업의 이벤트와 같으면 진행 표시를 갱신합니다(작업을 끝내는 것은 서버로 전달된 이벤트입니다).

알려진 제약#

확인 문제#