İş öğesi alanlarını ve özniteliklerini listeleme

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Sistem işlemiyle tanımlanan her alanın açıklaması için bkz . İş öğesi alan dizini.

Önkoşullar

Alanları listeleme veya gözden geçirme

Alanları listelemek veya gözden geçirmek için, işlem modelinize göre aşağıdaki araçlardan birini kullanın: Devralınan, Barındırılan XML veya Şirket İçi XML. Varsayılan işlemler içinde tanımlanan alanların dizini için bkz . İş öğesi alan dizini.

Alan veri türleri ve adları

Her iş öğesi türü, bu türdeki iş öğelerine dahil edilen alanları belirtir. Her alanın, çoğu sistem tanımlı ve sabit olan birden çok özniteliği vardır.

Alanlar aşağıdaki üç öznitelikle tanımlanır:

• Veri türü: Boole, Çift, Tamsayı, HTML veya Dize gibi alana girilebilen veri türünü gösterir. Her veri türünün ayrıntılı açıklamaları için bkz . Sorgu alanları, işleçler ve makrolar.
• Kolay ad: Sorgu yan tümcesinde bir Alan seçilirken kullanılan, alana atanan kullanıcı dostu ad. Bu ad, iş öğesi formunda görüntülenen addan farklı olabilir.
• Başvuru adı: WIQL sorguları oluştururken, geliştirilmiş iş öğesi şablonlarında, REST API komutlarını yürütürken veya XML iş öğesi türü tanımları tanımlarken kullanılan tanımlayıcı. Başvuru adı kalıcıdır ve ayarlandıktan sonra değiştirilemez.

Her alan özniteliğinin ayrıntılı açıklaması ve bunların nasıl listelendiğine ilişkin yönergeler için, bu makalenin devamında yer alan Alan öznitelikleri ve Liste alanı öznitelikleri bölümüne bakın. İş öğesi türlerine (WIT) ve iş öğelerine genel bakış için bkz. Kullanıcı hikayeleri, sorunları, hataları, özellikleri ve epic'lerle çalışmayı izleme.

Alan nedir? Alan adları nasıl kullanılır?

Her iş öğesi türü 31 sistem alanı ve türe özgü birkaç alan içerir. İş öğeleri projenizi planlamak ve izlemek için kullanılır.

Her alan gerçekleştirilecek çalışmayla ilgili belirli bilgileri yakalar. Bu alanlara atadığınız değerler iş izleme veri deposunda depolanır ve bu sayede durumu ve eğilimleri belirleyen sorgular oluşturabilirsiniz.

Temel sistem işlemleri (Agile, Basic, Scrum ve CMMI) için tanımlanan her alanın açıklamaları ve kullanımı için İş öğesi alan dizinine bakın.

Alan adları

İş öğesi alan adı, her iş öğesi alanını benzersiz olarak tanımlar. Alan adlarınızın aşağıdaki yönergelere uyduğundan emin olun:

• Benzersizlik: Alan adları hesap veya proje koleksiyonu içinde benzersiz olmalıdır.
• Uzunluk: Alan adları 128 Unicode karakter veya daha az karakter içermelidir.
• Aralık: Alan adlarının başında veya sonunda boşluk olamaz ya da ardışık iki veya daha fazla boşluk içeremez.
• Oluşturma: Alan adları en az bir alfabetik karakter içermelidir.
• Yasaklanmış Karakterler: Alan adları şu karakterleri içeremez: .,;':~/*|?" &%$!+=()[]{}<>'.

Özel alanlar kuruluş veya koleksiyon düzeyinde tanımlandığından, birden çok işleme aynı ada sahip bir özel alan ekleyemezsiniz.

Daha fazla bilgi için bkz . Adlandırma kısıtlamaları ve kuralları.

Sistem ve önceden tanımlanmış alanlar

İş öğesi alan adı, Azure DevOps içindeki her alanı benzersiz olarak tanımlar. Alan adlarınızın aşağıdaki yönergelere uyduğundan emin olun:

• Benzersizlik: Alan adları bir hesap veya proje koleksiyonu içinde benzersiz olmalıdır.
• Uzunluk: Alan adları 128 Unicode karakter veya daha az olmalıdır.
• Aralık: Alan adlarının başında veya sonunda boşluk olamaz ya da ardışık birden çok boşluk içeremez.
• Oluşturma: Alan adları en az bir alfabetik karakter içermelidir.
• Yasaklanmış Karakterler: Alan adları şu karakterleri içeremez: .,;':~/*|?" &%$!+=()[]{}<>'.

