Work Items - Create

Başvuru

Hizmet:: Work Item Tracking

API Sürümü:: 7.1

Tek bir iş öğesi oluşturur.

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

İsteğe bağlı parametrelerle:

POST https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/${type}?validateOnly={validateOnly}&bypassRules={bypassRules}&suppressNotifications={suppressNotifications}&$expand={$expand}&api-version=7.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 '7.1' olarak ayarlanmalıdır.
$expand	query		WorkItemExpand	İş öğesi öznitelikleri için genişletme parametreleri. Olası seçenekler şunlardır: { Yok, İlişkiler, Alanlar, Bağlantılar, Tümü }.
bypassRules	query		boolean	Bu güncelleştirmede iş öğesi türü kurallarını zorunlu kılma
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. Dizi söz konusu olduğunda, dizideki konumu belirtmek için sıfır tabanlı bir dizin kullanılabilir (örn. /biscuits/0/name). Dizinin sonuna eklemek için dizin yerine "-" karakteri kullanılabilir (örn. /biscuits/-).
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

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Belirteç URL'si: 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

Kapsamlar

Name	Description
vso.work_write	İş öğelerini ve sorgularını okuma, oluşturma ve güncelleştirme, pano meta verilerini güncelleştirme, okuma alanı ve yineleme yolları ile ilgili diğer iş öğesi izleme meta verilerini okuma, sorguları yürütme ve hizmet kancaları aracılığıyla iş öğesi olayları hakkında bildirim alma olanağı verir.

Örnekler

Create work item

Örnek isteği

HTTP

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

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

Örnek yanıt

Durum kodu:: 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": {
      "displayName": "Jamal Hartnett",
      "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "_links": {
        "avatar": {
          "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
        }
      },
      "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "uniqueName": "fabrikamfiber4@hotmail.com",
      "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
    },
    "System.ChangedDate": "2017-10-06T01:04:51.57Z",
    "System.ChangedBy": {
      "displayName": "Jamal Hartnett",
      "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "_links": {
        "avatar": {
          "href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
        }
      },
      "id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "uniqueName": "fabrikamfiber4@hotmail.com",
      "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
      "descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
    },
    "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ı koleksiyonunu temsil eden sınıf.
WorkItem	bir iş öğesini açıklar.
WorkItemCommentVersionRef	İş Öğesindeki bir açıklamanın belirli bir sürümüne başvuruyu temsil eder.
WorkItemExpand	İş öğesi öznitelikleri için genişletme parametreleri. Olası seçenekler şunlardır: { Yok, İlişkiler, Alanlar, Bağlantılar, Tümü }
WorkItemRelation

JsonPatchDocument

Object

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. Dizi söz konusu olduğunda, dizideki konumu belirtmek için sıfır tabanlı bir dizin kullanılabilir (örn. /biscuits/0/name). Dizinin sonuna eklemek için dizin yerine "-" karakteri kullanılabilir (örn. /biscuits/-).
value	object	İşlemin değeri. Bu bir ilkel veya JToken'dir.

Operation

Listeleme

Düzeltme eki işlemi

Değer	Description
add
copy
move
remove
replace
test

ReferenceLinks

Object

REST başvuru bağlantıları 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

Object

bir iş öğesini açıklar.

Name	Tür	Description
_links	ReferenceLinks	Başvuruları ilgili REST kaynaklarına bağlayın.
commentVersionRef	WorkItemCommentVersionRef	Bu düzeltmede eklenen/düzenlenen/silinen açıklamanın belirli bir sürümüne başvuru.
fields	object	İş öğesi için alan ve değerlerin haritası.
id	integer (int32)	İş öğesi kimliği.
relations	WorkItemRelation[]	İş öğesinin ilişkileri.
rev	integer (int32)	İş öğesinin düzeltme numarası.
url	string

WorkItemCommentVersionRef

Object

İş Öğesindeki bir açıklamanın belirli bir sürümüne başvuruyu temsil eder.

Name	Tür	Description
commentId	integer (int32)	Açıklamaya atanan kimlik.
createdInRevision	integer (int32)	[İç] Bu açıklamanın ilk eklendiği iş öğesi düzeltmesi.
isDeleted	boolean	[İç] Açıklamanın silinip silinmeyeceğini belirtir.
text	string	[İç] Açıklamanın metni.
url	string
version	integer (int32)	Sürüm numarası.

WorkItemExpand

Listeleme

İş öğesi öznitelikleri için genişletme parametreleri. Olası seçenekler şunlardır: { Yok, İlişkiler, Alanlar, Bağlantılar, Tümü }

Değer	Description
all	Tümünü genişletir.
fields	Alanlar iş öğesini genişletir.
links	İş öğesini genişletmeyi bağlar.
none	Varsayılan davranış.
relations	İlişkiler iş öğesi genişletildi.

WorkItemRelation

Object

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ş

Work Items - Create

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

oauth2

Kapsamlar

Örnekler

Create work item

Örnek isteği

Örnek yanıt

Tanımlar

JsonPatchDocument

Operation

ReferenceLinks

WorkItem

WorkItemCommentVersionRef

WorkItemExpand

WorkItemRelation