1.流程圖
1$Q]C_1T$T%7I_F{9`Z0M6K.png
2.部署流程定義
/**
* 1.部署流程
* 涉及表:ACT_RE_DEPLOYMENT ACT_RE_PROCDEF
*/
@Test
public void deploymentProcessDefinitionTest() {
InputStream is = this.getClass().getClassLoader().getResourceAsStream("diagrams/Helloworld.zip");
ZipInputStream zis = new ZipInputStream(is);
Deployment dy = processEngine.getRepositoryService().createDeployment().name("測試2").addZipInputStream(zis).deploy();
System.out.println("++++++++++++++++==");
System.out.println(dy.getId());
}
3.啟動流程
- 操作數(shù)據(jù)庫的act_ru_execution表,如果是用戶任務(wù)節(jié)點漓柑,同時也會在act_ru_task添加一條記錄
/**
* 2.啟動流程
* 涉及表:ACT_RU_EXECUTION ACT_RU_TASK
*/
@Test
public void startDeploymentTest() {
// 如果存在多個版本key默認最新
String definitionKey = "helloworld1";
ProcessInstance ps = processEngine.getRuntimeService().startProcessInstanceByKey(definitionKey);
System.out.println("+++++");
System.out.println(ps.getProcessDefinitionId()+":::"+ps.getId());
}
4.查詢我的個人任務(wù)
/**查詢當(dāng)前人的個人任務(wù)*/
@Test
public void findMyPersonalTask(){
String assignee = "張三";
List<Task> list = processEngine.getTaskService()//與正在執(zhí)行的任務(wù)管理相關(guān)的Service
.createTaskQuery()//創(chuàng)建任務(wù)查詢對象
/**查詢條件(where部分)*/
.taskAssignee(assignee)//指定個人任務(wù)查詢教硫,指定辦理人
// .taskCandidateUser(candidateUser)//組任務(wù)的辦理人查詢
// .processDefinitionId(processDefinitionId)//使用流程定義ID查詢
// .processInstanceId(processInstanceId)//使用流程實例ID查詢
// .executionId(executionId)//使用執(zhí)行對象ID查詢
/**排序*/
.orderByTaskCreateTime().asc()//使用創(chuàng)建時間的升序排列
/**返回結(jié)果集*/
// .singleResult()//返回惟一結(jié)果集
// .count()//返回結(jié)果集的數(shù)量
// .listPage(firstResult, maxResults);//分頁查詢
.list();//返回列表
if(list!=null && list.size()>0){
for(Task task:list){
System.out.println("任務(wù)ID:"+task.getId());
System.out.println("任務(wù)名稱:"+task.getName());
System.out.println("任務(wù)的創(chuàng)建時間:"+task.getCreateTime());
System.out.println("任務(wù)的辦理人:"+task.getAssignee());
System.out.println("流程實例ID:"+task.getProcessInstanceId());
System.out.println("執(zhí)行對象ID:"+task.getExecutionId());
System.out.println("流程定義ID:"+task.getProcessDefinitionId());
System.out.println("########################################################");
}
}
}
1) 因為是任務(wù)查詢,所以從processEngine中應(yīng)該得到TaskService
2) 使用TaskService獲取到任務(wù)查詢對象TaskQuery
3) 為查詢對象添加查詢過濾條件辆布,使用taskAssignee指定任務(wù)的辦理者(即查詢指定用戶的代辦任務(wù))瞬矩,同時可以添加分頁排序等過濾條件
4) 調(diào)用list方法執(zhí)行查詢,返回辦理者為指定用戶的任務(wù)列表
5) 任務(wù)ID锋玲、名稱景用、辦理人、創(chuàng)建時間可以從act_ru_task表中查到惭蹂。
6) Execution與ProcessInstance見5.6和5.7章節(jié)的介紹伞插。在這種情況下,ProcessInstance相當(dāng)于Execution
7) 如果assignee屬性為部門經(jīng)理盾碗,結(jié)果為空媚污。因為現(xiàn)在流程只到了”填寫請假申請”階段,后面的任務(wù)還沒有執(zhí)行廷雅,即在數(shù)據(jù)庫中沒有部門經(jīng)理可以辦理的任務(wù)耗美,所以查詢不到京髓。
8) 一個Task節(jié)點和Execution節(jié)點是1對1的情況,在task對象中使用Execution_來表示他們之間的關(guān)系
9) 任務(wù)ID在數(shù)據(jù)庫表act_ru_task中對應(yīng)“ID_”列
在activiti任務(wù)中商架,主要分為兩大類查詢?nèi)蝿?wù)(個人任務(wù)和組任務(wù)):
1.確切指定了辦理者的任務(wù)堰怨,這個任務(wù)將成為指定者的私有任務(wù),即個人任務(wù)蛇摸。
2.無法指定具體的某一個人來辦理的任務(wù)备图,可以把任務(wù)分配給幾個人或者一到 多個小組,讓這個范圍內(nèi)的用戶可以選擇性(如有空余時間時)來辦理這類任務(wù)赶袄,即組任務(wù)揽涮。
5.辦理任務(wù)
/**完成我的任務(wù)*/
@Test
public void completeMyPersonalTask(){
//任務(wù)ID
String taskId = "1802";
processEngine.getTaskService()//與正在執(zhí)行的任務(wù)管理相關(guān)的Service
.complete(taskId);
System.out.println("完成任務(wù):任務(wù)ID:"+taskId);
}
說明:
1) 是辦理任務(wù),所以從ProcessEngine得到的是TaskService弃鸦。
2) 當(dāng)執(zhí)行完這段代碼绞吁,再以員工的身份去執(zhí)行查詢的時候,會發(fā)現(xiàn)這個時候已經(jīng)沒有數(shù)據(jù)了唬格,因為正在執(zhí)行的任務(wù)中沒有數(shù)據(jù)家破。
3) 對于執(zhí)行完的任務(wù),activiti將從act_ru_task表中刪除該任務(wù)购岗,下一個任務(wù)會被插入進來汰聋。
4) 以”部門經(jīng)理”的身份進行查詢,可以查到結(jié)果喊积。因為流程執(zhí)行到部門經(jīng)理審批這個節(jié)點了烹困。
5) 再執(zhí)行辦理任務(wù)代碼,執(zhí)行完以后以”部門經(jīng)理”身份進行查詢乾吻,沒有結(jié)果髓梅。
6) 重復(fù)第3和4步直到流程執(zhí)行完。
6.查詢流程狀態(tài)(判斷流程正在執(zhí)行绎签,還是結(jié)束)
/**查詢流程狀態(tài)(判斷流程正在執(zhí)行枯饿,還是結(jié)束)*/
@Test
public void isProcessEnd(){
String processInstanceId = "1601";
ProcessInstance pi = processEngine.getRuntimeService()//表示正在執(zhí)行的流程實例和執(zhí)行對象
.createProcessInstanceQuery()//創(chuàng)建流程實例查詢
.processInstanceId(processInstanceId)//使用流程實例ID查詢
.singleResult();
if(pi==null){
System.out.println("流程已經(jīng)結(jié)束");
}
else{
System.out.println("流程沒有結(jié)束");
}
}
在流程執(zhí)行的過程中,創(chuàng)建的流程實例ID在整個過程中都不會變诡必,當(dāng)流程結(jié)束后奢方,流程實例將會在正在執(zhí)行的執(zhí)行對象表中
(act_ru_execution)被刪除
說明:
1) 因為是查詢流程實例,所以先獲取runtimeService
2) 創(chuàng)建流程實例查詢對象爸舒,設(shè)置實例ID過濾參數(shù)
3) 由于一個流程實例ID只對應(yīng)一個實例蟋字,使用singleResult執(zhí)行查詢返回一個唯一的結(jié)果,如果結(jié)果數(shù)量大于1扭勉,
則拋出異常
4) 判斷指定ID的實例是否存在鹊奖,如果結(jié)果為空,則代表流程結(jié)束涂炎,實例在正在執(zhí)行的執(zhí)行對象表中已被刪除嫉入,
轉(zhuǎn)換成歷史數(shù)據(jù)焰盗。
7.查詢歷史任務(wù) 查詢歷史流程實例
/**
* 查看歷史記錄
*/
@Test
public void findHistoryTask(){
String taskAssignee = "張三";
List<HistoricTaskInstance> list = processEngine.getHistoryService()//與歷史數(shù)據(jù)(歷史表)相關(guān)的Service
.createHistoricTaskInstanceQuery()//創(chuàng)建歷史任務(wù)實例查詢
.taskAssignee(taskAssignee)//指定歷史任務(wù)的辦理人
.list();
if(list!=null && list.size()>0){
for(HistoricTaskInstance hti:list){
System.out.println(hti.getId()+" "+hti.getName()+" "+hti.getProcessInstanceId()+" "+hti.getStartTime()+" "+hti.getEndTime()+" "+hti.getDurationInMillis());
System.out.println("################################");
}
}
}
/**查詢歷史流程實例(后面講)*/
@Test
public void findHistoryProcessInstance(){
String processInstanceId = "1601";
HistoricProcessInstance hpi = processEngine.getHistoryService()//與歷史數(shù)據(jù)(歷史表)相關(guān)的Service
.createHistoricProcessInstanceQuery()//創(chuàng)建歷史流程實例查詢
.processInstanceId(processInstanceId)//使用流程實例ID查詢
.singleResult();
System.out.println(hpi.getId()+" "+hpi.getProcessDefinitionId()+" "+hpi.getStartTime()+" "+hpi.getEndTime()+" "+hpi.getDurationInMillis());
}
Execution 執(zhí)行對象
按流程定義的規(guī)則執(zhí)行一次的過程.
對應(yīng)的表:
act_ru_execution: 正在執(zhí)行的信息
act_hi_procinst:已經(jīng)執(zhí)行完的歷史流程實例信息
act_hi_actinst:存放歷史所有完成的活動
ProcessInstance 流程實例
特指流程從開始到結(jié)束的那個最大的執(zhí)行分支,一個執(zhí)行的流程中咒林,流程實例只有1個。
注意
(1)如果是單例流程爷光,執(zhí)行對象ID就是流程實例ID
(2)如果一個流程有分支和聚合垫竞,那么執(zhí)行對象ID和流程實例ID就不相同
(3)一個流程中,流程實例只有1個蛀序,執(zhí)行對象可以存在多個欢瞪。
Task 任務(wù)
執(zhí)行到某任務(wù)環(huán)節(jié)時生成的任務(wù)信息。
對應(yīng)的表:
act_ru_task:正在執(zhí)行的任務(wù)信息
act_hi_taskinst:已經(jīng)執(zhí)行完的歷史任務(wù)信息