偵錯 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 網站，並將工作流程範本加入至文件庫或清單。然後您就可以啟動工作流程範本的執行個體，並且使用標準的偵錯工具對程式碼進行偵錯。

注意事項：
如果您將參考加入至其他組件，務必確認這些組件安裝在全域組件快取中。否則工作流程方案將會失敗。如需如何安裝組件的詳細資訊，請參閱 HOW TO：將組件安裝到全域組件快取。

指定偵錯組態設定

初次建立 [SharePoint 2007 循序工作流程] 或是 [SharePoint 2007 狀態機器工作流程] 專案時，可以在 [新的 Office SharePoint 工作流程] 精靈中指定偵錯組態設定。如需詳細資訊，請參閱 HOW TO：建立 SharePoint 工作流程專案。

您可以在 [屬性] 視窗中或再次啟動 [新的 Office SharePoint 工作流程] 精靈以變更這些設定。如需詳細資訊，請參閱 HOW TO：修改 SharePoint 工作流程專案的偵錯組態設定。

下表顯示精靈中包含的偵錯設定。

設定	說明
顯示名稱	識別 SharePoint Server 網站上的工作流程範本。這個名稱會出現在適用於文件庫或清單的工作流程範本清單中。
目標網站	指定要用來執行這個工作流程的 SharePoint 網站 URL。若要開發這個工作流程並進行偵錯，則這個網站必須位於本機電腦上。
目標清單	指定將用來初始化工作流程的文件庫或清單。工作流程中的活動會套用至這個文件庫或清單中的項目。
工作清單	指定要使用的工作清單。工作清單會顯示適用於每位工作流程參與者的工作流程工作。
記錄清單	指定一個清單，顯示工作流程執行時發生的所有事件。如果本機 SharePoint 網站上沒有記錄清單，則 Visual Studio Tools for Office 工作流程部署程序會建立一個清單。
自動產生關聯	表示是否自動產生工作流程範本與您在 [新的 Office SharePoint 工作流程] 精靈中所指定文件庫或清單之間的關聯。如果您選取這個選項，則 Visual Studio Tools for Office 工作流程部署程序會在工作流程範本與指定的文件庫或清單之間產生關聯。如果您清除這個選項，則必須使用 SharePoint 網站中的 [加入工作流程] 管理頁，手動產生工作流程範本與文件庫或清單之間的關聯。
允許手動啟動	表示您是否可以從文件庫中的文件或清單中的項目手動啟動工作流程。如需詳細資訊，請參閱手動啟動文件項目上的工作流程。
建立項目時啟動	表示是否在文件庫或清單中建立新項目時啟動工作流程。
變更項目時啟動	表示是否在文件庫或清單中的項目更新時啟動工作流程。

SharePoint 功能

功能 (Feature) 是指一組可攜的模組化功能單元，可透過網站定義簡化修改網站的作業。功能是 Windows SharePoint Services 項目的套件，可針對特定範圍啟動，並且協助使用者完成特殊目標或工作。工作流程部署程序會將工作流程範本部署為功能。

當您啟動偵錯工具時，工作流程部署程序就會在位於 %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES 的 feature 目錄中建立資料夾。

feature 目錄中的方案資料夾包含功能定義檔和工作流程定義檔。功能定義檔 (feature.xml) 說明工作流程功能中的檔案。工作流程定義檔 (workflow.xml) 則說明工作流程範本。您可以在 [方案總管] 中找到這些檔案。如需這些檔案的詳細資訊，請參閱 SharePoint 工作流程專案範本。

偵錯部署程序

當您啟動 Visual Studio 偵錯工具時，Visual Studio Tools for Office 工作流程部署程序會執行下列工作：

將功能和工作流程定義檔部署至 SharePoint Server。
將工作流程組件安裝到全域組件快取 (GAC) 中。
重新啟動 Internet Information Services (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 工作流程] 精靈中指定的其中一個方法。

例如，如果您指定可以手動啟動工作流程，請直接從文件庫或清單中的項目啟動工作流程。如需如何手動啟動工作流程的詳細資訊，請參閱手動啟動文件項目上的工作流程。

請參閱

共用方式為