新增或修改工作專案類型

Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018

您的專案包含一些工作專案類型,根據用來建立專案的程式,例如 AgileBasicScrumCMMI。 工作專案類型是您用來 追蹤不同類型的工作的物件。

注意

如需Azure DevOps Services或使用繼承程式模型的專案集合,請參閱新增和管理工作專案類型

您可以根據小組的追蹤需求或工作流程程式,修改現有的工作專案類型或新增自訂工作專案類型。 修改工作專案類型最常見的原因是新增或修改一組欄位或欄位規則、變更工作流程,或自訂工作專案表單。

如果您想要新增自訂欄位或修改現有欄位的欄位規則或屬性,請參閱 新增或修改 欄位。

大部分的工作專案類型自訂都是對工作專案類型 XML 定義進行,不過,其他自訂是透過進程組態定義或 透過 witadmin 命令列工具進行。

注意

如需Azure DevOps Services或使用繼承進程模型的集合,請參閱新增和管理工作專案類型

工作專案類型定義

ProcessConfiguration 定義

命令列變更

必要條件

  • 若要列出工作專案類型,您必須擁有集合集中專案的 [ 檢視專案層級資訊] 許可權,設定為 [允許]。
  • 若要藉由自訂程式範本來新增或自訂工作專案類型,您必須是 Project Collection Administrators 群組的成員,或將 編輯程式 許可權設定為 [允許]。
  • 若要列出工作專案類型,您必須擁有集合集中專案的 [ 檢視專案層級資訊] 許可權,設定為 [允許]。
  • 若要新增或自訂工作專案類型,您必須是 Project Administrators 群組的成員,或將 [ 編輯專案層級資訊] 許可權設定為 [允許]。

若要以系統管理員身分新增,請參閱 變更專案集合層級許可權

修改工作專案類型如何影響現有的工作專案?

下表摘要說明當您修改欄位或工作專案類型定義時,現有工作專案的效果。

動作 對現有工作項目的影響
從工作專案類型移除欄位 遭到移除之欄位的資料會保留在資料存放區中。 不過,您無法新增任何新資料,因為您已從工作專案類型定義中移除它們。
重新命名欄位 重新命名的欄位資料會保留在資料存放區的新易記名稱下。
刪除欄位 遭到刪除的資欄位料會從資料存放區中移除。
重新命名工作專案類型 所有資料在新名稱下保持不變。
刪除工作專案類型 建立為已刪除工作專案類型的工作專案所有資料都會永久移除,且無法復原。

如果您想要從資料存放區完全移除欄位,請使用witadmin deletefield 命令列工具

匯入和匯出工作專案類型定義檔案

注意

如果您使用託管的 XML 進程模型,則必須匯入和匯出專案所使用的程式範本。 如需詳細資訊,請參閱 自訂工作專案追蹤 Web 表單

  1. 如果您沒有專案的系統管理許可權, 請取得它們

    1. 根據 witAdmin:自訂和管理追蹤工作的物件所提供的指示,開啟命令提示字元視窗。 例如:
  2. 匯出您想要修改或新增欄位的工作專案類型定義檔。 指定工作專案類型和檔案的名稱。

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"

    CollectionURL的範例為 http://MyServer:8080/tfs/TeamProjectCollectionName

  3. 編輯檔案。 如需詳細資訊,請參閱 XML 元素定義的索引

  4. 匯入定義檔案。

    witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"

  5. 開啟入口網站,或重新整理頁面以檢視變更。

    如需使用 witadmin 的詳細資訊,請參閱匯入 、匯出和管理工作專案類型

新增或修改工作專案類型

若要新增自訂工作專案類型或修改現有的工作專案類型,您可以定義或修改 XML 定義檔,然後 根據您使用的程式模型將它匯入專案。 您可以藉由指定定義檔三個主要區段內定義的元素來修改工作專案類型: FIELDSWORKFLOWFORM

