SharePoint 2010 工作流解决方案：创建和调试 SharePoint 工作流解决方案

向 SharePoint 文档库中添加栏
1. 打开一个 SharePoint 网站 。
2. 新建一个文档库。 文档库的名字可取为“共享文档”
3. 在“库工具”功能区上单击“库”，然后单击该功能区上的“创建列”按钮以创建新列。

4. 将该列命名为“文档状态”，将其类型设置为“选项(要从中选择的菜单)”，指定以下三个选项，然后单击“确定”：
· 需要评审
· 评审完成
· 请求更改
5. 再创建两列并将它们命名为“受理人”和“评审注释”。 将“受理人”列类型设置为单行文本，将“评审注释”列类型设置为多行文本。
使文档无需签出即可编辑
如果无需签出文档即可进行编辑，则测试工作流模板会更容易一些。 在下一个过程中，您将配置 SharePoint 网站以达到此目的。
1. 单击“共享文档”。
2. 在“库工具”功能区上单击“库”，然后单击“库设置”按钮以显示“文档库设置”页。
3. 在“常规设置”部分中，单击“版本控制设置”以显示“版本控制设置”页。
4. 验证“要求先签出文档然后再对其进行编辑”的设置是否为“否”。 如果不是这样，请将其更改为“否”，然后单击“确定”。
创建 SharePoint 顺序工作流项目
顺序工作流是按顺序执行直到最后一个活动完成的一组步骤。 在此过程中，我们将创建一个将应用于“共享文档”列表的顺序工作流。 利用此工作流向导，您可以将工作流与网站定义或列表定义关联，并可以确定工作流的启动时间。
启动 Visual Studio，然后通过指向“文件”菜单上的“新建”并单击“项目”，显示“新建项目”对话框。
1. 展开“Visual C#”下的“SharePoint”节点，然后单击“2010”。
2. 在“模板”窗格中选择“顺序工作流”。
3. 在“名称”框中，键入 MySharePointWorkflow，然后单击“确定”。



这将显示“SharePoint 自定义向导”。
4. 在“要使用哪个本地网站进行调试?”页中，单击“下一步”以接受默认网站。



5. 在“指定用于调试的工作流名称”页上，接受默认名称（“MySharePointWorkflow - Workflow1”）。 保留默认工作流模板类型值“列表工作流”，然后单击“下一步”。



6. 在“是否希望 Visual Studio 在调试会话中自动关联工作流?”页中，单击“下一步”以接受所有默认设置。 此步骤会自动将工作流与共享文档库关联。



7. 在“指定确定工作流启动方式的条件”页上，将“您希望如何启动工作流?”部分中的默认选项保持选中状态，然后单击“完成”。



可利用此页指定工作流启动的时间。 默认情况下，当用户在 SharePoint 中手动启动工作流时，或在创建与工作流关联的项时，工作流将启动。

创建工作流活动
工作流包含一个或多个表示要执行的操作的活动。 使用工作流设计器可为工作流安排活动。 在此过程中，我们将向工作流中添加两个活动：HandleExternalEventActivity 和 OnWorkFlowItemChanged。 这些活动将监视“共享文档”列表中文档的评审状态。
1. 工作流应显示在工作流设计器中。 如果不是这样，请双击“解决方案资源管理器”中的“Workflow1.cs”以打开工作流。



2. 在设计器中，单击选择“OnWorkflowActivated1”活动。
3. 在“属性”窗口中，在“Invoked”属性旁键入 onWorkflowActivated，然后按 Enter。
代码编辑器将会打开，一个名为“onWorkflowActivated”的事件处理程序方法被添加到 Workflow1 代码文件中。





4. 切换回工作流设计器，打开工具箱，然后展开“Windows Workflow v3.0”节点。
5. 从“工具箱”的“Windows Workflow v3.0”节点拖动一个“While”活动，并将该活动与“onWorkflowActivated1”活动下的行连接。



6. 单击选择“WhileActivity1”活动。
7. 在“属性”窗口中，将“Condition”设置为“代码定义”。



8. 展开“Condition”属性，在“Condition”属性旁键入 isWorkflowPending，然后按 Enter。



代码编辑器将会打开，一个名为 isWorkflowPending 的方法被添加到 Workflow1 代码文件中。



