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

Çalışma öğesi alanlarını, raporlar üretmenin yanısıra, çalışma öğesi türü için verileri izlemek amacıyla ve sorgular için filtre kriterlerini tanımlamak için kullanın. Çekirdek sistem veri alanları haricindeki herhangi bir veri öğesi, Team Foundation Server (tfs), iş akışını tanımlamak için kullanın veya bir iş öğesi türü bir iş öğesi alanı olarak tanımlanmalıdır form üzerinde görünen izlemek istediğiniz. İş öğesi alanlarını bir iş öğesi türünün veya küresel iş akışının tanımı içinde tanımlayabilirsiniz.

İş öğesi alanları takım projesi koleksiyonu için devam ettirilir. Aşağıdaki görevlerden birini gerçekleştirdiğinizde alan eklersiniz:

• Takım projesi oluşturun. İş öğesi türleri veya genel iş akışı tanımlarında ve seçili işlem şablonlarında tanımlanan tüm alanlar oluşturulur. Çekirdek sistem alanları, takım projesi için tanımlanan her iş öğesi türü için otomatik olarak tanımlanır. Bu alanların listesi için, bkz. Visual Studio ALM için Çalışma Öğesi Alan Başvurusu.

• Bir iş öğesi türü tanımını içe. İş öğesi türü tanımı içinde tanımlanan tüm yeni alanlar, proje koleksiyonuna eklenir. Daha fazla bilgi için bkz. Tüm WITD XML öğeleri başvuru.

• Genel iş akışı tanımı içeri aktarmak. Genel iş akışı içinde tanımlanan tüm yeni alanlar, proje koleksiyonuna eklenir. Birkaç türde iş öğesinin paylaştığı bir iş öğesi alanları kümesini bulundurmak istediğinizde genel bir iş akışı tanımlayın. Daha fazla bilgi için bkz. Genel İş Akışını Özelleştirme.

• Bir proje koleksiyonunu bir Project Web App (pwa) örneğini için eşleme. Yükledikten sonra Team Foundation Server Project Server Extensions çeşitli bileşenlerini eşleştirerek tümleştirmeyi yapılandırırsınız Team Foundation. Bir koleksiyon eşlediğinizde, Project Server alanlarında çeşitli alanları destekleyen bir genel iş akışı tanımı içeri aktarılır. Daha fazla bilgi için bkz. Destek veri eşitlemesi için Project Server alanları eklendi.

Bütün takım projeleri için tüm iş öğeleri türlerinde ve tüm genel iş akışlarında tanımlı bütün alanlar, koleksiyon için tanımlı tam alanlar kümesini oluşturur. Var olan dosyaların özelliklerini değiştirebilir, tekrar isimlendirebilir ve silebilirsiniz. Ancak, bu tür değişiklikler yaptığınızda belirli maliyetler oluşabilir. Daha fazla bilgi için bkz. Proje İzleme Verilerini, Formları, İş Akışını ve Diğer Nesneleri Özelleştirme.

Eklemek veya bir koleksiyon için bir alanı özelleştirmek için genel iş akışı veya çalışma öğesi türü tanımı için xml içeriğini değiştirin. Her bir alan tanımlamak bir FIELD öğesi içinde FIELDS ya da bir iş öğesi türü veya genel iş akışı tanımı kısmını. Bu dosyaların yapısı ve konumu hakkında daha fazla bilgi için bkz. Tüm WITD XML öğeleri başvuru ve Genel İş Akışını Özelleştirme.

Bu konuda

• ALAN (Tanımlama) Söz dizimi Yapısı

• Alan Veri Türleri

• Alanlara Atanan Raporlanabilir Öznitelikler

• Dizinli alanlar

• ALAN (Tanımlama) Alt Öğeleri

• Sistem Alanları ve Önceden Tanımlanmış Alanlar

ALAN (Tanımlama) Söz dizimi Yapısı

Her FIELD (Tanım) öğesi isteğe bağlı olarak, bir kolay ada ve zorunlu bir başvuru adına sahiptir. Başvuru adı koleksiyon içinde benzersiz olmalıdır. Daha fazla bilgi için bkz. İş Öğesi İzleme Nesneleri için Adlandırma Kuralları.

Önemli

