[SharePoint 工作流] 如何设计一个通用的多级多审核工作流程(三):工作流开发

原创|其它|编辑:郝浩|2009-05-26 11:13:00.000|阅读 1688 次

概述:在我上一篇博客中,提到了设计一个通用的多级多审核工作流程. 所谓通用的,就是流程是从配置文件里获得,而不是在开发的时候就将流程定死.

# 界面/图表报表/文档/IDE等千款热门软控件火热销售中 >>

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

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

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

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

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

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

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

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

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

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

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

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

 


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为第一步的所有审批人。


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


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结束条件:判断投票结果是否通过。


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事件中使用


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上就可以开始使用了。

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


标签:

本站文章除注明转载外,均为本站原创或翻译。欢迎任何形式的转载,但请务必注明出处、不得修改原文相关链接,如果存在内容上的异议请邮件反馈至chenjj@evget.com

文章转载自:博客园

为你推荐

  • 推荐视频
  • 推荐活动
  • 推荐产品
  • 推荐文章
  • 慧都慧问
扫码咨询


添加微信 立即咨询

电话咨询

客服热线
023-68661681

TOP