【Moss开发系列】WF+Aspx进行Moss工作流开发（1）

Moss平台下工作流设计分一般三种模式：

一、根据Moss系统本身提供的一些流程模版，如审批工作流、三态工作流等进行定制。

二、利用SharePoint Designer进行流程设计。

三、前两种流程设计方式我们称之为流程定制，这种方式一般用于一些简单流程的处理，现实中有很多流程都需要专门的开发，对于这些复杂的流程，我们可以选用第三方流程开发工具（如K2），也可以选用标准的VS环境下的WF进行开发。

Moss平台下流程开发最常规的做法是：用InfoPath设计表单，然后利用WF设计流程并收集数据，然后与列表关联，最后发布流程。

这种方式看似简单，但做起来并不那么容易，因为InfoPath有其先天的不足，用InfoPath做过复杂流程的可能都经历过以下几点：

(1) 界面数据与流程交互比较麻烦，界面本身定制也比较麻烦，常见的情况：客户觉得InfoPath不好看，结果有好多东西是改不了的

(2) 界面上数据互动也较麻烦，比如常见的三级联动，仿Ajax验证，做起来也是很麻烦的事情

(3) 大表单与项目清单的显示与控制方面，常见的情况有，客户要求审批界面上半部分显示项目的详细信息，下面是审批信息，而且不同审批人能看到的项目信息字段权限不同

(4) 表单与表单代码的封装与重用，现实中的流程并不只简单的审批那么简单，一个复杂的流程涉及到的表单可能有上百个，难道都要从头设计，重用和表单管理本身是一个大的问题

那么如果我们能用Aspx表单来取代InfoPath表单的话，所有问题都可以轻易解决，一切都变得随心所欲了，下面切入正题，如何使用Aspx界面来替换InfoPath表单：

首先我们新建一个自定义列表“请假信息单”和一个“请假审批”任务类型列表

然后打开VS2008，新建一个WEB应用程序，注意：不要建成网站类型，建WEB应用程序，Moss环境下部署较麻烦，而WEB应用程序生成单一程序集，易于程序集的签名与部署。

然后对该WEB应用程序签名，以便于程序集可以部署在GAC中

新建一目录“_Layouts”,复制 C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS 下的application.master到该目录下。

删除默认的Default.aspx，新建一个审批页面 Approve.aspx，删除页面中原有HTML代码

将 前台页面的 Inherits节改为该web应用程序集强命名程序集的名称，Inherits="Janet.AspxWorkflow.Forms.Approve,Janet.AspxWorkflow.Forms, Version=1.0.0.0, Culture=neutral, PublicKeyToken=4af1d7891f28970c" 具体名字可以使用reflector查看。

然后改写添加 MasterPageFile="~/_layouts/application.master" 使继承母版页”application.master” ，最终页面代码如下： 

<%@ Page Language="C#" MasterPageFile="~/_layouts/application.master" AutoEventWireup="true"
    CodeBehind="Approve.aspx.cs" Inherits="Janet.AspxWorkflow.Forms.Approve,Janet.AspxWorkflow.Forms, Version=1.0.0.0, Culture=neutral, PublicKeyToken=4af1d7891f28970c" %>

 <%@ Import Namespace="Microsoft.SharePoint" %>
 <%@ Register TagPrefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls"
    Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
 <asp:Content ID="Content1" ContentPlaceHolderID="PlaceHolderPageTitle" runat="server">
    请假审批流程
 </asp:Content>
 <asp:Content ID="Content2" ContentPlaceHolderID="PlaceHolderTitleBreadcrumb" runat="server">
    &nbsp;
 </asp:Content>
 <asp:Content ID="Content3" ContentPlaceHolderID="PlaceHolderPageTitleInTitleArea"
    runat="server">
 </asp:Content>
 <asp:Content ID="Content5" ContentPlaceHolderID="PlaceHolderMain" runat="server">
   <TABLE width="650" style="font-size:12px;color:#369;BORDER-BOTTOM-STYLE: solid; BORDER-RIGHT-STYLE: solid; BORDER-COLLAPSE: collapse; BORDER-TOP-STYLE: solid; BORDER-LEFT-STYLE: solid" border="1" rules="all" cellSpacing="0" cellPadding="4">
       <tr>
            <td>请假人</td>
            <td>
                <%= this.UserName%>
            </td>
        </tr>
        <tr>
            <td>请假原因</td>
            <td>
                <%=this.UserMsg %>
            </td>
        </tr>
        <tr>
            <td>请假天数</td>
            <td>
                <%= this.Days%>
            </td>
        </tr>
        <tr>
            <td>审批意见</td>
            <td>
                <asp:TextBox ID="txtMsg" runat="server" TextMode="MultiLine" Rows="5" Columns="40"></asp:TextBox>
            </td>
        </tr>
        <tr>
            <td>是否通过</td>
            <td>
                <asp:RadioButtonList ID="radioPass" runat="server">
                    <asp:ListItem Value="true" Selected="True">通过</asp:ListItem>
                    <asp:ListItem Value="false">拒绝</asp:ListItem>
                </asp:RadioButtonList>                
            </td>
        </tr>
        <tr><td></td>
        <td><asp:Button Text="提交" runat="server" ID="BtnSubmit" onclick="BtnSubmit_Click" /></td>
        </tr>
    </table>
 </asp:Content>
 

  