witadmin changefield komut satırı aracını kullanarak bir alanın kolay adını değiştirebilirsiniz.Ancak, bir alanı yeniden adlandırırsanız, koleksiyonu içindeki bütün takım projelerindeki tüm iş öğe türlerini etkiler.

İş öğesi türü için tanım dosyasına aşağıdaki xml söz dizimini tarafından bir alanı tanımlar.

<FIELD name="fieldDisplayName"
   refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID"
   syncnamechanges="true | false"
   reportingname="reportingDisplayName"
   reportingrefname="reportingReferenceName"
   reportable="Dimension | Detail | Measure" 
   formula="sum" >
   <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>

Daha fazla bilgi için bkz. ALAN (Tanımlama) Öğesi.

Başa dön

Alan Veri Türleri

Alan türü, alanda saklayabildiğiniz verinin tür ve boyutunu tanımlar. Bir alanı bir takım projesi koleksiyonu içerisinde tanımlanmış yalnızca bir türü olabilir. Bu kısıtlama, kuruluşları projeler ve çalışma öğesi türleri arasında ortak alanları kullanmak için teşvik eder.

Aşağıdaki liste, desteklenen alan türlerini gösterir:

Veri türü	Tanımlama
DateTime	Eşgüdümlü Evrensel Saat (UTC)'e göre tarihi belirtir. Ekleme bir DateTime alanını kullanarak bir çalışma öğesi formuna FieldControl veya DateTimeControltype öznitelikleri.
Double	Kayan nokta değerini belirtir. Double alanları, sıklıkla sorgu filtrelerinde ve sonuçlar listelerinde kullanılır. Ekleme bir Double alanını kullanarak bir iş öğesi formuna FieldControltype özniteliği.
GUID	Benzersiz tanımlayıcı içerecek bir alanı belirtir. Çalışma öğesi formuna bir GUID alanı ekleyemezsiniz.
History	Tartışma zincirlerini görüntülemeyi ve diğer geçmiş bilgileri izlemeyi destekler. 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. Ekleme System.History alanını kullanarak bir iş öğesi formuna WorkItemLogControltype zengin metin biçimi denetimlerini destekleyen özniteliği.
HTML	Zengin metin verisi yakalama ve çalışma öğesi tanımlaması gibi uzun metin tanımlamalarını kullanmayı destekler. Bir HTML alanı, HTML alanının daha zengin bilgi görüntüleri için HTML'ye tam belirtilmiş şekilde yazıldığı Düz Metine göre farklılık gösterir. Ekleme bir HTML alanını kullanarak bir iş öğesi formuna HTMLControltype zengin metin biçimi denetimlerini destekleyen özniteliği.
Integer	32 Bitlik işaretli tamsayı değeri belirtir. Integer (Tamsayı) alanları, sıklıkla sorgu filtrelerinde ve sonuçlar listelerinde kullanılır. Ekleme bir Integer alanını kullanarak bir iş öğesi formuna FieldControltype özniteliği.
PlainText	255'ten fazla Unicode karakter içeren bir metin dizesi girdisini destekler. Ekleme bir PlainText alanını kullanarak bir çalışma öğesi formuna FieldControl tür özniteliği ve düz metinle sınırlı veya HTMLControltype zengin metin biçimi denetimlerini destekleyen özniteliği.
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. String (dize) alanları, sıklıkla sorgu filtrelerinde ve sonuçlar listelerinde kullanılır. Ekleme bir String alanını kullanarak bir iş öğesi formuna FieldControltype özniteliği.
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. 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. Ekleme System.AreaPath ve System.IterationPath alanlar bir iş öğesi formuna kullanarak WorkItemClassificationControl type özniteliği.

Başa dön

Alanlara Atanan Raporlanabilir Öznitelikler

Bazı alan değerleri özellikle raporlama için kullanışlıdır. İş öğesi türü tanım dilini kullanarak aşağıdaki isteğe bağlı öznitelikleri belirtebilirsiniz:

