工作項目追蹤
工作專案追蹤資源
為您的小組取得、建立及更新 Bug、工作和其他工作項目。 查詢可讓您充分利用工作項目查詢語言，來搜尋及篩選工作項目。 您可以使用工作項目查詢語言，來取得滿足查詢的每個工作項目。 工作項目會保留完整歷程記錄，而您可以取得工作項目的完整修訂，或只是取得每個版本所做的更新。 您也可以標記工作項目。
常見工作
使用查詢取得工作專案
批次更新 WorkItems
使用 Batch WorkItem 更新 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}"
}
]
}