在上2篇博客中,我们有了工作流定义的列表,也有了关联表单和启动表单,现在就是开始开发这个通用工作流的时刻了。 工作流的基本构成就是:一个While循环控制工作流的运转,While里的Task Replicator用来创建审批任务,至于应该创建哪一级的审批人,我们使用一个Step变量来控制。当Step==0时,表示需要提交者修改内容后重新提交。请看具体的逻辑图和流程图。

在上2篇博客中,我们有了工作流定义的列表,也有了关联表单和启动表单,现在就是开始开发这个通用工作流的时刻了。

工作流的基本构成就是:一个While循环控制工作流的运转,While里的Task Replicator用来创建审批任务,至于应该创建哪一级的审批人,我们使用一个Step变量来控制。当Step==0时,表示需要提交者修改内容后重新提交。

首先,我们先来看看这个工作流的逻辑图:

多级审批 java 多级审批设计思路_sed

这是一个简单的逻辑图示,最终的工作流图会有所不同。从这个图中可以看出,我们是用代码在控制流程的流转。

当Step为0时,表示需要提交者修改内容后,重新提交。

当Step>0时,TaskReplicator(一个Replicator里放置一个TaskActivity)就创建这步的所有审批人,并且根据审批类型为投票还是并行来做结束判断。

Code部分,根据Task的返回结果是通过还是拒绝,来决定Step++还是Step--。

如果Step>总步骤数,那么流程结束。While退出。

在这里,TaskReplicator的任务表单,我们都用同一个命名为Task1的User Control。而重新提交我们用命名为Task0的User Control。因为Task0会有稍许不同,Task0会直接提供修改原始List的表单,而不需要用户回到原始List中去做修改。

有了这个逻辑关系图,我们来看看具体的工作流程图和一些关键代码:

多级审批 java 多级审批设计思路_SharePoint_02

多级审批 java 多级审批设计思路_表单_03

与逻辑图中稍许不同的就是,我们在Resubmit后加了一个Terminate Activity,这是为了让提交者可以终止掉这个流程。While循环后的Code Activity则是为了记录一些日志。

有了上面的这个工作流程图,剩下的就需要一些变量来控制流程的流转了。比较重要的变量如下:

 

Code
public bool finished = false;     // While循环的结束条件
public bool task_passed = false;  // Task Replicator是否是“通过”
private int step = 1;             // 当前的步骤
private int step_total = 0;       // 总步骤
private string workflow_name = string.Empty;  // 工作流名称,用于去配置表中读取工作流定义
private int vote = 0;                         // 用于投票类型的审批,当前投票通过的百分比
public bool terminate = false;                // 用户是否终止提交工作流

有了这些变量,我们就可以设置While的结束条件,If-Else的分支条件了。

重新提交If-Else这个分支的提交为step==0。工作流终止If-Else的分支条件为terminate。

 

接下来,我们来看看如何用代码控制流转了(这里面最重要的内容请看《[SharePoint 工作流] While里的Replicator ChildInitialized事件不执行的解决方法 》)

1. 工作流的Activated事件:读取工作流的定义,设置TaskReplicator的InitChildData为第一步的所有审批人。

Code
InitData data = WorkflowDataSerializer.DeserializeFromXmlString<InitData>(workflowProperties.InitiationData);


workflow_name = data.WorkflowName;

SPListItem workflow = GetWorkflow(workflowProperties.Web, workflow_name);


step_total = int.Parse(workflow["步骤数"].ToString());

SubmitterComments = data.SubmitterComments;

user = data.InitUser;

days = data.ApproveDays;


replicatorTask.InitialChildData = GetWorkflowStepSettings(workflowProperties.Web, workflow_name, step);

workflow_name是从工作流的InitiationData中读取(这里用了一个反序列化来获得工作流启动时保存的对象数据)

2. taskReplicator的Initialized事件:做一些初始化工作,在这里不对InitChildData做任何赋值。

task_passed = false;  // 设置为未通过状态
vote = 0;             // 设置投票通过比例为0
taskPropertiesList = new List<SPWorkflowTaskProperties>();   // 用于记录所有用户处理过的任务信息

3. taskReplicator的ChildInitialized事件:创建该步骤对应的Task

Code
TaskActivity activity = e.Activity as TaskActivity;


activity.TaskProperties = new SPWorkflowTaskProperties();


activity.TaskProperties.DueDate = DateTime.Now.AddDays(days);

activity.TaskProperties.ExtendedProperties["SubmitterComments"] = SubmitterComments;

activity.TaskProperties.ExtendedProperties["ReviewComments"] = ReviewComments;


WorkflowReviewerSettings item = e.InstanceData as WorkflowReviewerSettings;


activity.TaskProperties.AssignedTo = item.DomainAccount;

activity.TaskProperties.Title = "请审批" + user + "的请假单";

activity.TaskProperties.TaskType = 1;

4. taskReplicator的Until结束条件:判断投票结果是否通过。

Code
SPListItem spitem = GetWorkflowStep(workflowProperties.Web, workflow_name, step);
string type = spitem["审批类型"].ToString();

switch (type)

{

    case "并行":

        int count = 0;

        foreach (SPWorkflowTaskProperties taskProp in this.taskPropertiesList)

        {

            string status = taskProp.ExtendedProperties["TaskStatus"] as string;


            switch (status)

            {

                case "Approved":

                    count++;

                    break;


                case "Rejected":

                    e.Result = true;

                    step--;

                    return;

            }

        }


        task_passed = count == replicatorTask.InitialChildData.Count;

        break;


    case "投票":

        int vote_passed = int.Parse(spitem["投票通过比例"].ToString());


        if (taskPropertiesList.Count == replicatorTask.InitialChildData.Count && vote < vote_passed)

        {

            e.Result = true;

            step--;


            return;

        }


        task_passed = vote >= vote_passed;

        break;

}

if (task_passed)

{

    step++;

}


e.Result = task_passed;

5. taskReplicator的ChildCompleted事件:把用户处理过的任务信息保存下来,以便在Until事件中使用

Code
TaskActivity activity = e.Activity as TaskActivity;


ReviewComments += PersonSayComment(activity.TaskProperties);

SubmitterComments = activity.TaskProperties.ExtendedProperties["SubmitterComments"] as string;


WorkflowReviewerSettings item = e.InstanceData as WorkflowReviewerSettings;

string status = activity.TaskProperties.ExtendedProperties["TaskStatus"] as string;
if (!string.IsNullOrEmpty(status) && status == "Approved") vote += item.VoteRatio;


taskPropertiesList.Add(activity.TaskProperties);

 

6. CodeActivity1设置While循环结束的条件,并且对taskReplicator进行重新赋值

finished = step > step_total;

if (!finished && step > 0)

{

    replicatorTask.InitialChildData = GetWorkflowStepSettings(workflowProperties.Web, workflow_name, step);

}

 

有了上面这些并不复杂的代码,我们就有了运转一个通用工作流的能力。工作流发布到SharePoint上就可以开始使用了。

接下来,下一节来看看这个工作流的具体运转情况。

在BI,SharePoint,工作流领域,我们服务过众多的国际国内大企业:

1. 西门子中国:BI项目与SharePoint门户
2. Nokia:BI项目与SharePoint门户
3. 中国人寿:BI & 工作流
4. 与狼共舞:BI门户
5. 玫琳凯:BI项目
6. 美国微软:BI项目
等等