Azure Boards'ta iş öğesi alanları ve öznitelikleri

İş öğesi alanları, bilgileri izlemek için kullanılır. Alanlar bir kuruluş için tanımlanır ve bu kuruluş için tanımlanan tüm projeler arasında paylaşılır. Kuruluş için tanımlanan alanları gözden geçirmek için iki araçdan birini kullanabilirsiniz. Bu araçlar hem Devralınan hem de Barındırılan XML işlem modellerinde kullanılabilir.

• İşlem>Alanları web sayfası
• İş Öğesi Alan Gezgini

İş öğesi alanları, bilgileri izlemek için kullanılır. Alanlar bir koleksiyon için tanımlanır ve bu koleksiyon için tanımlanan tüm projeler arasında paylaşılır. Koleksiyon için tanımlanan alanları gözden geçirmek için iki araçdan birini kullanabilirsiniz.

• İşlem>Alanları web sayfası: Devralınan işlem modeli için kullanılabilir
• İş Öğesi Alan Gezgini: Devralınan ve Şirket İçi XML işlem modelleri için kullanılabilir.

Devralınan bir işleme özel alan eklediğinizde, Azure DevOps Özel ön ekli bir başvuru adı atar ve ardından alan adı boşluklar kaldırılır. Örneğin, DevOps Triage adlı bir alan eklersiniz; başvuru adı Custom.DevOpsTriage olur. Başvuru adında boşluk kullanılmasına izin verilmez.

İşlem>Alanları sayfasını açarak kuruluşunuz için tanımlanan alanların veri türünü görüntüleyebilirsiniz.

Proje koleksiyonunuz iş izlemeyi özelleştirmek için Devralma işlemi modelini kullandığında, İşlem>Alanları sayfasını açarak alanların veri türünü görüntüleyebilirsiniz.

Şirket içi XML işlem modeli kullanılıyorsa, iş öğesi alan dizini aracılığıyla veri türünü arayabilirsiniz. Alternatif olarak, tanımlanan alanları ve öznitelik atamalarını gözden geçirmek için İş Öğesi Alan Gezgini'ni açabilir veya alan özniteliklerini listelemek için witadmin listfields komutunu kullanabilirsiniz. Daha fazla bilgi için bu makalenin devamında yer alan İş Öğesi Alan Gezgini ve Liste alanı öznitelikleri bölümüne bakın.

İşlem>Alanları web sayfası

Bir kuruluş veya koleksiyon için tanımlanan alanların listesini gözden geçirmek için Kuruluş ayarları>İşlem>Alanları'nı açın.

1. Projeler'i açmak için Azure DevOps logosunu seçin. Ardından Kuruluş ayarları'nı seçin.

   

2. Ardından İşlem'i seçin.

   

   Not

   İşlem'i görmüyorsanız, TFS-2018 veya önceki bir sürümden çalışıyorsunuz demektir. İşlem sayfası desteklenmez. Şirket içi XML işlem modeli için desteklenen özellikleri kullanmanız gerekir.

3. Ardından Alanlar'ı seçin.

   Listelenen alanlar, kuruluş veya koleksiyon için tanımlanan tüm alanlara karşılık gelir. Bu, tüm özel alanları ve sistem işlemleri için tanımlananları içerir.

   

   Not

   Alanlar'ı görmüyorsanız koleksiyonunuz Şirket İçi XML işlemini kullanır. Alanlar sayfası bu işlem için desteklenmez.

   Her alanın açıklamaları ve kullanımı ile her alanın Başvuru adı için, bunu İş öğesi alan dizininden arayabilirsiniz. Ayrıca, İş Öğesi Türleri Alanı - Liste REST API'sinden alanların Başvuru adını da alabilirsiniz.

Raporlanabilir öznitelikler

Tüm raporlama öznitelikleri yalnızca projeleri SQL Server Raporlama ve SQL Server Analysis Services'ı destekleyecek şekilde yapılandırılmış şirket içi dağıtımlar için geçerlidir. Daha fazla bilgi için bkz . Projeye rapor ekleme.

