调试 SharePoint 工作流解决方案

项目
09/10/2008

更新：2007 年 11 月

适用对象
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。项目类型 SharePoint 工作流 Microsoft Office 版本 SharePoint Server 2007 有关更多信息，请参见按应用程序和项目类型提供的功能。

本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。

项目类型

SharePoint 工作流

Microsoft Office 版本

SharePoint Server 2007

使用 Visual Studio 调试器可以调试 SharePoint 工作流模板。开始调试时，Visual Studio 将打开 SharePoint 站点，并将该工作流模板添加到一个库或列表中。然后可以启动工作流模板的实例并使用标准调试工具来调试代码。

说明：
如果将引用添加到其他程序集中，请确保这些程序集安装在全局程序集缓存中。否则工作流解决方案将失败。有关如何安装程序集的信息，请参见如何：将程序集安装到全局程序集缓存中。

指定调试配置设置

在第一次创建“SharePoint 2007 顺序工作流”或“SharePoint 2007 状态机工作流”项目时，可以在“新建 Office SharePoint 工作流”向导中指定调试配置设置。有关更多信息，请参见如何：创建 SharePoint 工作流项目。

在“属性”窗口中或通过再次启动“新建 Office SharePoint 工作流”向导可以更改这些设置。有关更多信息，请参见如何：修改 SharePoint 工作流项目的调试配置设置。

下表介绍向导中包含的调试设置。

设置	说明
显示名称	标识 SharePoint Server 网站上的工作流模板。该名称显示在工作流模板的列表中（这些工作流模板对某个库或列表可用）。
目标站点	指定要用来运行该工作流的 SharePoint 网站的 URL。若要开发和调试该工作流，此站点必须位于本地计算机上。
目标列表	指定要用来启动工作流的库或列表。工作流中的活动将应用于该库或列表中的项。
任务列表	指定要使用的任务列表。任务列表显示每个工作流参与者都可以使用的工作流任务。
历史记录列表	指定显示在工作流运行时发生的所有事件的列表。如果本地 SharePoint 网站上不存在历史记录列表，则 Visual Studio Tools for Office 工作流部署过程会创建一个列表。
自动关联	指示是否自动将工作流模板与您在“新建 Office SharePoint 工作流”向导中指定的库或列表相关联。如果选择此选项，则 Visual Studio Tools for Office 工作流部署过程会将工作流模板与指定的库或列表相关联。如果清除此选项，则必须通过使用 SharePoint 网站上的“添加工作流”管理页面，手动将工作流模板与库或列表相关联。
允许手动启动	指示是否可以从库中的文档或列表中的项手动启动工作流。有关更多信息，请参见 Manually start a workflow on a document item（在文档项上手动启动工作流）。
在创建项时启动	指示在库或列表中创建新项时是否启动工作流。
在更改项时启动	指示在库或列表中更新项时是否启动工作流。

SharePoint 功能

功能是一个可移植的模块化功能单元，它通过站点定义来简化站点修改。功能是一个 Windows SharePoint Services 元素包，它可以在特定范围内激活，帮助用户完成特定目标或任务。工作流部署过程将工作流模板部署为功能。

启动调试器时，工作流部署过程将在 %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES 的功能目录下创建一个文件夹。

功能目录的解决方案的文件夹中包含一个功能定义文件和一个工作流定义文件。功能定义文件 (feature.xml) 描述工作流功能中的文件。工作流定义文件 (workflow.xml) 描述工作流模板。可以在“解决方案资源管理器”中找到这些文件。有关这些文件的更多信息，请参见 SharePoint 工作流项目模板。

调试部署过程

启动 Visual Studio 调试器后，Visual Studio Tools for Office 工作流部署过程将执行以下任务：

将功能和工作流定义文件部署到 SharePoint Server。
将工作流程序集安装到全局程序集缓存 (GAC) 中。
重新启动 Internet 信息服务 (IIS) 和 SharePoint Server。
激活 SharePoint Server 2007 中的功能。
将工作流与您在“新建 Office SharePoint 工作流”向导中选择的 SharePoint 库或列表相关联。
将 Visual Studio 调试器附加到 Windows SharePoint Services 进程 (w3wp.exe)。

显示相应的库或列表页面。

说明：
如果选择不将工作流模板与库或列表自动关联，则必须首先通过使用 SharePoint 中的“添加工作流”管理页面，手动将工作流模板与库或列表相关联。

在每个任务都完成后，Visual Studio Tools for Office 将在 Visual Studio 的“输出”窗口中显示状态消息。如果某个任务无法完成，则 Visual Studio Tools for Office 会在 Visual Studio 的“错误列表”窗口中显示错误消息。有关如何解决错误的信息，请参见 SharePoint 工作流解决方案疑难解答。

启动工作流

部署过程不启动工作流。必须从 SharePoint 网站启动工作流。还可以通过使用客户端应用程序（例如 Microsoft Office Word 2007）或使用单独的服务器端代码来启动工作流。使用您在“新建 SharePoint 工作流”向导中指定的方法之一。

例如，如果您指定可以手动启动工作流，则直接从库或列表中的项启动工作流。有关如何手动启动工作流的更多信息，请参见 Manually start a workflow on a document item（在文档项上手动启动工作流）。

请参见

通过