對(duì)于工作流引擎的解釋請(qǐng)參考百度百科:工作流引擎
在第一家公司工作的時(shí)候主要任務(wù)就是開發(fā)OA系統(tǒng),當(dāng)然基本都是有工作流的支持,不過當(dāng)時(shí)使用的工作流引擎是公司一些牛人開發(fā)的(據(jù)說是用一個(gè)開源的引擎修改的),名稱叫CoreFlow;功能相對(duì)Activiti來說比較弱,但是能滿足日常的使用,當(dāng)然也有不少的問題所以后來我們只能修改引擎的代碼打補(bǔ)丁。
現(xiàn)在是我工作的第二家公司,因?yàn)橐_發(fā)ERP、OA等系統(tǒng)需要使用工作流,在項(xiàng)目調(diào)研階段我先搜索資料選擇使用哪個(gè)開源工作流引擎,最終確定了Activiti5并基于公司的架構(gòu)做了一些DEMO。
對(duì)于Activiti、jBPM4、jBPM5我們應(yīng)該如何選擇,在InfoQ上有一篇文章寫的很好,從大的層面比較各個(gè)引擎之間的差異,請(qǐng)參考文章:縱觀jBPM:從jBPM3到j(luò)BPM5以及Activiti5
官網(wǎng):http://www.activiti.org/
版本:Activiti的版本是從5開始的,因?yàn)锳ctiviti是使用jBPM4的源碼;版本發(fā)布:兩個(gè)月發(fā)布一次。
Eclipse Plugin: http://activiti.org/designer/update/
Activit中文群:5435716
因?yàn)锳ctiviti剛剛退出不久所以資料比較空缺,中文資料更是少的可憐,所以開始的時(shí)候一頭霧水(雖然之前用過工作流,但是感覺差距很多),而且官方的手冊(cè)還不是很全面;所以我把我在學(xué)習(xí)使用的過程遇到的一些疑問都羅列出來分享給大家;以下幾點(diǎn)是我遇到和想到的,如果你還有什么疑問可以在評(píng)論中和我交流再補(bǔ)充。
亂碼是一直纏繞著國人的問題,之前各個(gè)技術(shù)、工具出現(xiàn)亂碼的問題寫過很多文章,這里也不例外……,Activiti的亂碼問題在流程圖中。
流程圖的亂碼如下圖所示:
解決辦法有兩種:
修改源碼
org.activiti.engine.impl.bpmn.diagram.ProcessDiagramCanvas
在構(gòu)造方法
public ProcessDiagramCanvas(int width, int height)中有一行代碼是設(shè)置字體的,默認(rèn)是用Arial字體,這就是亂碼產(chǎn)生的原因,把字改為本地的中文字體即可,例如:
當(dāng)然如果你有配置文件讀取工具那么可以設(shè)置在*.properties文件中,我就是這么做的:
從5.12版本開始支持設(shè)置字體名稱,在引擎中添加如下設(shè)置,在生成圖片時(shí)即可使用微軟雅黑設(shè)置圖片中的文字。
Activiti支持部署*.bpmn20.xml、bar、zip格式的流程定義。
使用Activit Deisigner工具設(shè)計(jì)流程圖的時(shí)候會(huì)有三個(gè)類型的文件:
.activiti設(shè)計(jì)工具使用的文件
.bpmn20.xml設(shè)計(jì)工具自動(dòng)根據(jù).activiti文件生成的xml文件
.png流程圖圖片
解決辦法就是把xml文件和圖片文件同時(shí)部署,因?yàn)樵趩为?dú)部署xml文件的時(shí)候Activiti會(huì)自動(dòng)生成一張流程圖的圖片文件,但是這樣在使用的時(shí)候坐標(biāo)和圖片對(duì)應(yīng)不起來……
所以把xml和圖片同時(shí)部署的時(shí)候Activiti自動(dòng)關(guān)聯(lián)xml和圖片,當(dāng)需要獲取圖片的時(shí)候直接返回部署時(shí)壓縮包里面的圖片文件,而不是Activiti自動(dòng)生成的圖片文件
在“Package Explorer”視圖中右鍵項(xiàng)目名稱然后點(diǎn)擊“Create deployment artifacts”,會(huì)在src目錄中創(chuàng)建deployment文件夾,里面包含*.bar文件.
這也是我們采用的辦法,你可以手動(dòng)選擇xml和png打包成zip格式的文件,也可以像我們一樣采用ant target的方式打包這兩個(gè)文件。
1 2 3 4 5 6 7 8 9 10 11 12 |
|
這樣當(dāng)修改流程定義文件后只要運(yùn)行ant命令就可以打包了:
ant workflow.package.oa.leave
現(xiàn)在部署bar或者zip文件查看流程圖圖片就不是亂碼了,而是你的壓縮包里面的png文件。
定義表單的方式在每個(gè)Task標(biāo)簽中定義extensionElements和activiti:formProperty即可,到達(dá)這個(gè)節(jié)點(diǎn)的時(shí)候可以通過API讀取表單元素。
Activiti官方的例子使用的就是在流程定義中設(shè)置每一個(gè)節(jié)點(diǎn)顯示什么樣的表單哪些字段需要顯示、哪些字段只讀、哪些字段必填。
但是這種方式僅僅適用于比較簡(jiǎn)單的流程,對(duì)于稍微復(fù)雜或者頁面需要業(yè)務(wù)邏輯的判斷的情況就不適用了。
對(duì)于數(shù)據(jù)的保存都是在引擎的表中,不利于和其他表的關(guān)聯(lián)、對(duì)整個(gè)系統(tǒng)的規(guī)劃也不利!
這種方式應(yīng)該是大家用的最多的了,因?yàn)橐话愕臉I(yè)務(wù)系統(tǒng)業(yè)務(wù)邏輯都會(huì)比較復(fù)雜,而且數(shù)據(jù)庫中很多表都會(huì)有依賴關(guān)系,表單中有很多狀態(tài)判斷。
例如我們的系統(tǒng)適用jQuery UI作為UI,有很多javascript代碼,頁面的很多操作需要特殊處理(例如:多個(gè)選項(xiàng)的互斥、每個(gè)節(jié)點(diǎn)根據(jù)類型和操作人顯示不同的按鈕);基本每個(gè)公司都有一套自己的UI風(fēng)格,要保持多個(gè)系統(tǒng)的操作習(xí)慣一致只能使用自定義表單才能滿足。
這個(gè)問題在群里面很多人都問過,這也是我剛剛開始迷惑的地方;
后來看了以下API發(fā)現(xiàn)RuntimeService有兩個(gè)方法:
javadoc對(duì)其說明:
startProcessInstanceByKey(String processDefinitionKey, Mapvariables) Starts a new process instance in the latest version of the process definition with the given key
其中businessKey就是業(yè)務(wù)ID,例如要申請(qǐng)請(qǐng)假,那么先填寫登記信息,然后(保存+啟動(dòng)流程),因?yàn)檎?qǐng)假是單獨(dú)設(shè)計(jì)的數(shù)據(jù)表,所以保存后得到實(shí)體ID就可以把它傳給processInstanceBusinessKey方法啟動(dòng)流程。當(dāng)需要根據(jù)businessKey查詢流程的時(shí)候就可以通過API查詢:
建議數(shù)據(jù)庫冗余設(shè)計(jì):在業(yè)務(wù)表設(shè)計(jì)的時(shí)候添加一列:PROCESS_INSTANCE_ID varchar2(64),在流程啟動(dòng)之后把流程ID更新到業(yè)務(wù)表中,這樣不管從業(yè)務(wù)還是流程都可以查詢到對(duì)方!
特別說明: 此方法啟動(dòng)時(shí)自動(dòng)選擇最新版本的流程定義。
javadoc對(duì)其說明:
startProcessInstanceById(String processDefinitionId, String businessKey, Mapvariables) Starts a new process instance in the exactly specified version of the process definition with the given id.
processDefinitionId:這個(gè)參數(shù)的值可以通過repositoryService.createProcessDefinitionQuery()方法查詢,對(duì)應(yīng)數(shù)據(jù)庫:ACT_RE_PROCDEF;每次部署一次流程定義就會(huì)添加一條數(shù)據(jù),同名的版本號(hào)累加。
特別說明: 此可以指定不同版本的流程定義,讓用戶多一層選擇。
建議使用startProcessInstanceByKey,特殊情況需要使用以往的版本選擇使用startProcessInstanceById。
這個(gè)問題也是比較多的人詢問過,Activiti支持對(duì)任務(wù)分配到:指定人、指定組、兩者組合,而這些人和組的信息都保存在ACT_ID..表中,有自己的用戶和組(角色)管理讓很多人不知所措了;原因是因?yàn)槊總€(gè)系統(tǒng)都會(huì)存在一個(gè)權(quán)限管理模塊(維護(hù):用戶、部門、角色、授權(quán)),不知道該怎么和Activiti同步。
Activiti有一個(gè)IdentityService接口,通過這個(gè)接口可以操控Activiti的ACT_ID_*表的數(shù)據(jù),一般的做法是用業(yè)務(wù)系統(tǒng)的權(quán)限管理模塊維護(hù)用戶數(shù)據(jù),當(dāng)進(jìn)行CRUD操作的時(shí)候在原有業(yè)務(wù)邏輯后面添加同步到Activiti的代碼;例如添加一個(gè)用戶時(shí)同步Activiti User的代碼片段:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 |
|
刪除操作也和這個(gè)類似!
不管從業(yè)務(wù)系統(tǒng)維護(hù)用戶還是從Activiti維護(hù),肯定要確定一方,然后CRUD的時(shí)候同步到對(duì)方,如果需要同步多個(gè)子系統(tǒng)那么可以再調(diào)用WebService實(shí)現(xiàn)。
Activiti提供了兩個(gè)流程設(shè)計(jì)工具,但是面向?qū)ο蟛煌?/p>
Activiti Modeler,面向業(yè)務(wù)人員,使用開源的BPMN設(shè)計(jì)工具Signavio,使用BPMN描述業(yè)務(wù)流程圖
Eclipse Designer,面向開發(fā)人員,Eclipse的插件,可以讓開發(fā)人員定制每個(gè)節(jié)點(diǎn)的屬性(ID、Name、Listener、Attr等)
可能你會(huì)驚訝,因?yàn)槲覀儧]有使用Activiti Modeler,我們認(rèn)為用Viso已經(jīng)能表達(dá)流程圖的意思了,而且項(xiàng)目經(jīng)理也是技術(shù)出身,和開發(fā)人員也容易溝通。
目前這個(gè)項(xiàng)目是第一個(gè)使用Activiti的,開始我們?cè)谛枨笳{(diào)研階段使用Viso設(shè)計(jì)流程圖,利用泳道流程圖設(shè)計(jì)和客戶溝通,確定后由負(fù)責(zé)流程的開發(fā)人員用Eclipse Designer設(shè)計(jì)得到bpmn20.xml,最后部署。
這個(gè)插件有一個(gè)很討厭的Bug一直未修復(fù),安裝了插件后Eclipse的復(fù)制和粘帖快捷鍵會(huì)被更換為(Ctrl+Insert、Shift+Insert);Bug描述請(qǐng)見:
所以最后我們只能單獨(dú)開一個(gè)安裝了Eclipse Designer的Eclipse專門用來設(shè)計(jì)流程圖,這樣就不影響正常使用Eclipse JAVAEE了。
對(duì)于和Spring的集成Activiti做的不錯(cuò),簡(jiǎn)單配置一些Bean代理即可實(shí)現(xiàn),但是有兩個(gè)和事務(wù)相關(guān)的地方要提示:
配置processEngineConfiguration的時(shí)候?qū)傩?strong>transactionManager要使用和業(yè)務(wù)功能的同一個(gè)事務(wù)管理Bean,否則事務(wù)不同步。
對(duì)于實(shí)現(xiàn)了org.activiti.engine.delegate包中的接口的類需要被事務(wù)控制的實(shí)現(xiàn)類需要被Spring代理,并且添加事務(wù)的Annotation或者在xml中配置,例如:
單元測(cè)試均使用Spring的AbstractTransactionalJUnit4SpringContextTests作為SuperClass,并且在測(cè)試類添加:
雖然Activiti也提供了測(cè)試的一些超類,但是感覺不好用,所以自己封裝了一些方法。
代碼請(qǐng)轉(zhuǎn)移:https://gist.github.com/2182847
代碼請(qǐng)轉(zhuǎn)移:https://gist.github.com/2182869
代碼請(qǐng)轉(zhuǎn)移:https://gist.github.com/2182973
我們目前分為4中狀態(tài):未簽收、辦理中、運(yùn)行中、已完成。
查詢到任務(wù)或者流程實(shí)例后要顯示在頁面,這個(gè)時(shí)候需要添加業(yè)務(wù)數(shù)據(jù),最終結(jié)果就是業(yè)務(wù)和流程的并集,請(qǐng)參考6.2。
此類任務(wù)針對(duì)于把Task分配給一個(gè)角色時(shí),例如部門領(lǐng)導(dǎo),因?yàn)?strong>部門領(lǐng)導(dǎo)角色可以指定多個(gè)人所以需要先簽收再辦理,術(shù)語:搶占式
對(duì)應(yīng)的API查詢:
1 2 3 4 5 6 7 8 9 10 | /** * 獲取未簽收的任務(wù)查詢對(duì)象 * @param userId 用戶ID */ @Transactional (readOnly = true ) public TaskQuery createUnsignedTaskQuery(String userId) { TaskQuery taskCandidateUserQuery = taskService.createTaskQuery().processDefinitionKey(getProcessDefKey()) .taskCandidateUser(userId); return taskCandidateUserQuery; } |
此類任務(wù)數(shù)據(jù)類源有兩種:
簽收后的,5.1中簽收后就應(yīng)該為辦理中狀態(tài)
節(jié)點(diǎn)指定的是具體到一個(gè)人,而不是角色
對(duì)應(yīng)的API查詢:
說白了就是沒有結(jié)束的流程,所有參與過的人都應(yīng)該可以看到這個(gè)實(shí)例,但是Activiti的API沒有可以通過用戶查詢的方法,這個(gè)只能自己用hack的方式處理了,我目前還沒有處理。
從表ACT_RU_EXECUTION中查詢數(shù)據(jù)。
對(duì)應(yīng)的API查詢:
1 2 3 4 5 6 7 8 9 10 | /** * 獲取未經(jīng)完成的流程實(shí)例查詢對(duì)象 * @param userId 用戶ID */ @Transactional (readOnly = true ) public ProcessInstanceQuery createUnFinishedProcessInstanceQuery(String userId) { ProcessInstanceQuery unfinishedQuery = runtimeService.createProcessInstanceQuery().processDefinitionKey(getProcessDefKey()) .active(); return unfinishedQuery; } |
已經(jīng)結(jié)束的流程實(shí)例。
從表ACT_HI_PROCINST中查詢數(shù)據(jù)。
1 2 3 4 5 6 7 8 9 10 | /** * 獲取已經(jīng)完成的流程實(shí)例查詢對(duì)象 * @param userId 用戶ID */ @Transactional (readOnly = true ) public HistoricProcessInstanceQuery createFinishedProcessInstanceQuery(String userId) { HistoricProcessInstanceQuery finishedQuery = historyService.createHistoricProcessInstanceQuery() .processDefinitionKey(getProcessDefKey()).finished(); return finishedQuery; } |
提示:之前在業(yè)務(wù)對(duì)象添加了PROCESS_INSTANCE_ID字段
思路:現(xiàn)在可以利用這個(gè)字段查詢了,不管是Task還是ProcessInstance都可以得到流程實(shí)例ID,可以根據(jù)流程實(shí)例ID查詢實(shí)體然后把流程對(duì)象設(shè)置到實(shí)體的一個(gè)屬性中由Action或者Controller輸出到前臺(tái)。
代碼請(qǐng)參考:https://gist.github.com/2183557
結(jié)合實(shí)際業(yè)務(wù)描述一個(gè)業(yè)務(wù)從開始到結(jié)束的過程,對(duì)于迷惑的同學(xué)看完豁然開朗了;這里使用請(qǐng)假作為例子。
這樣的好處是申請(qǐng)和流程辦理分離開處理,列表顯示未啟動(dòng)流程的請(qǐng)假記錄(數(shù)據(jù)庫PROCESS_INSTANCE_ID為空)。
申請(qǐng)界面的截圖:
圖片方式顯示當(dāng)前節(jié)點(diǎn):
列表形式顯示流程流轉(zhuǎn)過程:
Java代碼請(qǐng)移步:https://gist.github.com/2183712
Javascript思路:先通過Ajax獲取當(dāng)前節(jié)點(diǎn)的坐標(biāo),在指定位置添加紅色邊框,然后加載圖片。
代碼移步:https://gist.github.com/2183804
之前就想寫這篇文章,現(xiàn)在終于完成了,花費(fèi)了幾個(gè)小時(shí),希望能節(jié)省你幾天的時(shí)間。
請(qǐng)讀者仔細(xì)閱讀Activiti的用戶手冊(cè)和Javadoc。
如果有什么疑問或者對(duì)于功能的實(shí)現(xiàn)有更好的辦法歡迎提出、分享。
動(dòng)態(tài)指定任務(wù)辦理人是群里面詢問比較多的問題之一,其實(shí)就是一層窗戶紙,只要在任務(wù)完成的時(shí)候傳遞activiti:assignee屬性中的變量即可。
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("hrUserId", hrUserId);
taskService.complete(taskId, variables);
下面的代碼是利用initiator功能,設(shè)置一個(gè)名稱(不是變量而是變量名)到啟動(dòng)事件上,并且在啟動(dòng)流程時(shí)調(diào)用一些下面的方法:
其中currentUserId表示當(dāng)前用戶,也就是啟動(dòng)流程的人,配置如下所示:
這樣流程啟動(dòng)之后如果任務(wù)流轉(zhuǎn)至"銷假"節(jié)點(diǎn)則會(huì)自動(dòng)把任務(wù)分配給啟動(dòng)流程的人。
如果在啟動(dòng)流程的時(shí)候調(diào)用了下面的代碼:
引擎會(huì)記錄啟動(dòng)人,即在ACT_HI_PROINST表的START_USER_ID字段,可以通過下面的代碼獲取。
很多人問“Owner”屬性為什么是空的,什么時(shí)候用?要了解它的作用首先要了解“代辦”。
代辦的概念可以用下面的一句話概括:
你領(lǐng)導(dǎo)接到一個(gè)任務(wù),讓你代辦,你辦理完成后任務(wù)還是回歸到你的領(lǐng)導(dǎo),事情是你做的,功勞是你領(lǐng)導(dǎo)的,此乃代辦也!
看到這個(gè)單元測(cè)試你就明白什么是代辦:ProcessTestDelegateTask
最好把activiti-study這個(gè)項(xiàng)目下載下來導(dǎo)入到Eclipse中運(yùn)行一下:https://github.com/henryyan/activiti-study
聯(lián)系客服