Share via

İş öğesi formu denetimlerini belirtme

  • Makale

TFS 2015 | TFS 2013

Önemli

Bu konu, Şirket içi XML işlem modeli için proje özelleştirmesi için geçerlidir. Barındırılan XML işlem modeli için bkz. WebLayout ve Denetim öğeleri. Devralma işlemi modeli için bkz. Bir işlemi özelleştirme.

İşlem modellerini genel bakış için bkz . İş izleme deneyiminizi özelleştirme.

Bir iş öğesi formunda görüntülemek istediğiniz her alan veya form denetimi için bir öğe eklersiniz Control . Takımınıza formu doğru şekilde kullanmalarına yardımcı olmak için bilgileri görüntülemek üzere bir iş öğesi formunu özelleştirebilirsiniz. izlemek istediğiniz verileri girmenize ve görüntülemenize olanak sağlayan iş öğesi alanlarını ve denetimlerini ekebilirsiniz.

öğesi Control , öznitelik için alan eklemek veya düz Type ya da köprü metni ya da alanları görüntülemek için kullanabileceğiniz çeşitli veri türü değerleri sağlar. Ayrıca, bağlantılar ve ekler eklemek, Web tabanlı içeriği görüntülemek veya kendi denetiminizi oluşturmak ve bir iş öğesi formuna eklemek için özel denetimler tanımlayabilirsiniz.

etiket adını, konumunu, metin kutusunun boyutunu ve diğer düz metin, tamsayı, sayı, tarih ve ağaç yolu iş öğesi alanlarının görüntüleme denetimlerini iş öğesi formunda kontrol edersiniz. Bu alanları görüntülemek için aşağıdaki seçeneklerden doğru Control öğe Type özniteliğini belirtmeniz gerekir:

  • FieldControl: , , , , , ve alan BooleanStringtürüne sahip alanların değer listelerini ve düz metinsel veya sayısal alanları görüntülemek Doubleiçin kullanılırPlainText. IntegerIdentity

  • HtmlFieldControl: Alan veri türüne sahip alanların çok satırlı, zengin metin biçimini görüntülemek için kullanılır HTML.

  • DateTimeControl: Alan türüne sahip biçimlendirilmiş tarih alanlarını görüntülemek için kullanılır DateTime.

  • WorkItemClassificationControl Alan türüne sahip hiyerarşik yol alanlarını görüntülemek için kullanılır TreePath.

İş öğesi alanları ekleme

İş öğesi formlarınızı özelleştirin, genellikle formda görünmesini istediğiniz iş öğesi türü için tanımlanan iş öğesi alanlarının bir alt kümesini eklersiniz. Alan tanımları, forma hangi verilerin görüntülr veya hangi verileri girebilirsiniz birçok yönüyle kontrol sağlar. Daha fazla bilgi için bkz . Bir alanı değiştirme veya özel alan ekleme.

Her iş öğesi alanı bir veri türüyle ilişkilendirildi. Label Denetimin yanında görüntüleyen metni belirtmek için özniteliğini kullanın. Etiketin denetime LabelPosition göre nerede görüntülendiğinden emin olmak için ilgili özniteliğini kullanın.

Not

Otomatik olarak güncelleştirilen sistem alanlarının değerlerini değiştiremezsiniz. Örneğin, bir iş öğesi ilk kez kaydedilebilirken Oluşturma Tarihi ve Oluşturan alanları tanımlanır. Ancak, bu alanları arama ölçütlerinde kullanabilirsiniz. Her sistem alanı için bir açıklama için bkz. İş öğesi alan dizini.

Sayısal alan ekleme

Tamsayı FieldControl alanına bir denetim alanı sağlamak için kullanın.

<Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />

Çift FieldControl alanların girişi veya görüntüsü için bir metin alanı sağlamak üzere kullanın.

<Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />

Düz metin veya dize alanı ekleme

String 255 karakterle sınırlı olan, seçim listelerinde veya kısa metinlerde kullanılan gibi bir dize alanı eklemek istediğiniz zaman denetimi belirtin.

<Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />

PlainText 255 karakterden büyük açıklamaları içeren metinleri yakalamak istediğiniz zaman denetimi belirtin.

<Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />

Onay kutusu veya Boole alanı ekleme

Not

Özellik kullanılabilirliği: Boole veri türü, TFS 2017.2 ve sonraki sürümler için Barındırılan XML (Azure DevOps Services) ve Şirket İçi XML için de desteklemektedir.

WIT tanımının ALANLAR bölümünde bir Boole alanı eklemek için aşağıdaki söz dizimi kullanın.

