学习资料：《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增加外置表单支持。