Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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:
- İşlem > Alanları web sayfası: Devralınan işlem modeli için kullanılabilir.
- İş Öğesi Alan Gezgini: Devralınan ve Şirket İçi XML işlem modellerinde kullanılabilir.
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
- 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:
- Veri türü: Boole, Çift, Tamsayı, HTML veya Dize gibi alana girebileceğiniz 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.
- Kullanıcı dostu ad: Sorgu yan tümcesinde bir Alan seçilirken kullanılan ve alana atanmış olan ad. Bu ad, iş öğesi formunda görüntülenen addan farklı olabilir.
- Başvuru adı: WIQL sorguları, iş öğesi şablonları oluştururken, REST API komutlarını yürütürken veya XML iş öğesi türü tanımlarını 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, 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.
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.
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:
Projeler'i
açmak için Azure DevOps logosunu seçin. Ardından Kuruluş ayarları'nı seçin.
İşlem'i seçin.
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.
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 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
- Ş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.
- 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.
- 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.
- 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.
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
İlgili içerik
- Sorgu sözdizimini ve kullanımını hızlı bir şekilde anlamak için sorgu hızlı başvuru kılavuzu.
- İş öğesi alan dizini kullanılabilir tüm iş öğesi alanlarını görüntülemek için.
- Devralınan işlem gereksinimlerinize göre alanları özelleştirmek için devralınan bir işlemin alanlarını ekleyin ve yönetin.
- Azure Boards Analytics için Metadata başvurusu, analiz meta verilerini ve raporlama özelliklerini anlamak için.
- Sorgu sözdizimini ve kullanımını hızlı bir şekilde anlamak için sorgu hızlı başvuru kılavuzu.
- İş öğesi alan dizini kullanılabilir tüm iş öğesi alanlarını görüntülemek için.
- İhtiyaçlarınıza uygun işlem modelini seçmek için proje koleksiyonunuz için işlem modelini seçin.
- İş öğesi alanını projenizin gereksinimlerine göre değiştirin.
- Gelişmiş alan yönetimi görevlerini gerçekleştirmek için witadmin kullanarak iş öğesi alanlarını yönetin.
- Azure Boards Analytics için Metadata başvurusu, analiz meta verilerini ve raporlama özelliklerini anlamak için.