2017.2.28 activiti实战--第六章--任务表单（二）外置表单

学习资料：《Activiti实战》

第六章 任务表单（二）外置表单

6.3 外置表单

考虑到动态表单的缺点（见上节），外置表单使用的更多。

外置表单的特点：

 页面的原样显示
 字段值的自动填充

6.3.1 流程定义

（1）form文件

leave-start.form作为示例展示（字段要和后面代码中variables变量的key互相对应）：

 <div class="control-group">
     <label class="control-label" for="startDate">开始时间：</label>
     <div class="controls">
         <input type="text" id="startDate" name="startDate" class="datepicker" data-date-format="yyyy-mm-dd" required />
     </div>
 </div>
 <div class="control-group">
     <label class="control-label" for="endDate">结束时间：</label>
     <div class="controls">
         <input type="text" id="endDate" name="endDate" class="datepicker" data-date-format="yyyy-mm-dd" required />
     </div>
 </div>
 <div class="control-group">
     <label class="control-label" for="reason">请假原因：</label>
     <div class="controls">
         <textarea id="reason" name="reason" required></textarea>
     </div>
 </div>

（2）流程文件

这里只显示部分xml内容，其他的一些见上节动态表单。这里的xml文件只是为了展示外置表单的使用方法。

基本使用方式就是：activiti:formkey="chapter6/leave-formkey/approve.form" 

form的值支持动态设置：activiti:formkey="${fooFormName}.form"

 <process id="leave-formkey" name="请假流程-外置表单">
     <startEvent id="startevent1" name="Start"
                 activiti:initiator="applyUserId"
                 activiti:formkey="chapter6/leave-formkey/leave-start.form">
     </startEvent>
     <userTask id="deptLeaderVerify" name="部门经理审批"
                 activiti:candidateGroups="deptLeader"
                 activiti:formkey="chapter6/leave-formkey/approve.form">
     </userTask>
     <userTask id="hrVerify" name="人事审批"
                 activiti:candidateGroups="hr"
                 activiti:formkey="chapter6/leave-formkey/approve.form">
     </userTask>
     <userTask id="reportBack" name="销假"
                 activiti:assignee="${applyUserId}"
                 activiti:formkey="chapter6/leave-formkey/report-back.form">
     </userTask>
     <userTask id="modifyApply" name="调整申请内容"
                 activiti:assignee="${applyUserId}"
                 activiti:formkey="chapter6/leave-formkey/modify-apply.form">
     </userTask>
     <endEvent id="endevent1" name="End"
     </endEvent>
 </process>

（3）单元测试

部署表单流程时需要把bpmn文件和form文件同时打包部署。这样部署了同名的form文件时多个流程定义，或相同流程不同版本之间，都不会有冲突。

 public class LeaveFormKeyTest extends AbstractTest {

     @Test
     @Deployment(resources = {"chapter6/leave-formkey/leave-formkey.bpmn",
             "chapter6/leave-formkey/leave-start.form",
             "chapter6/leave-formkey/approve-deptLeader.form",
             "chapter6/leave-formkey/approve-hr.form",
             "chapter6/leave-formkey/report-back.form",
             "chapter6/leave-formkey/modify-apply.form"})

     public void allPass() throws Exception {
         SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
         Map<String, String> variables = new HashMap<String, String>();
         Calendar ca = Calendar.getInstance();
         String startDate = sdf.format(ca.getTime());
         ca.add(Calendar.DAY_OF_MONTH, 2); // 当前日期加2天
         String endDate = sdf.format(ca.getTime());

         // 启动流程
         variables.put("startDate", startDate);
         variables.put("endDate", endDate);
         variables.put("reason", "公休");

         ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery().singleResult();

         // 读取启动表单
         Object renderedStartForm = formService.getRenderedStartForm(processDefinition.getId());
         assertNotNull(renderedStartForm);

         // 启动流程
         // 设置当前用户
         String currentUserId = "henryyan";
         identityService.setAuthenticatedUserId(currentUserId);
         ProcessInstance processInstance = formService.submitStartFormData(processDefinition.getId(), variables);
         assertNotNull(processInstance);

         // 部门领导审批通过
         Task deptLeaderTask = taskService.createTaskQuery().taskCandidateGroup("deptLeader").singleResult();
         assertNotNull(formService.getRenderedTaskForm(deptLeaderTask.getId()));
         variables = new HashMap<String, String>();
         variables.put("deptLeaderApproved", "true");
         formService.submitTaskFormData(deptLeaderTask.getId(), variables);

         // 人事审批通过
         Task hrTask = taskService.createTaskQuery().taskCandidateGroup("hr").singleResult();
         assertNotNull(formService.getRenderedTaskForm(hrTask.getId()));// 读取任务表单
         variables = new HashMap<String, String>();
         variables.put("hrApproved", "true");
         formService.submitTaskFormData(hrTask.getId(), variables);

         // 销假（根据申请人的用户ID读取）
         Task reportBackTask = taskService.createTaskQuery().taskAssignee(currentUserId).singleResult();
         assertNotNull(formService.getRenderedTaskForm(reportBackTask.getId()));
         variables = new HashMap<String, String>();
         variables.put("reportBackDate", sdf.format(ca.getTime()));
         formService.submitTaskFormData(reportBackTask.getId(), variables);

         // 验证流程是否已经结束
         HistoricProcessInstance historicProcessInstance = historyService.createHistoricProcessInstanceQuery().finished().singleResult();
         assertNotNull(historicProcessInstance);

         // 读取历史变量
         Map<String, Object> historyVariables = packageVariables(processInstance);

         // 验证执行结果
         assertEquals("ok", historyVariables.get("result"));

     }
 ...
 }

6.3.2 自定义表单引擎

activiti既可以可以支持B/S结构的应用，也可以支持C/S结构的应用。getRenderd***Form()返回的内容是经过activiti的默认Form引擎处理过的，返回的值可以让B/S结构的应用直接使用，但是却不能直接支持C/S结构的应用。所以如果要生成C/S程序需要的java控件，需要事先自定义的form引擎。

这一块暂时用不到，略过。

6.3.3 读取流程启动表单

Activiti Explorer支持动态表单，却不支持外置表单。所以需要为Activiti Explorer增加外置表单支持。