Reporting Work Item Revisions

Service:

Work Item Tracking

API Version:

4.1

此 API 可讓您存取專案或集合中的所有工作專案修訂，並可讓您建置倉儲。

API 的回應包含一批工作專案修訂 (「values」) 、下一批工作專案修訂的 URL (「nextLink」) ，以及布林值，告訴您您是否已讀取所有目前可用的工作專案修訂 (「isLastBatch」) 。

建置倉儲的工作流程如下所示：

1. 對 API 提出要求，而不提供 continuationToken 參數
2. 處理 API 傳回的工作專案修訂
3. 保存 「nextLink」 並檢查 「isLastBatch」
   • 如果 「isLastBatch」 為 true，則暫停一段時間 (會因目標延遲而有所不同)
4. 使用來自 「nextLink」 的 URL 提出下一個要求
5. 移至步驟 2

注意

使用移動工作專案和/或變更工作專案類型功能與查詢字串中的 URL 和/或 「types」 中的 「project」 時，此 API 的結果會受到影響。

• 專案範圍要求只會從指定的專案傳回工作專案修訂。
• 類型範圍要求只會傳回指定型別的工作專案修訂， (s)

範例專案

C# 範例

Operations

Read Reporting Revisions Get	使用包含已刪除專案的選項取得一批工作專案修訂
Read Reporting Revisions Post	取得一批工作專案修訂。 如果您的欄位清單夠大，且可能超過長度限制來執行 URL，則可能會使用此要求。