FIELD (Tanım) öğesi başvurusu
Kullandığınız FIELD bir iş öğesi alanı tanımlamak ve uygulamak koşul ve kuralları belirtmek için (tanım) öğesi.Bir alan atamak öznitelikleri bir iş öğesi formunda nasıl göründüğü ve raporlara eklemek için kullanılabilir olup olmadığını belirler.Bir takım projesi koleksiyonu için alan atamalarını kümesini yönetin.Bu nedenle, iş öğesi bir türde tanımlanan alanları atadığınız öznitelikleri koleksiyonunda tüm takım projeleri için iş öğeleri türleri üzerinde eşleşmelidir.Ayrıca, tüm koleksiyonları rapor edilebilir tüm alanları veri ambarı veritabanlarına verilir.
[!NOT]
Hakkında bilgi için FIELD bir durum değişikliği veya iş akışı geçişi sırasında kural ve koşulları alanları belirtmek için kullanın, (iş akışı) öğesi, bakın FIELD (İş Akışı) öğesi.
Bir koleksiyon için varolan alanlar kullanarak yaptığınız öznitelik atamalarını değiştirebilirsiniz witadmin aracı komutu.Daha fazla bilgi için bkz. İş öğesi alanlarını yönetme [witadmin].
Şema hiyerarşisi
FIELD
<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" syncnamechanges ="true | false" reportable="Dimension | Detail | Measure" formula="sum" reportingname="ReportingDisplayName" reportingrefname="ReportingReferenceName" > <ALLOWEDVALUES> . . . </ALLOWEDVALUES> <ALLOWEXISTINGVALUE /> <CANNOTLOSEVALUE /> <COPY /> <DEFAULT /> <EMPTY /> <FROZEN /> <HELPTEXT> . . . </HELPTEXT> <MATCH /> <NOTSAMEAS /> <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES> <READONLY /> <REQUIRED /> <SERVERDEFAULT /> <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES> <VALIDUSER /> <WHEN> . . . </WHEN> <WHENNOT> . . . </WHENNOT> <WHENCHANGED> . . . </WHENCHANGED> <WHENNOTCHANGED> . . . </WHENNOTCHANGED> </FIELD>
Öznitelikler ve Öğeler
Öznitelikler, alt ve üst öğeler aşağıdaki bölümlerde açıklanmaktadır.
Öznitelikler
Öznitelik |
Açıklama |
||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
name |
Gerekli.İş öğesi sorguları aşağı açılan menülerde görünen alanın kolay adı.Takım projesi içinde tanımlanan tüm alanlar boyunca kolay adı benzersiz olmalıdır.Ayrıca, kolay ad alanı iş öğesi formundaki yanında görünür etiketi farklı olabilir.Daha fazla bilgi için bkz. Denetim XML öğesi başvurusu. Öznitelik türü typelib:FieldName.Minimum uzunluk: 1; en fazla uzunluk: 128. Desen değeri: ^ [^ \.\[\]]+$ Desen değeri örneği: atanan |
||||||||||||||||||||
refname |
Gerekli.Takım projesi koleksiyonunda tanımlanan tüm diğer alanlardan bir alan ayırt eden benzersiz etiketi. Ek gereksinimler ve kolay ve başvuru adlarını sınırlamalar için bkz İş Öğesi İzleme Nesneleri için Adlandırma Kuralları. Öznitelik türü typelib:ReferenceFieldName.Minimum uzunluk: 1; en fazla uzunluk: 70. Desen değeri: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [a-zA-Z0-9_] +) + $ Desen değeri örneği: Company.IssueType |
||||||||||||||||||||
type |
Gerekli.Alanın kabul ettiği verinin türünü belirler.
Aşağıdaki tablo bu öznitelik için geçerli değerleri listeler:
|
||||||||||||||||||||
syncnamechanges |
İsteğe bağlı.Çalışma öğesi alanı, Active Directory veya çalışma grubunda yapılan değişiklikler gibi güncelleştirilmesi istediğiniz adlarını depolamak için kullanılıp kullanılmayacağını belirtir.Bu seçenek yalnızca geçerlidir type="String".Öznitelik türü xs:boolean. Belirtin true veri alanı için eşitlemeyi etkinleştirmek için belirtin false veri alanı için eşitlemeyi devre dışı bırakmak için. |
||||||||||||||||||||
reportable |
İsteğe bağlı.Veri alanından raporlara eklemek için kullanılabilir olup olmadığını belirtir.Varsayılan değeri ile alanları None ne ilişkisel veri ambarına dışarı ne de için işlenen SQL Server Analysis Services Küp.Rapor edilebilir alanları hakkında daha fazla bilgi için bkz Raporlamayı desteklemek üzere iş öğesi alanları ekleme veya değiştirme.
Aşağıdaki tablo bu öznitelik için geçerli değerleri listeler:
|
||||||||||||||||||||
formula |
İsteğe bağlı.Toplama türü için measure rapor edilebilir türü.Yalnızca geçerli değer sum, küme üzerinde tüm değerlerin toplamını döndürür. |
||||||||||||||||||||
reportingname |
İsteğe bağlı.Görünen ad raporlarında belirtir.Atanan değeri bir değer belirtmezseniz name özniteliği kullanılır.
Öznitelik türü typelib:FieldName.Minimum uzunluk: 1; en fazla uzunluk: 128. Desen değeri: ^ [^ \.\[\]]+$ Desen değeri örneği: atanan |
||||||||||||||||||||
reportingrefname |
İsteğe bağlı.Rapor edilebilir alan işlenirken kullanılan başvuru adını belirtir.Atanan değeri bir değer belirtmezseniz refname özniteliği kullanılır. Bu öznitelik, birleştirme ya da veri ambarına işlenen alanları ayırmak için kullanabilirsiniz.Farklı başvuru adları ve farklı proje koleksiyonlarında tanımlanmış iki alanı birleştirmek için aynı atadığınız reportingrefname ikisini de için.Aynı başvuru adına sahip ancak farklı proje koleksiyonlarında tanımlanmış iki alanı ayırmak için farklı bir atamanız reportingrefname her alana. Birleştirme alanları mümkün olduğunda alanları veri ambarında sayısını en aza indirmek ve sınırını 1024 rapor edilebilir alanların altında tutmak için.Birleştirilmiş raporlarla çapraz grup raporları oluşturulmasına neden olabilir. Öznitelik türü typelib:ReferenceFieldName.Minimum uzunluk: 1; en fazla uzunluk: 70. Desen değeri: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [a-zA-Z0-9_] +) + $ Desen değeri örneği: Company.IssueType |
Alt Öğeler
Öğe |
Açıklama |
|---|---|
İsteğe bağlı.Alan için izin verilen değerler listesini tanımlar.Sorgu Oluşturucu ve iş öğesi formları bir alan listesinden seçim için kullanılabilir olan değerler izin verilen değerler.Bu değerlerden birini seçmelisiniz. |
|
İsteğe bağlı.Varolan değerlere izin vermek üzere alanı tanımlar.Bu öğe geçerli olmasa bile, kullanılacak, zaten varolan alan değerlerini sağlar.Tüm yeni alan değerlerini geçerli olması gerekir. |
|
İsteğe bağlı.Alanın değeri kaybedersiniz olamaz gibi tanımlar.Bu öğe geçerli alan değeri tutar ve bu temizlenemez veya boş yapılan. |
|
İsteğe bağlı.Geçerli alana kopyalamak için bir değer içeren başka bir alan belirtir. |
|
İsteğe bağlı.Alan için varsayılan bir değer tanımlar. |
|
İsteğe bağlı.Alanı boş olarak tanımlar. |
|
İsteğe bağlı.Alanı donuk olarak tanımlar.Değişiklikler kaydedildikten sonra dondurulmuş bir alan herhangi bir boş değer değiştirilemez.Ancak, alan el ile temizleyin, iş öğesini kaydetmek ve ardından farklı bir değer belirtin. |
|
İsteğe bağlı.Alan için araç ipucunda görüntülenen metin tanımlar. |
|
İsteğe bağlı.Alan değeri eşleşmesi gereken alan için bir desen tanımlar. |
|
İsteğe bağlı.Değerini geçerli alanının değeri için aynı olamaz, başka bir alan belirtir. |
|
İsteğe bağlı.Yasak değerleri alan için bir listesini tanımlar. |
|
İsteğe bağlı.Alan salt okunur olarak tanımlar. |
|
İsteğe bağlı.Alanı gerekli olarak tanımlar. |
|
İsteğe bağlı.Değer alanı için sağlayacak bir sunucu bileşeni belirtir. |
|
İsteğe bağlı.Alan için önerilen değerleri listesini tanımlar.Önerilen değerler Sorgu Tasarımcısı ve iş öğesi formları bir alan listesinden seçim için kullanılabilir olan değerlerdir.Ayrıca listesinde olanları için diğer değerler girebilirsiniz. |
|
İsteğe bağlı.İzin verilen değerler listesi yalnızca sistem geçerli kullanıcılar oluşması gerektiğini belirtir. |
|
İsteğe bağlı.Başka bir alan belirli bir değere sahip olduğunda mevcut alana uygulanacak bir veya daha fazla kural belirtir. |
|
İsteğe bağlı.Belirli bir alanın değeri değiştiğinde geçerli alana bir veya daha fazla kuralı uygular. |
|
İsteğe bağlı.Başka bir alan belirli bir değere sahip olmadığı durumlarda geçerli alana bir veya daha fazla kuralı uygular. |
|
İsteğe bağlı.Belirli bir alanın değeri değil değiştiğinde geçerli alana bir veya daha fazla kuralı uygular. |
Üst Öğeler
Öğe |
Açıklama |
|---|---|
Gerekli.İş öğesi türü alan tanımlarını içerir. |
Notlar
FIELD(Tanım) bir öğedir gerekli bir alt FIELDS (tanım).
minOccurs = "1"
Tüm takım projesi koleksiyonları rapor edilebilir en fazla 1024 alanlar belirleyebilirsiniz ve takım projesi koleksiyonunda birden fazla 1024 iş öğesi alanları tanımlayabilirsiniz.Daha fazla bilgi için bkz. Raporlamayı desteklemek üzere iş öğesi alanları ekleme veya değiştirme.
[!NOT]
Farklı bir iş öğesi türü için varolan bir alan eklediğinizde, rapor edilebilir öznitelikler için geçerli değerleri kullanılır.
Ek gereksinimler ve alan dostu ve başvuru adlarını sınırlamalar için bkz İş Öğesi İzleme Nesneleri için Adlandırma Kuralları.Etiket alanlarının raporlama amaçları için nasıl kullanılacağı hakkında daha fazla bilgi için bkz Raporlamayı desteklemek üzere iş öğesi alanları ekleme veya değiştirme.
İle başlar özel bir alan tanımlayamaz System. öneki.Kullanarak bir alan tanımlayabilirsiniz Microsoft. önek, çünkü engel ancak, bu yöntem kesinlikle önerilmez Team Foundation Server işlevselliği.
Alan çalışma öğesi izleme nesnesi bir bakış için bkz: İş öğesi alanlarını tanımlama ve değiştirme.
Tüm sistem ve TFS işlem şablonları için tanımlanan önceden tanımlı alanların bir bakış için bkz: Visual Studio ALM için çalışma öğesi alanı başvurusu.
Alan başvuru adları yeniden adlandırılamaz.Listesinde alanları, alan kolay adı yeniden adlandır ve kullanarak alan özniteliklerini değiştirebilirsiniz witadmin komut satırı aracı.Daha fazla bilgi için bkz. İş öğesi alanlarını yönetme [witadmin].
Ekip projesi koleksiyonlarındaki alanları nasıl kullanıldığı hakkında daha fazla bilgi için bkz Veri ambarında oluşan şema çakışmalarını çözümleme ve Raporlamayı desteklemek üzere iş öğesi alanları ekleme veya değiştirme.
Örnek
<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
<HELPTEXT>Type of work involved</HELPTEXT>
<SUGGESTEDVALUES>
<LISTITEM value="Development"/>
<LISTITEM value="Testing"/>
<LISTITEM value="Requirements"/>
<LISTITEM value="Design"/>
<LISTITEM value="Deployment"/>
<LISTITEM value="Documentation"/>
</SUGGESTEDVALUES>
</FIELD>
Ayrıca bkz.
Başvuru
İş öğesi alanlarını yönetme [witadmin]
Kavramlar
İş Öğesi İzleme Nesneleri için Adlandırma Kuralları
Visual Studio ALM için çalışma öğesi alanı başvurusu
İş izleme nesnelerini, ekibinizin süreçlerini destekleyecek şekilde özelleştirme
İş öğesi alanlarını tanımlama ve değiştirme