QuickFlow教程(11)活动的扩展

有朋友问用QF的时候一些具体的功能如何实现，如以下的问题：

“我用的是 vs2008+quickflow+infopath，想在vs 代码里来更新文档库中项的值同时还需要更新其他相关联的列表项的值”

QF的基础是WF3.5和SharePoint本身的功能，然后提供了Flowchart类型的流程和一些常用的活动，显然，QF不可能考虑到所有的业务场景，不可能提供对所有功能的内在支持。

幸运的是，WF本身具有很强的扩展性，而QF并没有把这些扩展性屏蔽掉。基于QF的扩展开发包含以下内容：

1）EventBus的扩展，见SharePoint工作流解决方案QuickFlow系列(6)—事件总线（EventBus）

2）开发自定义的Activity，包含两种活动：

原生的WF活动。QF支持原生的WF活动，但是原生WF活动不能放到Flowchart的根下，必须采用Step活动包装（即先添加一个Step活动，然后再Step活动中即可添加任意其他活动）
QF的活动，支持直接添加到Flowchart的根下，并可以画线连接其他活动。

本篇文章就来讲解下QF活动的扩展开发，原生QF活动的开发可以参照QF活动。

本文以一个简单的请假审批流程作为示例：员工提交请假申请，部门经理审批，审批通过后，自动添加一个日历项到日历列表中。

1）先创建一个列表，用来提交请假信息，名称为“请假申请”，并添加开始时间，结束时间，备注三个字段。

2）新建一个Workflow Activity Library类型的项目，名称为QFExtensions.

3)添加对QuickFlow.dll和Microsoft.SharePoint.dll的引用

Microsoft.SharePoint.dll在目录C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\ISAPI中

将QuickFlow.wsp改名为QuickFlow.cab，然后解压缩，即可得到QuickFlow.dll

4)将活动名称改为AddCalendar, 基类改为QuickFlow.SPSequenceActivity。

所有可以添加到Flowchart跟上的活动都必须继承于SPSequenceActivity。

然后重载Execute方法，编写添加日历项的代码：

[ToolboxItem(typeof(ActivityToolboxItem))]
    [Designer(typeof(ActivityDesigner), typeof(IDesigner))]
	public partial class AddCalendar: QuickFlow.SPSequenceActivity
	{
		public AddCalendar()
		{
			InitializeComponent();
		}

        protected override ActivityExecutionStatus Execute(ActivityExecutionContext executionContext)
        {
            SPWeb web = this.WorkflowProperties.Web;

            SPList calendarList = web.Lists["Calendar"];

            SPListItem item = calendarList.Items.Add();

            item["Title"] = "请假:" + this.WorkflowProperties.Item.Title;
            //此处的Start Time等日历列表的字段需要实际版本修改，这儿是英文版上的字段名
            item["Start Time"] = this.WorkflowProperties.Item["开始时间"];
            item["End Time"] = this.WorkflowProperties.Item["结束时间"];
            item["Description "] = this.WorkflowProperties.Item["备注"];

            item.Update();

            return ActivityExecutionStatus.Closed;
        }
	}

5）将项目进行强签名，然后将QFExtensions.dll部署到GAC中，（直接将dll拖拽到C:\Windows\assembly或者执行示例项目中的GAC.bat文件）

6）配置web.config

用Reflector打开QFExtensions.dll，找到程序集的全名

修改应用程序目录下的web.config，在authorizedTypes节点中添加配置：

7）配置QuickFlowDesigner。

打开QuickFlowDesigner目录下的ToolboxItems.txt文件，添加一行配置：

QFExtensions.AddCalendar,QFExtensions, Version=1.0.0.0, Culture=neutral, PublicKeyToken=25e4e899ff9bd7c5

8）启动QFD，可以看到AddCalendar活动已经出现在工具栏上了

9）画出流程图，发布流程，可以看看效果了

添加ListItem

启动流程

本文示例代码下载：

http://cid-7f5a25cdf47d03e6.skydrive.live.com/self.aspx/QuickFlow/Examples/QFExtensions^_AddCalendar.zip

后记：有朋友问：如何怎样写带有属性的扩展组件？

编写WF活动的所有经验都可以用于QuickFlow的活动开发，对这个问题，只要给活动声明属性即可，假设要修改AddCalendar的代码，使日历列表的名字可以配置，代码如下：

[ToolboxItem(typeof(ActivityToolboxItem))]
    [Designer(typeof(ActivityDesigner), typeof(IDesigner))]
	public partial class AddCalendar: QuickFlow.SPSequenceActivity
	{
		public AddCalendar()
		{
			InitializeComponent();
		}

     public  string ListName{get;set;}

        protected override ActivityExecutionStatus Execute(ActivityExecutionContext executionContext)
        {
            SPWeb web = this.WorkflowProperties.Web;

            SPList calendarList = web.Lists[this.ListName];

            SPListItem item = calendarList.Items.Add();

            item["Title"] = "请假:" + this.WorkflowProperties.Item.Title;
            //此处的Start Time等日历列表的字段需要实际版本修改，这儿是英文版上的字段名
            item["Start Time"] = this.WorkflowProperties.Item["开始时间"];
            item["End Time"] = this.WorkflowProperties.Item["结束时间"];
            item["Description "] = this.WorkflowProperties.Item["备注"];

            item.Update();

            return ActivityExecutionStatus.Closed;
        }
	}

以上的代码中采用的是普通属性，普通属性在设计器中只能直接赋值，无法进行绑定，若要添加可以绑定的属性，则需要用WF中的依赖属性，将ListName声明修改如下：

public static DependencyProperty ListNameProperty = 
            DependencyProperty.Register("ListName", typeof(System.String), typeof(AddCalendar));   

        [ValidationOption(ValidationOption.Required)]
        [DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Visible)]
        [BrowsableAttribute(true)]
        [CategoryAttribute("Misc")]
        public String ListName
        {
            get
            {
                return ((string)(base.GetValue(ListNameProperty)));
            }
            set
            {
                base.SetValue(ListNameProperty, value);
            }
        }