新增和管理欄位 （繼承程式）

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019

您可以新增自訂欄位以支援追蹤其他資料需求，或修改繼承欄位的 select 屬性。 例如，您可以新增自訂欄位，或變更出現在繼承欄位之工作專案表單中的標籤。

重要

本文適用于 Azure DevOps Services 和 Azure DevOps Server 2019 和更新版本。 若要自訂 TFS 2018 或更早版本集合上定義的任何專案，請參閱 內部部署 XML 進程模型 。

如需為組織定義的所有欄位清單，其中包含針對系統和繼承程式定義的所有欄位，請參閱 檢視工作專案欄位和屬性 。

新增自訂欄位之後，您可以建立 查詢 、 圖表 或 分析檢視和 Power BI 報表 來追蹤與其相關的資料。

必要條件

在自訂程式之前，建議您檢閱 設定和自訂 Azure Boards ，其提供如何自訂 Azure Boards 以符合業務需求的指引。 如需不同待辦專案和麵板的描述，請參閱 待辦專案、面板、工作面板和方案 所支援的工作。

• 您必須在 Azure DevOps Services 中建立組織。 如果您尚未建立一個， 請立即 執行。
• 若要建立、編輯和管理程式，您必須是 Project Collection 管理員istrators 群組 的成員 ，或具有對應的集合層級許可權 建立進程、刪除程式 、 編輯程式 ，或 從組織 設定為 Allow 刪除欄位。 請參閱 設定工作追蹤的許可權和存取權、自訂繼承的程式 。

開啟 設定 > Process

您可以從組織設定 > 程式 建立、管理及自訂程式 。

1. 選擇 Azure DevOps 標誌以開啟 Projects 。 然後選擇 [ 組織設定 ]。

   

2. 然後選擇 [ 處理 ]。

   

   重要

   如果您沒有看到 Process ，則您正在從 TFS-2018 或更早版本工作。 不支援 [ 處理 ] 頁面。 您必須使用內部 部署 XML 進程模型 支援的功能。

注意

當您自訂繼承的進程時，使用該進程的所有專案都會自動更新，以反映自訂專案。 基於這個理由，建議您在有數個自訂專案時建立測試程式及測試專案，以便在將自訂專案推出至組織之前先測試自訂專案。 若要深入瞭解，請參閱 建立和管理繼承的進程 。

自訂功能變數名稱

當您將自訂欄位新增至繼承的程式時，Azure DevOps 會指派前面加上 Custom 的參考名稱，然後指派移除空格的功能變數名稱。 例如，您新增名為 DevOps Triage 的欄位，參考名稱為 Custom.DevOpsTriage 。 參考名稱內不允許空格。

新增自訂欄位

您可以新增欄位，並指定其應該出現在其中的群組和頁面。 此外，新增欄位之後，即可將其拖放到頁面內，以移動其在表單內的位置。 如果您有數個要新增至自訂頁面或群組的欄位，請先 新增這些頁面或群組 ，然後新增您的欄位。

注意

每個程式最多可以定義 1024 個欄位，包括系統繼承的欄位。 您只能在表單的頁面內新增欄位。 您無法將欄位新增至 [指派給]、[狀態] 和 [原因] 欄位所在表單內的灰色區域。

1. 從所選繼承進程的 [ 進程 ] 頁面中，選擇您要新增自訂欄位的工作專案類型。

   在這裡，我們選擇 Bug WIT。 請注意可讓您返回 [所有進程 ] 和 [MyAgile 進程] 頁面的階層連結。

   

   如果 [新增] 欄位 和其他選項已停用，則您沒有編輯程式的必要許可權。 請參閱 設定工作追蹤的許可權和存取權、自訂繼承的程式 。

2. 選取 WIT 後，選擇 [ 新增] 欄位 。

   

3. 為欄位命名，然後從其中一個支援的資料類型中選取欄位類型。 選擇性地新增描述。

   注意

   您必須指定組織內唯一的功能變數名稱。 針對某個進程定義的自訂欄位，不能與為另一個進程定義的名稱相同。 如需功能變數名稱的詳細資訊，請參閱 什麼是欄位？功能變數名稱的使用方式？

   在這裡，我們新增標示為客戶票證的整數位段。

   

4. （選擇性）在 [ 選項] 索引標籤上，指出欄位是否為必要，並指定預設值。 或者，將值保留空白。 使用者必須指定欄位的值，才能儲存工作專案。 當您建立工作專案，以及每次有人開啟工作專案且欄位是空的時，都會設定預設值。

   

