Work Items - Create

Referensi

Service:: Work Item Tracking

API Version:: 4.1

Membuat satu item kerja.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
organization	path	True	string	Nama organisasi Azure DevOps.
project	path	True	string	ID proyek atau nama proyek
type	path	True	string	Tipe item kerja dari item kerja yang akan dibuat
api-version	query	True	string	Versi API yang akan digunakan. Ini harus diatur ke '4.1' untuk menggunakan versi api ini.
bypassRules	query		boolean	Jangan menerapkan aturan tipe item kerja pada pembaruan ini
suppressNotifications	query		boolean	Jangan aktifkan pemberitahuan apa pun untuk perubahan ini
validateOnly	query		boolean	Menunjukkan apakah Anda hanya ingin memvalidasi perubahan tanpa menyimpan item kerja

Isi Permintaan

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

Nama	Jenis	Deskripsi
from	string	Jalur untuk menyalin dari untuk operasi Pindahkan/Salin.
op	Operation	Operasi patch
path	string	Jalur untuk operasi
value	object	Nilai untuk operasi. Ini adalah primitif atau JToken.

Respons

Nama	Jenis	Deskripsi
200 OK	WorkItem	operasi berhasil

Keamanan

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

Nama	Deskripsi
vso.work_write	Memberikan kemampuan untuk membaca, membuat, dan memperbarui item dan kueri kerja, memperbarui metadata papan, membaca area dan jalur perulangan item kerja lainnya yang melacak metadata terkait, menjalankan kueri, dan untuk menerima pemberitahuan tentang peristiwa item kerja melalui kait layanan.

Contoh

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"
}

Definisi

Nama	Deskripsi
JsonPatchDocument	Model JSON untuk Operasi Patch JSON
Operation	Operasi patch
ReferenceLinks	Kelas untuk mewakili kumpulan tautan referensi REST.
WorkItem	Menjelaskan item kerja.
WorkItemRelation

JsonPatchDocument

Model JSON untuk Operasi Patch JSON

Nama	Jenis	Deskripsi
from	string	Jalur untuk menyalin dari untuk operasi Pindahkan/Salin.
op	Operation	Operasi patch
path	string	Jalur untuk operasi
value	object	Nilai untuk operasi. Ini adalah primitif atau JToken.

Operation

Operasi patch

Nama	Jenis	Deskripsi
add	string
copy	string
move	string
remove	string
replace	string
test	string

ReferenceLinks

Kelas untuk mewakili kumpulan tautan referensi REST.

Nama	Jenis	Deskripsi
links	object	Tampilan baca-saja dari tautan. Karena tautan Referensi bersifat baca-saja, kami hanya ingin mengeksposnya sebagai baca saja.

WorkItem

Menjelaskan item kerja.

Nama	Jenis	Deskripsi
_links	ReferenceLinks	Menautkan referensi ke sumber daya REST terkait.
fields	object	Peta bidang dan nilai untuk item kerja.
id	integer	ID item kerja.
relations	WorkItemRelation[]	Hubungan item kerja.
rev	integer	Nomor revisi item kerja.
url	string

WorkItemRelation

Nama	Jenis	Deskripsi
attributes	object	Kumpulan atribut tautan.
rel	string	Jenis relasi.
url	string	Url tautan.

Bagikan melalui