H3 Workflow自由流的实现

       最近一年的时间都在做H3工作流的项目，作为国产的一个工作流产品H3已经做得很好了，面对如此庞大复杂的一个客户环境H3基本上完成了他们所有的功能。H3开发流程的一个主要特点就是开发速度快，笔者曾经一天做了4个简单的流程，业务复杂的流程也顶多花了3天的时间就能搞定，K2流程的开发就稍微显得繁琐。由于H3的引擎是自己开发的，这一点和K2是不同的，K2是基于Microsoft的WF的，K2的可定制化很高，H3的定制化没有K2那么灵活。在与客户各种系统集成的过程中我们遇到了很多困难，经过求助H3支持工程师和与客户方协同商量基本上都解决了。

     下面简单介绍一下H3中自由流的实现，自由流就是所有的流程步骤，步骤当中的审批人都是由用户自己设置的。这种情况在workflow中时不允许出现的，因为BPM的目标之一就是规范业务审批流程步骤，禁止用户自己控制流程的走向以及审批人。如果存在这种流程的话，那么用户肯定不会使用其他的业务流程了，全部都使用自由流了，这跟传统的OA审批流程没有任何区别也就失去了BPM的意义。但是由于客户方态度很强硬，一定要求实现这种流程功能，没办法，只能硬着头皮做了一个勉强算是自由流的一个流程，步骤如下。

     1.开发H3流程首先就是流程图的绘制，客户想要的自由流是完全自己设置流程的步骤，可多可少，可大可小，跟孙悟空的金箍棒似的，这一点我们明确表示产品没法做到。因为H3必须在流程图确立的情况下才能运行流程，不能在过程中随意修改流程图也没法修改。经过协商，决定流程步骤限死为10个步骤，不允许超过10个步骤的审批，流程图如下：

     

在这里我们设置了10个审批步骤，而且数据项里面我们还添加了10个参与者数据类型的审批人，名称分别为：审批人1,审批人2，……，审批人10.

     2.下面就是流程的发起界面了，自由流需要在发起界面的时候设置这10个步骤的审批人（当然也可以少于10个人），发起界面如下：

发起界面我们有一个 流程模板 选择界面，点击这一个选择按钮进入 设置流程审批步骤的审批人界面，简单界面如下：

