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增加外置表单支持。