5. （選擇性）在 [ 版面配置] 索引標籤上，您可以輸入與功能變數名稱不同的表單標籤。 此外，您也可以選擇欄位出現在表單上的頁面和群組。

   在這裡，我們會將 [客戶票證] 欄位新增至標示為 [客戶焦點] 的新群組。

   

   注意

   雖然您可以變更表單標籤，但當您將欄位新增至卡片（Kanban 、 Taskboard ）或 根據欄位建立查詢 時， 您必須使用功能變數名稱。

6. 選擇 [新增欄位 ] 以完成新增欄位。 如果您未指定其版面配置位置，系統會將其新增至表單上的第一組欄位。

7. 當您完成進行所有變更時，請開啟您所自訂類型的工作專案。

   在這裡，我們顯示 [客戶票證] 欄位已新增至 [狀態] 群組。 您可能需要重新整理瀏覽器，才能看到變更。

   

新增挑選清單

工作追蹤、處理序和專案限制

您可以新增欄位並定義挑選清單，或自訂繼承欄位的挑選清單。

注意

每個組織或集合最多可以定義 2048 個挑選清單。 每個挑選清單最多可以包含 2048 個專案。 Picklist 專案必須少於 256 個字元。 如果您想要新增相依挑選清單，請參閱 級聯清單 。

1. 從選擇 [ 新增] 欄位 開始，然後指定挑選清單類型—整數或字串]，然後新增要出現在挑選清單中的專案。 您可以新增專案，然後按 Enter 以新增另一個專案。

   

   若要刪除清單中的專案，請反白顯示專案，然後按一下 刪除圖示。

   若要修改繼承欄位的挑選清單，請選擇 [編輯 ] 以編輯欄位。 在 [ 定義] 索引標籤上，您可以選擇 [ 新增值 ]。

   

2. （選擇性）選擇 [ 選項 ] 索引標籤，以視需要定義欄位、指定預設值，或允許使用者輸入自己的值。

   

3. （選擇性）請參閱上 一個步驟 5 ，以指定您希望欄位出現在表單上的位置（ 版面配置 索引標籤）。

新增 [身分識別] 欄位

使用 [身分識別] 欄位來新增類似 [指派給] 欄位的欄位。 身分識別型欄位的運作方式與 [指派給] 欄位相同，提供搜尋和身分識別選擇器函式。 當您的組織使用 Microsoft Entra ID 或 Active Directory 管理使用者時，系統會同步處理身分識別型欄位與這些目錄中定義的名稱。

1. 從選擇 [ 新增] 欄位 開始，然後選擇功能變數名稱、身分識別類型，以及選擇性的描述。

   

2. （選擇性）請參閱上 一個步驟 5 ，以指定您希望欄位出現在表單上的位置（版面配置索引標籤）。

新增 RTF、HTML 欄位

1. 和之前一樣，選擇您要新增欄位的 WIT，然後選擇 [ 新增] 欄位。

2. 選擇 [文字]（多行）作為類型。 我們將欄位標示為客戶要求，以擷取產品功能要求的客戶批註。

   

3. 欄位會新增至所有系統定義 RTF 欄位之下的第一個資料行，但在 [討論] 控制項之前。

   

新增核取方塊欄位

1. 和之前一樣，選擇您要新增欄位的 WIT，然後選擇 [ 新增] 欄位。

2. 選擇布林值作為類型，並為其提供標籤。 在這裡，我們會將欄位標示為 [分級] 以追蹤 Bug 的分級狀態。

   

3. （選擇性）開啟 [選項] 索引 標籤，並指定是否應該需要欄位。

   

4. 根據預設，欄位會新增至第二個數據行中定義的最後一個群組。 開啟 [ 版面配置] 索引標籤，將欄位拖放到表單上的另一個群組。

   注意

   欄位會顯示為工作專案表單中的核取方塊。 核取方塊以指出 True 值。 如果您在 Kanban 或 Taskboard 上顯示欄位，則 True 和 False 的域值會顯示 （而非核取方塊）。

將現有的欄位新增至另一個 WIT

現有的欄位會對應至集合中定義的任何繼承欄位和自訂欄位。 一旦您將自訂欄位新增至一個 WIT，就可以從表單功能表將它新增至其他人。 或者，您可以將針對某個進程定義的欄位新增至另一個進程中的工作專案類型。 開啟工作專案類型，然後選擇現有的欄位。

若要查閱任何系統定義工作專案欄位的描述，請參閱 工作專案欄位索引 。

在這裡，我們會將 [客戶票證] 欄位新增至 [使用者劇本 WIT]。

