İş öğesi alanlarını tanımlama ve değiştirme

İş öğesi alanları veri bir iş öğesi türü için izlemek ve raporlar oluşturmak için de sorgular için filtre ölçütünü tanımlamak için kullanın.Çekirdek sistem veri alanları dışında herhangi bir veri öğesi Team Foundation Server (TFS) iş akışı tanımlamak için kullanın veya bir iş öğesi türünün bir iş öğesi alanı olarak tanımlanması için form üzerinde görünen izlemek istediğiniz,.İş öğesi alanları iş öğesi türü veya genel iş akışı tanımı içinde tanımlayabilirsiniz.

İş öğesi alanları bir takım projesi koleksiyonu için tutulur.Aşağıdaki görevleri gerçekleştirirken alanları Ekle:

• Ekip projesi oluşturun.İş öğesi türleri veya genel iş akışı için tanımları içinde tanımlanan ve seçilen işlem şablonu için 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 bir listesi için bkz Visual Studio ALM için çalışma öğesi alanı başvurusu.

• İş öğesi türü için bir tanım içeri aktarma.İş öğesi türü tanımı içinde tanımlanan tüm yeni alanlar koleksiyona eklenir.Daha fazla bilgi için bkz. Tüm WITD XML öğeleri başvurusu.

• Genel iş akışı tanımı içeri aktarma.Genel iş akışının içinde tanımlanan tüm yeni alanlar koleksiyona eklenir.İş öğeleri çeşitli türlerde paylaşan iş öğesi alanları kümesi istediğinizde genel bir iş akışı tanımlayın.Daha fazla bilgi için bkz. Customize global workflow.

• Bir proje koleksiyonu bir örneğiyle Project Web App (PWA) eşleme.Yükledikten sonra Team Foundation Server uzantılarını Project Server için çeşitli bileşenlerini eşleştirerek tümleştirme yapılandırmak Team Foundation.Bir koleksiyon eşleştirirken Project Server alanlarında çeşitli alanları destekleyen bir genel iş akışı tanımı alınır.Daha fazla bilgi için bkz. Veri eşitlemeyi desteklemek için TFS'ye eklenen Project Server alanları.

Tüm iş öğesi türleri ve tüm genel iş akışları tüm takım projeleri için tanımlanan tüm alanları koleksiyonu için tanımlanan alanlar tam kümesi oluşturur.Özniteliğini değiştirmek, yeniden adlandır ve varolan alanları silin.Ancak, bu tür değişiklikleri yaptığınızda belirli ücret uygulamasına neden.Daha fazla bilgi için bkz. İş izleme nesnelerini, ekibinizin süreçlerini destekleyecek şekilde özelleştirme.

Eklemek veya bir koleksiyon için bir alan özelleştirmek için XML içerik için bir iş öğesi veya genel iş akışı türünü tanımı değiştirin.Her alan aracılığıyla tanımlayan bir FIELD öğesi içinde FIELDS ya da iş öğesi türü veya genel iş akışı için tanım bölümünü.Bu dosyaların konumunu ve yapısı hakkında daha fazla bilgi için bkz Tüm WITD XML öğeleri başvurusu ve Customize global workflow.

Bu konuda

• ALAN (tanımlama) sözdizimi yapısı

• Alan veri türleri

• Rapor edilebilir öznitelikleri alanlarına atanan

• Dizinli alanları

• ALAN (tanımlama) alt öğeleri

• Sistem ve önceden tanımlanmış alanları

ALAN (tanımlama) sözdizimi yapısı

Her FIELD (tanım) öğesi, isteğe bağlı olarak, bir kolay bir ad ve gerekli bir başvuru adı içeriyor.Referans adı koleksiyonu içinde benzersiz olmalıdır.Daha fazla bilgi için bkz. İş öğesi izleme nesneleri için adlandırma kuralları.

Önemli
Kullanarak bir alan için kolay ad değiştirebilirsiniz witadmin changefield komut satırı aracı.Ancak, bir alan adını değiştirirseniz, tüm takım projeleri koleksiyonu içinde tüm iş öğesi türlerine etkiler.

İş öğesi türü için tanım dosyasındaki aşağıdaki XML sözdizimi tarafından bir alan tanımlayın.

<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. FIELD (Tanım) öğesi başvurusu.

Başa dön

Alan veri türleri

Bir alan türü türü ve alana depolayabilir verilerin boyutunu tanımlar.Bir alan bir takım projesi koleksiyonu içinde tanımlanan yalnızca bir türü olabilir.Bu kısıtlama, kuruluşların projeler arasında ortak alanları kullanın ve çalışma öğesi türleri önerir.

Aşağıdaki listede desteklenen alan türleri gösterilmektedir:

