工作流开发sharepoint(VS2008)

Sharepoint工作流开发（vs2008）7.4 采用Visual Studio 2008 开发工作流模板本节讲述采用Visual Studio 2008开发SharePoint工作流模板的一般步骤和方法。

为了使读者更好地理解本节的内容，本节在讲述基本原理和操作的同时会附带讲解一个实例工作流的开发，这个工作流是一个文档审批工作流：提交者上传文档，然后启动工作流，最后提交给审批人审批。

7.4.1 创建工作流项目Step1 新建项目。

打开Visual Studio 2008新建项目，选择“Workflow”中的“SharePoint 2007 Sequential Workflow”项目模板，如图7-40所示。

图7-40 新建项目Step2 指定调试工作流所用的站点路径，如图7-41所示。

图7-41 指定调试工作流所用的站点路径Step3 指定工作流用来调试时附加到的列表。

若列表不存在，则先到站点中创建，如图7-42所示。

图7-42 制定工作流用来调试时附加到的列表Step4 指定工作流调试时的启动方式为手工启动，如图7-43所示。

图7-43 指定工作流调试时的启动方式以上操作完成之后，可以看到VS 2008中如图7-44所示的布局。

该图中左边工具栏上是系统提供的所有活动组件，中间是工作流设计器界面，右边是项目文件。

l onTaskChanged：通过onTaskChanged活动，等待用户完成任务，并可以处理Invoked方法，按照用户的输入进行逻辑处理。

l completeTask：通过completeTask活动，完成用户的任务。

一个任务的分配过程，都是需要以上3个活动进行配合的。

下面是具体分配任务的操作过程。

Step1 从工具栏中拖曳createTask到设计器中，如图7-45所示。

Step2 指定createTask活动的CorrelationToken属性为“task1Token”，OwnerActivityName为“Workflow1”，如图7-46所示。

图7-45 从工具栏中拖曳CreateTask到设计器图7-46 指定CreateTask活动的属性Step3 绑定createTask活动的TaskId属性到工作里的字段。

单击“TaskId”属性的设置按钮，在弹出的属性绑定窗口选择绑定到新成员标签，输入名称为“task1Id”，选择创建字段，如图7-47所示。

图7-47 绑定CreateTask活动的TaskId属性到工作里的字段Step4 绑定createTask活动的TaskProperties属性到工作流的字段task1Properties。

Step5 处理createTask的MethodInvoking事件。

双击createTask，在自动生成的MethodInvoking事件处理函数中写入如下代码。

