ALAN (Tanımlama) Öğesi

Bir iş öğesi alanını tanımlamak ve ona uygulanacak olan kural ve koşulları belirlemek için FIELD (Tanımlama) öğesini kullanın. Bir alana atadığınız öznitelikler, bir iş öğesi formunda nasıl belirdiğini ve raporlara eklemek için kullanılabilir olup olmadığını belirler. Bir takım projesi koleksiyonu için alan atamalarını yönetin. Bu yüzden, bir tür iş öğesinde tanımlanan alanlara atadığınız öznitelikler, bir koleksiyon içinde bulunan iş öğesi türleri üzerinde eşleşmelidir. Ayrıca, tüm koleksiyonların bütün raporlanabilir alanları veri ambarı veritabanlarından dışarı aktarılır.

Not

Bir durum değişikliği veya iş akışı geçişi sırasında alanlara uygulanan kural ve koşulları belirlemek için kullandığınız FIELD (İş Akışı) öğesi hakkında daha fazla bilgi için bkz. ALAN (İş akışı) Öğesi.

witadmin komut aracını kullanarak, bir koleksiyon için varolan alanlara yaptığınız öznitelik atamalarını değiştirebilirsiniz. Daha fazla bilgi için bkz. İş Öğesi Alanlarını Yönetme [witadmin].

Şema Hiyerarşisi

WITD

   WORKITEMTYPE

      FIELDS

            FIELD

<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>