Veri türü	Açıklama
DateTime	Bir tarih Eşgüdümlü Evrensel Saat (UTC) zamanını göre süreyi belirtir. Add a DateTime field to a work item form by using either the FieldControl or DateTimeControltype attributes.
Double	Kayan nokta bir değer belirtir.Çift alanları sık kullanıldığı sorgu filtrelerinde ve sonuçlar listeler. Add a Double field to a work item form by using the FieldControltype attribute.
GUID	Benzersiz tanımlayıcı içerecektir alanı belirtir. Ekleyemezsiniz bir GUID alan için bir iş öğesi formu.
History	Tartışma dizileri görüntüleme ve diğer geçmiş bilgileri izlemeyi destekler. [!NOT] System.History Bu veri türünü kullanan tek alan bir alandır.Bu veri türü kullanarak özel bir alan tanımlayamaz. Add the System.History field to a work item form by using the WorkItemLogControltype attribute which supports rich text format controls.
HTML	Zengin metin verisi yakalama ve çalışma öğesi tanımlaması gibi uzun metin tanımlamaları kullanılacak özelliği destekler.Bir HTML alan bir HTML alanı kesin türü için HTML bilgilerin zengin görüntüler için yazılmış bir düz metin alanından farklıdır. Add an HTML field to a work item form by using the HTMLControltype attribute, which supports rich text format controls.
Integer	32-bit imzalı bir tamsayı değeri belirtir.Tamsayı alanlarının sık kullanıldığı sorgu filtrelerinde ve sonuçlar listeler. Add an Integer field to a work item form by using the FieldControltype attribute.
PlainText	Giriş 255'ten fazla Unicode karakter içeren bir metin dizesinin destekler. Add a PlainText field to a work item form by using either the FieldControl type attribute and limited to plain text, or the HTMLControltype attribute which supports rich text format controls.
String	En fazla 255 Unicode karakter içeren bir metin dizesi girdisini destekler.Bir etiket veya diğer kısa bir metin dizesi en fazla uzun bir satır için bir dize alanı kullanın.Dize alanları sık kullanıldığı sorgu filtrelerinde ve sonuçlar listeler. Add a String field to a work item form by using the FieldControltype attribute.
TreePath	Girdileri hiyerarşik veya ağaç yapısı, bir ürün için alan ve yineleme yollarını görüntülemek için gereksinimleri gibi görüntüleyen bir alan belirtir. [!NOT] System.AreaPath Ve System.IterationPath alanları bu veri türünü kullanan alanlar yalnızca.Bu veri türü kullanarak özel bir alan tanımlayamaz. Ekle System.AreaPath ve System.IterationPath alanları için bir iş öğesi formundaki kullanarak WorkItemClassificationControl type özniteliği.

Başa dön

Alanlara atanan rapor edilebilir öznitelikleri

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

• reportable.Rapor edilebilir öznitelik kümesine None, Detail, Dimension, veya Measureolup olmadığını ve nasıl raporlara dahil edilebilir alanının istediğiniz bağlı.Veri dışında bir değere sahip alanlarından None bu öznitelik için veri ambarına dışarı aktarılır ve raporlara dahil edilebilir.

  Bir iş öğesi için varolan bir alan eklediğinizde yazın, geçerli değeri reportable özniteliği kullanılır.Bir iş öğesi türü için bir alan eklediğinizde, kullanarak bunu açıkça belirtmeniz sürece raporlama devre dışıdır reportable özniteliği.

• reportingname.Veri raporlarda görüntülendiğinde kullanılan bir alan için farklı bir etiket atayın.Bir değer için atanan kolay ad belirtmezseniz, name özniteliği kullanılır.

• reportingrefname.İlişkisel veri ambarına veri verildiğinde kullanılan bir alan için farklı bir başvuru adı atayın.Atanan değeri bir değer belirtmezseniz refname özniteliği kullanılır.

  Bu öznitelik, birleştirme ya da raporlara dahil alanları ayırmak için kullanın.Farklı başvuru adları ve farklı proje koleksiyonlarında tanımlanmış iki alanı birleştirmek için aynı atadığınız reportingrefname her iki alan için.Aynı başvuru adına sahip ve farklı proje koleksiyonlarında tanımlanmış iki alanı ayırmak için farklı bir atamanız reportingrefname her alana.

Bir alan tanımlayın sonra kullanabileceğiniz witadmin changefield hariç tüm öznitelikleri değerini değiştirmek için komut istemine komut refname özniteliği.

Raporlama amacıyla alanları etiketleme içinde en iyi uygulamalar hakkında daha fazla bilgi için bkz Raporlamayı desteklemek üzere iş öğesi alanları ekleme veya değiştirme.

Başa dön

Rapor edilebilir öznitelik değerleri

Aşağıdaki tabloda açıklandığı gibi aşağıdaki değerlerden birini atayabilirsiniz reportable özniteliği: none, boyut, ayrıntı ve ölçü.

[!NOT]

Bir iş öğesi için kullanılan sonra bir alan rapor edilebilir yapabilirsiniz.Rapor edilebilir değeri ayarlandıktan sonra ambara kopyalanan iş öğesinin yeni düzeltmeleri alan değeri içerir.Ancak, zaten ambarında olan düzeltmelerinin backfilled mevcut değerlerle olmayacaktır.

