工作項目追蹤

發行項
07/14/2023

工作專案追蹤資源

為您的小組取得、建立及更新 Bug、工作和其他工作項目。查詢可讓您充分利用工作項目查詢語言，來搜尋及篩選工作項目。您可以使用工作項目查詢語言，來取得滿足查詢的每個工作項目。工作項目會保留完整歷程記錄，而您可以取得工作項目的完整修訂，或只是取得每個版本所做的更新。您也可以標記工作項目。

常見工作

使用查詢取得工作專案

查閱您想要使用的查詢。
取得該查詢的結果。
依識別碼取得每個工作專案。

批次更新 WorkItems

使用 Batch WorkItem 更新 API ，以批次方式更新您的工作專案。

更新工作專案的欄位

取得您要更新之工作專案的識別碼。
更新工作專案的欄位。

連結兩個工作項目

取得您想要連結之工作專案的識別碼。
新增工作專案之間的連結。

建立兩個工作專案並加以連結

使用建立工作專案，並在批次呼叫中新增連結 API。

將檔案附加至工作專案

取得您要更新之工作專案的識別碼。
將附件上傳至附件存放區。
將附件新增至工作專案。

建立工作項目

建立工作專案。請確定您至少提供一個標題。某些類型的工作專案需要其他欄位的值。

取得工作專案的完整歷程記錄

取得工作專案的識別碼。
取得對工作專案所做的更新清單。
取得出現在任何修訂中的完整工作專案。

刪除工作專案

取得工作專案的識別碼。
刪除工作專案。

取得小組專案中所使用的欄位

取得小組專案中使用的工作專案類型。
取得每個工作專案類型，以查看其所使用的欄位。 (略過 xmlform to fieldinstances.)

取得工作專案的類別

使用工作專案的類別來取得不同函式之 Team 專案中所使用的工作專案類型。例如，若要查看出現在待辦專案上的工作專案，請取得需求類別。

取得區域和反復專案

取得小組專案的區域階層或反復專案階層。

取得工作專案關聯的類型

取得專案集合中可用的工作專案連結類型。

工作專案中繼資料資源

工作專案是由中繼資料所控管。某些中繼資料的範圍設定為特定小組專案，而其他中繼資料的範圍會設定為專案集合， (例如Azure DevOps Services帳戶的預設集合) 。

專案範圍的中繼資料

您的小組專案有一組工作專案類型。每個工作專案類型可能屬於類別，例如「需求」或「Bug」，以定義其在專案中的角色。分類節點會定義一組值，可用於小組專案中工作專案的區域和反復專案欄位。

類別
分類節點 (區域和反復專案)
工作專案類型

集合範圍的中繼資料

工作專案類型會與其他類型的工作專案共用欄位和關聯類型， (連結和附件) 。

工作專案批次更新 API

執行多個工作專案更新要求。回應包含批次中每個要求的個別回應。失敗的要求不會影響批次中的後續要求。

REST API 語意

PATCH https://dev.azure.com/{organization}/_apis/wit/$batch?api-version=6.1

URI 參數

名稱	位於	必要	類型	Description
organization	路徑	True	字串	Azure DevOps 組織的名稱。
api-version	查詢		string	要使用的 API 版本。
bypassRules	查詢		boolean	請勿在此更新上強制執行工作專案類型規則。
suppressNotifications	查詢		boolean	請勿引發此變更的任何通知。

要求本文

要求本文是由工作專案更新要求的清單所組成。此清單中的每個專案都會串連單一更新要求的所有資訊，包括 REST 方法、路徑、標頭和本文。

如需單一要求的詳細資訊，請參閱工作專案更新檔。

Batch Update 範例

要求

PATCH https://dev.azure.com/fabrikam/_apis/wit/$batch?api-version=6.1

要求本文

[
  {
    // Add priority and test rev on work item with id 1
    "method": "PATCH",
    "uri": "/_apis/wit/workitems/1?api-version=6.1",
    "headers": {
      "Content-Type": "application/json-patch+json"
    },
    "body": [
      {
        "op": "test",
        "path": "/rev",
        "value": 3
      },
      {
        "op": "add",
        "path": "/fields/Microsoft.VSTS.Common.Priority",
        "value": "1"
      }
    ]
  },
  {
    // Replace tags on work item with id 299x   
    "method": "PATCH",
    "uri": "/_apis/wit/workitems/299?api-version=6.1",
    "headers": {
      "Content-Type": "application/json-patch+json"
    },
    "body": [
      {
        "op": "replace",
        "path": "/fields/System.Tags",
        "value": "Tag1; Tag2"
      }
    ]
  },
  {
    // You can also use Work Item Create format
    "method": "PATCH",
    "uri": "/mytestprojectname/_apis/wit/workitems/$Bug?api-version=4.1",
    "headers": {
        "Content-Type": "application/json-patch+json"
    },
    "body": [
        {
            "op": "add",
            "path": "/id",
            "value": "-1"
        },
        {
            "op": "add",
            "path": "/fields/System.Title",
            "from": null,
            "value": "Sample 1"
        }
    ]
  },
]

回應

回應是由每個批次更新要求的個別回應所組成。

count ：傳回的批次更新回應數目
value ：回應物件的清單及其回應碼、標頭和本文

{
  "count": 2,
  "value": [
    {
      "code": 200,
      "headers": {
        "Content-Type": "application/json; charset=utf-8"
      },
      "body": "{work item object}"
    },
    {
      "code": 200,
      "headers": {
        "Content-Type": "application/json; charset=utf-8"
      },
      "body": "{work item object}"
    }
  ]
}