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

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

İş öğesi alanları, Azure DevOps içindeki bilgileri izlemek için kullanılır. Bu alanlar kuruluş düzeyinde tanımlanır ve kuruluştaki tüm projeler arasında paylaşılır. Kuruluşunuz için tanımlanan alanları gözden geçirmek için, hem Devralınan hem de Barındırılan XML işlem modellerinde kullanılabilen aşağıdaki iki araçdan birini kullanabilirsiniz:

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

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

Önkoşullar

Kategori	Gereksinimler
İzin	Bir kuruluş veya koleksiyon için tanımlanan alanları görüntülemek için: Proje Koleksiyonu Geçerli Kullanıcılar uygulama grubunun üyesi veya örnek seviyesinde bilgi görüntüleme izni, kuruluş veya koleksiyon için İzin Ver olarak ayarlandı.

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.

Araç	Devralma	Barındırılan XML	Şirket içi XML
Web portalı: Devralınan ve özel tanımlı alanları listeleme	✔️	✔️1
İş öğesi alan gezgini	✔️	✔️	✔️
witadmin listfields komut satırı aracı	✔️	✔️	✔️

Not

1. Yalnızca varsayılan işlemler (Çevik, CMMI, Scrum) için desteklenir.

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?

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

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.

Öznitelik

Öznitelik türü

Açıklama

---

REST:
EŞ: AllowedValues

koleksiyonu

Seçim listesi değerleri içeren bir alan için geçerli değerler koleksiyonunu alır. Bir seçim listesi veya genel liste (şirket içi) belirterek bunu değiştirebilirsiniz.
Değişebilir mi?=Evet

REST: canSortBy
EŞİ: CanSortBy

boolean

Sorgu sonuçlarını bu alanla sıralayıp sıralayamayacağınızı gösterir.
Değişebilir mi?=Hayır

REST: açıklama
WIFE: HelpText

Dize

Alan için bir açıklama belirtir. Bu açıklama, çalışma öğesi formundaki alanın üzerine geldiğinizde görüntülenen yardım metnini de tanımlar.
Değişebilir mi?=Evet

REST:
EŞ: Kimlik

Tamsayı

Alanın iç kimliğini belirtir.
Değişebilir mi?=Hayır

REST:
EŞİ: IsCloneable

boolean

Kullanıcı bir iş öğesini kopyalamayı seçtiğinde alan için tanımlanan değerin kopyalanıp kopyalanmayacağını gösterir. Örneğin, Başlık, Etiketler ve Açıklama alanları kopyalanır, ancak Kimlik ve Geçmiş alanları kopyalanmamıştır.
Değişebilir mi?=Hayır

REST:
EŞİ: IsComputed

boolean

Bu alan tarafından ayarlanan değerin sistem tarafından hesaplandığını (True) veya değil (False) gösterir. Hesaplanan alanlara örnek olarak kimlik, Düzeltilmiş Tarih, Değiştirme Tarihi ve Dış Bağlantı Sayısı gibi sistem tarafından ayarlanan alanlar verilebilir.
Değişebilir mi?=Hayır

REST:
EŞİ: IsCoreField

boolean

Bu alanın tüm iş öğesi türleri için belirtilip belirtilmedidiğini gösterir.
Değişebilir mi?=Hayır

REST:
WIFE: IsEditable

boolean

Kullanıcıların bu alanı değiştirip değiştiremediğini (True) veya değiştirip değiştiremediğini (Yanlış) gösterir. Kimlik, Düzeltme, Oluşturan ve Değiştiren alanları gibi sistem tarafından ayarlananlar, değiştirilemez alanlara örnek olarak verilebilir
Değişebilir mi?=Hayır

REST: isIdentity
WIFE: IsIdentity

boolean

Bu alanın bir Kimlik alanı olup olmadığını gösterir. Kimlik alanları, kullanıcı kimliklerini depolamak için kullanılan dize alanlarıdır.
Değişebilir mi?=Hayır