<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 ögeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik	Tanımlama
name	Gerekli. Çalışma öğesi sorgularının açılan menüsünde görünen alanın kolay adı. Kolay ad, bir takım projesinde tanımlanan tüm alanlar boyunca benzersiz olmalıdır. Ayrıca, yakın ad, iş öğesi formundaki alanın yanında görünen etiketten farklı olabilir. Daha fazla bilgi için bkz. Denetim XML Öğesi Başvurusu. Öznitelik türü typelib:FieldName'dir. En az uzunluk: 1; en fazla uzunluk: 128. Desen değeri: ^[^\. \[\]]+$ Desen değeri örneği: Atanan
refname	Gerekli. Takım proje koleksiyonunda tanımlanan tüm diğer alanlardan bir alan ayıran benzersiz etiketi. Kolay adlarda ve başvuru adlarında ek gereksinimler ve sınırlamalar için bkz. İş Öğesi İzleme Nesneleri için Adlandırma Kuralları. Öznitelik türü typelib:ReferenceFieldName'dir. En az 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. Not Aynı reportingrefname içeren farklı proje koleksiyonlarındaki alanlara type için aynı değer atanmalıdır.Değerler farklıysa, veri ambarı işlendiğinde veri çakışmaları ortaya çıkabilir.Daha fazla bilgi için bkz. Veri Ambarında Oluşan Şema Çakışmalarını Çözümleme. Aşağıdaki tablo bu öznitelik için geçerli değerleri listeler: ValueKullanım DateTime Eşgüdümlü Evrensel Saat (UTC)'e göre tarihi belirtir. Double Kayan nokta değerini belirtir. GUID Benzersiz tanımlayıcı içerecek bir alanı belirtir. History Tartışma zincirlerini destekler ve diğer geçmiş bilgilerini izler. Not Yalnız System.History alanı bu veri türünü kullanır.Bu veri türünü kullanarak özel bir alan tanımlayamazsınız. HTML Zengin metin verisi yakalamayı destekler ve çalışma öğesi tanımlaması gibi uzun metin tanımlamaları için kullanılır. Integer 32 Bitlik işaretli tamsayı değeri belirtir. PlainText 255'ten fazla Unicode karakter içeren bir metin dizesi girdisini destekler. String En fazla 255 Unicode karakter içeren bir metin dizesi girdisini destekler.Bir etiket veya en fazla bir satır uzunluğunda diğer kısa bir metin dizesi için String (dize) alanını kullanın. TreePath Bir ürün için alan ve yineleme yollarını görüntülemeye yarayan gereksinimler gibi bir hiyerarşik veya ağaç yapısı içinde girdileri görüntüleyen alanı belirtir.Alt düğümleri tanımlamak için bkz: Alanlar ve Yinelemeler Oluşturma ve Değiştirme. Not Yalnız System.AreaPath ve System.IterationPath alanları bu veri türünü kullanır.Bu veri türünü kullanarak özel bir alan tanımlayamazsınız.
syncnamechanges	İsteğe Bağlı. Active Directory'de veya bir Çalışma alanında değişiklikler yapıldıkça güncellenmesini istediğiniz adları iş öğesi alanının tutup tutmayacağını belirtir. Bu seçenek sadece type="String" olduğunda geçerlidir. Öznitelik türü xs:boolean'dir. Veri alanı için eşitlemeyi etkinleştirmek için true 'yu belirtin, veri alanı için eşitlemeyi devre dışı bırakmak için false'u belirtin.
reportable	İsteğe Bağlı. Alandaki verilerin raporlara eklenmek üzere kullanılabilir olup olmadığını belirtir. None varsayılan değerine sahip alanlar, ilişkisel veri deposu için dışarı aktarılmaz ya da SQL Server Çözümleme Hizmetleri küpü için işlenmez. Raporlanabilir alanlar hakkında daha fazla bilgi için bkz. Raporlamayı Desteklemek Üzere Çalışma Öğesi Alanları Ekleme ve Değiştirme. Not Aynı reportingrefname değerini içeren farklı proje koleksiyonlarındaki alanlara reportable için aynı değer atanmalıdır.Değerler farklıysa, veri ambarı işlendiğinde veri çakışmaları ortaya çıkabilir.Daha fazla bilgi için bkz. Veri Ambarında Oluşan Şema Çakışmalarını Çözümleme. Aşağıdaki tablo bu öznitelik için geçerli değerleri listeler: Value Kullanım Detail DateTime, Double, Integer veya String türündeki alanlar için belirlenebilir. Bu alandaki veri, İş Öğesi ve Geçerli İş Öğesi tablolarındaki ilişkisel ambar veritabanına taşındığını ancak Çözümleme Hizmetleri küpüne taşınmadığını belirtir.Kısıtlamasız metin alanları için bu tür iyi bir seçimdir, çünkü küpü önemli ölçüde büyütmeden onları raporlarda kullanabilirsiniz. Dimension DateTime, Double, Integer veya String türündeki alanlar için belirlenebilir. Bu alandaki veri, ilişkisel ambar veritabanını ve Çözümleme Hizmetleri küpünü, verinin raporları filtreleyebilmesi için İş Öğesi boyutunun bir özniteliği olarak girer.Bu türü geçerli değerler listeleri olan alanlar için kullanın.Çalışma Öğesi Türü ve Durum, boyut için iyi örneklerdir. Measure Ölçü türünü, yalnızca Integer (tamsayı) ve Double alanları için kullanın.Ölçüler, raporlarınızdaki sayısal değerlerdir.Çözümleme Hizmetleri küpü işlendiğinde, reportable öznitelikleri ölçüye uygun ayarlanmış alanlardaki veri önceden hesaplanmıştır.Örneğin, İş Öğesi ve Geçerli İş Öğesi ölçüm grupları aşağıdaki alanlar için toplu verileri içerir: Orijinal Tahmin, Kalan Saatler ve Tamamlanan Saatler.Ölçü belirttiğinizde, formula özniteliğini belirtmelisiniz. None Alanı raporlara dahil etmek için kullanmak istemediğinizde, None öğesini belirtin.Bu varsayılan atamadır.
formula	İsteğe Bağlı. measure raporlanabilir türü için yığılma türü. Geçerli olan tek değer sum'dır, bu küme üzerindeki bütün değerlerin toplamını döndürür.
reportingname	İsteğe Bağlı. Raporlarda görünen adı belirtir. Değer belirtmezseniz, name özniteliğine atanmış değer kullanılır. Not Aynı reportingrefname içeren farklı proje koleksiyonlarındaki alanlara reportingname için aynı değer atanmalıdır.Değerler farklıysa, veri ambarı işlendiğinde veri çakışmaları ortaya çıkabilir.Daha fazla bilgi için bkz. Veri Ambarında Oluşan Şema Çakışmalarını Çözümleme. Öznitelik türü typelib:FieldName'dir. En az 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. Değer belirtmezseniz, refname özniteliğine atanmış değer kullanılır. Bu özniteliği veri ambarında işlenen alanları birleştirmek ya da ayırmak için kullanabilirsiniz. Farklı başvuru adları taşıyan ve farklı proje koleksiyonlarında tanımlanmış iki alanı birleştirmek için, her ikisine de aynı reportingrefname öğesini atayın. Aynı adı taşıyan fakat farklı proje koleksiyonlarında tanımlanmış iki alanı ayırmak için, her bir alana farklı bir reportingrefname atayın. Depodaki alan sayısını mümkün olduğunca aza indirmek ve raporlanabilir en fazla alan sayısı sınırını 1024'ün altında tutmak için alanları birleştirmeniz gerekir. Birleştirilmiş raporlarla çapraz grup raporları oluşturabilirsiniz. Öznitelik türü typelib:ReferenceFieldName'dir. En az 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

