스크립트로 값 계산 (스크립트 작업)

구매 금액에서 부가세(10%)를 JavaScript로, 합계 문구를 Java로 계산해 프로세스 변수에 넣습니다. 스크립트 작업은 사람이 처리할 필요 없이 바로 실행되고, 결과는 관리자 화면의 변수로 확인합니다.

무엇을 · 왜#

스크립트 작업(script task)은 엔진 안에서 짧은 코드를 실행하는 자동 작업입니다. 그림에서는 왼쪽 위에 두루마리 아이콘이 있는 사각형입니다. 변수로 계산하거나 문자열을 만들고, 다음 게이트웨이에서 확인할 값을 미리 정리할 때 씁니다. 다른 시스템을 호출하는 일은 REST 서비스 작업에 맡기세요.

uEngine6에서는 org.uengine.kernel.ScriptActivity가 맡습니다.

• 스크립트 안에서 쓸 수 있는 이름: instance(프로세스 인스턴스), activity(이 작업), definition(정의), util.
• 변수 읽기: instance.get("", "변수이름") (첫 인자는 실행 범위, 보통 빈 문자열).
• return으로 반환한 값은 「Return 값을 저장 할 변수」(JSON out)에 들어갑니다.
• 이 장의 두 스크립트는 JDK 21 스택에서 둘 다 실행됐습니다.

따라 하기#

1. 정의 보기. 홍길동으로 튜토리얼/스크립트/부가세계산을 엽니다. 「구매 요청 → 부가세 계산 → 합계 계산 → 결재(윤팀장)」입니다. 가운데 두 작업이 스크립트 작업입니다.

   

2. JavaScript 스크립트. 「부가세 계산」을 더블클릭합니다. 「스크립트 타입」은 Javascript이고, 「스크립트」에는 아래 코드가 들어 있습니다. 「Return 값을 저장 할 변수」는 부가세입니다.

   var a = instance.get("", "금액");
   return Math.round(a * 0.1);
   

   

3. Java 스크립트. 「합계 계산」은 「스크립트 타입」이 Java입니다. 메서드 몸통이므로 return으로 끝나고, 전체를 try/catch로 감쌌습니다. 반환 변수는 합계입니다.

   try {
     long a = Long.parseLong(String.valueOf(instance.get("", "금액")));
     long v = ((Number) instance.get("", "부가세")).longValue();
     return "합계 " + (a + v) + "원";
   } catch (Exception e) {
     return "오류 " + e;
   }
   

4. 실행. 최구매로 같은 정의에서 「실행」을 누르고, 품목 노트북, 금액 1250000으로 「완료」합니다.
5. 스크립트는 바로 실행됩니다. 윤팀장의 업무 목록에 「결재」가 곧바로 생깁니다. 작업 화면 그림에서 두 스크립트 작업이 완료된 경로(보라색)로 보입니다.
6. 변수 확인. 홍길동이 관리자 상세(/admin/<인스턴스 ID>)의 「프로세스 변수」 탭을 엽니다. 부가세가 125000, 합계가 합계 1375000원입니다.

   

설정 레퍼런스#

패널 ↔ JSON#

이 장에서 배포한 정의(발췌)#

<bpmn:scriptTask id="Vat" name="부가세 계산">
  <bpmn:extensionElements><uengine:properties><uengine:json>
    {"_type":"org.uengine.kernel.ScriptActivity","language":"0",
     "script":"var a = instance.get(\"\", \"금액\");\nreturn Math.round(a * 0.1);",
     "out":{"name":"부가세","type":"java.lang.Number"}}
  </uengine:json></uengine:properties></bpmn:extensionElements>
</bpmn:scriptTask>
<bpmn:scriptTask id="Sum" name="합계 계산">
  … {"_type":"org.uengine.kernel.ScriptActivity","language":"1","script":"try {\n  long a = …","out":{"name":"합계","type":"java.lang.String"}} …
</bpmn:scriptTask>

반환 변수(부가세·합계)도 정의의 프로세스 변수로 선언해 둡니다(Number, Text).

실행 결과(이 장을 촬영할 때의 실행)#

흔한 실수#

확인 문제#