为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