工作專案類型專案的摘要

新增工作專案類型最簡單的方式是複製現有的工作專案類型,然後修改定義檔。

加入或修改欄位、欄位規則、標籤或空白文字

您想要用來追蹤資料的任何欄位都必須新增至定義檔。 對於參考名稱開頭為 System 的所有欄位,但系統欄位 (,則為 true ) 。 所有系統欄位都會針對所有工作專案類型定義,不論您是否在工作專案類型定義中包含它們。 若要深入瞭解每個欄位,請參閱 工作專案欄位索引

您會將欄位和欄位規則新增至 FIELDS 區段。 若要讓欄位出現在工作專案表單上,您也必須將其新增至定義的 FORM 區段。

例如,若要將工作專案識別碼新增至表單,請在 區段中指定下列 XML 語法 FORM

<Control FieldName="System.ID" Type="FieldControl" Label="ID" LabelPosition="Left" />

若要深入瞭解定義欄位,請參閱 新增或修改欄位

修改工作流程

工作流程中的狀態REASONS區段會指定[狀態] 和 [原因] 欄位中的挑選清單值。 這些區段會追蹤工作項目的狀態。 TRANSITIONS區段會指定狀態之間的有效轉換,如下圖所示。 您可以指定向前和迴歸轉換。

範例工作流程狀態圖表,敏捷式使用者案例

您可以變更工作流程來達成下列目的:

  • 新增或移除狀態、原因或轉換
  • 指定要在狀態、原因或轉換變更期間套用之欄位的值
  • 指定自訂 動作 ,根據狀態、原因或轉換的變更,將欄位指派自動化。

當您自訂工作流程時,請遵循下列兩個步驟:

  1. 修改工作專案類型定義的工作流程

  2. 修改程式組態,將新的工作流程狀態對應至中繼狀態

    當您變更出現在敏捷式工具頁面上的工作專案類型工作流程時,需要執行第二個步驟。 這些工作專案類型屬於需求或任務類別。

工作流程欄位規則

您可以在變更狀態、指定原因或進行工作流程轉換時套用欄位規則。

例如,藉由在狀態設定為 [作用中] 時新增 EMPTY 規則,您可以自動將 [關閉日期] 和 [關閉日期] 欄位設為 [關閉日期] 和 [關閉者] 欄位,使其成為唯讀的。 從已關閉狀態中重新啟用工作項目時,這會非常有用。

<STATE value="Active">
   <FIELDS>
. . .
      <FIELD refname="Microsoft.VSTS.Common.ClosedDate"><EMPTY/></FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedBy"><EMPTY/></FIELD>
   </FIELDS>
</STATE>  

套用工作流程欄位規則來完成下列動作:

  • 指定CANNOTLOSEVALUEEMPTYFROZENNOTSAMEASREADONLYREQUIRED來限定欄位可以擁有的值
  • 使用COPYDEFAULTSERVERDEFAULT將值複製到欄位
  • 限制誰可以修改欄位
  • 使用MATCH在字串欄位上強制執行模式比對
  • 使用WHENWHENNOT、WHENCHANGEDWHENNOTCHANGED有條件地根據其他欄位中的值套用規則
  • 限制要套用至特定使用者或群組的規則。 大部分的規則都支援 ,讓 屬性專注于規則的用途,而且不適用。

如需套用工作流程欄位規則的詳細資訊,請參閱 FIELD (Workflow) 元素參考規則和規則評估

自訂工作項目表單

下圖醒目提示工作專案表單上最常見的元素。 您可以自訂除了標題區域和表單控制項以外的所有其他項目。 您用來自訂表單的專案取決於您的 系統管理員是否已啟用新表單

工作專案 Web 表單中標頭元素的螢幕擷取畫面。

您可以自訂表單以完成下列目標:

從待辦專案或工作面板新增或移除工作專案類型