很简单的一个table，简单看一下这个选人界面的后台代码，为了方便用户打开这个设置人界面时之前的数据依旧可以展示出来，我们将选择的结果放在一个session里面，页面卸载的时候移除session。

    /// <summary>
    /// 初始化数据
    /// </summary>
    private void InitData()
    {
        DataTable dt;
        if (Session["dt"] != null)
        {
            dt = Session["dt"] as DataTable;
        }
        else
        {
            dt = DefineDataTableSchema(hfRptColumns.Value);
            DataRow row;
            for (int i = 1; i <= 3; i++)
            {
                row = dt.NewRow();
                row["StepName"] = "";
                row["UserID"] = "";
                dt.Rows.Add(row);
            }
        }
        repDt.DataSource = dt;
        repDt.DataBind();
    }

    //添加行
    protected void btnAdd_Click(object sender, EventArgs e)
    {
        DataTable dt = GetDataSource();
        Button btn = sender as Button;
        string curNum = btn.CommandArgument;
        DataRow row = dt.NewRow();
        row["StepName"] = "";
        row["UserID"] = "";
        dt.Rows.InsertAt(row, Int32.Parse(curNum));
        repDt.DataSource = dt;
        repDt.DataBind();
    }

    //删除行
    protected void btnDel_Click(object sender, EventArgs e)
    {
        DataTable dt = GetDataSource();
        Button btn = sender as Button;
        string curNum = btn.CommandArgument;
        dt.Rows.RemoveAt(Int32.Parse(curNum) - 1);
        repDt.DataSource = dt;
        repDt.DataBind();
    }

    //保存数据
    protected void btnSave_Click(object sender, EventArgs e)
    {
        DataTable dt = GetDataSource();
        Session.Add("dt", dt);
        string js = "<script>window.opener.setValue();window.close();</script>";
        Page.ClientScript.RegisterStartupScript(Page.GetType(), "msg", js);
    }

    /// <summary>
    /// 根据repeater相对应的列名，定义数据源datatable的schema
    /// </summary>
    /// <param name="columns">列名</param>
    /// <returns>datatable的schema</returns>
    private DataTable DefineDataTableSchema(string columns)
    {
        DataTable dt = new DataTable();
        string[] columnsAry = columns.Split(',');
        foreach (string str in columnsAry)
        {
            dt.Columns.Add(str);
        }
        return dt;
    }

    /// <summary>
    /// 获取数据源
    /// </summary>
    /// <returns>数据源</returns>
    private DataTable GetDataSource()
    {
        DataTable dt = DefineDataTableSchema(hfRptColumns.Value);
        foreach (RepeaterItem item in repDt.Items)
        {
            DataRow newRow = dt.NewRow();
            newRow["StepName"] = ((TextBox)item.FindControl("txtStepName")).Text;
            string[] selectuser = ((UserSelector)item.FindControl("userSelector")).SelectedUsers;
            string userid = "";
            foreach (string user in selectuser)
            {
                userid += user;
                userid += ";";
            }
            newRow["UserID"] = userid;
            dt.Rows.Add(newRow);
        }
        Session["dt"] = dt;
        return dt;
    }

    protected void repDt_ItemDataBound(object sender, RepeaterItemEventArgs e)
    {
        if (Session["dt"] != null)
        {
            DataTable dt = Session["dt"] as DataTable;
            int index = e.Item.ItemIndex;
            //确保处理的是数据行，而不是Header或者Footer 
            if (e.Item.ItemType == ListItemType.Item || e.Item.ItemType == ListItemType.AlternatingItem
                || e.Item.ItemType == ListItemType.SelectedItem)
            {
                UserSelector userSelector = ((UserSelector)e.Item.FindControl("userSelector")) as UserSelector;
                string[] selectuser = dt.Rows[index]["UserID"].ToString().Split(';');
                userSelector.SelectedUsers = selectuser;
            }
        }
    }

         3.用户设置好流程的审批人之后，下面就是在我们发起界面的SaveDataFields(OThinker.H3.WorkSheet.SheetSubmitEventArgs Args)事件里面依次给我们的 审批人赋值，简单代码如下：

        /// <summary>
        /// 设置流程步骤审批信息
        /// </summary>
        private void SetFlowApprovePerson()
        {
            DataTable dt = Session["dt"] as DataTable;
            if (dt != null && dt.Rows.Count > 0)
            {
                for (int i = 0; i < dt.Rows.Count; i++)
                {
                    if (dt.Rows[i]["StepName"] != null && dt.Rows[i]["UserID"] != null
                        && dt.Rows[i]["StepName"].ToString() != "" && dt.Rows[i]["UserID"].ToString() != "")
                    {
                        string stepName = "审批步骤名称" + (i + 1).ToString();
                        this.Enviroment.InstanceData[stepName].Value = dt.Rows[i]["StepName"].ToString();

                        string stepPerson = "审批人" + (i + 1).ToString();
                        string[] selectuser = dt.Rows[i]["UserID"].ToString().Split(';');
                        this.Enviroment.InstanceData[stepPerson].Value = selectuser;
                    }
                }
            }
        }

 在这里我们循环遍历DataTable给流程的审批人数据赋值。下面我们看一下审批效果：

      

 

整个自由流的创建过程基本上就是这样，其实也是很简单的，只要手工给每一个审批步骤设置好审批人就可以了。这接近一年的H3使用过程中感觉H3产品功能很全面，要是细节方面能完善一下，美工做得更好一点，我相信一定是一个非常不错的产品。