共用方式為

自訂欄位

  • 發行項

Azure DevOps Services

使用自定義欄位可針對 測試回合和/或測試結果儲存自定義數據 。 針對單一 Azure DevOps 專案，最多可以定義 100 個自定義欄位。 專案管理員可以 管理自定義欄位集（新增/刪除）。

管理自定義欄位

有兩種方式可以管理自定義欄位 - 透過 REST API 或專案管理員可以在選擇 [管線] 下的 [測試管理] 時，透過 [專案] 設定來執行此動作。 按兩下 [ + 新增] 按鈕，即可在該頁面上新增自定義欄位。

項目設定的螢幕快照，其中已選取測試管理設定，以及新增以紅色矩形標示的新自定義欄位的按鈕。

選擇 [+ 新增 ] 以新增自訂欄位。 每個自定義欄位都必須設定名稱、類型，並指出其適用的成品類型。

用來新增自定義欄位之對話框的螢幕快照。

自定義功能變數名稱不能超過 50 個字元（不允許空格、數位和特殊字元），而且在專案中必須是唯一的。 名稱不區分大小寫，因此您無法有一個名為 「Test」 的自定義欄位，而另一個名為 「test」 的自定義欄位。 Type 可以是下列其中之一：

  • 位元
  • Datetime
  • int
  • Float
  • String
  • Guid

現有的自定義欄位可以編輯（只能變更名稱）或移除。

注意

拿掉自訂欄位之後，您無法在大約一天使用其名稱。 永久移除已刪除自定義欄位的背景程式會每天執行一次。

將自訂數據儲存至自訂欄位

您可以將自定義數據儲存到設定的自定義欄位，做為測試回合/結果建立的一部分，或在建立測試回合/結果之後。 這兩者現在都可以使用 REST API 來完成。 未來，我們將允許從測試結果檔案中挑選自定義數據。 若要取得儲存在現有測試回合/結果之自定義欄位中的值，您必須使用 REST API。 目前，我們不會在 Azure DevOps UI 上顯示儲存於這些中的自定義欄位和值（我們將在未來新增該功能）。

當您透過 REST API 建立測試回合和/或結果，並想要將自定義資料儲存至現有的自定義欄位時，最佳選項是將自定義數據傳送為測試回合和/或結果建立的一部分。 若要建立測試回合呼叫 REST API 執行 - 建立 和建立測試結果呼叫 REST API 結果 - 新增。

當測試回合和/或結果不是透過 REST API 建立，但透過其他方式建立時，您必須先找出您要在自定義欄位中設定自定義資料的測試回合或結果的識別碼，然後呼叫 REST API 執行 - 測試回合的更新 和 REST API 結果 - 更新 測試結果。

若要從先前針對測試回合和/或結果儲存的自定義欄位擷取自定義數據，您必須先找到測試回合或結果的識別。 然後，您可以呼叫 REST API 執行 - 查詢 測試回合和 REST API 結果 - 取得 測試結果。

自訂欄位的自訂數據會在數位中傳送或接收。 該陣列的每個專案都包含兩個屬性 「fieldname」 和 「value」，您可以在這裡看到該屬性的範例。 值是符合針對自定義欄位所設定之類型之型別的物件。 若要瞭解自定義欄位的類型，您可能想要使用 提供自定義欄位陣列的 REST API 。 您可以針對每個欄位找到其識別碼、名稱、類型和範圍。 如果您知道指定名稱的自定義字段類型為何，您也可以硬式編碼類型。