新增或修改工作項目類型

Azure DevOps Server 2022 - Azure DevOps Server 2019

您的專案包含一些工作項目類型，根據用來建立項目的程式，例如 Agile、Basic、Scrum 或 CMMI。 工作項目類型是您用來 追蹤不同類型的工作的物件。

注意

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

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

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

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

注意

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

工作項目類型定義

• 將欄位新增或修改至現有的工作項目類型
• 新增自訂工作項目類型、修改工作項目類型
• 變更工作流程（狀態、原因、轉換）
• 修改工作項目表單

ProcessConfiguration 定義

• 指定工作項目類型色彩
• 指定工作項目類型圖示
• 指定工作流程狀態色彩
• 從待辦專案或工作面板新增或移除工作項目類型
• 將自定義工作項目類型新增至待辦專案或面板
• 新增公事包待辦專案

命令行變更

• 列出工作項目類型
• 停用或停用工作項目類型
• 重新命名工作項目類型
• 刪除工作項目類型

必要條件

• 若要列出工作項目類型，您必須在集合集合中將 專案的 [檢視專案層級資訊] 權限設定為 [允許]。
• 若要藉由自定義程式範本來新增或自定義工作項目類型，您必須是 Project Collection 管理員 istrators 群組的成員，或將編輯程式許可權設定為 [允許]。

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

修改工作項目類型如何影響現有的工作專案？

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

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

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

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

注意

如果您使用裝載的 XML 進程模型，則必須匯入和匯出專案所使用的進程範本。 如需詳細資訊，請參閱 自定義工作項目追蹤 Web 窗體。

1. 如果您沒有項目的系統管理許可權， 請取得這些專案。

   1. 根據 wit 中提供的指示開啟命令提示字元視窗 管理員：自定義和管理追蹤工作的物件。 例如：

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 定義檔，然後根據您使用的進程模型將其匯入至專案。 您可以藉由指定定義檔的三個主要區段內定義的元素來修改工作項目類型： FIELDS、 WORKFLOW 和 FORM。

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

新增或修改欄位、欄位規則、標籤或空白文字

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

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

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

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

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

修改工作流程

工作流程中的 STATES 和 REASONS 區段會指定 [狀態] 和 [原因] 欄位中的挑選清單值。 他們會追蹤工作項目的狀態。 TRANSITIONS 區段會指定狀態之間的有效轉換，如下圖所示。 您可以同時指定正向轉換和回歸轉換。

您可以變更工作流程以完成下列目標：

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

當您自定義工作流程時，請遵循下列兩個步驟：

1. 修改工作項目類型定義的工作流程。

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

   當您變更出現在 Agile 工具頁面上的工作項目類型工作流程時，需要這個第二個步驟。 這些工作項目類型屬於需求或工作類別。

工作流程欄位規則

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

例如，藉由將狀態設定為 [作用中 ] 時新增 EMPTY 規則，您可以自動將 [關閉日期] 和 [關閉者依據] 字段設為 Null，並使其成為只讀的。 從關閉狀態重新啟用工作專案時，這非常有用。

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

套用工作流程欄位規則以完成下列動作：

• 藉由指定 CANNOTLOSEVALUE、EMPTY、FROZEN、NOTSAMEAS、READONLY 和 REQUIRED 來限定欄位可以擁有的值
• 使用 COPY、 DEFAULT 和 SERVERDEFAULT 將值複製到欄位
• 限制誰可以修改欄位
• 使用 MATCH 在字串字段上強制執行模式比對
• 使用 WHEN、WHENNOT、WHENCHANGED 和 WHENNOTCHANGED，根據其他欄位中的值有條件地套用規則
• 限制要套用至特定使用者或群組的規則。 大部分的規則都支援 或 不是 屬性，以將規則的焦點放在誰，而且不適用。

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

自訂工作項目表單

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

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

• 新增或修改欄位
• 變更欄位標籤
• 重新排列欄位
• 新增群組或頁面
• 新增群組
• 新增自定義控件、群組或頁面
• 新增參考文字或超連結
• 內嵌 HTML 文字或顯示動態報表
• 新增連結控件頁面

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

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

例如，您可以從產品待辦項目頁面新增 Bug。

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

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

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

變更現有工作項目的類型

請參閱 大量移動工作專案，並針對您根據平臺可用的功能變更工作項目類型 。

停用或停用工作項目類型

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

注意

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

刪除工作項目類型

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

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

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

重新命名工作項目類型

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

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

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

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

相關文章

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

其他相關主題或資源：

• 規則和規則評估
• 管理工作指南
• ProcessConfiguration XML 元素
• witadmin 命令行工具
• 自訂工作追蹤體驗
• 自訂面板上的卡片