任务实例生命周期是直接了当的: 在建立后, 任务实例可以随意的被开始. 然后,任务实例可以被结束,意思是任务实例被标记为完成了.

为了灵活性,分派不是生命周期的一部分.因此任务实例可能被分配也可能不被分配.任务实例分配不影响任务实例的生命周期.

任务实例的建立典型的是由流程执行进入一个 task-node (通过方法 TaskMgmtInstance.createTaskInstance(...)). 然后, 一个用户接口组件将用TaskMgmtSession.findTaskInstancesByActorId(...) 查询数据库得到任务清单tasklists.然后, 在收集了用户的输入后,UI组件调用 TaskInstance.assign(String), TaskInstance.start() 或 TaskInstance.end(...).

任务实例通过date-properties维护它的状态包括: create, start和 end. 这些属性可以通过TaskInstance它们对应的getters方法.

当前,完成的任务实例被标记为end date 所以它们不能被随后的任务列表查询获得.但它们依然保存在 JBPM_TASKINSTANCE表里.

任务实例是在参与者tasklist的项目. 任务实例可作为信令(发射信号).一个信令任务实例就是一个任务实例在完成的时候可以发送一个信号给它的令牌去继续流程执行. 任务实例可以被阻塞,意思是说相关的令牌(= 执行路线)不允许离开 task-node,在任务实例被完成之前.默认的任务实例是信令(signalling )和非阻塞的(non-blocking).

在多个任务同一个task-node关联情况下,流程开发者可以指定怎样完成任务实例来影响流程的继续  . 下面是一个给task-node的singal-property的值的清单.

任务实例建立必须基于以上运行时间计算. 这种情况下,增加一个 ActionHandler 在task-node的 node-enter事件里 并且设置属性 create-tasks="false" . 下面是一个动作handler的实现:

public class CreateTasks implements ActionHandler {
  public void execute(ExecutionContext executionContext) throws Exception {
    Token token = executionContext.getToken();
    TaskMgmtInstance tmi = executionContext.getTaskMgmtInstance();
      
    TaskNode taskNode = (TaskNode) executionContext.getNode();
    Task changeNappy = taskNode.getTask("change nappy");

    // now, 2 task instances are created for the same task.
    tmi.createTaskInstance(changeNappy, token);
    tmi.createTaskInstance(changeNappy, token);
  }
}

如例子所展示,在task-node指定的任务被建立. 它们也可以在 process-definition指定并且通过 TaskMgmtDefinition来获取. TaskMgmtDefinition用任务管理信息 扩展(extends) ProcessDefinition .

 标记任务实例的API完成用 TaskInstance.end() .随意地,你可以指定一个转换在end 方法里. 这种情况下这个任务实例完成将出发执行的继续,task-node 通过指定的转换离开..

通过接口AssignmentHandler来分配任务实例:

public interface AssignmentHandler extends Serializable {
  void assign( Assignable assignable, ExecutionContext executionContext );
}

一个分配handler实现在任务实例建立的时候被调用. 在这个时候,任务实例可以分配给一个或多个参与者.  AssignmentHandler 实现可以调用 Assignable 方法(setActorId或 setPooledActors )来分配任务. 可分配的要么是一个 TaskInstance 或者 SwimlaneInstance (= 流程角色).

public interface Assignable {
  public void setActorId(String actorId);
  public void setPooledActors(String[] pooledActors);
}

  TaskInstances 和 SwimlaneInstance s 两者都可以分配给指定的用户或参与者池. 分配一个TaskInstance给用户, 调用 Assignable.setActorId(String actorId) . 分配一个TaskInstance给候选参与者池, 调用 Assignable.setPooledActors(String[] actorIds).

流程中的每个任务都可以用在运行时间执行分配handler的实现关联起来.

当流程中多个任务被分配给同一个人或一组参与者,考虑 swimlane用途

允许建立重用的 AssignmentHandler s,每个 AssignmentHandler的用途可以在 processdefinition.xml配置. 参看 章节 13.2, “代理” 更多有关怎么添加分配handler的信息.

管理分配任务实例和分配swimlance实例到参与者的数据模型如下. 每个 TaskInstance 有actorId和一组被缓存的参与者.

Figure 9.1. 分配模型类图

actorId对任务负责, 当一组缓存的参与者代表候选者集合,如果他们得到任务就可以负责.actorId 和pooledActors 可以任意的组合.

任务实例的actorId 表明对指定任务责任的. TaskInstance 缓存的参与者是任务参与者的候选人. 典型的,TaskInstance 的actorId将引用一个一个用户. 缓存的参与者可以引用用户和组.

个人任务清单是所有所有指定actorId作为用户的 TaskInstance s.这个清单的获得是用过 TaskMgmtSession.findTaskInstances(String actorId).

另外一面, 共有的任务用来给从 共有的参与者中引用的用户. 获取集中的任务典型两个步骤操作: 1)从身份组件得到给定用户所有的组2)根据用户的actorId和从用户组得到的actorId来得到所有共有的任务.得到给定用户的所有共有的任务的清单通过方法 TaskMgmtSession.findPooledTaskInstances(String actorId)  或 TaskMgmtSession.findPooledTaskInstances(List actorIds) . 这些方法只返回任务实例的actorId是null或给定actorId之一匹配共有的的参与者其中一个.

为了防止多个用户在同一个共有的任务上工作, 更新TaskInstance 为用户的actorId就可以了. 做了这个, 任务实例将不会显示在共有的任务清单里,但只在用户的个人任务清单里. 设置TaskInstance 的actorId 为null,将会把任务实例放回共有的任务里.

Figure 9.3. 身份模型类图

黄色类图是有关类表达下一节讨论的分配handlerre.

用户表示用户或服务.  Group是任何一种类型的一群用户 .组能嵌套进team之间,业务单位之间和整个公司的关系模型 . 组有类型来区分组层次,比如头发颜色组. Membership s 表示多对多的在用户和组之间.membership可用来表示在公司中的职位. 成员的名字可以用来指明用户在组里履行的角色.

身份组件是在分派任务期间评估计算参与者的表达式的时候需要. 这里有个例子在流程定义中用分派表达:

<process-definition>
  ...
  <task-node name='a'>
    <task name='laundry'>
      <assignment expression='previous --> group(hierarchy) --> member(boss)' />
    </task>
    <transition to='b' />
  </task-node>
  ...

分配语法表达如下:

first-term --> next-term --> next-term --> ... --> next-term        

where

first-term ::= previous |
               swimlane(swimlane-name) |
               variable(variable-name) |
               user(user-name) |
               group(group-name)

and 

next-term ::= group(group-type) |
              member(role-name)

当你想用你们公司组织自己的数据源比如公司用户数据库或LDAP系统,你可以拔除jBPM身份组件. 你需要做的唯一事情就是删除行 ...

<mapping resource="org/jbpm/identity/User.hbm.xml"/>
<mapping resource="org/jbpm/identity/Group.hbm.xml"/>
<mapping resource="org/jbpm/identity/Membership.hbm.xml"/>

从文件 hibernate.cfg.xml

ExpressionAssignmentHandler 依赖身份组件因此你不将不能用它. 这中情况下你想重用 ExpressionAssignmentHandler并且同你的用户数据绑定 ,你可以扩展 ExpressionAssignmentHandler然后重写 getExpressionSession方法.

protected ExpressionSession getExpressionSession(AssignmentContext assignmentContext);