Specify work item form controls

Toto téma obsahuje rychlý odkazControlelementu, jeho podřízených elementů a atributů. Pro každé pole nebo ovládacího prvku formuláře, které chcete zobrazit na formulář pracovní položky, přidejteControlelementu.

Formulář pracovní položky můžete přizpůsobit tak, aby zobrazoval informace, které pomohou vašemu týmu správně používat formulář. Můžete přidat pole pracovních položek a ovládací prvky, které umožňují zadat a zobrazit data, jež chcete sledovat.

ControlPoskytuje devět hodnot pro elementTypeatribut, který můžete použít k přidání polí nebo k zobrazení s hypertextovým odkazem nebo prostý text nebo polí. Kromě toho můžete definovat zvláštní ovládací prvky pro přidání odkazů a příloh, zobrazení webového obsahu nebo tvorbu vlastního ovládacího prvku a jeho přidání do formuláře pracovní položky.

Přidání polí pracovních položek

Při vlastním nastavení formuláře pracovní položky obvykle přidáte dílčí sadu polí pracovní položky, jež jsou definována pro typ pracovní položky, který chcete zobrazit ve formuláři. Definice polí řídí mnoho aspektů týkajících se toho, jaká data se zobrazí nebo jaká data můžete zadat do formuláře. Další informace naleznete v tématuModify or add a field to support queries, reports, and workflow.

Každému poli pracovní položky je přiřazen typ dat. Informace v následující tabulce můžete použít k určení, jaký typ pole je podporován, podle kteréhoTypeatributuControlelementu. PoužitíLabelatribut určuje text, který se zobrazí vedle ovládacího prvku. Použít souvisejícíLabelPositionatribut, který chcete určit, kde se zobrazí popisek vzhledem ovládacího prvku. Další informace naleznete v tématuControl the display of work item fields.

Poznámka

Nelze změnit hodnoty systémových polí, která jsou aktualizována automaticky.Například pole Datum vytvoření a Vytvořil jsou definována při prvním uložení pracovní položky.Tato pole však můžete použít v kritériích hledání.Popis jednotlivých polí systému naleznete v tématuWork item field reference for Visual Studio ALM.

Typ pole	Atribut typu ovládacího prvku	Využití
DateTime	FieldControl DateTimeControl	PoužitíFieldControlposkytující textové pole pro zadání nebo zobrazení datové pole typu datum a čas. <Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" /> PoužitíDateTimeControlk poskytování kalendáře výběr k výběru data pro pole, jak je znázorněno na následujícím obrázku. <Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
Double	FieldControl	PoužitíFieldControlposkytující textové pole pro zadání nebo zobrazení dvojité polí. <Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />
History	WorkItemLogControl	PoužijeteWorkItemLogControlk poskytování pole ovládacího prvku pro historii pole, která sledovat posloupnosti diskusí a dalších historických informací, jak je znázorněno na následujícím obrázku. Tento ovládací prvek slouží pouze pro podporu zobrazení pole historie pracovní položky, pole pracovní položky System.History. Pomocí tohoto ovládacího prvku můžete rozbalit nebo sbalit podrobnosti o historii revizí pro pracovní položku. Také lze naformátovat text, který jste přidali do pole historie. <Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description and History" LabelPosition="Top" Dock="Fill" />
HTML	HTMLControl	PoužitíHTMLControlChcete-li poskytnout ovládací prvek pole, které umožňují HTML pole tak, aby zachytával formátování textu, jak je znázorněno na následujícím obrázku. <Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />
Integer	FieldControl	PoužitíFieldControlpro zajištění pole ovládacího prvku pole celé číslo. <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
PlainText	FieldControl	PoužitíFieldControlk poskytování pole ovládacího prvku pro pole ve formátu prostého textu, jako je například zadejte text, který obsahuje popisy, které může být větší než 255 znaků. <Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />
String	FieldControl	PoužitíFieldControlpro zajištění pole ovládacího prvku pole řetězce. Pole s řetězci jsou omezena na 255 znaků. <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
TreePath	WorkItemClassificationControl	PoužitíWorkItemClassificationControlpro zajištění pole ovládacího prvku TreePath pole. <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />

Volitelné atributy polí ovládacích prvků pro všechny typy ovládacích prvků

Následující volitelné atributy lze určit pouze pro typy ovládacích prvků, které jsou uvedeny.

Atribut	Popis
Field	Určuje ovládací prvek, který je spojen s polem pracovní položky.
Label	Určuje viditelný text ve formuláři, který identifikuje ovládací prvek. Určuje řetězec s maximálně 80 znaky. Poznámka Můžete připojit hypertextový odkaz na název pole, který je vložen do formulář pracovní položky pomocíFieldControl.Tento ovládací prvek je užitečný k poskytnutí odkazu na informace o způsobu použití pole.Další informace naleznete v tématuProvide help text, hyperlinks, or web content on a work item form.
LabelPosition	Určuje umístění popisku souvisejícího s daty ovládacího prvku. Zadejte řetězec z jednoho z následujících hodnot:TopBottomLeftaRight.
Dock	Určuje zarovnání popisku se zadanou stranou kontejneru, nebo roztáhne pole tak, aby vyplnilo kontejner. Zadejte řetězec z jednoho z následujících hodnot:FillTopBottomLeftaRight.
Padding	Určuje velikost prostoru v pixelech kolem vnitřního ohraničení ovládacího prvku. K dispozici jsou čtyři hodnoty, které odpovídají horní, dolní, levé a pravé straně. Například: (2,0,2,0).
Margin	Určuje velikost prostoru v pixelech kolem vnějšího ohraničení ovládacího prvku. K dispozici jsou čtyři hodnoty, které odpovídají horní, dolní, levé a pravé straně. Například: (2,0,2,0).
ReadOnly	Určuje, že je pole jen pro čtení. ZadejteTrueneboFalse.
MinimumSize	Určuje minimální velikost v pixelech pro ovládací prvek ve formuláři. Jsou k dispozici dvě hodnoty, které odpovídají šířce a výšce. Například: (100,100).
Name	Jednoznačně identifikuje ovládací prvek. NameAtribut je vyžadován, pokud je více než jeden prvek ve formuláři přidružen stejné pole pracovní položky. Poznámka Můžete použítNameatribut, který chcete zobrazit stejné pole ve více než jednu oblast ve formuláři.Zadejte jedinečnou hodnotu proNameatribut pro obě položky ovládacího prvku tak, aby systém jednoznačně identifikuje každý ovládací prvek.Je vhodné zobrazit stejný ovládací prvek v různých umístěních v závislosti na kontextu karet.

