Work Items - Create

Başvuru

Service:: Work Item Tracking

API Version:: 4.1

Tek bir iş öğesi oluşturur.

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

With optional parameters:

POST https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/${type}?validateOnly={validateOnly}&bypassRules={bypassRules}&suppressNotifications={suppressNotifications}&api-version=4.1

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
project	path	True	string	Proje Kimliği veya proje adı
type	path	True	string	Oluşturulacak iş öğesinin iş öğesi türü
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.
bypassRules	query		boolean	Bu güncelleştirmede iş öğesi türü kurallarını zorlama
suppressNotifications	query		boolean	Bu değişiklik için hiçbir bildirim tetiklemayın
validateOnly	query		boolean	İş öğesini kaydetmeden yalnızca değişiklikleri doğrulamak isteyip istemediğinizi belirtin

İstek Gövdesi

Media Types: "application/json-patch+json"

Name	Tür	Description
from	string	Taşıma/Kopyalama işleminin kopyalama yolu.
op	Operation	Düzeltme eki işlemi
path	string	İşlemin yolu
value	object	İşlemin değeri. Bu bir ilkel veya JToken'dir.

Yanıtlar

Name	Tür	Description
200 OK	WorkItem	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_write	İş öğelerini ve sorgularını okuma, oluşturma ve güncelleştirme, pano meta verilerini güncelleştirme, alan ve yineleme yollarını diğer iş öğesi izlemeyle ilgili meta verileri okuma, sorguları yürütme ve hizmet kancaları aracılığıyla iş öğesi olayları hakkında bildirim alma olanağı verir.

Örnekler

Create work item

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/{project}/_apis/wit/workitems/${type}?api-version=4.1

[
  {
    "op": "add",
    "path": "/fields/System.Title",
    "from": null,
    "value": "Sample task"
  }
]

Sample Response

Status code:: 200

{
  "id": 131489,
  "rev": 1,
  "fields": {
    "System.AreaPath": "CustomProcessPrj",
    "System.TeamProject": "CustomProcessPrj",
    "System.IterationPath": "CustomProcessPrj",
    "System.WorkItemType": "Task",
    "System.State": "New",
    "System.Reason": "New",
    "System.CreatedDate": "2017-10-06T01:04:51.57Z",
    "System.CreatedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
    "System.ChangedDate": "2017-10-06T01:04:51.57Z",
    "System.ChangedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
    "System.Title": "Sample task",
    "Microsoft.VSTS.Common.StateChangeDate": "2017-10-06T01:04:51.57Z",
    "Microsoft.VSTS.Common.Priority": 2
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489"
    },
    "workItemUpdates": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/updates"
    },
    "workItemRevisions": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/revisions"
    },
    "workItemHistory": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489/history"
    },
    "html": {
      "href": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=20cda608-32f0-4e6e-9b7c-8def7b38d15a&id=131489"
    },
    "workItemType": {
      "href": "https://dev.azure.com/fabrikam/aaee31d9-14cf-48b9-a92b-3f1446c13f80/_apis/wit/workItemTypes/Task"
    },
    "fields": {
      "href": "https://dev.azure.com/fabrikam/_apis/wit/fields"
    }
  },
  "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/131489"
}

Tanımlar

Name	Description
JsonPatchDocument	JSON Düzeltme Eki İşlemleri için JSON modeli
Operation	Düzeltme eki işlemi
ReferenceLinks	REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.
WorkItem	bir iş öğesini açıklar.
WorkItemRelation

JsonPatchDocument

JSON Düzeltme Eki İşlemleri için JSON modeli

Name	Tür	Description
from	string	Taşıma/Kopyalama işleminin kopyalama yolu.
op	Operation	Düzeltme eki işlemi
path	string	İşlemin yolu
value	object	İşlemin değeri. Bu bir ilkel veya JToken'dir.

Operation

Düzeltme eki işlemi

Name	Tür	Description
add	string
copy	string
move	string
remove	string
replace	string
test	string

ReferenceLinks

REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.

Name	Tür	Description
links	object	Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak kullanıma açmak istiyoruz.

WorkItem

bir iş öğesini açıklar.

Name	Tür	Description
_links	ReferenceLinks	İlgili REST kaynaklarına bağlantı başvuruları.
fields	object	İş öğesinin alan ve değerlerinin haritası.
id	integer	İş öğesi kimliği.
relations	WorkItemRelation[]	İş öğesinin ilişkileri.
rev	integer	İş öğesinin düzeltme numarası.
url	string

WorkItemRelation

Name	Tür	Description
attributes	object	Bağlantı öznitelikleri koleksiyonu.
rel	string	İlişki türü.
url	string	Bağlantı URL'si.

Aracılığıyla paylaş