Reporting Work Item Revisions - Read Reporting Revisions Post

Başvuru

Service:: Work Item Tracking

API Version:: 4.1

İş öğesi düzeltmelerinden oluşan bir toplu işlem alın. Alan listeniz URL'yi uzunluk sınırını aşacak kadar büyükse bu istek kullanılabilir.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/reporting/workitemrevisions?api-version=4.1

With optional parameters:

POST https://dev.azure.com/{organization}/{project}/_apis/wit/reporting/workitemrevisions?continuationToken={continuationToken}&startDateTime={startDateTime}&$expand={$expand}&api-version=4.1

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
project	path		string	Proje Kimliği veya proje adı
api-version	query	True	string	Kullanılacak API'nin sürümü. Bu, api'nin bu sürümünü kullanmak için '4.1' olarak ayarlanmalıdır.
$expand	query		ReportingRevisionsExpand
continuationToken	query		string	Toplu işlemi başlatacak filigranı belirtir. İlk düzeltme toplu işlemini almak için bu parametreyi atla.
startDateTime	query		string date-time	Düzeltmeler için başlangıç noktası olarak kullanılacak tarih/saat, tüm düzeltmeler bu tarih/saatten sonra gerçekleşir. 'watermark' parametresiyle birlikte kullanılamaz.

İstek Gövdesi

Name	Tür	Description
fields	string[]	İş öğesi düzeltmelerinde döndürülecek alanların listesi. Raporlanabilir tüm alanları almak için bu parametreyi atla.
includeDeleted	boolean	Silinen iş öğesini sonuma ekleyin.
includeIdentityRef	boolean	Kimlik alanları için dize değeri yerine bir kimlik başvurusu döndürür.
includeLatestOnly	boolean	İş öğesinin önceki tüm düzeltmelerini atlayarak yalnızca iş öğesinin en son sürümünü ekleyin.
includeTagRef	boolean	System.Tags alanı için dize değeri yerine etiket başvurusu ekle
types	string[]	Sonuçları belirli iş öğesi türlerine göre filtrelemek için türlerin listesi. Tüm iş öğesi türlerinin iş öğesi düzeltmelerini almak için bu parametreyi atla.

Yanıtlar

Name	Tür	Description
200 OK	ReportingWorkItemRevisionsBatch	başarılı işlem

Güvenlik

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

Name	Description
vso.work	İş öğelerini, sorguları, panoları, alan ve yineleme yollarını ve diğer iş öğesi izlemeyle ilgili meta verileri okuma olanağı verir. Ayrıca sorguları yürütme ve hizmet kancaları aracılığıyla iş öğesi olayları hakkında bildirim alma olanağı verir.

Örnekler

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/_apis/wit/reporting/workitemrevisions?continuationToken=813;350;1&api-version=4.1

{
  "types": [
    "Bug",
    "Task",
    "Product Backlog Item"
  ],
  "fields": [
    "System.WorkItemType",
    "System.Title",
    "System.AreaPath"
  ],
  "includeIdentityRef": true
}

Sample Response

Status code:: 200

{
  "values": [
    {
      "id": 3,
      "rev": 8,
      "fields": {
        "System.AreaPath": "Fabrikam-Fiber-Git",
        "System.WorkItemType": "Product Backlog Item",
        "System.Title": "Technician can submit invoices on Windows Phone"
      }
    }
  ],
  "nextLink": "https://dev.azure.com/fabrikam/_apis/wit/reporting/workItemRevisions?continuationToken=842;5;3&api-version=2.0",
  "isLastBatch": true
}

Tanımlar

Name	Description
ReportingRevisionsExpand
ReportingWorkItemRevisionsBatch
ReportingWorkItemRevisionsFilter

ReportingRevisionsExpand

Name	Tür	Description
fields	string
none	string

ReportingWorkItemRevisionsBatch

Name	Tür	Description
continuationToken	string
isLastBatch	boolean
nextLink	string
values	string[]

ReportingWorkItemRevisionsFilter

Name	Tür	Description
fields	string[]	İş öğesi düzeltmelerinde döndürülecek alanların listesi. Raporlanabilir tüm alanları almak için bu parametreyi atla.
includeDeleted	boolean	Silinen iş öğesini sonuma ekleyin.
includeIdentityRef	boolean	Kimlik alanları için dize değeri yerine bir kimlik başvurusu döndürür.
includeLatestOnly	boolean	İş öğesinin önceki tüm düzeltmelerini atlayarak yalnızca iş öğesinin en son sürümünü ekleyin.
includeTagRef	boolean	System.Tags alanı için dize değeri yerine etiket başvurusu ekle
types	string[]	Sonuçları belirli iş öğesi türlerine göre filtrelemek için türlerin listesi. Tüm iş öğesi türlerinin iş öğesi düzeltmelerini almak için bu parametreyi atla.

Aracılığıyla paylaş