SharePoint State Machine Workflow ＋ASP.NET ASPX Form step by step（2）－创建Associati

上帝大脸

　　在workflow中，有四种表单，分别是Association，Instantiation，Modification，TaskEdit.这篇我就讲讲如何自定义一个Association表单。
　　但什么是Association表单？当我们为一个Library、list加上一个workflow的时候，会出现下图，当我们点击Next之后，如果我们自定义了一个Association表单的话，那么你就会跳转到相应的你自己定义的那个表单页面。而总的来说，这个页面是对你的这个workflow做一些定义，你可以为这个workflow加上一些缺省的值，这些值是List/Library级别的，在每个不同Item的workflow中都可以使用。例如，我们可以在Association表单中定义缺省的审批人，然后在后面的Instantiation表单中显现（前提是你有自定义这个表单），在这个表单中你可以直接就使用Association表单中已经定义的审批者，也可以对他们进行修改。从我的理解来说，Association表单就是让你能够在List/Library级别上做些缺省设置，然后在接下来的步骤中，你可以选择使用这些，也可以进行修改用你自己的定义的值。
　　
     
　　首先，我们要定义一个APSX页面。我的做法是先创建一个Class Library的工程，把原先的文件删了，自己创建一个ASPX文件，和一个CLass Library作为aspx文件的后台代码。
　　
　　
     
　　你可以先将这个工程编译一下，生成一个dll，那么你就可以将这个Assmebly加到你的aspx文件头中。然后加上一些指令，你可以到layouts文件下找一个application页面，将一些公用的指令代码贴过来就行了。这些部分都是公用的，除最开头的Assembly和Inherits是不同的，其它的都可以用的。
　　

<%@ Assembly Name="MyASPXPage, Version=1.0.0.0, Culture=neutral, PublicKeyToken=91dbd359a1533843" %>
<%@ Page Language="C#" MasterPageFile="~/_layouts/application.master" EnableSessionState="true" ValidateRequest="False" AutoEventWireup="true" Inherits="MyASPXPage.MyAss" %>
<%@ Register Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@ Register Tagprefix="Utilities" Namespace="Microsoft.SharePoint.Utilities" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@ Import Namespace="Microsoft.SharePoint" %>   
<%@ Register TagPrefix="wssuc" TagName="LinksTable" src="/_controltemplates/LinksTable.ascx" %> <%@ Register TagPrefix="wssuc" TagName="InputFormSection" src="/_controltemplates/InputFormSection.ascx" %>
<%@ Register TagPrefix="wssuc" TagName="InputFormControl" src="/_controltemplates/InputFormControl.ascx" %> <%@ Register TagPrefix="wssuc" TagName="LinkSection" src="/_controltemplates/LinkSection.ascx" %>
<%@ Register TagPrefix="wssuc" TagName="ButtonSection" src="/_controltemplates/ButtonSection.ascx" %>
<%@ Register TagPrefix="wssuc" TagName="ActionBar" src="/_controltemplates/ActionBar.ascx" %> <%@ Register TagPrefix="wssuc" TagName="ToolBar" src="/_controltemplates/ToolBar.ascx" %>
<%@ Register TagPrefix="wssuc" TagName="ToolBarButton" src="/_controltemplates/ToolBarButton.ascx" %> <%@ Register TagPrefix="wssuc" TagName="Welcome" src="/_controltemplates/Welcome.ascx" %>
<%@ Register Tagprefix="wssawc" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@ Register Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@ Register Tagprefix="Workflow" Namespace="Microsoft.SharePoint.Workflow" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
　　
　　在master页面中有很多的PlaceHolder，但对于我们来说只有PlaceHolderMain是最重要的，我们的控件都是放在这里，你要是对其它的PlaceHolder感兴趣，你可以自己加上相应的东西。
　　

