为SharePoint 2010 Workflow 开发 Custom(自定义的) Workflow Activity

为SharePoint 2010 Workflow 开发 Custom Workflow Activity(Develop Custom Workflow Activity for SharePoint 2010 Workflow).

SharePoint2010提供了很多有用的开箱即用的Activity（活动action）,我们可以在SharePoint Designer 2010 中看到这些自带的操作（actions）.

但有时当这些需求不能满足我的需求，但是我又想用开箱即用的Activity（活动action）来设计工作流，这时我们就需要开发自己的Workflow Activity（action）.

本文将介绍如何开发一个自定义的Workflow Activity（action)，并在SharePoint Designer 2010 使用该自定义的Workflow Activity。

1. File ---> New Project-----> Visual C# ---> SharePoint | 2010 ----> Empty Project

点击"Finish"

2. 选中刚刚建的解决方案，左击，Add->New Project->Visual C#->WorkFlow

点击OK

3. 在项目CreateActivityDemo中添加CreateSurveyList.cs （activity）

4.在项目CreateActivityDemo中添加以下引用

a. C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\ISAPI\Microsoft.SharePoint.dll

b. C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\ISAPI\microsoft.sharepoint.WorkflowActions.dll

5. 在CreateSurveyList.cs 中添加如下命名空间

using Microsoft.SharePoint;
using Microsoft.SharePoint.Workflow;
using Microsoft.SharePoint.WorkflowActions;

6. 在CreateSurveyList.cs中添加SiteUrlProperty ，用于存储SiteUrl，这个属性可以在SharePoint 2010 Designer 看到，我们可以设置它

public static DependencyProperty SiteUrlProperty = DependencyProperty.Register("SiteUrl",typeof(string), typeof(CreateSurveyList), new PropertyMetadata(""));
        [DescriptionAttribute("Url of site where survey is to be created")]
        [BrowsableAttribute(true)]
        [DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Visible)]
        [ValidationOption(ValidationOption.Required)]
        public string SiteUrl { get { return ((string)(base.GetValue(CreateSurveyList.SiteUrlProperty))); } set { base.SetValue(CreateSurveyList.SiteUrlProperty, value); } }

7. 在CreateSurveyList.cs中添加SurveyListNameProperty

 public static DependencyProperty SurveyListNameProperty = DependencyProperty.Register("SurveyListName",typeof(string), typeof(CreateSurveyList), new PropertyMetadata(""));
        [DescriptionAttribute("Name for survey list")]
        [BrowsableAttribute(true)]
        [DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Visible)]
        [ValidationOption(ValidationOption.Required)]
        public string SurveyListName { get { return ((string)(base.GetValue(CreateSurveyList.SurveyListNameProperty))); } set { base.SetValue(CreateSurveyList.SurveyListNameProperty, value); } }

8. 在CreateSurveyList.cs添加以下代码，用于覆盖Activity的运行方法

 protected override ActivityExecutionStatus Execute(ActivityExecutionContext executionContext) 
        { 
            this.CreateSurveyLibrary(); 
            return ActivityExecutionStatus.Closed;
        }       
        
        private void CreateSurveyLibrary() 
        { 
            using (SPSite oSPSite = new SPSite(SiteUrl))
            { 
                using (SPWeb oSPWeb = oSPSite.RootWeb)
                {
                    Guid ID = oSPWeb.Lists.Add(SurveyListName, SurveyListName + System.DateTime.Now.ToString(), SPListTemplateType.Survey); 
                    SPList oSPList = oSPWeb.Lists[ID]; oSPList.OnQuickLaunch = true; oSPList.Update(); 
                }
            } 
        }

9.为项目CreateActivityDemo添加强名

编译CreateActivityDemo，显示编译成功

10.右击CustomWorkflowActivityDemo 先择Add ---> SharePoint Mapped Folder，定位到Template->1033->Workflow

11. 在刚刚添加的WorkFlow文件夹中添加CreateActivityDemo.Actions，一个xml 文件，后缀名Actions会被SharePoint Desginer 2010识别

<WorkflowInfo>
  <Actions Sequential="then" Parallel="and">
    <Action Name="Create Survey List"
        ClassName="CreateActivityDemo.CreateSurveyList"
        Assembly="CreateActivityDemo, Version=1.0.0.0, Culture=neutral, PublicKeyToken=331ffcc01b13c340"
        AppliesTo="all"
        Category="Sundar Activity">
      <RuleDesigner Sentence="Survey List Name %1 to site %2.">
        <FieldBind Field="SurveyListName" Text="Survey List Name"
           DesignerType="TextArea" Id="1"/>
        <FieldBind Field="SiteUrl" Text="Url of base site" Id="2"
           DesignerType="TextArea"/>
      </RuleDesigner>
      <Parameters>
        <Parameter Name="SurveyListName" Type="System.String, mscorlib"
      Direction="In" />
        <Parameter Name="SiteUrl" Type="System.String, mscorlib"
      Direction="In" />
      </Parameters>
    </Action>
  </Actions>
</WorkflowInfo>

注意PublicKeyToken=331ffcc01b13c340是需要替换的，不同的项目不一样，具体可以用Reflector查看

12. 双击CustomWorkFlowActivityDemo 中的Package.Package，点击Advanced, 添加Safe Control ‘CreateActivityDemo’

13.在C:\inetpub\wwwroot\wss\VirtualDirectories\80\web.config中添加（在<authorizedTypes>节点下）

<authorizedType Assembly="CreateActivityDemo, Version=1.0.0.0, Culture=neutral, PublicKeyToken=331ffcc01b13c340" Namespace="CreateActivityDemo" TypeName="*" Authorized="True" />

注意PublicKeyToken=331ffcc01b13c340是需要替换的，不同的项目不一样

14.部署CustomWorkFlowActivityDemo （不出意外部署应该是成功的）

15.启动Microsoft SharePoint Designer 2010，打开网站http://ccpc/，选择工作流，新建工作流（基于某个List，例如我的是Agents）,工作流启动条件为新建项目

16. 添加我们开发好的activty,并保存和发布工作流

18.查看工作流建好的Survery

至此开发自定义的Moss 2010 action（activity）完成了，希望本文对朋友们有帮助。

需要的朋友可以从这里下载到该实例的代码：http://download.csdn.net/source/3573107