<FIELD name="Triage" refname="Fabrikam.Triage" type="Boolean" >
  <DEFAULT from="value" value="False" />
  <HELPTEXT>Triage work item</HELPTEXT>
</FIELD>

Ardından, alanın formda görünmesi için FORM bölümüne aşağıdaki söz dizimlerini ekleyin.

<Control Label="Triage" Type="FieldControl" FieldName="Fabrikam.Triage" />

Alan formda bir onay kutusu olarak görünür.

Tarih veya Takvim alanları ekleme

Kullanıcılara bir DateTimeControl alan için tarih seçmesi için bir takvim seçici vermek üzere türünü kullanırsiniz DateTime . Bu denetimi kullanarak, alan için hızla bir tarih ve saat seçin.

Format="Short" ile Takvim Alanı
Calendar field

Örneğin, tercih edilen bir başlangıç tarihi veya gelecekte bir gözden geçirme tarihi belirtsiniz.

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"  
Label="Preferred Start Date:" LabelPosition="Left" Format="Short" />  
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"  
Label="Preferred Start Time:" LabelPosition="Left" Format="Time" />

Aşağıdaki tabloda açıklanan isteğe DateTime bağlı öznitelikleri kullanarak alanın biçimini kontrol etmek için kullanabilirsiniz.

Öznitelik Açıklama
Format DateTimePickerFormat enum değerinin bir değerine karşılık gelen tarih-saat alanı biçimini belirtir. Geçerli değerler şu şekildedir: Custom, Long, Short, Time.

belirttiğinizde Customözniteliğini de ayarlay CustomFormat gerekir.
CustomFormat DateTimePicker.CustomFormat özelliği için tanımlanan söz dizimine karşılık gelen tarih-saat alanı için kullanılan özel biçimi belirtir. Örnek:

Format="Custom"

CustomFormat = "MMM dd, 'of the year' yyyy"

Daha fazla bilgi için bkz. Microsoft Web sitesi: DateTimePicker.CustomFormat Özelliği.

Zengin metin (HTML) alanı ekleme

Aşağıdaki çizimde HTMLControl gösterildiği gibi HTML zengin metin biçimlendirmesini yakalamak için bir alan eklemek için belirtin.

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />

HTML field shown on work item form

İpucu

Bir forma HTMLFieldControl dikey olarak yığılmış birkaç öğe eklerken, her alan denetimi için MinimumSize özniteliğini belirtmeniz gerekir. Bu şekilde, metin kutularının tüm boyutunu benzer hale ebilirsiniz. Aksi takdirde, son HTML denetim öğesi formu dolduracak şekilde boyutlandırılır ve önceki öğeler daha küçük metin kutularıyla birlikte görünür.

Düz veya köprü metni denetimi ekleme

Aşağıdaki çizimde LabelControl gösterildiği gibi, bir alanla ilişkilendirilen düz veya köprülü metin görüntülemek için kullanın.

Metinleri kısmen LabelTextLink köprüyle ilişkilendirilen bir alanın veya etiketin metin, köprü ve konumunu belirtmek için ve alt öğelerini ve kapsayıcı öğelerini kullanırsiniz. Daha fazla bilgi için bkz . Yardım metni, köprü veya web içeriği sağlama, LabelText ve Text ve Link ve Param.

Example of two hyperlinks applied to text

Web sayfası denetimi ekleme

Web WebpageControliçeriğini bir iş öğesi formunda görüntülemek için kullanın. Bu denetim genellikle kendi sekme grubunda yer alan bir denetimdir. web sayfası WebpageControlOptions hedefini Link iş öğesi formunda yüklemek için gereken denetimleri belirtmek için ve alt öğelerini kullanırsiniz.

Daha fazla bilgi için bkz . Bir iş öğesi formuna web içeriği eklemek için WIT tanımını düzenleme, WebControlOptions ve Link ve Param.

İş öğeleri LinksControl arasındaki bağlantıları oluşturmak ve yönetmek için kullanırsiniz. Bu denetim genellikle aşağıdaki çizimde gösterildiği gibi kendi sekme grubunda yer alan bir denetimdir.

Example of links control added to a work item form

Bağlantı listesini görüntülemek LinksControlOptions için kullanılan sütun alanlarının bağlantı filtrelerini ve düzenini tanımlamak için de kullanabilirsiniz. Daha fazla bilgi için bkz . Bağlantı ilişkilerini kısıtlamak için bağlantı denetimlerini tanımlama veLinksControlOptions.

Storyboards denetimi ekleme