敏捷式規劃工具—產品待辦專案、短期衝刺待辦專案和工作面板頁面,會根據用來建立專案的程式範本來顯示特定的工作專案類型。 您可以新增或移除要出現在這些頁面上的工作專案類型。 例如,如果您的專案使用 Scrum 工作專案類型,產品待辦專案和 Bug 都會出現在待辦專案頁面上。 不過,如果您的專案是使用 Agile、CMMI 或其他程式範本建立的,則 Bug 不會出現在您的待辦專案或工作面板上。

例如,您可以從產品待處理項目 (Backlog) 頁面加入 Bug。

若要瞭解如何從待辦專案或工作面板新增或移除工作專案類型,請參閱 將工作專案類型新增至待辦專案和麵板。 若要新增工作專案類型以支援組合待辦專案,請參閱 新增組合待辦專案層級

變更工作專案類型的色彩、圖示或工作流程狀態色彩

在入口網站中,工作專案會出現在查詢結果中,以及敏捷式工具的待辦專案和麵板頁面。 若要變更與現有工作專案類型相關聯的色彩或圖示,或新增要用於新工作專案類型的色彩, 請編輯程式組態。 若要變更工作流程狀態的色彩,您也會 編輯程式組態

查詢結果的螢幕擷取畫面,其中顯示工作專案類型色彩、圖示和狀態色彩。

變更現有工作專案的類型

如需根據平臺可用的功能 ,請參閱大量移動工作專案,並變更工作專案類型

停用或停用工作專案類型

如果您想要將特定工作專案類型的建立限制為使用者群組, 請將工作專案類型新增至 [隱藏類別] 群組 ,以防止大部分參與者建立它們。 如果您想要允許一組使用者存取, 您可以建立範本的超連結, 以開啟工作專案表單,並與您想要建立這些小組成員共用該連結。

注意

您無法新增欄位規則來限制工作流程,因為您無法將規則套用至系統欄位。

刪除工作專案類型

若要防止小組成員使用特定工作專案類型來建立工作專案,您可以從專案中移除該專案。 當您使用 witadmin destroywitd* 時,會永久移除使用該工作專案類型以及工作專案類型本身建立的所有工作專案。 例如,如果您的小組未使用 「一元」,您可以從 Fabrikam 網站專案刪除標示為「啟用」的工作專案類型。

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment" 

當您刪除屬於類別的工作專案類型時,您必須更新專案的類別定義,以反映新名稱。 如需詳細資訊,請參閱匯入、匯出和管理工作專案類型和匯入和匯出類別

重新命名工作專案類型

若要重新命名現有的工作專案類型,請使用 witadmin renamewitd 。 例如,您可以將標示為「QoS 專案」的工作專案類型重新命名為「服務合約」。

witadmin renamewitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"QoS Item" /new:"Service Agreement"

當您重新命名屬於類別的工作專案類型時,您必須更新專案的類別定義,以反映新名稱。 特別是,在您更新類別定義之前, 待辦專案和麵板 將無法運作。

如需詳細資訊,請參閱匯入、匯出和管理工作專案類型和匯入和匯出類別

在升級後啟用功能

您可以在內部部署升級之後,使用 [設定功能精靈] 來更新我的專案,可以進行哪些自訂?

您可以新增自訂工作專案類型,並變更表單版面配置。 [ 設定功能精靈 ] 將會更新您的專案,而且您將取得最新功能的存取權。

變更工作流程或重新命名工作專案類型可能需要您在更新專案時執行一些手動作業。 若要瞭解您可以安全地進行的其他自訂專案,以及應避免的自訂專案,請參閱 自訂工作追蹤體驗:自訂之前,請先瞭解維護和升級影響

本文說明如何新增和自訂託管 XML 和內部部署 XML 程式模型的工作專案類型。 如需新增和自訂繼承進程模型之工作專案類型的資訊,請參閱 自訂程式

其他相關主題或資源: