Wiql - Query By Id

參考

Service:: Work Item Tracking

API Version:: 6.0

取得指定查詢識別碼的查詢結果。

GET https://dev.azure.com/{organization}/{project}/{team}/_apis/wit/wiql/{id}?api-version=6.0

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/{team}/_apis/wit/wiql/{id}?timePrecision={timePrecision}&$top={$top}&api-version=6.0

URI 參數

名稱	位於	必要	類型	Description
id	path	True	string uuid	查詢識別碼。
organization	path	True	string	Azure DevOps 組織的名稱。
project	path		string	專案識別碼或專案名稱
team	path		string	小組識別碼或小組名稱
api-version	query	True	string	要使用的 API 版本。這應該設定為 '6.0' 以使用此版本的 API。
$top	query		integer int32	要傳回的結果數目上限。
timePrecision	query		boolean	是否要使用時間精確度。

回應

名稱	類型	Description
200 OK	WorkItemQueryResult	成功作業

安全性

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

名稱	Description
vso.work	授與讀取工作專案、查詢、面板、區域和反復專案路徑，以及其他工作專案追蹤相關中繼資料的能力。同時授與執行查詢、搜尋工作專案，以及透過服務勾點接收工作專案事件的通知的能力。

範例

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/wiql/{id}?api-version=6.0

Sample Response

Status code:: 200

{
  "queryType": "tree",
  "asOf": "2014-12-29T20:49:33.803Z",
  "columns": [
    {
      "referenceName": "System.Id",
      "name": "ID",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Id"
    },
    {
      "referenceName": "System.WorkItemType",
      "name": "Work Item Type",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.WorkItemType"
    },
    {
      "referenceName": "System.Title",
      "name": "Title",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.Title"
    },
    {
      "referenceName": "System.AssignedTo",
      "name": "Assigned To",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.AssignedTo"
    },
    {
      "referenceName": "System.State",
      "name": "State",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/System.State"
    }
  ],
  "workItemRelations": [
    {
      "target": {
        "id": 4,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/4"
      }
    },
    {
      "target": {
        "id": 5,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/5"
      }
    },
    {
      "target": {
        "id": 6,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/6"
      }
    },
    {
      "target": {
        "id": 7,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/7"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 7,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/7"
      },
      "target": {
        "id": 8,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/8"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 7,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/7"
      },
      "target": {
        "id": 9,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/9"
      }
    },
    {
      "target": {
        "id": 11,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/11"
      }
    },
    {
      "target": {
        "id": 12,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/12"
      }
    },
    {
      "target": {
        "id": 20,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/20"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 20,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/20"
      },
      "target": {
        "id": 1,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/1"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 20,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/20"
      },
      "target": {
        "id": 2,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/2"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 20,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/20"
      },
      "target": {
        "id": 3,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/3"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 20,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/20"
      },
      "target": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 13,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/13"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 14,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/14"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 15,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/15"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 16,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/16"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 17,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/17"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 18,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/18"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 10,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/10"
      },
      "target": {
        "id": 19,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/19"
      }
    },
    {
      "target": {
        "id": 21,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/21"
      }
    },
    {
      "target": {
        "id": 33,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/33"
      }
    },
    {
      "target": {
        "id": 34,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/34"
      }
    },
    {
      "target": {
        "id": 46,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/46"
      }
    },
    {
      "target": {
        "id": 47,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/47"
      }
    },
    {
      "target": {
        "id": 58,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/58"
      }
    },
    {
      "target": {
        "id": 59,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/59"
      }
    },
    {
      "target": {
        "id": 297,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 297,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
      },
      "target": {
        "id": 299,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 297,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
      },
      "target": {
        "id": 300,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300"
      }
    },
    {
      "target": {
        "id": 298,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/298"
      }
    }
  ]
}

定義

名稱	Description
QueryResultType	結果類型。
QueryType	查詢的類型。
WorkItemFieldReference	工作專案中欄位的參考
WorkItemLink	兩個工作專案之間的連結。
WorkItemQueryResult	工作專案查詢的結果。
WorkItemQuerySortColumn	排序資料行。
WorkItemReference	包含工作專案的參考。

QueryResultType

結果類型。

名稱	類型	Description
workItem	string	一般查詢 (的工作專案清單) 。
workItemLink	string	OneHop 和樹狀結構查詢 (的工作專案連結清單) 。

QueryType

查詢的類型。

名稱	類型	Description
flat	string	取得工作專案的一般清單。
oneHop	string	取得工作專案及其直接連結的清單。
tree	string	取得工作專案的樹狀結構，其中顯示其連結階層。

WorkItemFieldReference

工作專案中欄位的參考

名稱	類型	Description
name	string	欄位的易記名稱。
referenceName	string	欄位的參考名稱。
url	string	資源的 REST URL。

WorkItemLink

兩個工作專案之間的連結。

名稱	類型	Description
rel	string	連結類型。
source	WorkItemReference	來源工作專案。
target	WorkItemReference	目標工作專案。

WorkItemQueryResult

工作專案查詢的結果。

名稱	類型	Description
asOf	string	查詢在的內容中執行的日期。
columns	WorkItemFieldReference[]	查詢的資料行。
queryResultType	QueryResultType	結果類型。
queryType	QueryType	查詢的類型
sortColumns	WorkItemQuerySortColumn[]	查詢的排序資料行。
workItemRelations	WorkItemLink[]	查詢所傳回的工作專案連結。
workItems	WorkItemReference[]	查詢所傳回的工作專案。

WorkItemQuerySortColumn

排序資料行。

名稱	類型	Description
descending	boolean	排序依據的方向。
field	WorkItemFieldReference	工作專案欄位。

WorkItemReference

包含工作專案的參考。

名稱	類型	Description
id	integer	工作專案識別碼。
url	string	資源的 REST API URL

共用方式為