選擇性地指定 欄位表單 中的必要/預設值 和 位置。

重新標記欄位

不支援重新命名欄位或變更欄位類型。 不過，您可以從 [ 版面配置] 索引標籤變更出現在工作專案表單上的標籤。 在查詢中選取欄位時，您必須選取功能變數名稱，而不是欄位標籤。

在這裡，我們會將 [客戶票證] 欄位重新標記為 [票證號碼]。

修改描述解說文字

描述解說文字會在使用者將滑鼠停留在工作專案表單中的欄位上方時顯示。 您可以針對不同工作專案類型，為相同欄位定義不同的解說文字。 自訂欄位和繼承的欄位都支援修改。 請注意，實作會根據欄位類型而有所不同。

• 對於繼承的欄位 ：描述解說文字可以針對每個工作專案類型和程式以不同的方式定義。
• 針對自訂欄位 ：描述解說文字會針對所有工作專案類型和所有處理常式的欄位顯示相同。

若要修改 [ 描述 說明] 文字，請選擇您要修改的工作專案類型，選擇 欄位的 [編輯 ]，然後選擇 [ 定義 ] 索引標籤。修改的值只會影響進程中的欄位，以及該工作專案類型的欄位。

在這裡，我們會修改 [使用者劇本] 的 [劇本點] 欄位。

顯示、隱藏或移除欄位

您可以選擇在表單上顯示或隱藏任何欄位或自訂控制項。 如果您想要稍後將欄位恢復至表單，您可以取消隱藏這些動作與 [刪除 ] 選項不同，這會從組織刪除欄位。

注意

針對繼承欄位定義的資料，即使您隱藏它，也會保留在資料存放區和工作專案歷程記錄中。 您可以檢視工作專案的 [記錄] 索引標籤來檢視它的記錄。

當您從配置中移除自訂欄位時，它會保留在資料存放區中，但會從歷程記錄中移除。 您可以從查詢結果檢視它。 如果您將欄位新增回表單，則會還原其歷程記錄。若要從專案集合中刪除自訂欄位，請參閱 刪除欄位 。

隱藏欄位或自訂控制項

1. 開啟欄位或控制項的操作功能表，然後選擇 [ 從配置 隱藏]。

   

2. 若要將隱藏欄位或控制項新增至表單，請選擇 [在版面配置 上顯示]。

從表單中移除自訂欄位

1. 從您要移除的欄位操作功能表中，選擇 [移除 ]。

   

2. 確認您想要移除欄位。

   

3. 若要新增已移除的自訂欄位，請選擇 [新增] 欄位 ，然後選取 [ 使用現有的欄位 ]。

將欄位還原為預設預設值

您可以捨棄您對繼承欄位所做的變更。 從修改的工作專案類型的 [版 面配置] 頁面中，選擇欄位的 [ 還原 ] 選項。

刪除自訂欄位

使用繼承程式模型，您只能刪除自訂欄位。 您無法刪除針對系統預設進程定義的欄位。

刪除欄位會刪除與該欄位相關聯的所有資料，包括歷程記錄值。 刪除之後，您只能還原欄位，並使用 Fields - Update REST API 來復原資料 。

注意

我們建議您只刪除未使用中的欄位。 您可以藉由執行 witadmin listfields 命令來判斷未使用的欄位。 若要瞭解如何，請參閱 管理工作專案欄位 （witadmin） 。
或者，如果已為組織或集合啟用 Analytics，您可以查詢自訂欄位搭配下列語法使用的位置分析：

https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/WorkItemTypeFields?$filter=FieldReferenceName eq {CustomFieldReferenceName}&$select=WorkItemType

1. 您可以從 [ 所有進程 > 欄位 ] 頁面刪除欄位。

   

   若要刪除欄位，您必須是 Project Collection 管理員istrators 群組的成員，或 被授與從帳戶 刪除欄位的明確許可權。

2. 若要完成刪除作業，您必須輸入功能變數名稱，如下所示。

   

相關文章

注意

您可以透過稽核記錄檢閱對繼承程式所做的變更。 若要深入瞭解，請參閱 存取、匯出和篩選稽核記錄 。

• 檢視工作專案欄位和屬性
• 新增或修改自訂工作專案類型
• 自訂 Web 版面配置
• 使用繼承的進程自訂專案
• 自訂面板上的卡片
• 在待處理項目和面板上顯示 Bug
• 工作追蹤、處理序和專案限制

如果您正在使用測試計劃或測試案例，請參閱下列文章：

• 建立測試計劃
• 建立手動測試案例