9. 切换回工作流设计器，打开工具箱，然后展开“SharePoint 工作流”节点。
10. 从“工具箱”的“SharePoint 工作流”节点拖动一个“OnWorkflowItemChanged”活动，并将该活动与“whileActivity1”活动中的行连接。



11. 单击选择“onWorkflowItemChanged1”活动。
2. 在“属性”窗口中，如下表所示设置属性。

属性	值
CorrelationToken	workflowToken
Invoked	onWorkflowItemChanged

处理活动事件
最后，检查每个活动后文档的状态。 如果文档已经过评审，则工作流将完成。
1. 在 Workflow1.cs中，将以下字段添加到 Workflow1 类的顶部。 在活动中使用此字段可确定工作流是否已完成。
Boolean workflowPending = true;
2. 将下面的方法添加到 Workflow1 类中。 此方法检查“文档”列表的 “文档状态” 属性的值，以确定文档是否已评审。 如果“文档状态”属性设置为 “评审完成”，checkStatus 方法就将 workflowPending 字段设置为 false 以指示工作流可以完成。
private void checkStatus()
{
if ((string)workflowProperties.Item["文档状态"] == "评审完成")
workflowPending = false;
}
3. 将下面的代码添加到 onWorkflowActivated 和 onWorkflowItemChanged 方法以调用 checkStatus 方法。 当工作流开始时，onWorkflowActivated 方法调用 checkStatus 方法以确定文档是否已评审。 如果文档尚未评审，则工作流继续。 保存文档时，onWorkflowItemChanged 方法再次调用 checkStatus 方法以确定文档是否已评审。 如果 workflowPending 字段设置为 true，则工作流继续运行。
private void onWorkflowActivated(object sender, ExternalDataEventArgs e)
{
// Check the status.
checkStatus();
}

private void onWorkflowItemChanged(object sender, ExternalDataEventArgs e)
{
// Check the status.
checkStatus();
}
4. 向 isWorkflowPending 方法中添加以下代码以检查 workflowPending 属性的状态。 每次保存文档时，“whileActivity1”活动都会调用 isWorkflowPending 方法。 此方法检查 ConditionalEventArgs 对象的 Result 属性，以确定“WhileActivity1”活动应继续还是完成。 如果该属性设置为 true，则活动继续。 否则，活动完成并且工作流也完成。
private void isWorkflowPending(object sender, ConditionalEventArgs e)
{
e.Result = workflowPending;
}
5. 保存项目。
测试 SharePoint 工作流模板
启动调试器时，Visual Studio 将工作流模板部署到 SharePoint Server，并将该工作流与“共享文档”列表相关联。 若要测试工作流，请从“共享文档”列表中的某个文档启动工作流的一个实例。
1. 在 Workflow1.cs中，在“onWorkflowActivated”方法旁设置一个断点。
2. 按 F5 生成并运行解决方案。 SharePoint 网站将出现。
3. 在 SharePoint 中的导航窗格中单击“共享文档”。
4. 在“共享文档”页中，单击“库工具”选项卡上的“文档”，然后单击“上载文档”按钮以上载文档。
5. 在“上载文档”对话框中，单击“浏览”按钮，选择任何文档文件，单击“打开”，然后单击“确定”。
这会将选定文档上载到“共享文档”列表中并启动工作流。
6. 在 Visual Studio 中，确认调试器是否在 onWorkflowActivated 方法旁的断点处停止。
7. 按 F5 继续执行。
8. 虽然您可以在此处更改文档的设置，但此时请单击“保存”以保留这些文档设置的默认值。
这将返回到默认 SharePoint 网站的“共享文档”页。
9. 在“共享文档”页中，验证“MySharePointWorkflow”列下方的值是否设置为“正在进行中”。 这指示工作流正在进行中，文档在等待评审。
10. 在“共享文档”页中，指向该文档，单击向下箭头，然后单击“编辑属性”。
11. 将“文档状态”设置为“评审完成”，然后单击“保存”。
这将返回到默认 SharePoint 网站的“共享文档”页。
12. 在“共享文档”页中，验证“MySharePointWorkflow”列下方的值是否设置为“评审完成”。 这指示工作流已完成，文档已评审。

本文参考msdn文档完成。