All FORM XML elements reference

Článek
09/11/2015

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 vFORMkontejner 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ématuDesign the work item form.

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 nebo obsah HTML
Elementy, které filtrovat a zobrazit odkaz relace

Příklad formuláře

Následující příklad ukazuje celkovou strukturuFORMelementu. Určete rozložení formuláře pomocíLayoutelementu. 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í proTeam 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ímGroupaColumnelementů. Můžete použítControlelementu, který chcete definovat každé pole, které se mají zobrazit ve formuláři. Můžete použítTabelementu, 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řitControlelementů vGroupa má vnořitGroupelementů vColumni v případě sloupec využito na celou šířku formuláře.Navíc by měl vnořit každýchColumnv oddíluGroupi když skupině nemá žádný viditelný popisek nebo hranice.

Element	Popis	Povinné?
Column	Rozdělí oblastí formuláře na sloupce. `<Column PercentWidth="WidthPerceOfContainingElement" FixedWidth="WidthInPixels"> <Group> . . . </Group <Control> . . . </Control> <TabGroup> . . . </TabGroup> <Splitter> . . . </Splitter> </Column >`	Vyžadováno
Control	Definuje pole, text, hypertextový odkaz nebo jiného elementu ovládacího prvku na formulář pracovní položky. `<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" />` Další informace naleznete v tématuControl – referenční dokumentace elementu XML.	Požadováno
FORM	Definuje elementem formuláře nejvyšší úrovně. `<FORM> <Layout> . . . </Layout> </FORM>`	Požadováno
Group	Poskytuje visual seskupení prvků, podobně jako skupinový rámeček systému Windows. `<Group Label="LabelText" Padding="(top, bottom, left, right)" Margin="(top, bottom, left, right)"> <Column> . . . </Column> </Group >`	Vyžadováno
Layout	Definuje rozložení formulář pracovní položky. `<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>`	Požadováno
Splitter	Rozdělí formuláře na dvě oblasti pro podporu rozložení dva elementy formuláře na stejné úrovni. `Splitter />`	Nepovinné
Tab	Definuje rozložení jednu kartu ve skupině karty. `<Tab Label="LabelText" Padding="(top, bottom, left, right)" Margin="(top, bottom, left, right)"> <Group> . . . </Group <Control> . . . </Control> <TabGroup> . . . </TabGroup> <Splitter> . . . </Splitter> </Tab>`	Nepovinné
TabGroup	Definuje jedna nebo více karet pro daný formulář. `<TabGroup Padding="( top, bottom, left, right)" Margin="(top, bottom, left, right)"> <Tab> . . . </Tab> </TabGroup>`	Nepovinné

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ématuDesign the work item form.

Atribut	Popis	Použít elementy
ControlSpacing	Volitelné. Určuje svislé posun ovládacích prvků. Celé číslo.	Layout
FixedWidth	Volitelné. Šířka sloupce v pixelech. PercentWidthaFixedWidthse vzájemně vylučují.	Column
Label	Volitelné. Text, který se zobrazí u ovládacího prvku nebo skupiny. Pokud je zadán popisek, přepíše všechny popisek, který je přidružen k poli v metadata pro ovládací prvek. PožadovanáTabelementu. Text, který se zobrazí na kartu. LabelTextje textový řetězec, který obsahuje mezi 1 až 80 znaků.	Control Group Tab
LabelPosition	Volitelné. Popisek pozici vzhledem k datům pole. Možné hodnoty jsou nahoru, dolů, doleva a doprava.	Control
LabelSpacing	Volitelné. Určuje počet pixelů mezi popiskem a upravit oblast ovládacího prvku.	Layout
Margin	Volitelné. Řetězec ve formě (vlevo, horního, pravého, dolního), který určuje velikost místa kolem ovládacího prvku a mezi ovládacího prvku a jeho okolí v pixelech. Velikost místa na obou stranách může lišit. Hodnota vzorku: ^ $\d+\,\d+\,\d+\,\d+$$ Příklad hodnoty vzor: (2,0,2,0)	Control Group Layout Tab TabGroup
MinimumSize	Volitelné. Řetězec ve formě (Šířkavýšku). Tato hodnota určuje minimální velikost samotný formulář. Když ovládací prvek menší než velikost tohoto kontejneru, zobrazí se posuvníky vodorovně a svisle.	Control Layout
Name	Volitelné. Název ovládacího prvku. Je-li tento parametr zadán, název je stejný jakoFieldName.	Control
Padding	Volitelné. Řetězec formuláři (nejvyšší, dolů, doleva, doprava), který určuje v pixelech množství prostor kolem vnějšího okraje ovládacího prvku a kolem uvnitř ohraničení. Velikost místa na obou stranách může lišit.	Control Group Layout Tab TabGroup
PercentWidth	Volitelné. Šířka sloupce jako procentní podíl šířky nadřazeného elementu. PercentWidthaFixedWidthse vzájemně vylučují.	Column
ReadOnly	Volitelné. Pole jen pro čtení lze zobrazit v ovládacím prvku. Různé ovládací prvky reagovat na tento atribut několika různými způsoby.	Control
Target	Volitelné. Řetězec, který určuje, na který klient se vztahuje toto rozložení. Visual StudioZobrazí tento typ pracovní položky v tomto rozvržení, pokudTargetatributu je vynechán nebo nastaven na Windows Forms. Externí klienti pomocí vlastní můžete zadat další rozloženíTargetatributy, kteréVisual Studioignoruje. Platné jsou následující hodnoty: WinForms: Formulář použijePrůzkumník týmových projektůaTeam Explorer Everywhere. Web: Formulář použijeTeam Web Access.	Layout
Type	Požadováno. Typ ovládacího prvku. Další informace naleznete v tématuControl – referenční dokumentace elementu XML.	Control

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