Öge	Tanımlama
ALLOWEDVALUES	İsteğe Bağlı. Alan için izin verilen değerlerin bir listesini tanımlar. İzin verilen değerler, iş ögesi formlarındaki alan listesinde ve sorgu tasarımcısında seçim için kullanılabilir değerlerdir. Bu değerlerden birini seçmelisiniz.
ALLOWEXISTINGVALUE	İsteğe Bağlı. Varolan değerlere izin vermek üzere alanı tanımlar. Bu öğe mevcut alan değerlerinin geçerli olmasalar bile kullanımına izin verir. Bütün yeni alan değerleri geçerli olmak zorundadır.
CANNOTLOSEVALUE	İsteğe Bağlı. Alanı değer kaybedemez şeklinde tanımlar. Bu öğe güncel alan değerini tutar, temizlenemez veya boşaltılamaz.
copy	İsteğe Bağlı. Güncel alana kopyalanmak üzere olan bir değeri içeren başka bir alan belirtir.
DEFAULT	İsteğe Bağlı. Alan için varsayılan bir değer tanımlar.
BOŞ	İsteğe Bağlı. Bir alanı boş olarak tanımlar.
FROZEN	İsteğe Bağlı. Bir alanı donuk olarak tanımlar. Donuk bir alan, değişiklikler uygulandıktan sonra sıfır dışında bir değere değiştirilemez. Fakat, alanı elle temizleyebilir, iş ögesini kaydedebilir ve daha sonra farklı bir değer belirleyebilir.
HELPTEXT	İsteğe Bağlı. Alan için Araç ipucunda gösterilen metni tanımlar.
MATCH	İsteğe Bağlı. Alan değerinin eşleşmek zorunda olduğu bir desen tanımlar.
NOTSAMEAS	İsteğe Bağlı. Değeri güncel alanın değeriyle aynı olamayacak başka bir alan belirtir.
YASAKLANAN DEĞERLER	İsteğe Bağlı. Alan için yasaklanmış değerlerin bir listesini tanımlar.
SALTOKUNUR	İsteğe Bağlı. Bir alanı salt okunur olarak tanımlar.
REQUIRED	İsteğe Bağlı. Bir alanı gerekli olarak tanımlar.
SERVERDEFAULT	İsteğe Bağlı. Alan için değer sağlayacak olan bir sunucu bileşeni belirtir.
SUGGESTEDVALUES	İsteğe Bağlı. Alan için önerilen değerlerin bir listesini tanımlar. Önerilen değerler, iş ögesi formlarındaki alan listesinde ve sorgu tasarımcısında seçim için kullanılabilir değerlerdir. Listedekilere ek olarak diğer değerleri girebilirsiniz.
VALIDUSER	İsteğe Bağlı. İzin verilen değerler listesinin sadece sistemin geçerli kullanıcılarından oluşması gerektiğini belirtir.
WHEN	İsteğe Bağlı. Diğer bir alan özel bir değere sahip olduğunda mevcut alana uygulanacak bir ya da daha fazla kuralı belirler.
DEĞİŞTİRİLMEZAMANI	İsteğe Bağlı. Belirli bir alanın özel değeri değiştiğinde mevcut alana bir ya da daha fazla kuralı uygular.
WHENNOT	İsteğe Bağlı. Diğer bir alan özel bir değere sahip olmadığında mevcut alana bir ya da daha fazla kuralı uygular.
WHENNOTCHANGED	İsteğe Bağlı. Belirli bir alanın özel değeri değişmediğinde mevcut alana bir ya da daha fazla kuralı uygular.

