Work Items - Create

Referensi

Service:: Work Item Tracking

API Version:: 7.1-preview.3

Membuat satu item kerja.

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

With optional parameters:

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

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 '7.1-preview.3' untuk menggunakan versi api ini.
$expand	query		WorkItemExpand	Parameter perluas untuk atribut item kerja. Opsi yang mungkin adalah { None, Relations, Fields, Links, All }.
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. Dalam kasus array, indeks berbasis nol dapat digunakan untuk menentukan posisi dalam array (misalnya /biskuit/0/name). Karakter "-" dapat digunakan alih-alih indeks untuk disisipkan di akhir array (misalnya /biskuit/-).
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 iterasi metadata terkait pelacakan item kerja lainnya, menjalankan kueri, dan 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=7.1-preview.3

[
  {
    "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": {
      "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"
}

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.
WorkItemCommentVersionRef	Mewakili referensi ke versi komentar tertentu pada Item Kerja.
WorkItemExpand	Parameter perluas untuk atribut item kerja. Opsi yang mungkin adalah { None, Relations, Fields, Links, All }
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. Dalam kasus array, indeks berbasis nol dapat digunakan untuk menentukan posisi dalam array (misalnya /biskuit/0/name). Karakter "-" dapat digunakan alih-alih indeks untuk disisipkan di akhir array (misalnya /biskuit/-).
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 dibaca saja, kami hanya ingin mengeksposnya sebagai baca-saja.

WorkItem

Menjelaskan item kerja.

Nama	Jenis	Deskripsi
_links	ReferenceLinks	Menautkan referensi ke sumber daya REST terkait.
commentVersionRef	WorkItemCommentVersionRef	Referensi ke versi tertentu dari komentar yang ditambahkan/diedit/dihapus dalam revisi ini.
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

WorkItemCommentVersionRef

Mewakili referensi ke versi komentar tertentu pada Item Kerja.

Nama	Jenis	Deskripsi
commentId	integer	Id yang ditetapkan untuk komentar.
createdInRevision	integer	[Internal] Revisi item kerja tempat komentar ini awalnya ditambahkan.
isDeleted	boolean	[Internal] Menentukan apakah komentar telah dihapus.
text	string	[Internal] Teks komentar.
url	string
version	integer	nomor versi.

WorkItemExpand

Parameter perluas untuk atribut item kerja. Opsi yang mungkin adalah { None, Relations, Fields, Links, All }

Nama	Jenis	Deskripsi
all	string	Memperluas semua.
fields	string	Item kerja bidang diperluas.
links	string	Item kerja tautan diperluas.
none	string	Perilaku default.
relations	string	Item kerja hubungan diperluas.

WorkItemRelation

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