WebpageControlOptionsElementu 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ématuProvide help text, hyperlinks, or web content on a work item form.

Element	Povinné?	Popis
Content	VolitelnýWebpageControlOptionselementu.	Určuje obsah ve formátu CDATA HTML objevit formuláře pracovních položek. `<Content> <![CDATA[Contents of HTML]]> </Content>` Další informace naleznete v tématuReferenční dokumentace XML elementů WebpageControlOptions.
LabelText	VolitelnýControlelement přitype="LabelControl".	Definuje buď prostý nebo s hypertextovým odkazem popisku. Další informace naleznete v tématuReferenční dokumentace XML elementů LabelText a Text.
Link	VolitelnýControlelement přitype="FieldControl". VolitelnýTextelementu. VolitelnýWebpageControlelementu. VolitelnýWebpageControlOptionselementu.	Definuje hypertextový odkaz na pole, popisku nebo webového prohlížeče obsahu se zobrazí v formuláře pracovních položek. `<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters"> <Param /> </Link>` Další informace naleznete v tématuReferenční dokumentace XML elementů odkazů a parametrů.
Param	VolitelnýLinkelementu.	Určuje hodnotu, která určuje adresu URL hypertextového odkazu přiURLPathje určena proLinkelementu. `<Param index="IndexValue " value="ParamValue " type ="Original \| Current"/>` Další informace naleznete v tématuReferenční dokumentace XML elementů odkazů a parametrů.
Text	VolitelnýLabelTextelementu.	Kontejner prvku informace nebo popisku na formulář pracovní položky. `<Text> <Link > <Param /> </Link> LabelText </Text>` Další informace naleznete v tématuReferenční dokumentace XML elementů LabelText a Text.
WebpageControlOptions	VolitelnýControlelement přitype="WebpageControl"	Element kontejneru, který určuje možnosti pro ovládací prvek webové stránky. Další informace naleznete v tématuReferenční dokumentace XML elementů WebpageControlOptions.

Elementy, které filtrovat a zobrazit odkaz relace

Můžete použítLinksControlOptionselementu, 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. LinksControlOptionsElementu 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ématuDefinice řízení propojení s cílem omezit vztahy určené propojenímiaLinksControlOptions – elementy.

Element	Povinné?	Popis
LinksControlOptions	VolitelnýControlelement přitype="LinksControl"	Poskytuje kontejner pro prvky, které definují možnosti pro kontrolu odkazy, které mohou být přidány do pracovní položkou a výchozí sloupce, které chcete zobrazit seznam odkazů v pracovní položku.
WorkItemLinkFilters	VolitelnýLinksControlOptionselementu	Poskytuje kontejner pro jednu nebo víceFilterelementy, které určují odkaz filtrovat kritéria, která má být použit pro typy odkazů, které jsou definovány pro kolekce týmových projektů.
ExternalLinkFilters	VolitelnýLinksControlOptionselementu	Poskytuje kontejner pro jednu nebo víceFilterodkaz na elementy, které určují kritéria filtru, který má být použit pro typy, které jsou definovány v jiné týmové projekty.
WorkItemTypeFilters	VolitelnýLinksControlOptionselementu	Poskytuje kontejner pro jednu nebo víceFilterelementy, které určují kritéria filtru, který má být použita pro pracovní položky typy.
Filter(typy odkazů)	PožadovanéWorkItemLinkFilterselement přiFilterTypeatribut jeexcludeneboinclude. PožadovanéExternalLinkFilterselement přiFilterTypeatribut jeexcludeneboinclude.	Určuje typy odkazů, které chcete zahrnout nebo vyloučit ze sady odkazů, které lze vytvořit pro pracovní položku.
Filter(pracovní položky typy)	VolitelnýWorkItemTypeFilterselement přiFilterTypeatribut jeexcludeneboinclude.	Určuje typy pracovních položek, které chcete zahrnout nebo vyloučit z sadu pracovní položka typů mezi kterými lze propojit uživatelů.
LinkColumns	VolitelnýLinksControlOptionselementu	Poskytuje kontejner pro jednu nebo víceLinkColumnklíčová slova.
LinkColumn	PožadovanéLinkColumnselementu	Určuje pole pracovních položek a atributy typu odkaz na formulář pracovní položky pro seznam odkazů.

Sdílet prostřednictvím

All FORM XML elements reference

Příklad formuláře

Prvky formuláře

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

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

Elementy, které filtrovat a zobrazit odkaz relace

Viz také

Koncepty

Další zdroje

Další materiály