项目中添加对Microsoft.SharePoint的引用，修改后台代码，改变页面继承自 Microsoft.SharePoint.WebControls.LayoutsPageBase

编写提交处理事件，页面后台代码如下：

 namespace Janet.AspxWorkflow.Forms
{
    public partial class Approve : Microsoft.SharePoint.WebControls.LayoutsPageBase
    {
        protected SPList taskList;         //请假审批任务列表
        protected SPListItem taskItem;    //当前任务

        public string UserName; //请假人
        public string UserMsg;  //请假原因
        public string Days; //请假天数

        protected void Page_Load(object sender, EventArgs e)
        {
            string strListID = Request.QueryString["List"];
            if (strListID != null)
            {
                taskList = Web.Lists[new Guid(strListID)];
                taskItem = taskList.GetItemById(Convert.ToInt32(Request.Params["ID"]));
                if (!Page.IsPostBack)
                {
                    Guid workflowId = new Guid((string)taskItem["WorkflowInstanceID"]);
                    SPWorkflow workflow = new SPWorkflow(Web, workflowId);
                    SPListItem projectItem = workflow.ParentItem;    //当前请假项目

                    this.UserName = projectItem["Author"].ToString();
                    this.UserMsg=projectItem["请假原因"].ToString();
                    this.Days = projectItem["请假天数"].ToString();
                }                
            }
        }



        protected void BtnSubmit_Click(object sender, EventArgs e)
        {
            try
            {
                if (taskItem != null)
                {
                    SPWeb web = SPContext.Current.Web;
                    web.AllowUnsafeUpdates = true;
                    Hashtable taskHash = new Hashtable();
                    taskHash["ApproveMsg"] = this.txtMsg.Text; //审批信息
                    taskHash["approved"] = this.radioPass.SelectedValue;    //审批状态，WF中获取用来判断，是否回退....
                    SPWorkflowTask.AlterTask(taskItem, taskHash, true);     //提交任务审批结果
                    SPUtility.Redirect(taskList.DefaultViewUrl, SPRedirectFlags.UseSource, HttpContext.Current);
                }
            }
            catch (Exception ex)
            {
                Response.Write(ex.ToString());
            }
        }
    }
}

   

编写Feature配置文件，

Feathre.xml 

<?xml version="1.0" encoding="utf-8"?>
 <Feature Id="1161B2A1-FDED-47a2-B3FE-7C97DD6CC743" Title="请假审批内容类型" Scope="Site" Version="1.0.0.0" Hidden="FALSE" DefaultResourceFile="core" xmlns="http://schemas.microsoft.com/sharepoint/">
  <ElementManifests>
    <ElementManifest Location="form.xml" />
  </ElementManifests>
 </Feature>

form.xml  