Raporlanabilir her özniteliğin açıklaması için bkz. [Raporlamayı desteklemek için iş öğesi alanlarını ekleme veya değiştirme]((/previous-versions/azure/devops/reference/xml/add-or-modify-work-item-fields-to-support-reporting).

Varsayılan olarak tanımlanmış raporlanabilir öznitelikleri olan alanların listesi için bkz . Raporlanabilir alanlar başvurusu .

Dizine alınan alanlar

witadmin indexfield komutunu kullanarak bir iş öğesi alanı için dizin oluşturmayı etkinleştirebilir veya devre dışı bırakabilirsiniz. Bir alan için dizin oluşturmayı etkinleştirdiğinizde, sorguları bu alanı belirten iş öğelerini bulma performansını artırabilirsiniz. Varsayılan olarak, şu alanlar dizine eklenir: Atanan, Oluşturulma Tarihi, Değiştiren, Durum, Neden, Alan Kimliği, Yineleme Kimliği ve İş Öğesi Türü.

İş öğesi sorgularınızın çoğunda kullandığınız özel bir alan eklerseniz, bu alan için dizin oluşturmayı etkinleştirmek isteyebilirsiniz. Daha fazla bilgi için bkz . İş öğesi alanlarını yönetme (witadmin).

Alanlar - GET REST API'sini kullanarak bir alana atanan öznitelikleri listeleyebilirsiniz. KuruluşAdı için kuruluşunuzun adını girin.

https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName

Örneğin burada Yineleme Yolu özniteliklerini listeleyeceğiz ve fabrikam kuruluşu için başvuru adını System.IterationPathbelirteceğiz.

https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath

Döndürülen veriler:

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://dev.azure.com/mseng/_apis/wit/fields/System.IterationPath"
}

Alanlar - GET REST API'sini kullanarak bir alana atanan öznitelikleri listeleyebilirsiniz. KuruluşAdı için kuruluşunuzun adını girin. REST kullanmaya başlamak için bkz . Azure DevOps Services REST API Başvurusu

https://{ServerName:Port}/tfs/{Collection}/_apis/wit/fields/FieldReferenceName?api-version={version}

Örneğin, burada Yineleme Yolu özniteliklerini listeleyeceğiz ve fabrikam sunucusu için başvuru adını System.IterationPathbelirteceğiz.

https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1

Döndürülen veriler:

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1"
}

Komut satırı aracını kullanarak witadmin öznitelikleri listeleme

witadmin listfields komutunu kullanarak veri türü, raporlanabilir öznitelikler ve dizin oluşturma gibi alan özniteliklerini listeleyebilirsiniz.

Örneğin, microsoft.VSTS.Common.Issue gibi belirtilen bir alan için tanımlanan öznitelikleri listelemek için aşağıdaki komutu girebilirsiniz.

witadmin listfields /collection:http://fabrikam:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue  

Bu örnekte gösterildiği gibi, adlandırılmış alan için alan ve öznitelik bilgileri görüntülenir.

Field: Microsoft.VSTS.Common.Issue  
Name: Issue  
Type: String  
Reportable As: dimension  
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)  
Indexed: False  

Use parametresi, her projenin adını ve alanın kullanıldığı iş öğesi türünü gösterir.

Bir işleme alan eklemek için, bunları bir veya daha fazla iş öğesi türüne eklersiniz. Daha fazla bilgi için bkz . Devralma işlemini özelleştirme.

WIT içinde yer alan alanları ekleyebilir veya değiştirebilir ya da özel bir WIT ekleyebilirsiniz. Daha fazla bilgi için bkz.

• Devralma işlemi modelini kullanan proje koleksiyonları için: Devralma işlemini özelleştirme.
• Şirket içi XML işlem modelini kullanan proje koleksiyonları için: Şirket içi XML işlem modelini özelleştirin.

witadmin komut satırı aracını kullanarak sistem alanları dışında herhangi bir alanın alan adını, dizinini ve rapor özniteliklerini değiştirebilirsiniz. Daha fazla bilgi için bkz . İş öğesi alanlarını yönetme-witadmin.

• Sorgu hızlı başvurusu
• İş öğesi alan dizini
• Devralınan bir işlem için alan ekleme ve yönetme
• Azure Boards Analytics için meta veri başvurusu

• Sorgu hızlı başvurusu
• İş öğesi alan dizini
• Proje koleksiyonunuz için işlem modelini seçme
• Çalışmayı izlemek için alan ekleme veya değiştirme
• witadmin kullanarak iş öğesi alanlarını yönetme
• Azure Boards Analytics için meta veri başvurusu