REST:
EŞİ: IsIndexed¹

boolean

Bu alanın aramayı destekleyecek şekilde dizine alınıp alınmadığını gösterir.
Değişebilir mi?=Hayır

REST:
WIFE: IsLongText

boolean

Alanın, Düz Metin, HTML veya Geçmiş veri türü atanmış alanlar gibi 255'ten fazla karakter içerebileceğini gösterir.
Değişebilir mi?=Hayır

REST: isPicklist² WIFE:

Boolean

Alanın bir seçim listesiyle ilişkili olup olmadığını gösterir. Azure DevOps ve Seçim Listesi (Dize) veya Seçim Listesi (Tamsayı) türü için özel bir alan tanımlandığında değer True olarak ayarlanır. Seçim listelerini tanımlayan devralınan alanlar için değer False olarak ayarlanır.
Değişebilir mi?=Hayır

REST: isPicklistSuggested² WIFE:

Boolean

Alanın, kullanıcıların seçim listesi için kendi değerlerini girmesine izin verip vermediğini gösterir. Azure DevOps, Seçim Listesi (Dize) veya Seçim Listesi (Tamsayı) türü için özel bir alan tanımlandığında değer True olarak ayarlanır ve Kullanıcıların kendi değerlerini ayarlamasına izin ver onay kutusu işaretlenir.
Değişebilir mi?=Evet

REST: isQueryable
WIFE: IsQueryable

boolean

Alanın, bir iş öğesi sorgusuna filtre uygulamak için ekleyebileceğiniz alan kümesinde (True) gösterilip gösterilmediğini (Yanlış) gösterir. Çoğu alan sorgulanabilir.
Değişebilir mi?=Hayır

REST:
EŞİ: IsReportable ³

boolean

Raporlanabilir özniteliğin tanımlandığını veya Hiçbiri dışında bir değere ayarlandığını gösterir. Bu öznitelik şirket içi ortamlar için değiştirilebilir.
Değişebilir mi?=Evet

REST:
EŞİ: IsUsedInGlobalWorkflow

boolean

Alanın genel bir iş akışı içinde tanımlandığını gösterir.
Değişebilir mi?=Hayır

REST:
WIFE: IsUserNameField

boolean

Alanın bir Kimlik alanını görüntülemek için kullanılıp kullanılmadiğini gösterir.
Değişebilir mi?=Hayır

REST: name
EŞİ: Ad

Dize

Alana atanan kolay ad. Kolay ad Azure DevOps için değiştirilemez, ancak witadmin changefield komutu kullanılarak şirket içi için değiştirilebilir.
Değişebilir mi?=Yalnızca şirket içi

REST: picklistId
WIFE: HelpText

GUID

Alan bir seçim listesiyse, ilişkili seçim listesinin tanımlayıcısı, aksi takdirde null olur. Azure DevOps ve Seçim Listesi (Dize) veya Seçim Listesi (Tamsayı) türü için özel bir alan tanımlandığında benzersiz bir GUID değeri atanır.
Değişebilir mi?=Hayır

REST:
WIFE: ProhibitedValues

koleksiyonu

Bu tür değerleri belirten bir alan için yasaklanmış değerler koleksiyonunu alır. Yalnızca şirket içi dağıtımlar için yasaklanmış değerler tanımlayabilirsiniz.
Değişebilir mi?=Yalnızca şirket içi

REST: readOnly
KARI:

Boolean

Alanın salt okunur olarak ayarlanıp ayarlanmadığını gösterir. Azure DevOps Services için yalnızca özel alanlar salt okunur olacak şekilde değiştirilebilir. Sistem alanları değiştirilemez.
Değişebilir mi?=Evet

REST: referenceName
WIFE: Başvuru Adı

Dize

Bir alanın başvuru adını belirtir.
Değişebilir mi?=Hayır

REST:
WIFE: ReportingAttributes³