Volitelné atributy polí ovládacích prvků pro konkrétní typy ovládacích prvků

Následující volitelné atributy lze určit pouze pro typy ovládacích prvků, které jsou uvedeny.

Atribut	Typy ovládacích prvků	Popis
NumberFormat	FieldControl	Určuje znaky, které lze zadat do ovládacího prvku pole. Jsou platné tyto hodnoty:WholeNumbersSignedWholeNumbersDecimalNumbersaSignedDecimalNumbers.
MaxLength	FieldControl	Určuje maximální délku znaků, které lze použít pro ovládací prvek pole.
Format	DateTimeControl	Určuje formát pro pole s datem a časem, které odpovídá jedné hodnotě ve výčtu DateTimePickerFormat. Jsou platné tyto hodnoty:CustomLongShortTime.
CustomFormat	DateTimeControl	Určuje vlastní formát, jenž se používá pro pole s datem a časem, které odpovídá syntaxi definované pro vlastnost DateTimePicker.CustomFormat.

Přidání speciálních ovládacích prvků

V následující tabulce jsou uvedenyControlelementTypeatributy, které poskytují podporu, takže můžete spravovat přílohy souborů, vytvoření odkazů, zobrazení webového obsahu a zobrazit další data, který není spojen s polem pracovní položku.

Atribut typu ovládacího prvku	Využití
AttachmentsControl	Slouží k připojení souborů k formuláři pracovní položky. Tento ovládací prvek je obvykle součástí vlastní skupiny karet, jak je znázorněno na následujícím obrázku. Ovládací prvek příloh Další informace naleznete v tématuPřidání ovládacího prvku příloh.
LabelControl	Slouží k zobrazení prostého textu nebo textu s hypertextovým odkazem, který není spojený s polem, jak je znázorněno na následujícím obrázku. Můžete použítLabelTextaLinkpodřízený objekt a kontejner elementů zadat text, hypertextový odkaz a pozici pole nebo popisek, jejíž text je částečně přidružený hypertextový odkaz. Další informace naleznete v tématuProvide help text, hyperlinks, or web content on a work item formReferenční dokumentace XML elementů LabelText a TextaReferenční dokumentace XML elementů odkazů a parametrů.
LinksControl	Slouží k vytvoření a správě vztahů mezi pracovními položkami. Tento ovládací prvek je obvykle součástí vlastní skupiny karet, jak je znázorněno na následujícím obrázku. Můžete použítLinksControlOptionsk definování připojení filtrů a rozložení tohoto pole sloupců, které se používají k zobrazení seznamu odkazů. Další informace naleznete v tématuDefinice řízení propojení s cílem omezit vztahy určené propojenímiaLinksControlOptions – elementy.
StoryboardsControl	Slouží k scénářů v aplikaci PowerPoint ze otevřít pracovní položkou a odkaz na soubory scénáře uloženo do síťové sdílené složce. Tento ovládací prvek je obvykle součástí vlastní skupiny karet, jak je znázorněno na následujícím obrázku. Chcete-li přidatStoryboardsControlkFORModdílu, přidejte následující fragment kódu: <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>
WebpageControl	Slouží k zobrazení webového obsahu ve formuláři pracovní položky. Tento ovládací prvek je obvykle součástí vlastní skupiny karet. Můžete použítWebpageControlOptionsaLinkpodřízených elementů k zadání ovládacích prvků, které jsou nutné k načtení cíl webové stránky v práci položku formuláře. Další informace naleznete v tématuPřidání webového obsahu do formuláře pracovní položky úpravou definice typu pracovní položky (WIT)Referenční dokumentace XML elementů WebpageControlOptionsaReferenční dokumentace XML elementů odkazů a parametrů.

Přidání vlastních ovládacích prvků

Kromě předdefinovaných ovládacích prvků můžete přidat vlastní ovládací prvek do formuláře pracovní položky.

Například můžete přidat vlastní ovládací prvek k pořízení snímku obrazovky ze schránky. Nebo můžete vložit ovládací prvek pro zachycení více hodnot přidáním zaškrtávacího políčka u hodnot, které jsou uvedeny v seznamu nebo v nabídce.

k implementaci vlastní ovládací prvekje třeba zadat název ovládacího prvku proTypeatributu.

Viz také

Úkoly

Změna rozložení formuláře pracovní položky

Přidání webového obsahu do formuláře pracovní položky úpravou definice typu pracovní položky (WIT)

Referenční dokumentace

Control – referenční dokumentace elementu XML