Aracılığıyla paylaş


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

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

İş öğesi alanları, Azure DevOps içindeki bilgileri izler. Sistem bu alanları kuruluş düzeyinde tanımlar ve kuruluştaki tüm projelerde paylaşı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:

İş öğesi alanları, Azure DevOps içindeki bilgileri izler. Sistem bu alanları koleksiyon düzeyinde tanımlar ve bunları bu koleksiyondaki tüm projelerde paylaşır. Koleksiyonunuz için tanımlanan alanları gözden geçirmek için aşağıdaki araçlardan birini kullanın:

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

İş öğesi alanlarının neden önemli olduğu

İş öğesi alanları, Azure DevOps'ta birkaç kritik işleve hizmet sağlar:

  • Veri izleme: İş öğeleriyle ilgili temel bilgileri yakalama ve depolama
  • Sorgu işlevselliği: Güçlü arama ve filtreleme özelliklerini etkinleştirme
  • Raporlama: Analiz ve pano oluşturma desteği
  • İş akışı yönetimi: Durum geçişlerini ve iş kurallarını yönetme
  • Tümleştirme: Dış araçlar ve sistemlerle bağlanma

Alan özniteliklerini anlamanıza yardımcı olur:

  • Sorguları iyileştirme: Verimli aramalar için doğru alanları seçin
  • Özelleştirmeleri planlama: Sınırlamaları ve olasılıkları anlama
  • Sorunları giderme: Alan davranışıyla ilgili sorunları tanılama
  • Tasarım süreçleri: Etkili iş öğesi türleri ve iş akışları oluşturma

Prerequisites

Category Requirements
Permissions 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.

Tool Inheritance 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ı ✔️ ✔️ ✔️

Note

  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ı tanımlayan üç anahtar özniteliği:

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, kullanıcı hikayeleri, sorunlar, hatalar, özellikler ve destanlarla çalışmayı takip etmeye bakınız.

Alan nedir? Alan adları nasıl çalışır?

Her iş öğesi türü 31 sistem alanı ve türe özgü birkaç alan içerir. İş öğeleri projenizi planlamanıza ve izlemenize yardımcı olur.

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 adlandırma gereksinimleri

İş öğ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: .,;':~/*|?" &%$!+=()[]{}<>'.

Sistem kuruluş veya koleksiyon düzeyinde özel alanlar tanımladığı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

Sistem, tutarlılık ve işlevsellik sağlamak için belirli adlandırma ve yapısal gereksinimlere sahip iş öğesi alanlarını tanımlar:

  • 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: .,;':~/*|?" &%$!+=()[]{}<>'.

Sistem kuruluş veya koleksiyon düzeyinde özel alanlar tanımladığı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

Sistem, kuruluş veya proje koleksiyonu düzeyinde özel alanlar tanımladığı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 depolayabileceğiniz 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 bir sürece özel bir alan eklediğinizde, Azure DevOps, "Özel" ön ekiyle ve alan adının boşluksuz birleştirilmesiyle oluşan bir başvuru adı atar. Örneğin, DevOps Triage adlı bir alan eklemek, Custom.DevOpsTriage başvuru adının oluşmasına neden olur. 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.

Kuruluş Ayarları, İşlem, Alanlar sayfasının ekran görüntüsü.

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.

Koleksiyon Ayarları, İşlem, Alanlar sayfasının ekran görüntüsü.

Proje koleksiyonunuz Şirket İçi XML işlem modelini kullanıyorsa, veri türünü İş öğesi alan dizini aracılığıyla belirleyebilirsiniz. Alternatif olarak şunları da yapabilirsiniz:

  • Tanımlı alanları ve bunların özniteliklerini gözden geçirmek için İş Öğesi Alan Gezgini'ni açın.
  • Alan özniteliklerini listelemek için witadmin listfields komutunu kullanın.

Daha fazla bilgi için bu makalenin devamında yer alan İş Öğesi Alan Gezgini ve Liste alanı öznitelikleri bölümüne bakın.

Alan listesini gözden geçirme