• reportable. Raporlanabilir özniteliğini ayarlamak None, Detail, Dimension, veya Measureve nasıl istediğiniz alanı raporlara dahil edilebilir bağlı olarak. Bu öznitelik için None değerinden farklı bir değere sahip alanlar veri ambarına dışarı aktarılır ve raporlara dahil edilebilir.

  Çalışma öğesi türüne varolan bir alan eklediğinizde, reportable özniteliği için geçerli değer kullanılır. Çalışma öğesi türüne için bir alan eklediğinizde, reportable özniteliğini kullanarak onu açıkça belirtmediğiniz sürece raporlama devre dışıdır.

• reportingname. Veriler raporlarda görüntülendiğinde kullanılan bir alana farklı bir etiket atayabilirsiniz. Değer belirtmeseniz name özniteliğine atanmış yakın ad kullanılır.

• reportingrefname. Veriler ilişkisel veri ambarına dışa aktarıldığında kullanılan bir alana farklı bir başvuru adı atayabilirsiniz. Değer belirtmezseniz, refname özniteliğine atanmış değer kullanılır.

  Birleştirme ya da raporlarda yer alan ayırmak için bu özniteliği kullanın. Farklı başvuru adları taşıyan ve farklı proje koleksiyonlarında tanımlanmış iki alanı birleştirmek için, her iki alana da aynı reportingrefname öğesini atayın. Aynı adı taşıyan ve farklı proje koleksiyonlarında tanımlanmış iki alanı ayırmak için, her bir alana farklı bir reportingrefname atayın.

Bir alanı tanımladıktan sonra, refname özniteliğininki hariç tüm özniteliklerin değerini değiştirmek için bir komut isteminde witadmin changefield komutunu kullanabilirsiniz.

Raporlama amacıyla alanları etiketlemede en iyi yöntemler hakkında daha fazla bilgi için bkz. Raporlamayı Desteklemek Üzere Çalışma Öğesi Alanları Ekleme ve Değiştirme.

Başa dön

Raporlanabilir Öznitelik Değerleri

Aşağıdaki tabloda açıklandığı gibi, reportable özniteliğine şu değerlerden birini atayabilirsiniz: hiçbiri, boyut, detay ve ölçü.

Not

Çalışma öğesi için kullandıktan sonra, bir alanı raporlanabilir yapabilirsiniz.Raporlanabilir değeri ayarladıktan sonra, ambara kopyalanan iş öğesinin yeni düzeltmeleri alan değerini içerecektir.Ancak, ambarda zaten varolan düzeltmeler, varolan değerlerle doldurulmaz.

Öznitelik değeri	Tanımlama
Detail	Detail türünü yalnızca Integer (tamsayı), Double, String (dize) veya DateTime alanları için kullanın. Bu alandaki veri, İş Öğesi ve Geçerli İş Öğesi tablolarındaki ilişkisel ambar veritabanına taşındığını ancak SQL Server Çözümleme Hizmetleri küpüne taşınmadığını belirtir. Kısıtlamasız metin alanları için bu türü kullanarak, küpü önemli ölçüde büyütmeden onları raporlarda kullanabilirsiniz.
Dimension	Dimension türünü yalnızca Integer (tamsayı), Double, String (dize) veya DateTime alanları için kullanın. 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	Measure 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ünün işlenmesi sırasında, veriler Measure olarak ayarlanmış alanlar üzerinde ö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çüm grupları hakkında daha fazla bilgi için bkz. Takım Sistemi için Çözümleme Hizmetleri Küpü'nde Sağlanan Perspektifler ve Ölçüm Grupları. Measure'u belirttiğinizde, sorguda başvurulan her ölçünün toplamını veren formula özniteliği için sum'ı belirtmelisiniz.
None	Alanı raporlara dahil etmek istemediğinizde, None öğesini belirtin. Bu değer, varsayılan atamadır.

Başa dön

Raporlamanın Nasıl Belirtileceğini Gösteren Örnekler

Ayrıntı Örneği

<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

Boyut Örneği

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

Ölçü Örneği

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

Dizinli alanlar

witadmin indexfield komutunu kullanarak bir iş öğesi için dizinlemeyi etkinleştirebilir veya devre dışı bırakabilirsiniz. Alan için dizinlemeyi etkinleştirdiğinizde, sorgularının bu alanı belirttiği çalışma öğelerini bulma performansını artırabilirsiniz. Çalışma öğesi sorgularınızın çoğunda kullandığınız özel alanı eklerseniz, bu alan için dizinlemeyi etkinleştirmek isteyebilirsiniz. Daha fazla bilgi için bkz. İş Öğesi Alanlarını Yönetme [witadmin].