Alanın raporlara eklenmesini isteyip istemediğinize ve nasıl eklenmesini istediğinize bağlı olarak Ayrıntı, Boyut veya Ölçü'yü belirtir. Bu öznitelik için None dışında bir değere sahip alanlardaki veriler veri ambarı'na aktarılır ve SQL raporlarına eklenebilir.
Değişebilir mi?=Yalnızca şirket içi

REST:
WIFE: ReportingName³

Dize

SQL raporlarında veriler görüntülendiğinde alanın etiketini belirtir. Bir değer belirtmezseniz, alanın kolay adı kullanılır.
Değişebilir mi?=Yalnızca şirket içi

REST:
WIFE: ReportingReferenceName³

Dize

Veriler ilişkisel veri ambarı'na aktarıldığında kullanılan bir alana farklı bir başvuru adı belirtir. Bir değer belirtmezseniz, alan başvuru adı kullanılır.
Değişebilir mi?=Yalnızca şirket içi

REST: supportedOperations
KARI:

set

Bu alana başvururken kullanılmak üzere geçerli olan sorgu işleçleri kümesi. Veri türüne göre desteklenen işlemlere hızlı başvuru için bkz . Her veri türü için desteklenen hızlı başvuruyu, İşleçleri ve makroları sorgulama.
Değişebilir mi?=Hayır

REST:
WIFE: SupportsTextQuery

boolean

Alanın Sözcük İçerir, Sözcük İçermiyor gibi metin sorgularını destekleyip desteklemediğini gösterir.
Değişebilir mi?=Hayır

REST:
WIFE: SystemType

Dize

Alanın veri türünü belirtir ve System.DateTime veya System.String gibi sistem adına başvurur.
Değişebilir mi?=Hayır

REST: tür
WIFE: FieldType

Dize

Boole, DateTime, Integer, String gibi alanın veri türünü belirtir. Tam liste ve açıklamalar için bkz . Sorgu alanları, işleçler ve makrolar.
Değişebilir mi?=Hayır

REST: kullanım
WIFE: Kullanım

Dize

Alanın iş öğeleri (WorkItem) veya iş öğesi bağlantısı (WorkItemLink) nesneleriyle kullanılmak üzere tasarlanıp tasarlanmamış olduğunu belirtir. Çoğu alanın kullanımı WorkItem'dir. Kullanım değerlerinin tam listesi için bkz . Alanları Al, FieldUsage.
Değişebilir mi?=Hayır

Not

1. Şirket içi dağıtımlarda, alan üzerinde filtreleme yaparken sorgu yanıt sürelerini iyileştirmek için bir alan için dizin oluşturmayı etkinleştirebilirsiniz. Daha fazla bilgi için bu makalenin devamında yer alan Dizinli alanlar bölümüne bakın.
2. isPicklist ve isPicklistSuggested öznitelikleri yalnızca devralınan bir işlem için tanımlanan özel alanlara atanır. Devralınan işlem modeli, Azure DevOps Server 2019 ve sonraki sürümler için desteklenir. Daha fazla bilgi için bkz . Devralınan işlem modeli.
3. 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.

Liste alanı öznitelikleri

Alanlar - GET REST API'sini kullanarak bir alana atanan öznitelikleri listeleyebilirsiniz. OrganizationName değerini gerçek kuruluşunuzun adıyla değiştirin.

REST

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

Örneğin, Yineleme Yolu özniteliklerini listelemek için System.IterationPath kuruluşun başvuru adını fabrikam kullanın:

REST

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

Alan ekleme ve değiştirme

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.

İlgili makaleler

• Sorgu söz dizimini ve kullanımını hızla anlamak için Sorgu hızlı başvurusuna bakın.
• Kullanılabilir tüm iş öğesi alanlarını görüntülemek için İş öğesi alan dizinini keşfedin.
• Devralınan işlem gereksinimlerinize göre alanları özelleştirmek için devralınan bir işlemin alanlarını ekleyin ve yönetin.
• Analiz meta verilerini ve raporlama özelliklerini anlamak için Azure Boards Analytics için meta veri başvurusuna erişin.