Activiti腳本任務（ScriptTask）
作者:Jesai
你一直問為什么到不了遠方，請停下數數你的腳步，是不是還沒邁開腿
對於沒有接觸過groovy腳本語言的人來說，可能比較難使用
應用場景：
Activiti腳本任務比較少用，腳本任務一般是用在當前的監聽器或者監聽服務類都不能滿足的情形下面，或者說后期系統維護，突然在不想改動系統的情況下需要對流程做一些適當的改變。僅僅是幾個變量或者僅僅是一個計算公式等等。這個時候可以使用腳本任務。至於還用其他的作用，我暫時沒去多了解。
官方解釋：
Script Task（腳本服務）
A script task is an automatic activity. When a process execution arrives at the script task, the corresponding script is executed.
腳本任務是一個自動化活動。當一個流程執行到達腳本任務時，執行相應的腳本。
Graphical Notation（圖形）
A script task is visualized as a typical BPMN 2.0 task (rounded rectangle), with a small 'script' icon in the top-left corner of the rectangle.
d的的腳本任務可視化為一個典型的BPMN 2.0 任務（圓角矩形），在矩形的左上角帶有一個小的‘腳本’圖標。
A script task is defined by specifying the script and the scriptFormat.
通過指定腳本（script ）和腳本格式（scriptFormat）定義一個腳本任務。
<scriptTask id="theScriptTask" name="Execute script" scriptFormat="groovy">
<script>
sum = 0
for ( i in inputArray ) {
sum += i
}
</script>
</scriptTask>
The value of the scriptFormat attribute must be a name that is compatible with the JSR-223 (scripting for the Java platform). The Groovy jar is shipped by default with the Activiti distribution. If you want to use another (JSR-223 compatible) scripting engine, it is sufficient to add the corresponding jar to the classpath and use the appropriate name.
scriptFormat屬性的值必須是一個和JSR-223 兼容的名稱（Java平台上的腳本系統）。發布包缺省帶有Groovy jar包。如果你想使用另外的腳本引擎，將相應的jar包加入classpath里。
Variables in scripts（腳本里的變量）
All process variables that are accessible through the execution that arrives in the script task, can be used within the script. In the example, the script variable 'inputArray' is in fact a process variable (an array of integers).
通過到達在腳本任務里的執行，所有可以訪問的流程變量也能夠在腳本里面使用。在本例中，腳本變量'inputArray'事實上是一個流程變量（一個整數數組）。
<script>
sum = 0
for ( i in inputArray ) {
sum += i
}
</script>
It's also possible to set process variables in a script, simply by using an assignment statement. In the example above, the 'sum' variable will be stored as a process variable after the script task has been executed. To avoid this behavior, script-local variables can be used. In Groovy, the keyword 'def' must then be used: 'def sum = 0'. In that case, no process variable will be stored.
簡單地通過使用一個賦值語句，也可能在一個腳本里設置流程變量。在上例，在腳本任務已經執行之后， 'sum'變量將保存為一個流程變量。為了避免這個行為，能夠使用腳本局部變量。在Groovy里面，必須使用關鍵字 'def' ： 'def sum = 0'。在那種情況下，將不保存任何流程變量。
An alternative is to set variables through the current execution, which is available as a reserved variable called 'execution'.
通過當前執行，有另外設置變量的可選方式，作為叫做 'execution'的保留變量可以獲得。
<script>
def scriptVar = "test123"
execution.setVariable("myVar", scriptVar)
</script>
Note: the following names are reserved and cannot be used as variable names: out, out:print, lang:import, context, elcontext.
注意：下列名稱將要保留並且不能作為變量名被使用（cannot be used）：out, out:print, lang:import, context, elcontext。
Script results（腳本結果）
The return value of a script task can be assigned to an already existing or to a new process variable by specifying the process variable name as a literal value for the'activiti:resultVariableName' attribute of a script task definition. Any existing value for a specific process variable will be overwritten by the result value of the script execution. When not specifying a result variable name, the script result value gets ignored.
為了一個腳本任務定義的屬性 'activiti:resultVariableName' ，通過指定流程變量名稱為一個字面值，腳本任務的返回值能夠分配給已經存在的或者一個新的流程變量。對於一個特定的流程變量的任何存在的值將被腳本執行的結果值復寫。當沒有指定一個結果變量值，腳本結果值被忽視。
<scriptTask id="theScriptTask" name="Execute script" scriptFormat="juel" activiti:resultVariableName="myVar">
<script>#{echo}</script>
</scriptTask>
In the above example, the result of the script execution (the value of the resolved expression '#{echo}') is set to the process variable named 'myVar' after the script completes.
的在上例里，在腳本完成之后，腳本執行（解析變量 '#{echo}'的值）的結果被設置為名叫'myVar'的流程變量。
我們將會使用Groovy腳本來實現腳本任務。
什么是Groovy腳本？
Groovy是一種基於JVM（Java虛擬機）的敏捷開發語言，它結合了Python、Ruby和Smalltalk的許多強大的特性，Groovy 代碼能夠與 Java 代碼很好地結合，也能用於擴展現有代碼。由於其運行在 JVM 上的特性，Groovy 可以使用其他 Java 語言編寫的庫。
需要的jar包：
groovy-all-2.4.3.jar
ScriptTask實現：
流程圖設計：
制定腳本的語言scriptformat=”groovy”
流程設計的代碼：
1 <?xml version="1.0" encoding="UTF-8"?> 2 <definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.activiti.org/processdef"> 3 <process id="process" isExecutable="true"> 4 <startEvent id="sid-42267A2F-38D1-4A65-A383-6E74430FACC1" activiti:initiator="admin"></startEvent> 5 <scriptTask id="sid-2E17D24E-A933-48E8-8A86-7A05DD363386" name="腳本任務" scriptFormat="groovy" activiti:autoStoreVariables="false"> 6 <script><![CDATA[import light.mvc.workflow.scriptTask.ScriptTask; 7 public class GPerson { 8 public void say(String name){ 9 println "Hello, $name! "; 10 } 11 def foo(){ 12 ScriptTask p = new ScriptTask(); 13 p.ScriptTaskWriteToConsole(); 14 } 15 static void main(args) { 16 GPerson gp = new GPerson(); 17 gp.say("jesai！"); 18 gp.foo(); 19 } 20 } 21 22 def gp = new GPerson() 23 gp.say("jesai！") 24 gp.foo()]]></script> 25 </scriptTask> 26 <endEvent id="sid-315AF00C-DE1A-4390-89B9-F33640B62AAF"></endEvent> 27 <sequenceFlow id="sid-19DCED8B-09E1-4E5C-B81C-4B02B09ED6E9" sourceRef="sid-2E17D24E-A933-48E8-8A86-7A05DD363386" targetRef="sid-315AF00C-DE1A-4390-89B9-F33640B62AAF"></sequenceFlow> 28 <sequenceFlow id="sid-A0230878-472D-4D2B-8FF9-8D7CC9DC5621" sourceRef="sid-42267A2F-38D1-4A65-A383-6E74430FACC1" targetRef="sid-2E17D24E-A933-48E8-8A86-7A05DD363386"></sequenceFlow> 29 </process> 30 <bpmndi:BPMNDiagram id="BPMNDiagram_process"> 31 <bpmndi:BPMNPlane bpmnElement="process" id="BPMNPlane_process"> 32 <bpmndi:BPMNShape bpmnElement="sid-42267A2F-38D1-4A65-A383-6E74430FACC1" id="BPMNShape_sid-42267A2F-38D1-4A65-A383-6E74430FACC1"> 33 <omgdc:Bounds height="30.0" width="30.0" x="106.75" y="97.0"></omgdc:Bounds> 34 </bpmndi:BPMNShape> 35 <bpmndi:BPMNShape bpmnElement="sid-2E17D24E-A933-48E8-8A86-7A05DD363386" id="BPMNShape_sid-2E17D24E-A933-48E8-8A86-7A05DD363386"> 36 <omgdc:Bounds height="80.0" width="100.0" x="252.75" y="72.0"></omgdc:Bounds> 37 </bpmndi:BPMNShape> 38 <bpmndi:BPMNShape bpmnElement="sid-315AF00C-DE1A-4390-89B9-F33640B62AAF" id="BPMNShape_sid-315AF00C-DE1A-4390-89B9-F33640B62AAF"> 39 <omgdc:Bounds height="28.0" width="28.0" x="405.0" y="98.0"></omgdc:Bounds> 40 </bpmndi:BPMNShape> 41 <bpmndi:BPMNEdge bpmnElement="sid-19DCED8B-09E1-4E5C-B81C-4B02B09ED6E9" id="BPMNEdge_sid-19DCED8B-09E1-4E5C-B81C-4B02B09ED6E9"> 42 <omgdi:waypoint x="352.75" y="112.0"></omgdi:waypoint> 43 <omgdi:waypoint x="405.0" y="112.0"></omgdi:waypoint> 44 </bpmndi:BPMNEdge> 45 <bpmndi:BPMNEdge bpmnElement="sid-A0230878-472D-4D2B-8FF9-8D7CC9DC5621" id="BPMNEdge_sid-A0230878-472D-4D2B-8FF9-8D7CC9DC5621"> 46 <omgdi:waypoint x="136.75" y="112.0"></omgdi:waypoint> 47 <omgdi:waypoint x="252.75" y="112.0"></omgdi:waypoint> 48 </bpmndi:BPMNEdge> 49 </bpmndi:BPMNPlane> 50 </bpmndi:BPMNDiagram> 51 </definitions>
腳本語言的編寫：
import light.mvc.workflow.scriptTask.ScriptTask; public class GPerson { public void say(String name){ println "Hello, $name! "; } def foo(){ ScriptTask p = new ScriptTask(); p.ScriptTaskWriteToConsole(); } static void main(args) { GPerson gp = new GPerson(); gp.say("jesai！"); gp.foo(); } } def gp = new GPerson() gp.say("jesai！") gp.foo()
這是一段groovy的腳本語言，也許有得人很多人並沒有接觸過groovy這個腳本。
需要調用的java方法：
1 package light.mvc.workflow.scriptTask; 2 3 4 5 /** 6 7 * 8 9 * 項目名稱：lightmvc 10 11 * 類名稱：ScriptTask 12 13 * 類描述： 14 15 * 創建人：鄧家海 16 17 * 創建時間：2017年6月4日 下午8:02:29 18 19 * 修改人：deng 20 21 * 修改時間：2017年6月4日 下午8:02:29 22 23 * 修改備注： 24 25 * @version 26 27 * 28 29 */ 30 31 32 33 public class ScriptTask { 34 35 36 37 public void ScriptTaskWriteToConsole(){ 38 39 System.out.println("hellow,It is ScriptTask Running!test success!"); 40 41 } 42 43 44 45 }
最后部署流程，運行：
Activiti交流QQ群：634320089