Bir kuruluş veya koleksiyon için tanımlanan alanların listesini gözden geçirmek için şu adımları izleyin:

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

    Kuruluş Ayarlarını Seç seçeneğinin ekran görüntüsü.

  2. İşlem'i seçin.

    Choose Process'ın ekran görüntüsü.

  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.

    Seçili devralınan işlemin kopyasını oluşturma işleminin ekran görüntüsü.

    Note

    Alanları görmüyorsanız, koleksiyonunuz Şirket İçi XML işlemini kullanıyor. 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ı Keşfi

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

İş öğesi alan gezgininin ekran görüntüsü.

İş Öğ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 isimleri, onları Alanlar - Get REST API aracılığıyla almanıza veya İş Öğesi Alan Gezgini (WIFE) aracı aracılığıyla görüntülemenize bağlı olarak farklılık gösterir.

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.

Attribute

Öznitelik türü

Description


REST:
EŞ: AllowedValues

collection

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: Yardım Metni

string

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

Integer

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 sistemin alan için tanımlanan değeri kopyalayıp kopyalamadığını gösterir. Örneğin, sistem Başlık, Etiketler ve Açıklama alanlarını kopyalar, ancak Kimlik ve Geçmiş alanlarını kopyalamaz.
Değişebilir mi?=Hayır

REST:
EŞİ: IsComputed

boolean

Sistemin alanın belirttiği değeri (True) hesaplayıp hesaplamadığını (False) gösterir. Hesaplanan alanlara örnek olarak kimlik, Düzeltilmiş Tarih,Değiştirme Tarihi ve Dış Bağlantı Sayısı gibi sistemin ayarlandığı 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: Düzenlenebilir

boolean

Kullanıcıların bu alanı değiştirip değiştiremeyeceğini (Evet) veya değiştiremeyeceğini (Hayır) gösterir. Sistemin ayarladığı, değiştirilemez alanlara örnek olarak Kimlik, Düzeltme, Oluşturan ve Değiştiren alanları 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Şİ: IsIndexed1

boolean

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

REST:
Eş: 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: isPicklist2 EŞ:

Boolean

Alanın bir seçim listesiyle ilişkilendirilip ilişkilendirmediğini gösterir. Azure DevOps için özel bir alan tanımlayıp Seçim Listesi (Dize) veya Seçim Listesi (Tamsayı) türünü seçtiğinizde sistem değeri True olarak ayarlar. Sistem, seçim listelerini tanımlayan devralınan alanlar için değeri False olarak ayarlar.
Değişebilir mi?=Hayır

REST: isPicklistSuggested2 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 için özel bir alan tanımladığınızda sistem değeri True olarak ayarlar, Seçim Listesi (Dize) veya Seçim Listesi (Tamsayı) türünü seçin ve Kullanıcıların kendi değerlerini ayarlamasına izin ver onay kutusunu işaretleyin.
Değişebilir mi?=Evet

REST: isQueryable
EŞ: IsQueryable

boolean

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

REST:
EŞİ: IsReportable 3

boolean

Raporlanabilir özniteliğin tanımlanıp tanımlanmadığını veya Hiçbiri dışında bir değere ayarlanıp ayarlanmadığını gösterir. Şirket içi ortamlar için bu özniteliği değiştirebilirsiniz.
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:
EŞ: 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

string

Alana atanan tanımlayıcı ad. Azure DevOps'un kolay adını değiştiremezsiniz, ancak witadmin changefield komutunu kullanarak şirket içi için bu adı değiştirebilirsiniz.
Değişebilir mi?=Yalnızca şirket içi

REST: picklistId
WIFE: Yardım Metni

GUID

Alan bir seçim listesi ise, ilişkili seçim listesinin tanımlayıcısı; aksi takdirde, sonuç null olur. Azure DevOps için özel bir alan tanımlayıp Seçim Listesi (Dize) veya Seçim Listesi (Tamsayı) türünü seçtiğinizde sistem benzersiz bir GUID değeri atar.
Değişebilir mi?=Hayır

REST:
WIFE: YasaklıDeğerler

collection

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
WIFE:

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: Referans Adı

string

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

REST:
EŞ: RaporlamaÖznitelikleri3

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

REST:
WIFE: RaporlamaAdı3

string

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

REST:
WIFE: ReportingReferenceName3

