Bagikan melalui

Pelacakan item kerja

  • Artikel

Sumber daya pelacakan item kerja

Dapatkan, buat, dan perbarui bug, tugas, dan item kerja lain untuk tim Anda. Kueri memungkinkan Anda menggunakan dukungan penuh bahasa kueri item kerja untuk mencari dan memfilter item kerja. Anda dapat menggunakan bahasa kueri item kerja untuk mendapatkan setiap item kerja yang memenuhi kueri. Item kerja mempertahankan riwayat lengkap, dan Anda bisa mendapatkan setiap revisi lengkap dari item kerja, atau hanya pembaruan yang dibuat dalam setiap revisi. Item kerja juga dapat ditandai.

Tugas umum

Mendapatkan item kerja menggunakan kueri

  1. Cari kueri yang ingin Anda gunakan.
  2. Dapatkan hasil untuk kueri tersebut.
  3. Dapatkan setiap item kerja berdasarkan ID.

Memperbarui WorkItems dalam batch

Gunakan api Batch WorkItem Update untuk memperbarui workitem Anda dalam batch.

Memperbarui bidang item kerja

  1. Dapatkan ID item kerja yang ingin Anda perbarui.
  2. Perbarui bidang item kerja.
  1. Dapatkan ID item kerja yang ingin Anda tautkan.
  2. Tambahkan tautan di antara item kerja.

Gunakan buat item kerja dan tambahkan API tautan dalam panggilan batch.

Melampirkan file ke item kerja

  1. Dapatkan ID item kerja yang ingin Anda perbarui.
  2. Unggah lampiran ke penyimpanan lampiran.
  3. Tambahkan lampiran ke item kerja.

Membuat item kerja

Membuat item kerja. Pastikan Anda memberikan setidaknya judul. Beberapa jenis item kerja akan memerlukan nilai untuk bidang lain.

Mendapatkan riwayat lengkap item kerja

  1. Dapatkan ID item kerja.
  2. Dapatkan daftar pembaruan yang dibuat untuk item kerja.
  3. Dapatkan seluruh item kerja seperti yang muncul dalam revisi apa pun.

Menghapus item kerja

  1. Dapatkan ID item kerja.
  2. Hapus item kerja.

Mendapatkan bidang yang digunakan dalam proyek tim

  1. Dapatkan jenis item kerja yang digunakan dalam proyek tim.
  2. Dapatkan setiap jenis item kerja untuk melihat bidang yang digunakannya. (Lewati melewati bentuk xml ke fieldinstance.)

Mendapatkan kategori item kerja

Gunakan kategori item kerja untuk mendapatkan jenis item kerja yang digunakan dalam proyek tim untuk fungsi yang berbeda. Misalnya, untuk melihat item kerja yang muncul di backlog, dapatkan kategori persyaratan.

Mendapatkan area dan iterasi

Dapatkan hierarki area atau hierarki perulangan untuk proyek tim Anda.

Mendapatkan jenis hubungan item kerja

Dapatkan jenis tautan item kerja yang tersedia yang tersedia di koleksi proyek Anda.

Sumber daya metadata item kerja

Item kerja diatur oleh metadata. Beberapa metadata dilingkup ke proyek tim tertentu, dan metadata lainnya terlingkup ke koleksi proyek (seperti koleksi default akun Azure DevOps Services Anda).

Metadata lingkup proyek

Proyek tim Anda memiliki sekumpulan jenis item kerja. Setiap jenis item kerja mungkin termasuk dalam kategori seperti "persyaratan" atau "bug" untuk menentukan perannya dalam proyek. Simpul klasifikasi menentukan kumpulan nilai yang dapat digunakan di area dan bidang iterasi untuk item kerja dalam proyek tim.

Metadata cakupan koleksi

Jenis item kerja berbagi bidang dan jenis relasi (tautan dan lampiran) dengan jenis item kerja lainnya.

API pembaruan batch item kerja

Melakukan beberapa permintaan Pembaruan Item Kerja. Respons berisi respons individual untuk setiap permintaan dalam batch. Permintaan yang gagal tidak memengaruhi permintaan berikutnya dalam batch.

SEMANTIK REST API

PATCH https://dev.azure.com/{organization}/_apis/wit/$batch?api-version=6.1

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
organization Jalur True string Nama organisasi Azure DevOps.
versi-api query untai (karakter) Versi API yang akan digunakan.
bypassRules query boolean Jangan menerapkan aturan tipe item kerja pada pembaruan ini.
suppressNotifications query boolean Jangan aktifkan pemberitahuan apa pun untuk perubahan ini.

Isi Permintaan

Isi permintaan terdiri sebagai daftar permintaan Pembaruan Item Kerja. Setiap item dari daftar ini akan menggabungkan semua informasi tentang Permintaan Pembaruan tunggal termasuk metode REST, jalur, header, dan isi.

Anda dapat memeriksa dokumentasi Pembaruan Item Kerja untuk informasi terperinci tentang satu permintaan.

Contoh Pembaruan Batch

Permintaan

PATCH https://dev.azure.com/fabrikam/_apis/wit/$batch?api-version=6.1

Isi Permintaan

[
  {
    // Add priority and test rev on work item with id 1
    "method": "PATCH",
    "uri": "/_apis/wit/workitems/1?api-version=6.1",
    "headers": {
      "Content-Type": "application/json-patch+json"
    },
    "body": [
      {
        "op": "test",
        "path": "/rev",
        "value": 3
      },
      {
        "op": "add",
        "path": "/fields/Microsoft.VSTS.Common.Priority",
        "value": "1"
      }
    ]
  },
  {
    // Replace tags on work item with id 299x   
    "method": "PATCH",
    "uri": "/_apis/wit/workitems/299?api-version=6.1",
    "headers": {
      "Content-Type": "application/json-patch+json"
    },
    "body": [
      {
        "op": "replace",
        "path": "/fields/System.Tags",
        "value": "Tag1; Tag2"
      }
    ]
  },
  {
    // You can also use Work Item Create format
    "method": "PATCH",
    "uri": "/mytestprojectname/_apis/wit/workitems/$Bug?api-version=4.1",
    "headers": {
        "Content-Type": "application/json-patch+json"
    },
    "body": [
        {
            "op": "add",
            "path": "/id",
            "value": "-1"
        },
        {
            "op": "add",
            "path": "/fields/System.Title",
            "from": null,
            "value": "Sample 1"
        }
    ]
  },
]

Respons

Respons terdiri dari respons individual untuk setiap permintaan pembaruan batch.

  • count : jumlah respons pembaruan batch yang dikembalikan
  • nilai : daftar objek respons dengan kode respons, header, dan isinya
{
  "count": 2,
  "value": [
    {
      "code": 200,
      "headers": {
        "Content-Type": "application/json; charset=utf-8"
      },
      "body": "{work item object}"
    },
    {
      "code": 200,
      "headers": {
        "Content-Type": "application/json; charset=utf-8"
      },
      "body": "{work item object}"
    }
  ]
}