Özel alanlar kuruluş veya koleksiyon düzeyinde tanımlandığından, birden çok işleme aynı ada sahip bir özel alan ekleyemezsiniz.

Daha fazla bilgi için bkz . Adlandırma kısıtlamaları ve kuralları.

Özel alanlar

Özel alanlar kuruluş veya proje koleksiyonu düzeyinde tanımlandığından, birden çok işleme aynı ada sahip bir özel alan ekleyemezsiniz.

Özel alanlar eklerken aşağıdaki sınırları not edin:

• İş öğesi türü başına en fazla alan sayısı (WIT): 64
• İşlem başına en fazla alan sayısı: 512

Alan veri türü, alanda depolanabilecek verilerin türünü ve boyutunu belirler. Her alanın bir proje koleksiyonu içinde tanımlanmış tek bir türü olabilir ve bu da farklı projeler ve iş öğesi türleri arasında ortak alanların kullanılmasını teşvik eder.

Devralınan işleme özel bir alan eklediğinizde, Azure DevOps Özel ön eki eklenmiş bir başvuru adı atar ve ardından alan adı boşluk bırakmaz. Örneğin, DevOps Triage adlı bir alan eklemek Custom.DevOpsTriage başvuru adını döndürür. Başvuru adlarında boşluklara izin verilmez.

Daha fazla bilgi için bkz . Adlandırma kısıtlamaları ve kuralları.

Alan veri türünü nasıl belirleyebilirim?

Alanları gözden geçirme listesi

Bir kuruluş veya koleksiyon için tanımlanan alanların listesini gözden geçirmek için aşağıdaki adımları uygulayın:

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

   

2. İşlem'i seçin.

   

3. Alanlar'ı seçin.

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

   

   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ı, kullanımı ve başvuru adları için İş öğesi alan dizinine bakın. Ayrıca, İş Öğesi Türleri Alanı - Liste REST API'sini kullanarak alan başvuru adlarını alabilirsiniz.

İş Öğesi Alan Gezgini

İş Öğesi Alan Gezgini aracını kullanarak alan özniteliklerinin atamalarını arayabilirsiniz.

İş Öğesi Alan Gezgini'ne erişmek için İşlem Düzenleyicisi Aracı'nı yükleyin. Visual Studio'nun yüklü sürümüne bağlı olarak, aşağıdaki uzantılardan birinden İşlem Düzenleyicisi Aracı'nı edinin.

• Visual Studio 2019 ve 2022: Şu andan itibaren, kullanılabilir belirli bir İşlem Şablonu Düzenleyicisi uzantısı yoktur. Ancak, herhangi bir metin düzenleyicisi veya XML düzenleyicisi gibi diğer araçları kullanarak işlem şablonlarını özelleştirmeye devam edebilirsiniz. Özellikle devralınan işlemler için belirli özelleştirmeler için Azure DevOps web portalını da kullanabilirsiniz.
• Visual Studio 2017: TFS İşlem Şablonu Düzenleyicisi. Eski stildeki iş öğesi formlarını değiştirmek için İşlem Düzenleyicisi'nin bu sürümünü de kullanabilirsiniz. Yeni web formlarıyla ilişkili formları düzenlemek için kullanamazsınız.
• Visual Studio 2015: TFS Power Tools.

Alan öznitelikleri

Her iş öğesi alanı için birçok değiştirilemez ve gizli öznitelik vardır. Aşağıdaki tabloda her bir öznitelik açıklanmaktadır. Özniteliklerin adları Alanlar - REST API'yi alma veya İş Öğesi Alan Gezgini (WIFE) aracı aracılığıyla görüntülemenize bağlı olarak farklı adlara sahiptir.

Bir alana atanan öznitelikler, kullandığınız platforma ve sürüme bağlıdır. Örneğin, bazı öznitelikler Devralma işlemiyle desteklenmez. Bir alanın başvuru adını aramak için İş öğesi alan dizinine bakın.

Liste alanı öznitelikleri

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

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

**Returned data:**

> [!div class="tabbedCodeSnippets"]
> ```JSON
> {
> "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"
> }
> ```

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

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

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

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

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  

Alan ekleme ve değiştirme

İlgili makaleler