<?xml version="1.0" encoding="utf-8"?>
 <Elements Id="D9170A70-D733-4886-9117-12410DF5A8B2" xmlns="http://schemas.microsoft.com/sharepoint/">
  <ContentType ID="0x0108010023070ff45efd410a8bb9252cbabc1211"
               Name="请假审批页面"
               Group="我的审批页面"
               Description="请假审批表单内容类型"
               Version="0">
    <FieldRefs> 
    </FieldRefs>
    <XmlDocuments>
      <XmlDocument NamespaceURI="http://schemas.microsoft.com/sharepoint/events">
        <Receivers />
      </XmlDocument>
      <XmlDocument NamespaceURI="http://schemas.microsoft.com/sharepoint/v3/contenttype/forms/url">
        <FormUrls xmlns="http://schemas.microsoft.com/sharepoint/v3/contenttype/forms/url">
          <New>_layouts/MyAspxTask/Approve.aspx</New>
          <Display>_layouts/MyAspxTask/Approve.aspx</Display>
          <Edit>_layouts/MyAspxTask/Approve.aspx</Edit>
        </FormUrls>
      </XmlDocument>
    </XmlDocuments>
  </ContentType>
</Elements>

 注意：上面文件中的 _layouts/MyAspxTask/Approve.aspx 指向的是你的审批页面。    

在C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES 下面建一目录 MyAspxTask ,然后把这两个XML文件放入该目录中。执行命令：STSADM -o InstallFeature -filename MyAspxTask\feature.xml -force   注册该Feature。

注册成功后在“网站集功能”中能看到该内容类型，然后激活该内容类型

 

 然后进入“请假审批”任务列表的设置页，选择“高级设置”启用内容类型管理，如下图所示：

 然后在“请假审批”列表中添加刚才我们创建的那个内容类型：

 

 把我们的审批页面 approve.aspx 文件复制到 C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS\MyAspxTask 目录下，然后把WEB应用程序的dll文件，拖到GAC中(C:\WINDOWS\assembly文件夹)，到这里，页面部分设计完成，下面进行WF部分开发。

该流程仅涉及到一级审批：

 注意：创建任务活动在这里要使用“CreateTaskWithContentType”，在该活动的＂ContentTypeID＂属性中输入　0x0108010023070ff45efd410a8bb9252cbabc1211，即form.xml中的ContentType节的ID中的值，整个流程的代码如下： 

 public sealed partial class Workflow1 : SequentialWorkflowActivity
    {
        public Workflow1()
        {
            InitializeComponent();
        }

        public Guid workflowId = default(System.Guid);
        public SPWorkflowActivationProperties workflowProperties = new SPWorkflowActivationProperties();
        public Guid taskId1 = default(System.Guid);
        public SPWorkflowTaskProperties taskProperties1 = new Microsoft.SharePoint.Workflow.SPWorkflowTaskProperties();

        private void onWorkflowActivated1_Invoked(object sender, ExternalDataEventArgs e)
        {

        }

        private void createTaskWithContentType1_MethodInvoking(object sender, EventArgs e)
        {
            this.taskId1 = Guid.NewGuid();
            this.taskProperties1.AssignedTo = "jasper\\moss";
            this.taskProperties1.Title = string.Format("请审批【{0}】", this.workflowProperties.Item.DisplayName);
        }

        private void onTaskChanged1_Invoked(object sender, ExternalDataEventArgs e)
        {
            bool approve = bool.Parse(this.taskProperties1.ExtendedProperties["approved"].ToString());
            string msg = approve ? "审批通过：" : "审批拒绝：";
            msg += this.taskProperties1.ExtendedProperties["ApproveMsg"].ToString();
            this.workflowProperties.Workflow.CreateHistoryEvent(approve ? 2 : 8, 0, this.workflowProperties.OriginatorUser, msg, "", "");   //写入工作流历史记录
        }
    }

  

启动该工作流：

 审批该任务，看到我们熟悉的Aspx页面：

 审批结束： 

 

 请假审批结束，历史记录记录了该请假中间的审批过程,可以看到我的回家看老婆的希望已经破灭了......

 总结：这个只是一个简单的演示，很多细节没有进行处理。用Aspx做表单，一个流程的第一次使用感觉麻烦了点，后期经过一系列封装之后，做起来就简单的多了。

 示例项目下载

 下一篇将对aspx+wf进行一系列封装，使之能够轻易完成wf+infopath中的task1, task2 ... taskn的功能。