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

     在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