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()); 28         assertNotNull(renderedStartForm);

        // 啟動流程
        // 設置當前用戶
        String currentUserId = "henryyan";
        identityService.setAuthenticatedUserId(currentUserId);
        ProcessInstance processInstance = formService.submitStartFormData(processDefinition.getId(), variables); 35         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()));// 讀取任務表單 47         variables = new HashMap<String, String>();
        variables.put("hrApproved", "true");
 formService.submitTaskFormData(hrTask.getId(), variables); 50 
        // 銷假（根據申請人的用戶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增加外置表單支持。