bir iş StoryboardsControl öğesinden PowerPoint'i açmak ve ağ paylaşımına kaydedilen Storyboard dosyalarına bağlantı açmak için kullanın. Bu denetim genellikle aşağıdaki çizimde gösterildiği gibi kendi sekme grubunda yer alan bir denetimdir.

Storyboard links control

bölümünü eklemek StoryboardsControl için FORM aşağıdaki kod parçacığını ekleyin:

<Tab Label="Storyboards">
     <Control Name="StoryboardsControl" Type="LinksControl">
        <LinksControlOptions>
           <WorkItemLinkFilters FilterType="excludeAll" />
           <ExternalLinkFilters FilterType="include">
              <Filter LinkType="Storyboard" />
           </ExternalLinkFilters>
           <LinkColumns>
              <LinkColumn RefName="System.Title" />
              <LinkColumn LinkAttribute="System.Links.Comment" />
           </LinkColumns>
        </LinksControlOptions>
     </Control>
  </Tab>

Alan ve yineleme yolları ekleme (TreePath denetimi)

Veri türü olan WorkItemClassificationControl alanları eklemek için türünü kullanırsiniz TreePath. Bu denetim, alan yolu alanlarını ve yineleme yolu alanlarını hiyerarşik, iç içe ağaç biçiminde görüntüleme desteği sağlar. Ağaç, genişlet ve daraltarak hiyerarşik düğümleri gösterir.

<Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area"LabelPosition="Left" />

Not

ve alanlarını görüntülemek WorkItemClassificationControl için kullanabilirsiniz System.AreaPathSystem.IterationPath . Bu denetimi kullanarak başka bir alan türü veya özel alan görüntü olamaz.

Geçmiş denetimi ekleme

Aşağıdaki çizimde WorkItemLogControl gösterildiği gibi, Geçmiş alanı için tartışma iş parçacıklarını ve diğer geçmiş bilgileri takip eden bir denetim alanı sağlamak için kullanın.

History tab and field on work item form

Bu denetimi yalnızca bir iş öğesinin geçmiş alanı olan System.History iş öğesi alanını görüntülemek için kullanabilirsiniz. Bu denetimi kullanarak, bir iş öğesinin geçmiş düzeltmeleri ile ilgili ayrıntıları genişletebilirsiniz ve daraltabilirsiniz. Geçmiş alanına ekley istediğiniz metni de biçimlendirebilirsiniz.

<Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description and History" LabelPosition="Top" Dock="Fill" />

Ek denetimi ekleme

Bir iş AttachmentsControl öğesi formuna dosya eklemek için kullanın. Bu denetim genellikle aşağıdaki çizimde gösterildiği gibi kendi sekme grubunda yer alan bir denetimdir.

Attach files to a work item

Daha fazla bilgi için bkz . Ekler denetimi ekleme.

Sağlanan yerleşik denetimlere ek olarak, markette kullanabileceğiniz ek denetimler . Veya kendi denetiminizi oluşturabilirsiniz. Bkz . İş öğesi formunu genişletme.

Alanları etiketleme ve formda iki yerde alan ekleme

Her form denetimi için ve özniteliklerini kullanarak isteğe bağlı bir etiket ve etiketin konumunu LabelLabelPosition belirtebilirsiniz. Etiket, öğesi tarafından atanan kolay addan farklı bir ad belirtebilirsiniz FIELD . Etiket belirtmezseniz kolay ad kullanılır. Ancak, bir ekip üyesi iş öğelerini aramak için bir sorgu çalıştırsa kolay adın her zaman kullanıla bir ad olduğunu unutmayın. En büyük etiket boyutu 80 karakterdir.

Not

Aynı grupta tanımlanan tüm denetimler için aynı etiket konumunu tanımlamanız gerekir.

Alanı formun birden fazla alanına (örneğin, formun üst kısmında ve bir sekmede) eklemek için özniteliğini kullanarak bunu Name yapın. özniteliği Name , denetimi forma eklenen diğer denetimden ayrı olarak tanımlar.

Bir alanı Read-Only

Bir alanı iki farklı şekilde salt okunur olarak işaretleyebilirsiniz. İlk yöntemde, öğesini READONLY tür tanımının bölümündeki FIELD öğesine alt FIELDS öğe olarak eklersiniz. öğesini kullanarak READONLY , belirli kullanıcıların alanı değiştirip değiştiremezseniz belirtebilirsiniz. Aşağıdaki örnekte gösterildiği gibi, yalnızca program yöneticileri bir Sub-Title değiştirebilir.

<FIELD name="Sub-Title" refname="ACME.ACE.SubTitle" type="String" >  
<READONLY for="[Global]\Team Foundation Valid Users" not="Program Managers"/>  
</FIELD>