Öznitelik değeri	Açıklama
Detail	Kullanım Detail yalnızca tamsayı, Double, dize veya tarih/saat alanları için türü. Bu alan verilerde ilişkisel ambarı veritabanına iş öğesi ve geçerli iş öğesi tablolarındaki ancak olmayacak şekilde taşınır SQL Server Analysis Services Küp.Sınırsız metin alanları için bu türü kullanarak, bunları raporlarında küp önemli ölçüde daha büyük yapmadan kullanabilirsiniz.
Dimension	Kullanım Dimension yalnızca tamsayı, dize veya tarih/saat alanları için türü. Bu alanda veri ambarı ilişkisel veritabanı ve Analysis Services küp veri raporları filtrelemek için bir iş öğesi boyut özniteliği olarak girer.Bu tür için geçerli değerler listesi alanlarını kullanın.İş öğesi türü ve durum iyi bir boyut örnekler.
Measure	Kullanım Measure yalnızca tamsayı ve çift alanları için türü.Raporları sayısal değerleri ölçüler. Analysis Services küpünün işlenmesi sırasında veri kümesi için alanlar üzerinde önceden Measure.Örneğin, iş öğesi ve geçerli iş öğesi ölçü grupları için aşağıdaki alanlar toplu verileri içerir: özgün tahmin, kalan saat ve saat tamamlandı.Ölçü grupları hakkında daha fazla bilgi için bkz: Visual Studio için Analysis Services küpü'nde sağlanan perspektifler ve ölçüm grupları. Belirttiğinizde Measure, belirtmeniz gerekir sum için formula özniteliği sorguda başvurulan her ölçünün toplamını döndürür.
None	Belirtin None olduğunda istediğiniz alanı raporlara dahil edilecek.Varsayılan atama değerdir.

Başa dön

Raporlama belirtmek nasıl gösteren örnekleri

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ı

Etkinleştirebilir veya devre dışı kullanarak bir iş öğesi alanı için dizin oluşturma witadmin indexfield komutu.Bir alan için dizin oluşturma etkinleştirdiğinizde, sorgularının alanı belirten iş öğeleri bulma, performansını artırabilir.Çalışma öğesi sorgularını çoğunu kullandığınız özel bir alan eklerseniz, bu alan için dizin oluşturma etkinleştirmek istediğiniz.Daha fazla bilgi için bkz. İş öğesi alanlarını yönetme [witadmin].

Başa dön

ALAN (tanımlama) alt öğeleri

Bir dizi için bir iş öğesi alanı, örneğin belirtebilirsiniz isteğe bağlı bir alt öğe vardır:

• Yardım metni.Görüntüler için bir alan iş öğesi formu araç ipucu veya Yardım bilgisini tanımlar (HELPTEXT).

• Alan kısıtlamaları.Salt okunur, gerekli bir alan belirtir, dondurulmuş boş veya belirli bir desen eşleştirme (REQUIRED, READONLY, EMPTY, FROZEN, MATCH).

• Alan değeri otomatik doldurma.Alan için bir değer 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ştirilmez veya değişmemiş veya başka bir alan sahip veya belirli bir değer veya diğer koşulu olmayan bir alana bir veya daha fazla 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ı sistemle, örneğin, System.AreaPath, System.AssignedTo, başlayan ve bu düzende devam eder başvuru adlarına sahip.

TFS sağlayan varsayılan işlem şablonları tarafından tanımlanan önceden tanımlı alanlar Microsoft.VSTS ile başlar ve ardından daha fazla kullanımları üzerinde göre farklılık.Ortak, amaçları ve ile tümleştirme zamanlama için kullanılan tanımlı alan örnekleri Microsoft Project, ile tümleştirme için Team Foundation Yapısıve ile tümleştirme Team Foundation aşağıdaki gibidir:

• Microsoft.VSTS.Common.Priority

• Microsoft.VSTS.Scheduling.DueDate

• 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 bir bakış için bkz: Visual Studio ALM için çalışma öğesi alanı başvurusu.Alan adlarını belirtme hakkında daha fazla bilgi için İş öğesi izleme nesneleri için adlandırma kuralları.

Başa dön

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

Bir iş öğesi alanı için değiştirebilirsiniz özniteliklerini değiştirilemeyen ve neredeyse gizli öznitelikleri her alan için bir dizi vardır.İş Öğesi Alanı Gezgini aracını kullanarak bu alanların atamalarına bakabilirsiniz.İş öğesi alan Gezgini aracını işlem düzenleyicisini güç aracından erişin.

İş Öğesi Alan Gezgini

[!NOT]

İşlem Düzenleyicisi güç aracı, Team Foundation Server işlem şablonlarını özelleştirmek için bir grafik kullanıcı arabirimi sağlar.Bu aracı, alma ve verme iş öğesi türleri, işlem şablonu içeriğini değiştirmeye ve bir takım projesi koleksiyonu için tanımlanan alanlar kümesi keşfedin için 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

Özelleştirilecek genel alanlar [yeniden yönlendirildi]

Raporlamayı desteklemek üzere iş öğesi alanları ekleme veya değiştirme

Tüm FIELD XML öğeleri başvurusu

Diğer Kaynaklar

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