如何使用HistoryService

這篇文章主要講解了“如何使用HistoryService”，文中的講解內(nèi)容簡單清晰，易于學(xué)習(xí)與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學(xué)習(xí)“如何使用HistoryService”吧！

Activit中的歷史簡介

• 歷史: Activiti中的一個組件,可以捕獲發(fā)生在進(jìn)程執(zhí)行中的信息并永久的保存.與運(yùn)行時數(shù)據(jù)不同的是,當(dāng)流程實例運(yùn)行完成之后它還會存在于數(shù)據(jù)庫中

• 歷史實體對象有5個:

• HistoricProcessInstances: 包含當(dāng)前和已經(jīng)結(jié)束的流程實例信息

• HistoricVariableInstances: 包含最新的流程變量或任務(wù)變量

• HistoricActivityInstances: 包含一個活動即流程上的節(jié)點(diǎn)的執(zhí)行信息

• HistoricTaskInstances: 包含關(guān)于當(dāng)前和已完成或已刪除任務(wù)實例信息

• HistoricDetails: 包含歷史流程實例,活動實例,任務(wù)實例的各種信息

• 因為數(shù)據(jù)庫中保存著歷史信息以及正在運(yùn)行的流程實例信息,就要考慮怎樣盡量減少的對運(yùn)行中的流程實例數(shù)據(jù)進(jìn)行訪問的方式來查詢這些表以保證執(zhí)行的性能

查詢歷史

• 在Activiti API中提供了5中實體的查詢方法,在HistoryService類中:

• createHistoricProcessInstanceQuery()

• createHistoricVariableInstanceQuery()

• createHistoricActivityInstanceQuery()

• createHistoricDetailQuery()

• createHistoricTaskInstanceQuery()

HistoricProcessInstanceQuery

• 流程實例

• 獲取流程定義ID是'XXX',已經(jīng)結(jié)束,花費(fèi)時間最長(持續(xù)時間最長)的10個HistoricProcessInstances

historyService.createHistoricProcessInstanceQuery()
  .finished()
  .processDefinitionId("XXX")
  .orderByProcessInstanceDuration().desc()
  .listPage(0, 10);

HistoricVariableInstanceQuery

• 在ID為'xxx',已經(jīng)結(jié)束的流程實例中查詢所有HistoricVariableInstances, 并按變量名排序

historyService.createHistoricVariableInstanceQuery()
  .processInstanceId("XXX")
  .orderByVariableName.desc()
  .list();

HistoricActivityInstanceQuery

• 獲取所有已經(jīng)結(jié)束的流程定義ID為’XXX'并且類型是'serviceTask'中的最后一個 HistoricActivityInstance

historyService.createHistoricActivityInstanceQuery()
  .activityType("serviceTask")
  .processDefinitionId("XXX")
  .finished()
  .orderByHistoricActivityInstanceEndTime().desc()
  .listPage(0, 1);

HistoricDetailQuery

• 獲取所有id為123的流程實例中產(chǎn)生的可變更新信息

• 這個查詢只會返回HistoricVariableUpdates

• 注意一些變量名可能包含多個HistoricVariableUpdate實體,每次流程運(yùn)行時會更新變量.可以用orderByTime(變量被更新的時間)或者orderByVariableRevision(運(yùn)行更新時變量的版本)來排序查詢.

historyService.createHistoricDetailQuery()
  .variableUpdates()
  .processInstanceId("123")
  .orderByVariableName().asc()
  .list()

• 獲取所有流程實例ID為123的流程中 ,提交任務(wù)或者啟動流程時的form-properties. 這個查詢只會返回 HistoricFormPropertiess

historyService.createHistoricDetailQuery()
  .formProperties()
  .processInstanceId("123")
  .orderByVariableName().asc()
  .list()

• 獲取所有在執(zhí)行ID為123的任務(wù)時的變量更新.返回全部在任務(wù)中設(shè)置的變量 (任務(wù)局部變量)HistoricVariableUpdates, 不是流程實例變量

historyService.createHistoricDetailQuery()
  .variableUpdates()
  .taskId("123")
  .orderByVariableName().asc()
  .list()

• 任務(wù)局部變量可以用TaskService設(shè)置,在TaskListener里設(shè)置

taskService.setVariableLocal("123", "myVariable", "Variable value");

• 任務(wù)局部變量也可以用DelegateTask設(shè)置,在TaskListener里設(shè)置

public void notify(DelegateTask delegateTask) {
  delegateTask.setVariableLocal("myVariable", "Variable value");
}

HistoricTaskInstanceQuery

• 獲取所有任務(wù)中10個花費(fèi)時間最長(持續(xù)時間最長)并已經(jīng)結(jié)束的HistoricTaskInstances

historyService.createHistoricTaskInstanceQuery()
  .finished()
  .orderByHistoricTaskInstanceDuration().desc()
  .listPage(0, 10);

• 獲取刪除原因包含"invalid",最后分配給用戶"kermit"的HistoricTaskInstances

historyService.createHistoricTaskInstanceQuery()
  .finished()
  .taskDeleteReasonLike("%invalid%")
  .taskAssignee("kermit")
  .listPage(0, 10);

歷史配置

• 歷史級別可以用編寫代碼的方法配置 :org.activiti.engine.impl.history.HistoryLevel (枚舉類型)

ProcessEngine processEngine = ProcessEngineConfiguration
  .createProcessEngineConfigurationFromResourceDefault()
  .setHistory(HistoryLevel.AUDIT.getKey())
  .buildProcessEngine();

• 級別可以在配置文件activiti.cfg.xml或者在spring-context中配置:

<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration">
  <property name="history" value="audit" />
  ...
</bean>

• 歷史信息級別:

• 這個級別存儲發(fā)生在審核以及所有其它細(xì)節(jié)的信息,主要是更新流程變量

• 是最高級別的歷史信息存檔,同樣也是最慢的

• 默認(rèn)值,保存所有流程實例信息,活動信息,保證所有的變量和提交的表單屬性保持同步

• 這樣所有用戶交互信息都是可追溯的,可以用來審計

• 保存所有流程實例信息和活動實例信息:

• 在流程實例結(jié)束時,最后一個流程實例中的最新的變量值將賦值給歷史變量

• 不會保存過程中的詳細(xì)信息

• 忽略所有歷史存檔:

• 這是流程執(zhí)行時性能最好的狀態(tài),但沒有任何歷史信息可用

• none:

• activity:

• audit:

• full:

審計

• 歷史配置在audit級別之上,所有通過:

• FormService.submitStartFormData(String processDefinitionId, Map<String, String> properties)

• FormService.submitTaskFormData(String taskId, Map<String, String> properties) 提交的屬性都會被記錄

• 表單屬性可以通過API查詢:

historyService
      .createHistoricDetailQuery()
      .formProperties()
      ...
      .list();

類型為HistoricFormProperty的詳細(xì)信息會被查詢出來

• 在調(diào)用IdentityService.setAuthenticatedUserId(String) 提交之前設(shè)置了認(rèn)證用戶:

• 在開始表單中使用HistoricProcessInstance.getStartUserId() 獲取

• 在任務(wù)表單中用HistoricActivityInstance.getAssignee() 獲取

• 提交表單的用戶將被保存在歷史信息中:

感謝各位的閱讀，以上就是“如何使用HistoryService”的內(nèi)容了，經(jīng)過本文的學(xué)習(xí)后，相信大家對如何使用HistoryService這一問題有了更深刻的體會，具體使用情況還需要大家實踐驗證。這里是億速云，小編將為大家推送更多相關(guān)知識點(diǎn)的文章，歡迎關(guān)注！