İkinci yöntemde, öğesinin ReadOnly özniteliğini belirtirsiniz CONTROL . Bu yöntemde, tüm kullanıcıların alanını değiştirmesi kısıtlanır.

<Control FieldName=" ACME.ACE.SubTitle" Type="FieldControl" Label="Sub-Title" LabelPosition="Left" ReadOnly="True" />

Tüm denetim türleri için isteğe bağlı denetim öğesi alan öznitelikleri

Aşağıdaki isteğe bağlı öznitelikler yalnızca listelenen denetim türleri için belirtilebilir.

Not

Her veri girişi alanı için genel boyut çeşitli faktörler tarafından belirlenir: alana atanan öznitelikler, kapsayıcının boyutu ve formdaki diğer alanlara ayrılan alan. Varsayılan değerler, minimum boyut belirtmezseniz alanlara atanır. Ancak, formdaki diğer alanlara atanan öznitelikler alanların boyutunu etkileyebilir. Her sütundaki en büyük alana ayırdnız sütun sayısı ve yatay boyut, formun yatay boyutunu belirler. Bir dikey grupta belirttiğiniz alan sayısı ve her alana ayıracak dikey boyut, formun üst boyutunu ve ayrıca formun alt boyutunu belirler.

Öznitelik Açıklama
Field İş öğesi alanıyla ilişkili denetimi belirtir.
Label Formda denetimi tanımlayan görünür metni belirtir. 80 karakterden uzun bir dize belirtin.

Not: kullanarak iş öğesi formuna eklenen bir alanın etiketine köprü iliştirebilirsiniz . Bu denetim, alanın nasıl kullanıldıkları hakkında bilgilerin bağlantısını sağlamak için kullanışlıdır. Daha fazla bilgi için bkz . Yardım metni, köprü veya web içeriği sağlama.
LabelPosition Etiketin denetim verilerine göre konumunu belirtir. Aşağıdaki değerlerden bir dize belirtin: Top, Bottom, Leftve Right.
Dock Etiketin kapsayıcının belirtilen tarafıyla hizalamasını belirtir veya alanı kapsayıcıyı dolduracak şekilde esneter. Aşağıdaki değerlerden bir dize belirtin: Fill, , TopBottom, Leftve Right.
Padding Denetimin iç kenarlığı çevresinde piksel cinsinden alan miktarını belirtir. Üst, alt, sol ve sağ değere karşılık gelen dört değer sağlanır. Örneğin: (2,0,2,0).
Margin Denetimin dış kenarlığı çevresinde piksel cinsinden alan miktarını belirtir. Üst, alt, sol ve sağ değere karşılık gelen dört değer sağlanır. Örneğin: (2,0,2,0).
ReadOnly Alanın salt okunur olduğunu belirtir. veya True belirtin False.
MinimumSize Denetimin formda kaplayacak minimum boyutu piksel cinsinden belirtir. Genişlik ve yüksekliğe karşılık gelen iki değer belirtilir. Örneğin: (100.100).
Name Bir denetimi benzersiz olarak tanımlar. Formda Name birden fazla denetim aynı iş öğesi alanıyla ilişkili ise özniteliği gereklidir.

Not: Formda aynı alanı birden fazla alanda görüntülemek için özniteliğini kullanırız. Sistemin her denetimi benzersiz olarak tanımlaması Name için her iki denetim girdisi için özniteliği için benzersiz bir değer belirtirsiniz. Aynı denetimi sekmelerin bağlamına göre çeşitli konumlarda göstermek yararlıdır.

Belirli denetim türleri için isteğe bağlı denetim öğesi alan öznitelikleri

Aşağıdaki isteğe bağlı öznitelikler yalnızca listelenen denetim türleri için belirtilebilir.

Öznitelik Denetim türleri Description
NumberFormat FieldControl Alan denetimine girebilirsiniz karakterleri belirtir. Aşağıdaki değerler geçerlidir: WholeNumbers, SignedWholeNumbers, DecimalNumbersve SignedDecimalNumbers.
MaxLength FieldControl Bir alan denetimi için kullanabileceğiniz maksimum karakter uzunluğunu belirtir.
Format DateTimeControl DateTimePickerFormat enum değerinin bir değerine karşılık gelen tarih-saat alanı biçimini belirtir. Aşağıdaki değerler geçerlidir: Custom, , Long, ShortTime.
CustomFormat DateTimeControl DateTimePicker.CustomFormat özelliği için tanımlanan söz dizimine karşılık gelen tarih-saat alanı için kullanılan özel biçimi belirtir.