İş öğesi izleme

  • Makale

İş öğesi izleme kaynakları

Hataları, görevleri ve takımınız için diğer iş öğelerini alın, oluşturun ve güncelleştirin. Sorgular, aranacak iş öğesi sorgu dilinin tam gücünden yararlanmanıza ve iş öğelerini filtrelemenize olanak tanır. Sorguyu karşılayan her bir iş öğesine ulaşmak için iş öğesi sorgu dilini kullanabilirsiniz. İş öğeleri tam geçmiş kaydı tutar ve iş öğesinin her tam düzeltmesini ya da yalnızca her bir düzeltmede yapılmış güncelleştirmeleri alabilirsiniz. İş öğeleri ayrıca etiketlenebilir.

Genel görevler

Sorgu kullanarak iş öğelerini alma

  1. Kullanmak istediğiniz sorguyu arayın.
  2. Bu sorgunun sonuçlarını alın.
  3. İş öğelerinin her birini kimlik bilgilerine göre alın.

Toplu olarak WorkItems'i güncelleştirme

Batch WorkItem Update API'sini kullanarak iş öğelerinizi toplu olarak güncelleştirin.

İş öğesinin alanlarını güncelleştirme

  1. Güncelleştirmek istediğiniz iş öğesinin kimliğini alın.
  2. İş öğesinin alanlarını güncelleştirin.
  1. Bağlamak istediğiniz iş öğelerinin kimliğini alın.
  2. İş öğeleri arasına bir bağlantı ekleyin.

bir iş öğesi oluşturun ve toplu çağrıya bağlantı API'leri ekleyin.

İş öğesine dosya ekleme

  1. Güncelleştirmek istediğiniz iş öğesinin kimliğini alın.
  2. Eki ek deposuna yükleyin.
  3. Eki iş öğesine ekleyin.

İş öğesi oluşturma

bir iş öğesi oluşturun. En azından bir başlık belirttiğinizden emin olun. Bazı iş öğesi türleri diğer alanlar için değer gerektirir.

İş öğesinin tüm geçmişini alma

  1. İş öğesinin kimliğini alın.
  2. İş öğesinde yapılan güncelleştirmelerin listesini alın.
  3. Herhangi bir düzeltmede göründüğü gibi iş öğesinin tamamını alın.

İş öğesini silme

  1. İş öğesinin kimliğini alın.
  2. İş öğesini silin.

Takım projesinde kullanılan alanları alma

  1. Takım projesinde kullanılan iş öğesi türlerini alma.
  2. Kullandığı alanları görmek için her iş öğesi türünü alın. (Xmlform'u fieldinstances'a atlayın.)

İş öğesi kategorilerini alma

Farklı işlevler için bir takım projesinde kullanılan iş öğesi türlerini almak için iş öğesi kategorilerini kullanın. Örneğin, kapsam üzerinde görünen iş öğelerini görmek için gereksinimler kategorisini alın.

Alanları ve yinelemeleri alma

Ekip projeniz için alan hiyerarşisini veya yineleme hiyerarşisini alın.

İş öğesi ilişki türlerini alma

Proje koleksiyonunuzda bulunan kullanılabilir iş öğesi bağlantı türlerini alın.

İş öğesi meta veri kaynakları

İş öğeleri meta veriler tarafından yönetilir. Bazı meta verilerin kapsamı belirli bir takım projesine, diğer meta verilerin kapsamı ise bir proje koleksiyonuna (Azure DevOps Services hesabınızın varsayılan koleksiyonu gibi) göre belirlenmiştir.

Proje kapsamlı meta veriler

Takım projenizde bir dizi iş öğesi türü var. Her iş öğesi türü, projedeki rolünü tanımlamak için "gereksinim" veya "hata" gibi bir kategoriye ait olabilir. Sınıflandırma düğümleri , takım projesindeki iş öğeleri için alanda ve yineleme alanlarında kullanılabilecek değer kümesini tanımlar.

Koleksiyon kapsamlı meta veriler

İş öğesi türleri , alanları ve ilişki türlerini (bağlantılar ve ekler) diğer iş öğesi türleriyle paylaşır.

İş öğesi toplu güncelleştirme API'si

Birden çok İş Öğesi Güncelleştirme isteği gerçekleştirir. Yanıt, toplu iş içindeki isteklerin her biri için tek tek yanıtlar içerir. Başarısız istekler toplu iş içindeki sonraki istekleri etkilemez.

REST API SEMANTIĞI

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

URI Parametreleri

Name İçinde Gerekli Tür Açıklama
Organizasyon Yol True string Azure DevOps kuruluşunun adı.
api-sürümü query string Kullanılacak API'nin sürümü.
bypassRules query boolean Bu güncelleştirmede iş öğesi türü kurallarını zorlamayın.
suppressNotifications query boolean Bu değişiklik için hiçbir bildirim tetiklemayın.

İstek Gövdesi

İstek gövdesi, İş Öğesi Güncelleştirme isteklerinin listesi olarak oluşturulur. Bu listedeki her öğe REST yöntemi, yol, üst bilgiler ve gövde dahil olmak üzere tek bir Güncelleştirme İsteği hakkındaki tüm bilgileri içerir.

Tek istek hakkında ayrıntılı bilgi için İş Öğesi Güncelleştirme belgelerine bakabilirsiniz.

Batch Update örneği

İstek

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

İstek Gövdesi

[
  {
    // 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"
        }
    ]
  },
]

Response

Yanıt, her toplu güncelleştirme isteği için tek tek yanıtlardan oluşur.

  • count : döndürülen toplu güncelleştirme yanıtlarının sayısı
  • value : yanıt kodu, üst bilgileri ve gövdesiyle yanıt nesnelerinin listesi
{
  "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}"
    }
  ]
}