Başa dön

ALAN (Tanımlama) Alt Öğeleri

Çalışma öğesi alanı için belirtebildiğiniz birçok isteğe bağlı alt öğe vardır, örneğin:

• Yardım metni. Araç ipucunu veya çalışma öğesi formu üzerindeki bir alan için görüntüleyen yardım bilgisini tanımlar (HELPTEXT).

• Alan kısıtlamaları. Alanı; gerekli, salt okunur, boş, dondurulmuş veya belirli bir düzene eşleşen olarak belirtir (REQUIRED, READONLY, EMPTY, FROZEN, MATCH).

• Field value auto-population(Alan değeri otomatik popülasyonu). Alan için bir değeri belirtir (DEFAULT, COPY, SERVERDEFAULT).

• Alan listeleri. İzin verilen, önerilen veya yasaklanmış değerleri belirtir. (ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

• Alan koşulları. Başka bir alan değiştirildiğinde veya değiştirilmediğinde ya da başka bir alanın belirli bir değeri varsa ya da diğer bir şartta alana bir veya daha çok kural uygular. (WHEN, WHENNOT, WHENCHANGED, WHENNOTCHANGED, CANNOTLOSEVALUE, NOTSAMEAS)

Daha fazla bilgi için bkz. Tüm FIELD XML Öğeleri Başvurusu.

Başa dön

Sistem ve Önceden Tanımlanmış Alanlar

Tüm sistem tanımlı alanları System ile başlayan başvuru adlarına sahiptir, örneğin, System.AreaPath, System.AssignedTo, ve bu düzende devam eder.

tfs sağlayan varsayılan işlem şablonları tarafından tanımlanan önceden tanımlı alanların Microsoft.VSTS ile başlar ve sonra daha fazla kendi kullanım amaçlarına göre farklılık. Zamanlama amaçları için, Microsoft Project ile tümleştirme için, Team Foundation Yapısı ile tümleştirme için ve Team Foundation ile tümleştirme için ortak olarak kullanılan önceden tanımlı alan örnekleri aşağıdaki gibidir:

• Microsoft.VSTS.Common.Priority

• Microsoft.VSTS.scheduling.SonGün

• Microsoft.VSTS.Build.FoundIn

• Microsoft.VSTS.TCM.Steps

Tüm sistem ve tfs sağlayan varsayılan işlem şablonları 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 adlarını belirtme üzerine daha fazla bilgi için, bkz. İş Öğesi İzleme Nesneleri için Adlandırma Kuralları.

Başa dön

Gizli ve değiştirilemeyen öznitelikleri ve iş öğesi alan Gezgini

Değiştirebileceğiniz bir iş öğesi alanı için özniteliklere ek olarak, değiştirilemeyen ve neredeyse gizli öznitelikleri her alan için bir dizi vardır. Bu alanlar çalışma öğesi alan Gezgini aracını kullanarak atamalarını bakabilirsiniz. Çalışma öğesi alanı Explorer aracı olan işlem düzenleyicisini güç aracından erişin.

Alan Gezgini iş öğesi

Not

Güç aracı olan işlem düzenleyicisini Team Foundation Server işlem şablonları özelleştirmek için bir grafik kullanıcı arabirimi sağlar.Alma ve verme iş öğesi türlerini, işlem şablonunun içeriğini değiştirmek ve bir takım projesi koleksiyonu için tanımlı alan kümesine keşfetmek için bu aracı kullanabilirsiniz.Daha fazla bilgi için Microsoft Web sitesindeki şu sayfaya bakın: Team Foundation Server Güç Araçları.

Ayrıca bkz.

Başvuru

İş Öğesi Alanlarını Yönetme [witadmin]

Kavramlar

İş Öğesi İzlemeyi ve Takım Projenizi Özelleştirme

Raporlamayı Desteklemek Üzere Çalışma Öğesi Alanları Ekleme ve Değiştirme

Tüm FIELD XML Öğeleri Başvurusu

Diğer Kaynaklar

Çalışma Öğesi Alanları Tanımlama