작업 입력값과 데이터 매핑

사용자 작업의 입력 칸은 아규먼트로 정하고, 데이터 매핑으로 그 값을 프로세스 변수에 옮깁니다. 「구매 요청」에 품목·금액 칸을 만들고 매퍼로 변수 구매품목·구매금액에 연결해 실행 결과를 확인합니다.

무엇을 · 왜#

작업 하나가 주고받는 값과 프로세스 전체에서 사용하는 값은 다릅니다.

Camunda의 입력·출력 매핑(input/output mappings)과 같은 역할을 합니다. 매핑이 있으면 작업의 칸 이름과 변수 이름을 따로 지을 수 있고, 다음 작업·게이트웨이·서비스 작업은 변수만 참조하면 됩니다.

• out: 작업이 끝날 때 제출한 값 [Arguments].<아규먼트> → 변수. 이 장에서 씁니다.
• in: 작업이 열릴 때 변수 → 아규먼트(또는 폼 칸). 값을 미리 채웁니다. 폼 붙이기·업무 목록에서 일하기에서 씁니다.

따라 하기#

1. 편집 잠금. 홍길동으로 튜토리얼/매핑/구매요청을 열고 연필 아이콘을 누릅니다.
2. 아규먼트 만들기. 「구매 요청」을 더블클릭합니다. 「데이터 처리 방식」은 「기본」입니다. 아래쪽 「아규먼트 이름」 칸에 품목을 적고 Enter를 누릅니다(타입은 기본값 「문자열」). 다시 금액을 적고 타입을 「정수」로 바꾼 뒤 Enter를 누릅니다.

   

3. 매퍼 열기. 「데이터 매핑」을 누르면 「구매 요청 매퍼」가 열립니다. 왼쪽 트리의 「Arguments」, 오른쪽 트리의 「Variables」를 펼칩니다.
4. 선 잇기. 왼쪽 품목의 연결점에서 오른쪽 구매품목으로, 금액에서 구매금액으로 끌어 선을 잇습니다.

   

5. 저장. 매퍼 오른쪽 위 디스켓 → 패널의 디스켓 → 패널 닫기 → 화면 오른쪽 위 디스켓(「버전 업 / 설명 / 저장」 창의 「저장」) 순서로 저장합니다. 매퍼만 저장하고 정의를 저장하지 않으면 실행에 반영되지 않습니다.
6. 실행. 「실행」을 누르면 「Process 실행」 창에 첫 작업의 「품목」「금액」 칸이 나옵니다. 노트북 5대, 7500000을 넣고 「완료」를 누릅니다.

   

7. 변수 확인. 관리자 화면 /admin/<인스턴스 ID>의 「프로세스 변수」 탭에서 구매품목 = 노트북 5대, 구매금액 = 7500000을 확인합니다.

   

설정 레퍼런스#

아규먼트#

매핑#

argument.text는 받는 쪽, variable.name은 주는 쪽입니다. out이면 받는 쪽이 변수, in이면 받는 쪽이 작업의 칸입니다. 이름 앞의 [Arguments].는 「이번에 제출한 값」을 뜻합니다.

저장된 작업(발췌)#

녹화에서 화면으로 저장한 「구매 요청」의 속성입니다.

{"_type": "org.uengine.kernel.HumanActivity", "role": "요청자",
 "eventSynchronization": {"eventType": "",
   "attributes": [{"name": "품목", "className": "String", "isKey": false, "isCorrKey": false},
                  {"name": "금액", "className": "Integer", "isKey": false, "isCorrKey": false}],
   "mappingContext": {"mappingElements": [
     {"argument": {"text": "구매품목"}, "direction": "out", "variable": {"name": "[Arguments].품목"}},
     {"argument": {"text": "구매금액"}, "direction": "out", "variable": {"name": "[Arguments].금액"}}]}}}

API#

화면의 「완료」와 같은 일을 API로 처리하려면 아규먼트 이름을 키로 값을 보냅니다. 매핑은 엔진이 적용합니다.

curl -X POST http://localhost:9294/work-item/<taskId>/complete -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"parameterValues": {"품목": "노트북 5대", "금액": 7500000}}'
curl http://localhost:9294/instance/<instId>/variables -H "Authorization: Bearer $TOKEN"   # 변수 전부

알려진 제약#

확인 문제#