11.历史
历史是一个组件，它可以捕获发生在进程执行中的信息并永久的保存，与运行时数据不同的是，当流程实例运行完成之后它还会存在于数据库中。
有5个历史实体对象:
HistoricProcessInstances 包含当前和已经结束的流程实例信息。HistoricVariableInstances 包含最新的流程变量或任务变量。HistoricActivityInstances 包含一个活动(流程上的节点)的执行信息 。HistoricTaskInstances 包含关于当前和过去的（已完成或已删除）任务实例信息。HistoricDetails 包含历史流程实例、活动实例、任务实例的各种信息。
由于数据库中保存着历史信息以及正在运行的流程实例信息，就要考虑怎样尽量少的对运行中的流程实例数据进行访问的方式查询这些表来保证执行的性能。
稍后, 这个信息体现在Activiti Explorer。同时它也是报告将生成的信息。
查询历史
在API中, 提供了对这5种实体的查询方法。类HistoryService 提供了以下几种方法 createHistoricProcessInstanceQuery(), createHistoricVariableInstanceQuery(), createHistoricActivityInstanceQuery(), createHistoricDetailQuery() 和 createHistoricTaskInstanceQuery()。
下面是一些API中查询历史信息的例子. 这些方法的详细描述可以在 ZAjavadocs中找到, 在包org.activiti.engine.history 中
HistoricProcessInstanceQuery
流程实例。获取流程定义ID是'XXX'、已经结束、花费时间最长（持续时间最长）的10个HistoricProcessInstances
historyService.createHistoricProcessInstanceQuery()
.finished()
.processDefinitionId("XXX")
.orderByProcessInstanceDuration().desc()
.listPage(0, 10);
HistoricVariableInstanceQuery
在ID为'xxx'、已经结束的流程实例中查询所有HistoricVariableInstances，并按变量名排序
historyService.createHistoricVariableInstanceQuery()
.processInstanceId("XXX")
.orderByVariableName.desc()
.list();
HistoricActivityInstanceQuery
获取所有已经结束的流程定义ID为’XXX'并且类型是'serviceTask'中的最后一个 HistoricActivityInstance
historyService.createHistoricActivityInstanceQuery()
.activityType("serviceTask")
.processDefinitionId("XXX")
.finished()
.orderByHistoricActivityInstanceEndTime().desc()
.listPage(0, 1);
HistoricDetailQuery
下个例子, 获取所有id为123的流程实例中产量的可变更新信息。这个查询只会返回 HistoricVariableUpdates. 注意一些变量名可能包含多个 HistoricVariableUpdate 实体, 每次流程运行时会更新变量。 你可以用 orderByTime (变量被更新的时间) 或者 orderByVariableRevision (运行更新时变量的版本)来排序查询.
historyService.createHistoricDetailQuery()
.variableUpdates()
.processInstanceId("123")
.orderByVariableName().asc()
.list()
这个例子获取所有流程实例ID为123的流程中，提交任务或者启动流程时的form-properties 。 这个查询只会返回 HistoricFormPropertiess 。
historyService.createHistoricDetailQuery()
.formProperties()
.processInstanceId("123")
.orderByVariableName().asc()
.list()
最后这个例子获取所有在执行ID为123的任务时的变量更新。 返回全部在任务中设置的变量（任务局部变量） HistoricVariableUpdates , 不是流程实例变量。
historyService.createHistoricDetailQuery()
.variableUpdates()
.taskId("123")
.orderByVariableName().asc()
.list()
任务局部变量可以用 TaskService 设置或者使用 DelegateTask, 在TaskListener里设置:
taskService.setVariableLocal("123", "myVariable", "Variable value");public void notify(DelegateTask delegateTask) {
delegateTask.setVariableLocal("myVariable", "Variable value");
}HistoricTaskInstanceQuery
获取所有任务中10个花费时间最长（持续时间最长）并已经结束的 HistoricTaskInstances 。
historyService.createHistoricTaskInstanceQuery()
.finished()
.orderByHistoricTaskInstanceDuration().desc()
.listPage(0, 10);
获取删除原因包含"无效"，最后分配给用户"kermit"的 HistoricTaskInstances。
historyService.createHistoricTaskInstanceQuery()
.finished()
.taskDeleteReasonLike("%invalid%")
.taskAssignee("kermit")
.listPage(0, 10);
历史配置
历史级别可以用编写代码的方法配置, 用枚举类型org.activiti.engine.impl.history.HistoryLevel (或者在5.11之前定义在ProcessEngineConfiguration中的常量 HISTORY_*):
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>
历史信息级别可以配置成以下几种:
none: 忽略所有历史存档。这是流程执行时性能最好的状态，但没有任何历史信息可用。activity: 保存所有流程实例信息和活动实例信息。 在流程实例结束时, 最后一个流程实例中的最新的变量值将赋值给历史变量。 不会保存过程中的详细信息。audit: 这个是默认值. 它保存所有流程实例信息, 活动信息, 保证所有的变量和提交的表单属性保持同步 这样所有用户交互信息都是可追溯的，可以用来审计。full: 这个是最高级别的历史信息存档，同样也是最慢的。 这个级别存储发生在审核以及所有其它细节的信息, 主要是更新流程变量。
在Activiti 5.11之前, 历史级别都存在数据库中 (表 ACT_GE_PROPERTY,属性名为 historyLevel). 从Activiti 5.11开始, 这个值不再用，并且从数据库中忽略或者删除掉。 这个配置可以在两次启动间修改, 因为是在启动之前修改的，所以不会抛出异常.
审计目的的历史
当配置 在 audit级别之上 。 所有通过 FormService.submitStartFormData(String processDefinitionId, Map<String, String> properties) and FormService.submitTaskFormData(String taskId, Map<String, String> properties) 方法提交的属性都会被记录。
表单属性可以通过API查询，如下:
historyService
.createHistoricDetailQuery()
.formProperties()
...
.list();
上面的例子只有类型为 HistoricFormProperty的详细信息会被查询出来。
如果你在调用IdentityService.setAuthenticatedUserId(String)提交之前设置了认证用户，那么提交表单的用户将被保存在历史信息中并可以在开始表单中 使用HistoricProcessInstance.getStartUserId()获取，在任务表单中用HistoricActivityInstance.getAssignee()获取。