为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