private void createTask1_MethodInvoking(object sender, EventArgs e){this.task1Id = Guid.NewGuid(); //生成任务IDthis.task1Properties.Title = "文档审批";this.task1Properties.AssignedTo = "codeart\user1"; //设置任务操作人}Step6 拖曳onTaskChanged到工作流设计器中，如图7-48所示。

图7-48 拖曳onTaskChanged到工作流设计器Step7 设置onTaskChanged活动的CorrelationToken属性为“task1Token”，如图7-49所示。

Step8 将onTaskChanged活动的TaskId属性绑定到已有的task1Id字段，如图7-50所示。

图7-50 TaskId属性绑定到已有的task1Id字段图7-49 CorrelationToken属性为“createTask1”Step9 将onTaskChanged活动的BeforeProperties和AfterProperties属性均绑定到已有task1Properties 字段。

Step10 拖曳completeTask活动到工作流设计器中，如图7-51所示。

图7-51 拖曳CompleteTask活动到工作流设计器Step11 设置completeTask活动的CorrelationToken属性为“task1Token”。

Step12 将completeTask活动的TaskId属性绑定到已有的task1Id字段。

Step13 设置completeTask活动的TaskOutcome属性为“完成”，如图7-52所示。

图7-52 设置TaskOutcome属性以上是创建一个任务的基本过程。

在实际过程中，任务操作人的获取可能有多种情形，比如从站点的某个组内获取用户，从第三方的角色管理系统中获取用户等。

假设任务要分配给站点的部门经理组中的用户，则createTask活动的MethodInvoking事件可以如下。

private void createTask1_MethodInvoking(object sender, EventArgs e){this.task1Id = Guid.NewGuid();this.task1Properties.Title = "文档审批";//获取到部门经理网站组SPGroup group1 = this.workflowProperties.Web.SiteGroups["部门经理"];SPUser user1 = ers[0]; //获取部门经理网站组中的第一个用户this.task1Properties.AssignedTo = user1.LoginName; //分配任务}createTask活动会在工作流对应的任务列表中创建一个任务列表项。

在默认情况下，对任务列表具有操作权限的用户都可以操作这个任务列表项，但通常情况下，希望只有特殊的用户才可以进行操作，这就要用到createTask活动的SpecialPermissions属性。

SpecialPermissions是一个集合类型，可以将有权限的用户加到它里面，实现对任务列表项的特殊权限控制。

下面是具体的操作步骤。

Step1 选中createTask活动，单击SpecialPermissions属性的“绑定”图标，绑定属性到specialPermissions1字段中，如图7-53和图7-54所示。

图7-53 SpecialPermissions属性的绑定图标图7-54 绑定属性到specialPermissions1字段Step2 修改createTask的MethodInvoking事件处理方法，设置specialPermissions1集合，代码如下所示。

private void createTask1_MethodInvoking(object sender, EventArgs e){this.task1Id = Guid.NewGuid();this.task1Properties.Title = "任务标题";this.task1Properties.AssignedTo = "codeart\\user1";//设置任务权限this.specialPermissions1.Add(this.task1Properties.AssignedTo,SPRoleType.Contributor);}以上讲述的是单个任务的创建过程，重复这个过程，可以创建出多步的顺序审批流程。

7.4.3 工作流的测试和调试上一节已经完成了任务分配的基本编码，直接按“F5”键即可部署和调试。

如果只是单纯的部署，可以通过项目右键菜单的“Deploy”菜单项进行，如图7-55所示。

图7-55 右键菜单的“Deploy”菜单项部署完成后，访问MOSS站点测试工作流关联的文档库（本节示例为名称为文档审批的文档库），新建或上传一个文档，然后选择名称栏右键菜单的“工作流”选项，选择要测试的工作流，如图7-56和图7-57所示。

图7-56 新建一个文档图7-57 工作流选择启动工作流后，返回文档库，会发现文档库上多出来一栏，以工作流的名称命名，可以称这一栏为工作流状态栏，如图7-58所示。

图7-58 工作流状态栏单击工作流状态栏链接，可以转到工作流状态页面。

在此页面，可以查看到工作流分配的所有任务情况，如图7-59所示。

图7-59 工作流状态页面用具有编辑任务权限的用户登录站点，访问到工作流状态页面，通过任务标题栏的“编辑项目”菜单可以转到任务编辑页面，如图7-60所示。

图7-60 任务编辑页面由于尚未定义任务操作页面，所以会看到如图7-61所示的默认任务编辑页面，单击“确定”按钮即可完成审批任务。

图7-61 默认任务编辑页面完成任务之后，转回任务状态页面，可以看到任务的状态已经变成“已完成”，如图7-62所示。

图7-62 任务状态页面以上是在测试时可进行的快捷操作。

工作流实际运行时，不可能要求用户采用这样的操作方式，一般采用用户任务Web部件，让用户直接在站点首页集中处理工作流任务。

在站点首页进入编辑模式，选择添加Web部件，选中添加用户任务Web部件即可，如图7-63所示。

图7-63 选择用户任务Web部件7.4.4 设计工作流模板的任务表单上一节已经看到了默认的任务编辑页面，这显然是不符合实际要求，普通的审批页面一般具有一个意见框、一个批准和拒绝的选项。

本节讲述如何采用InfoPath来开发自定义的任务操作界面。

1．设计表单Step1 新建表单。

打开InfoPath，选择“表单模板”单选按钮，确认选中“仅启动浏览器兼容性功能”复选框，如图7-64所示。

图7-64 新建表单Step2 添加数据源域。

在数据源中添加两个字段域，一个名称为“comments”，数据类型为“文本”；另一个名称为“approval”，数据类型为“boolean”，如图7-65和图7-66所示。

图7-65 添加数据源域图7-66 添加数据源域Step3 插入布局表格。

选择“插入”菜单中的“版式表格”选项，插入一个3行1列的布局表格，如图7-67和图7-68所示。

图7-67 插入布局表格图7-68 插入布局表格Step4 设计表单字段。

将审批意见域拖曳到布局表格上，并调整高度。

将审批结果域拖曳到布局表格上，并且更改为选项按钮，分别在两个单项框后面添加批准和拒绝文字，如图7-69所示。