开发SharePoint中的定制流程动作

在上一篇文章里面，我发布了一个SharePoint的Workflow引擎。其中提到了用户可以根据自己的要求，自己定制需要的流程动作，并插入到流程定义文件中。这篇文章演示了如何开发定制的流程动作：给一个指定的Email地址发送一封邮件，告知有新的报告来了。

 

打开VS.NET，新建一个“类库”项目，在项目中加入两个Assembly的引用：Kaneboy.SPSWorkflow.dll和Microsoft.SharePoint.dll。

 

编写自定义流程动作，其实就是创建一个从Kaneboy.SPSWorkflow.Actions.ActionBase继承下来的类，并override继承的DoAction()方法。

 

Kaneboy.SPSWorkflow.Actions.ActionBase提供了多个protected的属性，这些属性公开了与这个流程动作相关的一些信息：

Web : 当前的SPS站点

List : 当前这个文件所在的文档库

User : 执行这个动作的用户

File : 当前的文件

ListItem : 当前文件相关的列表项

Parameter : 从流程定义文件中传入的参数的值，比如流程定义文件中对于这个动作的定义是“<action ns="Tencent" prefix="st1" Assembly="”C:/SPSWorkflowActionSample.dll” Type=”SPSWorkflowActionSample.SendEmail” Parameter=”[email protected]” />”，那么这里的Parameter属性值就是“[email protected]”

 

现在开始创建这个流程动作类：

public class SendEmail : Kaneboy.SPSWorkflow.Actions.ActionBase

 

然后重写父类的DoAction()方法：

public override Microsoft.SharePoint.SPFile DoAction()

{

MailMessage mailMsg = new MailMessage();

// 邮件的发件信箱就是当前用户的Email，这个Email是SPS站点用户的信箱

mailMsg.From = this.User.Email;

// 邮件的收件信箱从动作参数中获得

mailMsg.To = this.Parameter;

// 邮件的主题和正文从当前用户和当前文件中获得相应信息

mailMsg.Subject = this.User.Name + "提交了一篇新的报告：" + this.File.Name;

mailMsg.Body = mailMsg.Subject;

 

try

{

       // 这个例子假设可以在本机通过CDOSYS发送邮件

SmtpMail.SmtpServer = "127.0.0.1";

SmtpMail.Send(mailMsg);

}

finally

{

}

 

       // 除非对当前文件做了移动操作，否则返回null即可。

return null;

}

 

编译，得到一个dll文件，然后将dll文件放置到SPS服务器的某个位置。参看这个流程定义文件，如果我们要在报告移到部门经理报告库后自动发送一封邮件给经理，那么在

 

<action Assembly="" Roman?? New ?Times mso-hansi-font-family: Roman?; mso-ascii-font-family: 宋体; FONT-FAMILY: Parameter="

<Action Assembly="" Type="Kaneboy.SPSWorkflow.Actions.Move" Parameter="部门经理报告库" />

 

的后面再添加一行：

 

<action Assembly="C:/SPSWorkflowAction

<Action Assembly="C:/SPSWorkflowActionSample.dll" Type="SPSWorkflowActionSample.SendEmail" Parameter="[email protected]" />

 

Assembly属性的值就是编译得到的dll文件的绝对路径，Type属性的值是动作类的名称，Parameter属性的值就是收件人的信箱。

完整的项目源码点击这里下载。