string

Sistemin verileri ilişkisel veri ambarı'na aktarırken kullandığı alana farklı bir başvuru adı belirtir. Bir değer belirtmezseniz, sistem alan başvuru adını kullanır.
Değişebilir mi?=Yalnızca şirket içi

REST: desteklenenİşlemler
WIFE:

set

Bu alana başvururken kullanılmak üzere geçerli olan sorgu işleçleri koleksiyonu. Veri türüne göre desteklenen işlemler hakkında hızlı bir başvuru yapmak için Sorgu hızlı başvuru, her veri türü için desteklenen işleçler ve makrolar sayfasına bakın.
Değişebilir mi?=Hayır

REST:
WIFE: MetinSorgusunuDestekler

boolean

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

REST:
KADIN: SystemType

string

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
EŞ: FieldType

string

Alanın veri türünü, örneğin Boolean, DateTime, Integer, String gibi, 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

string

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

Note

  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. Sistem isPicklist ve isPicklistSuggested özniteliklerini yalnızca devralınan bir işlem için tanımlanan özel alanlara atar. Devralınan işlem modeli Azure DevOps Server 2020 ve sonraki sürümleri destekler. 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.

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:

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.

Alanlarla çalışmak için en iyi yöntemler

İş öğesi alanlarıyla çalışırken şu önerileri göz önünde bulundurun:

Alan seçimi ve tasarımı

  • Anlamlı adlar seçin: Amaçlarını açıkça belirten açıklayıcı alan adları kullanın
  • Adlandırmayı standartlaştırma: Kuruluşunuz genelinde tutarlı adlandırma kuralları oluşturma
  • Özel alanları sınırlama: Aşırı kullanıcılardan kaçınmak için özel alanları rastgele ekleyin
  • Veri türlerini göz önünde bulundurun: Depoladığınız bilgiler için uygun veri türlerini seçin

Performans iyileştirme

  • Dizine alınan alanları kullanma: Şirket içi dağıtımlar için sık sorgulanan özel alanların dizinini oluşturmayı göz önünde bulundurun
  • Yoğun sorgulardan kaçının: Birçok alan filtresi kullanırken sorgu performansına dikkat edin
  • Seçim listelerini iyileştirme: Seçim listesi değerlerini yönetilebilir boyutta ve iyi düzenlenmiş olarak tutun

Bakım ve idare

  • Belge alanı kullanımı: Özel alanların amacını ve kullanımını açıklayan belgeleri koruyun
  • Düzenli olarak gözden geçirme: Kullanılmayan veya yedekli alanları belirlemek için özel alanları düzenli aralıklarla gözden geçirin
  • Değişiklikleri planlama: Alan değişikliklerinin var olan iş öğeleri ve sorgular üzerindeki etkisini göz önünde bulundurun
  • Test değişiklikleri: Her zaman önce geliştirme ortamında alan değişikliklerini test edin

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.

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

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.

Alan sorunlarını giderme

İş öğesi alanlarıyla çalışırken karşılaşılan yaygın sorunlar ve çözümler:

Alan görünürlüğü sorunları

  • Alan görünmüyor: Alanın iş öğesi türü düzenine eklenip eklenmediğini kontrol edin
  • İzin sorunları: Alanları görüntülemek veya düzenlemek için uygun izinlere sahip olduğunuzu doğrulayın
  • İşlem farklılıkları: Alanın geçerli işlemde mevcut olduğundan emin olun

Sorgu ve arama sorunları

  • Alan sorgulanamaz: Alanın özelliğini denetleyin IsQueryable
  • Performans sorunları: Sık sorgulanan özel alanların (şirket içi) dizinini oluşturmayı göz önünde bulundurun
  • İşleç sınırlamaları: Alan veri türü için hangi işleçlerin desteklendiğini doğrulayın

Veri girişi ve doğrulama

  • Geçersiz değerler: Alanda izin verilen değerlerin veya doğrulama kurallarının kısıtlanmış olup olmadığını denetleyin
  • Salt okunur alanlar: Alanın IsEditable özniteliğini doğrulama
  • Biçim gereksinimleri: Verilerin beklenen alan veri türüyle eşleştiğinden emin olun