Üst Öğeler

Öge	Tanımlama
FIELDS	Gerekli. İş öğesi türü alan tanımlarını içerir.

Notlar

FIELD (Tanımlama) FIELDS (Tanımlama) için gerekli bir alt öğedir.

minOccurs="1"

Aynı takım projesi koleksiyonunda 1.024'ten fazla iş öğesi alanı tanımlayamazsınız ve tüm takım projesi koleksiyonlarında 1.024'ten fazla alanı rapor edilebilir olarak ayarlayamazsınız. Daha fazla bilgi için bkz. Raporlamayı Desteklemek Üzere Çalışma Öğesi Alanları Ekleme ve Değiştirme.

Not

Varolan bir alanı farklı bir çalışma öğesine eklediğinizde, raporlanabilir öznitelikler için geçerli değerler kullanılır.

Alan kolaylığı olan adlarda ve başvuru adlarında ek gereksinimler ve sınırlamalar için, bkz. İş Öğesi İzleme Nesneleri için Adlandırma Kuralları. Raporlama amacıyla etiket alanlarının nasıl kullanılacağı hakkında bilgi için bkz. Raporlamayı Desteklemek Üzere Çalışma Öğesi Alanları Ekleme ve Değiştirme.

System. ön ekiyle başlayan özel bir alan tanımlayamazsınız. Microsoft. ön ekini kullanarak bir alan tanımlayabilirsiniz, bununla birlikte, bu işlem güçlü bir şekilde caydırılır çünkü Team Foundation Server işlevselliğini engelleyebilir.

Alan iş öğesi izleme nesnesine genel bir bakış için, bkz. Çalışma Öğesi Alanları ile Çalışma.

Tüm sistem ve Çevik Yazılım Geliştirme v5.0 işlem şablonu MSF'si (Microsoft Solutions Framework) için tanımlanan önceden tanımlı alanların genel bakışı için, bkz. Visual Studio ALM için Çalışma Öğesi Alan Başvurusu.

Alan başvuru adları yeniden adlandırılamazlar. Alanları listeleyebilir, alanda kullanılan adı değiştirebilir ve witadmin komut satırı aracını kullanarak alan özniteliklerini değiştirebilirsiniz. Daha fazla bilgi için bkz. İş Öğesi Alanlarını Yönetme [witadmin].

Alanların ekip proje koleksiyonları arasında nasıl kullanıldığı konusunda bilgi için bkz. Veri Ambarında Oluşan Şema Çakışmalarını Çözümleme ve Raporlamayı Desteklemek Üzere Çalışma Öğesi Alanları Ekleme ve 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

Proje İzleme Verilerini, Formları, İş Akışını ve Diğer Nesneleri Özelleştirme

Çalışma Öğesi Alanları ile Çalışma

Diğer Kaynaklar

Çalışma Öğesi Türleri için XML Öğe Tanımlarının Dizini