为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.****.net/source/3573107