Referenční dokumentace všech elementů XML FORM

Informace v tomto tématu můžete použít jako rychlou referenci na všechny elementy a hlavní atributy, které řídí formulář pro typ pracovní položky.Zadejte tyto prvky v FORM kontejner elementu, třetím a posledním hlavní části definice typu pracovní položky.Mnoho prvků jsou vnořené ve ostatním uživatelům ke skupinám formuláře, oddíly nebo karty v formuláře pracovních položek.Další informace o tom, jak seskupit tyto prvky naleznete v tématu Návrh formuláře pracovní položky.

V tomto tématu

• Příklad formuláře

• Syntaxe pro prvků formuláře

• Atributy, které určují prvků formuláře

• Elementy, které určují samostatné popisky, hypertextových odkazů, webových stránek a obsah HTML

• Elementy, které filtrovat a zobrazit odkaz relace

Příklad formuláře

Následující příklad ukazuje celkovou strukturu FORM elementu.Určete rozložení formuláře pomocí Layout elementu.Můžete zadat různá rozložení, které se zaměřují různé klienty.Například můžete zadat jedno rozložení pro klienty se systémem Windows a jiné rozložení pro Team Web Access.Rozložení se obvykle skládá z horní části formuláře a potom skupinu záložek.Pořadí, ve kterém můžete definovat elementů v rámci rozvržení určuje pořadí, ve kterém elementy zobrazeny ve formuláři.

Seskupit elementy zobrazit v rámci sloupce s použitím Group a Column elementy.Můžete použít Control elementu, který chcete definovat každé pole, které se mají zobrazit ve formuláři.Můžete použít Tab elementu, který chcete podporují různé funkční oblasti skupiny polí.

<FORM>
      <Layout>
        <Group>
          <Column PercentWidth="70">
            <Group>
              <Column PercentWidth="100">
                <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
                <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />
                <Control FieldName="System.IterationPath" Type="WorkItemClassificationControl" Label="&amp;Iteration Path:" LabelPosition="Left" />
                <Group>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.ProductUnit" Type="FieldControl" Label="PU (Use Area Path)" LabelPosition="Left" />
                  </Column>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.Priority" Type="FieldControl" Label="Priority" LabelPosition="Left" />
                  </Column>
                </Group>
              </Column>
            </Group>
          </Column>
          <Column PercentWidth="30">
            <Group Label="Status">
              <Column PercentWidth="100">
                <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
                <Control FieldName="System.State" Type="FieldControl" Label="State" LabelPosition="Left" />
                <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assigned To" LabelPosition="Left" />
              </Column>
            </Group>
          </Column>
        </Group>

. . .
</Layout>
</FORM>

Prvky formuláře

Můžete určit, jakým způsobem jsou seskupeny pole informace a pracovních položek a vložit do formuláře pracovních položek pomocí elementů, které jsou popsány v následující tabulce.

[!POZNÁMKA]

Nejlepších výsledků dosáhnete, by měl vnořit Control elementů v Group, a má vnořit Group elementů v Column, i v případě sloupec využito na celou šířku formuláře.Navíc by měl vnořit každých Column v oddílu Group, i když skupině nemá žádný viditelný popisek nebo hranice.

<Column PercentWidth="WidthPerceOfContainingElement" FixedWidth="WidthInPixels">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Column >

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Padding="(top, bottom, left, right)" 
Margin="( top, bottom, left, right)" ReadOnly="True | False" MinimumSize="(Width,Height)" 
Name="InstanceName" />

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

<Group Label="LabelText" Padding="(top, bottom, left, right)" Margin="(top, bottom, left, right)">
   <Column> . . . </Column>
</Group >

<Layout Target="ClientName" MinimumSize="(width,height)" Padding="(top, bottom, left, right)" 
Margin="(left, top, right, bottom)" ControlSpacing="Distance" LabelSpacing="Distance">
   <Group> . . . </Group>
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Layout>

Splitter />

<Tab Label="LabelText" Padding="(top, bottom, left, right)" Margin="(top, bottom, left, right)">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Tab>

<TabGroup Padding="( top, bottom, left, right)" Margin="(top, bottom, left, right)">
   <Tab> . . . </Tab>
</TabGroup>

Atributy, které slouží k formátování prvků formuláře

Mezery a velikost mnoho elementů na formulář pracovní položky můžete ovládat tak, že určíte atributy, které jsou popsány v následující tabulce.Další informace naleznete v tématu Návrh formuláře pracovní položky.

Elementy, které určují samostatné popisky, hypertextových odkazů, webových stránek nebo obsah ve formátu HTML

WebpageControlOptions Elementu a jeho podřízených elementů mít následující strukturu syntaxe:

<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>

Můžete použít prvky, které jsou popsány v následující tabulce můžete definovat ve formátu prostého textu nebo hypertextového odkazu popisky, přidat hypertextové odkazy na pole nebo zobrazit obsah webové stránky v formuláře pracovních položek.Další informace naleznete v tématu Poskytnutí textu nápovědy, hypertextových odkazů nebo webového obsahu ve formuláři pracovní položky.

<Content>
   <![CDATA[Contents of HTML]]>
</Content>

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">
   <Param />
</Link>

<Param index="IndexValue " value="ParamValue " type ="Original | Current"/>

<Text>
   <Link >
      <Param />
   </Link>
   LabelText
</Text>

Elementy, které filtrovat a zobrazit odkaz relace

Můžete použít LinksControlOptions elementu, který chcete definovat možnosti pro ovládání, co odkazy mohou být přidány do pracovní položkou a výchozí sloupce, které chcete zobrazit seznam odkazů v pracovní položku.Když přidáte odkaz ovládacího prvku formuláře pracovních položek, můžete určit filtry, které omezit typy odkazů, zda mohou uživatelé vytvářet a typy pracovních položek, mezi které uživatele můžete vytvořit vazbu.LinksControlOptions Elementu a jeho podřízených elementů mít následující strukturu:

<LinksControlOptions>
   <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
       <Filter LinkType="linkTypeRefName" FilterOn="reverseName | forwardName" />
   </WorkItemLinkFilters>
   <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll">
       <Filter LinkType="externalLinkName"/>
   </ExternalLinkFilters>
   <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" />
       <Filter WorkItemType="workItemTypeReferenceName"/>
   </WorkItemTypeFilters>
   <LinkColumns>
      <LinkColumn RefName="referenceName" | LinkAttribute="linkAttributeName"/>
   </LinkColumns>
</LinksControlOptions>

Konkrétně používají prvky, které je uveden v následující tabulce.Další informace o tom, jak používat tyto prvky naleznete v tématu Definice řízení propojení s cílem omezit vztahy určené propojeními a LinksControlOptions – elementy.

Viz také

Koncepty

Návrh formuláře pracovní položky

Další zdroje

Sledování pracovní položky: rejstřík definic elementů XML