WebLayout ve Denetim öğeleri


Denetim

WebLayout içindeki bir Grup içinisteğe bağlı alt öğesi. İş öğesi formunda görünecek bir alan, metin, köprü veya başka bir denetim öğesi tanımlar.

<Control FieldName="FieldName" Type="DateTimeControl | ExtensionsControl |  
FieldControl | HtmlFieldControl | LabelControl | WebpageControl"  
Label="LabelText" EmptyText="TextString" 
ReadOnly="True | False" Name="InstanceName" />

Her öznitelik hakkında bilgi için bkz.Öğeözniteliklerini ve denetim türünü denetleme.

ControlContribution

Formda görünecek alan düzeyinde bir iş öğesi uzantısı belirtmek için kullanılan WebLayout içindeki Group öğesinin isteğe bağlı alt öğesi.

<ControlContribution Id="ContributionId" Label="Name">  
<Inputs>  
<Input Id="FieldName" Value="Value" />  
</Inputs>  
</ControlContribution>  

Belirttiğiniz ContributionId, hesap veya proje koleksiyonuna yük yükleriniz gerekir. Dışarı aktardınız WIT tanım dosyaları yüklü katkıların listesini içerir.

Dahili numara

Uzantılar için gerekli alt öğe. İş öğesi formunda görüntülemek üzere bir iş öğesi denetim uzantısının uzantı kimliğini belirtmek için kullanın. ControlContribution, GroupContributionveya PageContributionöğesi için düzende kullanılan her uzantıyı belirtmeniz gerekir.

<Extension Id="ExtensionId" />  

Belirttiğiniz ExtensionId, hesap veya proje koleksiyonuna yük yükleriniz gerekir. Dışarı aktardınız WIT tanım dosyaları yüklü uzantıların listesini içerir.

Uzantıları

Bir veya daha fazla Uzantı öğesi belirtmeyi desteklemek için kullanılan WebLayout isteğe bağlı kapsayıcı alt öğesi. Formda uzantılar kullanılıyorsa, bunları Bir Sayfa öğesi öncesinde belirtin.

<WebLayout >  
<Extensions >  
<Extension Id="ExtensionId" />  
. . .   
</Extensions>   
. . .
</WebLayout>  

FORM

İş öğesi formunda görünecek düzeni ve denetimleri belirtmek için kullanılan WITD'nin gerekli alt öğesi. Hem Düzen (istemci formu düzeni) hem de WebLayout (web formu düzeni) öğeleri için üst öğe.

<FORM>  
<Layout> . . . </Layout>  
<WebLayout> . . . </WebLayout>  
</FORM>  

Grup

Bölümünün gerekli alt öğesi. Etiketleyebilirsiniz bir bölüm içinde öğelerin görsel bir gruplama sağlar.

<Group Label="LabelText"   
<Control> . . . </Control>  
</Group>  

GroupContribution

Formda görünecek grup düzeyinde bir iş öğesi uzantısı belirtmek için kullanılan WebLayout içindeki Bölümünün isteğe bağlı alt öğesi. Uzantı, formda bir grup olarak görünür.

<GroupContribution Id="ContributionId" Label="Name" />  

Belirttiğiniz ContributionId, hesap veya proje koleksiyonuna yük yükleriniz gerekir. Dışarı aktardınız WIT tanım dosyaları yüklü katkıların listesini içerir.

Giriş

Bir uzantı için giriş verilerini belirten Girişler için gerekli alt öğe.

<Input Id="FieldName" Value="Value" />  

Girişler

ControlContribution için isteğe bağlı kapsayıcı alt öğesi, uzantı için giriş verisi belirtimlerini desteklemek için kullanılır.

<Inputs>
<Input Id="FieldName" Value="Value" />  
</Inputs>

Sayfa

WebLayout öğesinin gerekli alt öğesi. Web formu içindeki bir sayfanın düzenini tanımlar.
Sayfanın adını ve kullanım düzenini belirtin.

<Page Label="PageName" LayoutMode="FirstColumnWide | EqualColumns ">  
<Section>    
<Group> . . .   
<Control> . . . </Control>  
<Control> . . . </Control>  
</Group>  
</Section>  
</Page>  

PageContribution

Sayfada görünecek sayfa düzeyi iş öğesi uzantısını belirtmek için kullanılan WebLayout isteğe bağlı alt öğesi. Uzantı, formda bir sayfa olarak görünür.

<PageContribution Id="ContributionId" Label="Name"  />  

Belirttiğiniz ContributionId, hesap veya proje koleksiyonuna yük yükleriniz gerekir. Dışarı aktardınız WIT tanım dosyaları yüklü katkıların listesini içerir.

Section

Sayfa'nın gerekli alt öğesi. Web formunun bir sayfasındaki bölümün düzenini tanımlar. Bölümler, değişken yeniden boyutlandırmayı destekleyen grupları içerir. Sayfa içinde dört bölüm sınırı tanımlanabilir.

<Page>  
<Section>    
<Group> . . .   
<Control> . . . </Control>  
<Control> . . . </Control>  
</Group>  
</Section>  
</Page>  

SystemControls

WebLayoutiçin gerekli alt öğe. Web formunun üst bilgisinde yer alan denetimler için etiketleri ve boş metin değerlerini tanımlar. Buna Geçmiş, Bağlantılar ve Ekler sayfalarınınetiketleride dahildir

<SystemControls>    
<Control Type="FieldControl" FieldName="System.Title" EmptyText="Enter title" />   
<Control Label="Assi&gned To" Type="FieldControl" FieldName="System.AssignedTo" />  
<Control Label="Stat&e" Type="FieldControl" FieldName="System.State" />  
<Control Label="Reason" Type="FieldControl" FieldName="System.Reason" />  
<Control Label="&Area" Type="WorkItemClassificationControl" FieldName="System.AreaPath" />  
<Control Label="Ite&ration" Type="WorkItemClassificationControl" FieldName="System.IterationPath" />  
<Control Label="History" Type="WorkItemLogControl" FieldName="System.History" />  
<Control Label="Links" Type="LinksControl" Name="Links" />  
<Control Label="Attachments" Type="AttachmentsControl" Name="Attachments" />  
</SystemControls>  

WebLayout

FORM öğesinin gerekli alt öğesi. Web portalında görüntülenen iş öğesi formunun düzenini tanımlar. Bir veya daha fazla Sayfa öğeleri içerir.

<WebLayout>  
<Page>  
<Section>  
<Group> . . . 
<Control> . . . </Control>  
<Control> . . . </Control>  
</Group>  
</Section>  
</Page>  
. . .
</WebLayout>

Denetim öğesi söz dizimi

Bir iş öğesi formunda görüntülemek üzere bir iş öğesi alanı, metin, köprü veya başka bir form türü tanımlamak için Control öğesini kullanırız. WebLayout bölümünde belirttiğiniz Control öğesi aşağıdaki söz dizimine uygun olması gerekir:

<Control FieldName="FieldRefName" Type="DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | WebpageControl&quot; Label="LabelText" 
LabelPosition="Top | Bottom | Left | Right" EmptyText="TextString" 
ReadOnly="True | False" Name="InstanceName" [Visible="false" | 
FieldName="ReplacementFieldRefName" Replaces="FieldRefName"] />

Denetim öğesi özniteliği söz dizimi

Öznitelik

Açıklama

Fieldname

İsteğe bağlı. Denetimin ilişkili olduğu iş öğesi alanını belirtir. 1 ile 70 karakter arasında olması gereken alanın başvuru adını belirtin.

Tür

Gereklidir. Denetimin veri türünü belirtir. Bu yerleşik türlerden biri için bir dize belirtin:

  • DateTimeControl:Alan türü DateTime olan biçimlendirilmiş tarih alanlarını görüntülemek için kullanın.
  • FieldControl:Boole, düz metin, sayısal alanlar, kişi adı alanları ve seçim listelerini görüntülemek için kullanın. Boole, Double ,Identity , Integer,PlainTextm ve String veri türüne sahip alanları destekler.

Özellik kullanılabilirliği: Boole veri türü alanı TFS 2017 ve sonraki sürümlerde de kullanılabilir.

  • HtmlFieldControl:Alan türü HTML olan alanların çok satırlı, zengin metin biçimini görüntülemek için kullanın.
  • LabelControl:Bir alanla ilişkilendirilen metni görüntülemek için kullanın. Metin düz veya köprü biçiminde olabilir. LabelText, Link ve Text öğelerini kullanarak ek denetimlerbelirtebilirsiniz.
  • Web SayfasıDeneki:Bir URI tarafından tanımlanan veya bir CDATA etiketine eklenmiş HTML tabanlı içeriği görüntülemek için kullanın. Bu denetimin ilişkili bir alanı veya alan türü yok. Web SayfasıControlOptions öğesini kullanarak görüntülemek istediğiniz içeriği ve bağlantıları belirtirsiniz.

EmptyText

İsteğe bağlı. Bir alan boş olduğunda görüntülenen 1 ile 255 karakter arasındaki bir metin dizesini belirtir.

Etiketle

İsteğe bağlı. Formda denetimi tanımlayan görünür metni belirtir. 80 karakterden uzun bir dize belirtin. Belirtilmezse, kolay adı FieldName kullanılır.

Readonly

İsteğe bağlı. Alanın salt okunur olduğunu belirtir:

  • True:Denetim alanı salt okunur.
  • False:Denetim alanı salt okunur değil.

Ad

İsteğe bağlı. Bir denetimi benzersiz olarak tanımlar. Formda birden fazla denetim aynı iş öğesi alanıyla ilişkili ise Name önemlidir.

Not

Form üzerinde birden fazla sayfada aynı alanı görüntülenmesini Istediğinizde, Name özniteliğini kullanırsınız. Her iki denetim girdisi için de Name özniteliği için benzersiz bir değer belirtirsiniz, böylece sistem her denetimi benzersiz bir şekilde tanımlar.

Görünür

İsteğe bağlı. Visible="false"Üst bilgi alanı içinde normal olarak bulunan bir alanı ne zaman gizlemek istediğinizi belirtin. Bu özniteliği yalnızca System. Reason, System. AreaPath veya System. IterationPath alanlarıyla birlikte belirtebilirsiniz. Bu özniteliği belirtirseniz Replaces özniteliği belirtemezsiniz.

Yerine

İsteğe bağlı. FieldName="ReplacementFieldRefName" Replaces="FieldRefName"Üst bilgi alanı içindeki bir alanı başka bir alanla değiştirmek istediğinizde belirtin. Bu özniteliği yalnızca System. Reason, System. AreaPath veya System. IterationPath alanlarıyla birlikte belirtebilirsiniz. Bu özniteliği belirtirseniz Visible özniteliği belirtemezsiniz. Ayrıca, değiştirdiğiniz alana ait girişi bölümün içinden kaldırmanız gerekir.

Denetim öğesi türü öznitelik sözdizimi

Tür

Açıklama

DateTimeControl

Veri türü olan biçimli tarih alanlarını göstermek için kullanın DateTime . FieldControlTarih Saat alanının girişi veya görüntülenmesi için bir metin alanı sağlamak üzere kullanın.

<Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" 
Label="Start Date" LabelPosition="Left" />

DateTimeControlAşağıdaki çizimde gösterildiği gibi bir alan için bir tarih seçmek üzere bir Takvim Seçici sağlamak için kullanın.

Tarih-saat denetimi, takvim alanı

<Control Type="DateTimeControl" FieldName="FabrikamFiber.Schedule.SubmittedDate" 
Label="Submitted Date:" LabelPosition="Left"  Format="Short" />

Not

Görünen tarih-saat biçimi Kullanıcı profili kullanıcı profiliyleeşleşiyor. WebLayout bölümü Layout öğesi özelliğini kabul etmiyor .

FieldControl

Boole, dize, kimlik, tamsayı, Çift ve düz metin veri türü olan alanları görüntüleme için kullanın. Örnek:

<Control Type="FieldControl" FieldName="FabrikamFiber.Milestone" 
Label="Milestone" Name="Milestone" LabelPosition="Left" />

Özellik kullanılabilirliği: Boole veri türü alanı yalnızca TFS 2017 ve üzeri sürümlerde desteklenir. Visual Studio veya tutulma gibi bir istemci çalışma öğesi formunda, True veya False değeri görüntülenecektir.

Boole alanı, Web iş öğesi formu içinde onay kutusu olarak görüntülenir.

Web iş öğesi formunda Boole alanı görüntüleme

HTMLFieldControl

Çok satırlı, zengin metin biçimli denetimi görüntüleme için kullanın. Alanları için bu denetim türünü belirtin Type=HTML .
İş öğesi formunda gösterilen HTML alanı
Örnek:

<Control Type="HtmlFieldControl" FieldName="FabrikamFiber.ReleaseNotes" 
Label="Release Notes" Dock="Fill" />

LabelControl

Bir alanla ilişkilendirilmemiş metni göstermek için kullanın. Metin düz veya köprülenmiş olabilir. LabelText, bağlantı ve metin öğelerini kullanarak ek denetimler belirtebilirsiniz. Bkz. LabelText ve Text XML öğeleri başvurusu ve LINK ve param XML öğeleri başvurusu.

WebpageControlOptions

Bir URI tarafından tanımlanan veya CDATA etiketi içinde gömülü olan HTML tabanlı içeriği göstermek için kullanın. Bu denetimde ilişkili bir alan veya alan türü yok. WebpageControlOptions öğesini kullanarak görüntülenecek içeriği ve bağlantıları belirtirsiniz.

WebpageControlOptions öğesi ve onun alt öğeleri aşağıdaki sözdizimi yapısına sahiptir:

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >  
<Link UrlRoot="UrlRoot" UrlPath ="UrlPathWithParameters" >  
<Param index="IndexValue" value="ParamValue" type ="Original | Current">  
</Link>  
<Content>  
<![CDATA[Contents of HTML]]/>  
<Content/>  
<WebpageControlOptions/>

Düz metin veya köprülü Etiketler tanımlamak, bir alana köprüler eklemek veya bir iş öğesi formunda Web sayfası içeriğini göstermek için Content, LabelTextve Link öğelerini kullanırsınız. Söz dizimi hakkındaki ayrıntılar için bkz. bir iş öğesi formunda yardım metni, köprüler veya Web Içeriği sağlama .

Yeni formla çalışmaya başladıysanız, kullanıma almayı yönetmek veya özelleştirmek için şu ek konulara bakın:

İşlem modelleri ve her biriyle desteklenen özellikler hakkında daha fazla bilgi edinmek için bkz. iş izleme deneyiminizi özelleştirme.

Market uzantıları

kullanmaya başlayabileceğinizi istediğiniz uzantıları bulmak için Azure DevOps marketi ' ni ziyaret edin.

Form uzantıları

Controlkatkı, Groupkatkısıve pagekatkı öğeleri, bir proje koleksiyonu veya hesabı için yüklenmiş uzantılara ait katkılara başvurur. Visual Studio marketi'nden bir uzantı yüklersiniz. Uzantı oluşturmak için, bkz. ilk uzantınızı oluşturma.

Uzantılar yüklendikten sonra, bir iş öğesi türü için XML tanımına katkı öğesi eklersiniz. Bu dosyaları bir işlemi dışarı aktararak ya da WIT tanım dosyasını dışarı aktararakdışarı aktarabilirsiniz.

XML tanımını dışa aktardığınızda, yüklü uzantıları, kimlikleri ve gerekli girdileri listeleyen bir açıklama bölümü içerir. Örnek:

<!--**********************Work Item Extensions**********************
Extension:
    Name: color-control-dev
    Id: mariamclaughlin.color-control-dev
    Control contribution:
        Id: mariamclaughlin.color-control-dev.color-control-contribution
        Description: 
        Inputs:
            Id: FieldName
            Description: The field associated with the control.
            Type: Field
            IsRequired: true
            Id: Labels
            Description: The list of values to select from.
            Type: String
            IsRequired: false
            Id: Colors
            Description: The field associated with the control.
            Type: String
            IsRequired: false  
Extension:
    Name: vsts-workitem-recentlyviewed
    Id: mmanela.vsts-workitem-recentlyviewed  
    Group contribution:
        Id: mmanela.vsts-workitem-recentlyviewed.recently-viewed-form-group
        Description: Recently viewed work item form group  
Extension:
    Name: vsts-extensions-multi-values-control
    Id: ms-devlabs.vsts-extensions-multi-values-control   
    Control contribution:
        Id: ms-devlabs.vsts-extensions-multi-values-control.multi-values-form-control
        Description: Multi Values Selection Control.
        Inputs:
            Id: FieldName
            Description: The field associated with the control.
            Type: Field
            IsRequired: true
            Id: Values
            Description: The list of values to select from.
            Type: String
            IsRequired: false
Extension:
    Name: vsts-extension-workitem-activities
    Id: ms-devlabs.vsts-extension-workitem-activities   
Extension:
    Name: vsts-uservoice-ui
    Id: ms-devlabs.vsts-uservoice-ui   
    Group contribution:
        Id: ms-devlabs.vsts-uservoice-ui.vsts-uservoice-ui-wi-group
        Description: Shows User Voice details on the work item form
-->

Yukarıdaki örnek verildiğinde, uzantı kimliğini belirterek Kullanıcı ses grubu uzantısını açmak için iş öğesi türü tanımınıza aşağıdaki kod parçacığını ekleyebilirsiniz vsts-uservoice-ui :

<WebLayout>
... 
 <Extensions>
     <Extension Id="ms-devlabs.vsts-uservoice-ui" />
 </Extensions>
...
</WebLayout> 

Güncelleştirilmiş WıT tanımını içeri aktardıktan sonra, Grup uzantısı çalışma öğesi formunda otomatik olarak görünür.

WıT tanımınızı bir sonraki sefer dışa aktardığınızda bir GroupContribution öğe eklendiğini görürsünüz. Diğer tüm denetimleri yaptığınız gibi, bu öğeyi bölüm içinde taşıyabilirsiniz WebLayout .

Azure DevOps Services (barındırılan XML) | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2017

Web portalı aracılığıyla görüntülenen iş öğesi formlarında görünen düzeni ve denetimleri tanımlamak için Weblayout öğesini kullanın. Yeni iş öğesi deneyiminidestekler. Visual Studio ve diğer web dışı istemcilerle görüntülendiklerinde görüntülenen form öğelerini tanımlayan düzen öğesine ek niteliğindedir.

Önemli

Bu makale, barındırılan XML ve şirket içi XML (TFS 2017 ve sonraki sürümler) işlem modellerinin proje özelleştirmesi için geçerlidir. TFS 2015 ve önceki sürümleri için bkz. Layout XML öğe başvurusu.

Devralma işlemi modeli için bkz. bir Işlemi özelleştirme. İşlem modellerine genel bakış için bkz. iş izleme deneyiminizi özelleştirme.

Weblayout öğesi, form öğesinin gerekli bir alt öğesidir. Bu konu, Weblayout öğesini ve onun alt öğelerini belgeler. Yeni Weblayout bölümünü içeren bir WIT tanımını daha fazla özelleştirmek için bunu kılavuz olarak kullanın. Bu değişiklikler hakkında daha fazla bilgi edinmek için, TFS 'deki eski Iş öğesi formunun kullanımdan kaldırılması duyurusubaşlıklı blog gönderisine bakın.

Web yerleşimini değiştirmek için, bu konuda belirtilen bilgileri kullanarak belirli bir iş öğesi türü için XML tanım dosyasını değiştirin. Değişikliklerinizi içeri ve dışarı aktarmak için bkz. iş izleme Web formunu özelleştirme.

Windows istemci yerleşimini özelleştirmek için bkz. Layout XML öğesi.

Yeni form ve WebLayout bölümünün etkinleştirilmesi

Yeni form kullanıma alma etkinleştirildiğinde, koleksiyondaki tüm iş öğesi türleri (WTS 'ler) için XML tanımları, form bölümünün Içinde bir weblayout bölümü içerecek şekilde güncelleştirilir.

Yeni form yeni iş öğesi deneyimindeaçıklandığı gibi çeşitli yeni özellikler sunar. Hesabınız veya proje koleksiyonu yöneticiniz Yeni form anahtarınıyönetir.

Öğe ve öznitelik Özeti

Weblayout ve Updated Denetim öğeleri birkaç yeni öğe ortaya çıkarabilir ve birkaç öğe ve özniteliği kullanımdan kaldırır. Genel olarak, öncülü şundan çok daha basit bir sözdizimi yapısıdır.

Yeni öğeler Korunan öğeler Kullanım dışı öğeler Kullanım dışı öznitelikler
-Controlkatkısı
-Groupkatkısı
-Giriş
-Girişler
-Sayfa
-Pagekatkısı
-Bölüm
-SystemControls
-WebLayout
-FORM
-Düzen
-Grup
-Control
-Sütun
-Splitter
-Sekme
-TabGroup
-ControlSpacing
-FixedWidth
-LabelPosition
-LabelSpacing
-Kenar boşluğu
-MinimumSize
-Doldurma
-PercentWidth

İpucu

Sayfa öğesi kullanım dışı sekme öğesine benzer. Ancak, bir sayfa öğesi gruplandırılamıyor veya iç içe yerleştirilemez. Bir sayfa, Web formu içinde bir sekmeyi tanımlar.

Üst bilgi özelleştirmesi

Yeni Web formu düzeninde, sistem Systemcontrols öğesi içindeki çeşitli üst bilgi öğelerini yönetir. Bu modüller şunlardır:

  • Alanlar: Iş öğesi kimliği, başlık, atanan, durum, neden, alan yolu, yineleme yolu ve Etiketler
  • Sayfalar: geçmiş sayfası simge geçmişi, bağlantılar sayfa simgesi bağlantıları ve ekler sayfası simgesi ekleri.
Web formu içinde üst bilgi öğesi

Bir WıT tanımını dışa aktardığınızda, Weblayout bölümünün başlangıcında aşağıdakilere benzer bir systemcontrols bölümü görürsünüz:

<WebLayout ShowEmptyReadOnlyFields="true"> 
    <SystemControls>
      <Control Type="FieldControl" FieldName="System.Title" EmptyText="Enter title" />
      <Control Label="Assi&amp;gned To" Type="FieldControl" FieldName="System.AssignedTo" />
      <Control Label="Stat&amp;e" Type="FieldControl" FieldName="System.State" />
      <Control Label="Reason" Type="FieldControl" FieldName="System.Reason" />
      <Control Label="&amp;Area" Type="WorkItemClassificationControl" FieldName="System.AreaPath" />
      <Control Label="Ite&amp;ration" Type="WorkItemClassificationControl" FieldName="System.IterationPath" />
      <Control Label="History" Type="WorkItemLogControl" FieldName="System.History" />
      <Control Label="Links" Type="LinksControl" Name="Links" />
      <Control Label="Attachments" Type="AttachmentsControl" Name="Attachments" />
    </SystemControls>
...

Not

Link öğesisystemcontrols bölümü içinde izin verilen bir öğe değil.

TFS 2017, şirket ıçı XML işlem modeli için: sistem. title alanı için EmptyText öznitelik değerini değiştirme gibi systemcontrols bölümündeki Select öğelerini değiştirebilirsiniz. Genel olarak, bu bölümü ondan çok daha fazlasını özelleştirmemenizi öneririz. Örneğin, bu bölümün içindeki alanları kaldıramaz veya başka alanlar ekleyemezsiniz.

TFS 2018, şirket içi xml ve Azure DevOps Services, barındırılan xml işlem modelleri: showwemptyreadonlyfields özniteliğini belirtebilir veya systemcontrols bölümünde tanımlanan alanları gizlemeyi veya değiştirmeyi seçebilirsiniz.

Örneğin, neden alanını gizlemek için Denetim öğesini özniteliğiyle değiştirirsiniz.

<Control Label="Reason" Type="FieldControl" FieldName="System.Reason" Visible="false" />

Neden alanını başka bir alanla değiştirmek için Replaces özniteliğini kullanın. Ayrıca, neden alanı girdisini bölümünün içinden kaldırın.

<Control Label="Milestone" Type="FieldControl" FieldName="Fabrikam.Milestone" Replaces="System.Reason" />

Nedeni, alan yolunu ve yineleme yolu alanlarını gizleyebilir ya da değiştirebilirsiniz. İsterseniz, ayrıntılar sayfasına veya diğer özel sayfaya bu alanları ekleyebilirsiniz. Başlığı, Atanan veya durum alanlarını gizleyemezsiniz veya değiştiremezsiniz.

WebLayout örneği

Aşağıdaki örnek, form bölümünün Içindeki weblayout bölümünün genel yapısını gösterir. Weblayout , formda görünmesini istediğiniz her alan Için bir Denetim öğesi belirtir.

Öğeleri, bölüm ve Grup öğelerini kullanarak bir sayfa içinde görünecek şekilde gruplandırabilirsiniz. Formda görünmesini istediğiniz her bir alanı veya denetimi tanımlamak için bir Denetim öğesi kullanın.

Aşağıdaki örnek, bu konuda daha önce gösterilen Ayrıntılar sayfasının sözdizimini belirtir.

<FORM>
. . .
  <WebLayout>
       <SystemControls>
          <Control Type="FieldControl" FieldName="System.Title" EmptyText="Enter title" />
          <Control Label="Assi&amp;gned To" Type="FieldControl" FieldName="System.AssignedTo" />
          <Control Label="Stat&amp;e" Type="FieldControl" FieldName="System.State" />
          <Control Label="Reason" Type="FieldControl" FieldName="System.Reason" />
          <Control Label="&amp;Area" Type="WorkItemClassificationControl" FieldName="System.AreaPath" />
          <Control Label="Ite&amp;ration" Type="WorkItemClassificationControl" FieldName="System.IterationPath" />
          <Control Label="History" Type="WorkItemLogControl" FieldName="System.History" />
          <Control Label="Links" Type="LinksControl" Name="Links" />
          <Control Label="Attachments" Type="AttachmentsControl" Name="Attachments" />
        </SystemControls>
    <Page Label="Details" LayoutMode="FirstColumnWide">
        <Section>
          <Group Label="Description">
             <Control Label="Description" Type="HtmlFieldControl" FieldName="System.Description" />
          </Group>
        </Section>
        <Section>
      <Group Label="Planning">
          <Control Label="Story Points" Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.StoryPoints" />
          <Control Label="Priority" Type="FieldControl" FieldName="Microsoft.VSTS.Common.Priority" />
        </Group>
        <Group Label="Classification">
          <Control Label="Value area" Type="FieldControl" FieldName="Microsoft.VSTS.Common.ValueArea" />
        </Group>
      </Section>
      <Section>
        <Group Label="Development">
          <Control Type="LinksControl" Name="Development">
            <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">
              <ListViewOptions GroupLinks="false">
              </ListViewOptions>
              <LinkFilters>
                <ExternalLinkFilter Type="Build" />
                <ExternalLinkFilter Type="Pull Request" />
                <ExternalLinkFilter Type="Branch" />
                <ExternalLinkFilter Type="Fixed in Commit" />
                <ExternalLinkFilter Type="Fixed in Changeset" />
                <ExternalLinkFilter Type="Source Code File" />
              </LinkFilters>
            </LinksControlOptions>
          </Control>
        </Group>
       <Group Label="Related Work">
          <Control Type="LinksControl" Name="Related Work">
            <LinksControlOptions>
              <LinkFilters>
                <WorkItemLinkFilter Type="System.LinkTypes.Hierarchy-Reverse" />
                <WorkItemLinkFilter Type="System.LinkTypes.Hierarchy-Forward" />
                <WorkItemLinkFilter Type="System.LinkTypes.Related" />
              </LinkFilters>
              <Columns>
                <Column Name="System.State" />
                <Column Name="System.ChangedDate" />
                <Column Name="System.Links.Comment" />
              </Columns>
            </LinksControlOptions>
          </Control>
        </Group>
      </Section>
    </Page>
  </WebLayout>
</FORM>

WebLayout öğe sözdizimi

Bilgi ve iş öğesi alanlarının nasıl gruplandığını ve aşağıdaki tabloda açıklanan öğeleri kullanarak iş öğesi formunda nasıl görüneceğini belirtebilirsiniz.

<WebLayout ShowEmptyReadOnlyFields="true | false">
   ...
</WebLayout>

Öznitelikler

Öznitelik Açıklama
ShowEmptyReadOnlyFields İsteğe bağlı WebLayout öznitelik. trueSalt okunurdur ve boş alanları (varsayılan) göstermek ve false Bu alanları gizlemek için değerini belirtin.

İpucu

Çalışma öğesi izlemeye ilişkin şema tanımı, tüm form alt öğelerini ortası Case ve tüm diğer öğeleri tüm büyük harfli olarak tanımlar. Tür tanım dosyalarınızı doğrularken hatalarla karşılaşırsanız, öğelerinizin durum yapısını denetleyin. Ayrıca, açılış ve kapanış etiketlerinin durum yapısı, XML sözdizimi kurallarına göre aynı olmalıdır. Daha fazla bilgi için bkz. DENETIM XML öğesi başvurusu.

Öğe

Açıklama