Code
<asp:Content ContentPlaceHolderID="PlaceHolderMain" runat="server">   
     
        <wssuc:InputFormSection Title="Default Workflow Start Values" Description="My Association Form"
            runat="server">
            <template_inputformcontrols>
                <wssuc:InputFormControl LabelText="Reviewers:" runat="server">
                    <Template_Control>
                        <wssawc:PeopleEditor
                                    AllowEmpty="true"
                                    ValidatorEnabled="true"
                                    id="Reviewers"
                                    runat="server"
                                    SelectionSet="User,SecGroup,SPGroup"
                                    width='300px' MultiSelect="true"/>
                        </Template_Control>
                </wssuc:InputFormControl>
                <wssuc:InputFormControl LabelText="Type a message to include with your request:" runat="server">
                        <Template_Control>
                            <wssawc:InputFormTextBox Title="Task Description" class="ms-input" ID="Description" runat="server" TextMode="MultiLine" Columns="40" Rows="5"/>
                        </Template_Control>
                </wssuc:InputFormControl>
            </template_inputformcontrols>
        </wssuc:InputFormSection>
        <wssuc:ButtonSection runat="server">
            <template_buttons>
            <asp:PlaceHolder runat="server">
               
                <asp:Button runat="server" class="ms-ButtonHeightWidth" OnClick="btnOK_Click" Text="OK" id="btnOK"/>
            </asp:PlaceHolder>
        </template_buttons>
        </wssuc:ButtonSection>
               
        <input type="hidden" name="WorkflowDefinition" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["WorkflowDefinition"]),Response.Output); %>' />
        <input type="hidden" name="WorkflowName" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["WorkflowName"]),Response.Output); %>'/>
        <input type="hidden" name="AddToStatusMenu" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["AddToStatusMenu"]),Response.Output); %>'/>
        <input type="hidden" name="AllowManual" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["AllowManual"]),Response.Output); %>'/>
        <input type="hidden" name="RoleSelect" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["RoleSelect"]),Response.Output); %>'/>
        <input type="hidden" name="GuidAssoc" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["GuidAssoc"]),Response.Output); %>'/>
        <input type="hidden" name="SetDefault" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["SetDefault"]),Response.Output); %>'/>
        <input type="hidden" name="HistoryList" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["HistoryList"]),Response.Output); %>'/>
        <input type="hidden" name="TaskList" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["TaskList"]),Response.Output); %>'/>
        <input type="hidden" name="UpdateLists" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["UpdateLists"]),Response.Output); %>' />      
        <input type="hidden" name="AutoStartCreate" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["AutoStartCreate"]),Response.Output); %>' />
        <input type="hidden" name="AutoStartChange" value='<% SPHttpUtility.NoEncode(SPHttpUtility.HtmlEncode(Request.Form["AutoStartChange"]),Response.Output); %>' />

</asp:Content>　　
　　以上就是ASPX文件的所有内容，后面我们就要着手我们的后台代码了。首先我们要定义一大堆的变量，这些变量是用来保存例如ListId，ItemId,WorkflowId,TaskList等等之类的东西。你还要定义相应的控件，变量名要和你aspx文件控件id一样。
　　

Code
private SPWeb _myTeamSite;              

        Paramater variables received from the Workflow Attachment screen#region Paramater variables received from the Workflow Attachment screen

        string _paramWorkflowName = string.Empty;               
        string _paramWorkflowGuid = string.Empty;               
        string _paramSPListGuid = string.Empty;                 
        string _paramTaskList = string.Empty;                  
        string _paramHistoryList = string.Empty;                     
        bool _paramAutoStartWF_OnItemChange;                    
        bool _paramAllowManualStart;                           
        string _paramWorkflowAssociationGuid = string.Empty;   

        #endregion

        Workflow List, Template and Association Variables#region Workflow List, Template and Association Variables

        bool _worfkflowAssociationExists = false;           
        SPList _sharePointListAttachedTo;                  
        Guid _workflowAssociationGuid;                     
        SPWorkflowAssociation _workflowAssociationObject;   
        Guid _workflowTemplateGuid;                        
        SPWorkflowTemplate _workflowTemplateObject;         
        #endregion

        Task List and History List variables#region Task List and History List variables

        SPList _workflowtTaskList;                          
        SPList _workflowHistoryList;                        
        #endregion　　你先是重载OnPreInit函数。
　　
　　protected override void OnPreInit(EventArgs e)
        {
          this._myTeamSite = SPControl.GetContextWeb(Context);
         }
　　然后为前先无数的变量设置值。因为我们自定义Association Form，原先我们点击了Next之后，相应的workflow就与相应的List联系起来，现在，这些工作要我们自己来做。代码就不贴了，看附件吧（其实代码借用了很多前人的代码）。大家一看就能明白了。下面也没有什么需要嘱咐的地方，就有个地方，在我们的Association Form上有个按钮，你不需要对控件加上一个EventHandler，你只需要在代码中实现一个和页面控件OnClick属性值同名的一个函数，函数原型就和一般的EventHandler是一样的，但记得要设为Public。
　　将生成的dll放到GAC中。（要强签名），把ASPX文件放到layouts文件夹下，在你生成的workflow的workflow.xml中做加上 AssociationUrl="_layouts/MyAss.aspx"
　　

Code
<Workflow
     Name="TestWorkflow"
     Description="My SharePoint Workflow"
     Id="e0d38698-f244-492a-ae32-4ca3ebcb1b03"
     CodeBesideClass="TestWorkflow.Workflow1"
     CodeBesideAssembly="TestWorkflow, Version=1.0.0.0, Culture=neutral, PublicKeyToken=cd996aa41f54bf80"
     AssociationUrl="_layouts/MyAss.aspx" />　　
　　我的页面的样子
　　
     希望大家对提意见。
　　Association Form