逐步解說:部署專案工作清單定義
本逐步解說將說明如何使用 Visual Studio 2010 建立、自訂、偵錯和部署 SharePoint 清單定義,以便追蹤專案工作。
這個逐步解說將說明下列工作:
建立包含工作的 SharePoint 清單定義專案。
將清單定義加入至 SharePoint 功能。
將事件接收器加入至清單。
建立和自訂 SharePoint 套件來部署您的功能。
建置和部署 SharePoint 方案。
注意事項 |
---|
您的電腦可能會在下列說明中,以不同名稱或位置顯示某些 Visual Studio 使用者介面項目。 您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。 如需詳細資訊,請參閱 Visual Studio 設定。 |
必要條件
您需要下列元件才能完成此逐步解說:
支援的 Microsoft Windows 和 SharePoint 版本。 如需詳細資訊,請參閱開發 SharePoint 方案的要求。
Visual Studio 2010 Professional 或某個 Visual Studio Application Lifecycle Management (ALM) 版本。
建立 SharePoint 清單定義
建立 SharePoint 清單定義專案,並將清單定義與工作產生關聯。
若要建立 SharePoint 清單定義專案
開啟 [新增專案] 對話方塊,展開 [SharePoint] 節點,然後按一下 [2010]。
選取 [範本] 窗格中的 [ListDefinition],將專案命名為 ProjectTaskList,然後按一下 [確定]。
[SharePoint 自訂精靈] 隨即出現。
輸入用於偵錯的本機 SharePoint 網站,然後按 [下一步]。
針對清單的 [顯示名稱],輸入 [專案工作清單]。
在 [清單定義的類型為何] 下拉式功能表中,選取 [工作],然後按一下 [完成]。
清單定義、清單執行個體、功能和套件隨即出現在 [方案總管] 中。
加入事件接收器
在工作清單定義中,您可以加入事件接收器,以便自動設定工作的到期日和描述。 在下列程序中,會將簡單的事件處理常式加入至清單執行個體做為事件接收器。
若要加入事件接收器
以滑鼠右鍵按一下專案節點,指向 [新增],然後按一下 [新增項目]。
選取 SharePoint 2010 範本清單中的 [事件接收器],將它命名為 ProjectTaskListEventReceiver。
[SharePoint 自訂精靈] 隨即出現。
在 [選擇事件接收器設定] 頁面上,選取 [清單項目事件] 做為事件接收器類型。
將 [事件來源項目] 設定為 ProjectTaskList。
在要處理的事件清單中,選取 [已加入一個項目] 旁的方塊,然後按一下 [完成]。
如此隨即將新的事件接收器節點加入至專案,其中包含名為 ProjectTaskListEventReceiver 的程式碼檔。
將程式碼加入至 ProjectTaskListEventReceiver 程式碼檔中的 ItemAdded 方法。 每當加入新工作時,預設到期日和描述便會加入至該工作。 預設到期日為 2009 年 7 月 1 日。
Public Overrides Sub ItemAdded(ByVal properties As SPItemEventProperties) MyBase.ItemAdded(properties) Dim web As SPWeb = properties.OpenWeb() properties.ListItem("Due Date") = "July 1, 2009" properties.ListItem("Description") = "This is a critical task." properties.ListItem.Update() End Sub
public override void ItemAdded(SPItemEventProperties properties) { base.ItemAdded(properties); SPWeb web = properties.OpenWeb(); properties.ListItem["Due Date"] = "July 1, 2009"; properties.ListItem["Description"] = "This is a critical task."; properties.ListItem.Update(); }
自訂專案工作清單功能
當您建立 SharePoint 方案時,Visual Studio 會自動為預設專案項目建立功能。 您可以使用「功能設計工具」自訂 SharePoint 網站的專案工作清單設定。
若要自訂專案工作清單功能
在 [方案總管] 中,展開 [功能]。
按兩下 [Feature1]。
在 [標題] 欄位中,輸入專案工作清單功能。
在 [範圍] 下拉式功能表中,選取 [Web]。
在 [屬性] 視窗中,輸入 1.0.0.0 做為 [版本] 屬性的值。
自訂專案工作清單套件
建立 SharePoint 專案時,Visual Studio 會自動將包含預設專案項目的功能加入至套件。 您可以使用封裝設計工具自訂 SharePoint 網站的專案工作清單設定。
若要自訂專案工作清單套件
按兩下 [方案總管] 中的 [封裝]。
在 [名稱] 欄位中,輸入 ProjectTaskListPackage。
選取 [重設 Web 伺服器]。
建置和測試專案工作清單
執行專案時,SharePoint 網站會開啟。 不過,您必須手動巡覽至工作清單的位置。
若要測試專案工作清單
按 F5 建置和部署專案工作清單。
SharePoint 網站隨即開啟。
按一下 [首頁]。
按一下左提要欄位中的 [ProjectTaskList - ListInstance1]。
[專案工作清單] 頁面隨即出現。
按一下 [清單工具] 索引標籤中的 [項目]。
按一下 [新增項目]。
按一下 [工作]。
在 [標題] 文字方塊中輸入 Task1。
按一下 [儲存]。
重新整理網站之後,[Task1] 工作隨即出現,到期日為 2009 年 7 月 1 日。
按一下 [Task1]。
工作的詳細檢視隨即出現,說明顯示「這是要徑任務」。
部署專案工作清單
建置及測試專案工作清單後,您可以將它部署到「本機系統」(Local System) 或「遠端系統」(Remote System)。 本機系統是方案部署所在的同一部電腦,而遠端系統是另一部電腦。
若要將專案工作清單部署到本機系統
按一下 [建置] 功能表上的 [部署]。
Visual Studio 會回收 IIS 應用程式集區、撤銷任何現有的方案版本、將方案套件 (.wsp) 檔複製到 SharePoint,然後啟動其功能。 現在您可以在 SharePoint 中使用方案。 如需部署組態的詳細資訊,請參閱 HOW TO:編輯 SharePoint 部署組態。
若要將專案工作清單部署到遠端系統
按一下 [建置] 功能表上的 [封裝]。
如此就會在專案的二進位偵錯資料夾 (…\<Project Name>\<Project Name>\bin\Debug) 中建立方案的 .wsp 檔。
將這個 .wsp 檔複製到遠端系統。
使用 PowerShell Add-SPUserSolution 命令將套件安裝到遠端 SharePoint 安裝 (若為陣列方案,請使用 Add-SPSolution 命令)。
例如,Add-SPUserSolution C:\MyProjects\ProjectTaskList\ProjectTaskList\bin\Debug\ProjectTaskList.wsp。
使用 PowerShell Install-SPUserSolution 命令部署方案 (若為陣列方案,請使用 Install-SPSolution 命令)。
例如,Install-SPUserSolution –Identity ProjectTaskList.wsp –Site http://NewSiteName。
如需遠端部署的詳細資訊,請參閱使用方案 (英文) 和使用 PowerShell 將方案加入及部署到 SharePoint 2010 中 (英文)。
後續步驟
您可以透過下列主題,進一步了解如何自訂和部署 SharePoint 方案: