Propojení a Param referenční elementy jazyk XML

Můžete přidat hypertextový odkaz na pole nebo samostatnou jmenovku na formulář pracovní položky pomocí Link prvku.Můžete použít Link element v následujících případech k:

• Přidání hypertextového odkazu do pole Popisek

• Přidání hypertextového odkazu na samostatnou jmenovku nebo její části informačního textu

• Zadejte adresu URL pro obsah zobrazený v rámci formuláře pracovních položek

Link Prvek je podřízeným prvkem prvku Control element nebo podřízený prvek WebpageControlTarget nebo WebpageControlOptions prvky.Další informace o těchto elementech naleznete v tématech Odkaz Element jazyk XML řízení a Referenční elementy jazyk XML WebpageControlOptions.

Schéma hierarchie

WITD

   WORKITEMTYPE

       FORMULÁŘ

           Rozložení

               Skupiny

               Sloupec

               TAB

                     Ovládací prvek

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">
   <Param Index="IndexValue " Value="ParamValue " Type ="Original | Current"/>
</Link>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

Podřízené prvky a atributy

Element	Atribut	Description
Link		Volitelný Control prvek při type="FieldControl". Volitelný element typu LabelText. Volitelný element typu Text. Volitelný element typu WebpageControlOptions. Kontejner prvku pro definování hypertextový odkaz nebo URL.Typ elementu je komplexní typ: HyperLinkType.
	UrlRoot	Požadovaný atribut typu Link. Určuje protokol a název serveru na adresu URL, na které odkazy popisek.Podporované protokoly jsou HTTP, HTTPS a MAILTO. Můžete buď napevno do kódu zadaný název serveru, nebo můžete použít jednu z následujících makra a volitelně přidat další informace o adrese do makra: Poznámka Každý makro odkazuje na adresu URL, která je definována a povoleno pro týmového projektu formulář pracovní položka, pro kterou Link prvek je definován.Je-li žádné prostředky nejsou zřízeny nebo povolena týmového projektu se zobrazí chyba "page not found". @PortalPage: URL webu služby SharePoint pro aktuální týmového projektu (například http://název_serveru/sites/Název_kolekce/TeamProjectName). @ProcessGuidance: Adresa URL webu služby SharePoint pro Průvodce procesem pro týmového projektu. @ReportManagerUrl: Adresa URL serveru, který hostí správce sestav pro aktuální tým projektu.To poskytuje odkaz na zobrazení složky pro sestavy (například https://serverName/Reports/Pages/Folder.aspx?ItemPath=/Název_kolekce/teamProjectName). @ReportServiceSiteUrl: Adresa URL serveru, který je hostitelem SQL Server týmu služby Reporting Services pro aktuální projekt plus základní cesta pro týmového projektu (například http://název_serveru/Reports/Pages/reportservice.asmx?ItemPath = /Název_kolekce/teamProjectName). Chcete-li určit hodnotu pevně kódováno pro první dvě makra, můžete otevřít nastavení portálu projektu týmu projektu.Další informace naleznete v tématu Přístup k portálu týmového projektu nebo pokynům k procesu. Atribut type je jednoduchý typ: NonBlankString.
	UrlPath	Nepovinný atribut Link. Určuje cestu URL pro hypertextový odkaz.Tento atribut slouží k určení proměnných parametrů, které jsou určeny v době běhu.Atribut type je jednoduchý typ: NonBlankString.
Param		Volitelný element typu Link.Požadováno, pokud UrlPath je určena. Určuje hodnotu, která bude sloužit ke zjištění adresy URL hypertextového odkazu při UrlPath je určena. Typ elementu je komplexní typ: HyperLinkParamType.
	Index	Požadovaný atribut typu Param. Určuje index parametru, kde hodnota musí být formátován do řetězce adresy URL.Není nutné objednat hodnoty indexu postupně; však musí odpovídat počtu indexu v URLPath řetězec. Atribut type je PositiveInteger.První číslo indexu musí být 0.
	Value	Požadovaný atribut typu Param. Určuje číslo přidružené hodnoty pro cestu URL pro hypertextový odkaz. Určuje hodnotu, která musí být formátován do URLPath řetězec.Hodnoty musí být platným odkazem názvy polí, které jsou použity v definici pracovní položky typu. @Me Proměnné je podporována.Je nahrazen název aktuálního člena týmu, který je zobrazení Formulář pracovní položky.Hodnota položky nejsou malá a velká písmena Atribut type je xs:string.
	Type	Nepovinný atribut Param. Určuje, že původní hodnota pole je použít pro parametr.Atribut type je jednoduchý typ:HyperLinkParamValueKind. Platné hodnoty jsou následující: Original: Určuje použití původní hodnota parametru k určení cesty URL. Current: Určuje pomocí aktuální hodnoty parametru určit cestu URL. Pokud tento atribut není specifikován, aktuální hodnotu pole se používá jako parametr

Rodičovské elementy

Element	Description
Ovládací prvek	Povinné.Definuje pole, text, hypertextový odkaz nebo jiný ovládací prvek na formulář pracovní položky.
LabelText	Volitelný element typu Control. Kontejner prvku popisek zobrazen na formulář pracovní položky.
Text	Volitelný element typu LabelText. Kontejner prvku informace nebo popisku na formulář pracovní položky.
WebpageControlOptions	Volitelný element typu Control. Kontejner prvku, který určuje možnosti pro ovládací prvek webové stránky. Další informace naleznete v tématu Displaying Web Content within a Work Item Form.

Poznámky

Výchozí chování Link prvkem je hypertextový odkaz otevřít formulář pracovní položka nebo webové stránky.Pokud hypertextový odkaz je možno otevřít v novém okně (target = "_blank"), a pak spustil externí prohlížeče.

Text prostý a s hypertextovými odkazy můžete kombinovat přidáním více Text prvky LabelText prvku.

LabelText Element rozpoznáván pouze klienti, kteří používají nejnovější verzi Průzkumník týmových projektů.Proto je nutné zadat Label atribut v Control element, zadáte-li dítě Link element.Pro klienty, kteří používají nejnovější verzi Průzkumník týmových projektů, text poskytnutý LabelText element se zobrazí ve formuláři Položka práce.Pro klienty, kteří používají předchozí verze Průzkumník týmových projektů, text určený Control element Label atribut se zobrazí ve formuláři Položka práce.

Příklad: Zadání hypertextového odkazu s parametry

Description

Následující příklad ukazuje, jak lze definovat hypertextový odkaz s propojením na Průvodce procesem pro iteraci téma:

http://název_serveru/sites/Název_kolekce/projectName/render.aspx?wit=bug & amp; téma = iterace

Název projektu je odvozen z hodnoty přiřazené k poli System.Project.

Kód

<Link UrlRoot="https://serverName" UrlPath="sites/{0}/render.aspx?wit=bug&amp;topic=Iteration">
   <Param Index="0" Value="System.Project" />
</Link>

Příklad: Přidání hypertextového odkazu na samostatnou jmenovku

Description

Následující příklad ukazuje, jak lze přiřadit hypertextový odkaz na text "pracovní položku pokyny" na formulář pracovní položky.

Kód

<Control type="LabelControl">
   <LabelText> 
      <Text>
         <Link UrlRoot="https://www.msn.com" />
      work item guidance
      </Text>
   </LabelText> 
</Control>

Příklad: Přidání do pole typu hypertextový odkaz

Description

Následující příklad ukazuje, jak přidat hypertextový odkaz na popisek pole na formulář pracovní položky.

Kód

<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="This text comes from the Label attribute:">
   <LabelText>
      <Text>
         <Link UrlRoot="http://www.live.com/" />
         This text comes from the inner Label Text
      </Text>
   </LabelText>
</Control>

Definice schémat

• HyperLinkType

• NonBlankString

• HyperLinkParamType

• HyperLinkParamValueKind

Komplexní typ: HyperLinkType

<xs:complexType name="HyperLinkType" >
   <xs:sequence>
      <xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
   <xs:attribute name="UrlRoot"  type="NonBlankString" use="required" />
   <xs:attribute name="UrlPath"  type="NonBlankString" use="optional" />
</xs:complexType>

HyperLinkParamType

<xs:complexType name="HyperLinkParamType" >
   <xs:attribute name="Index"     type="PositiveInteger" use="required" />
   <xs:attribute name="Value"     type="xs:string" use="required" />
   <xs:attribute name="Type" type="HyperLinkParamValueKind" use="optional" />
</xs:complexType>

NonBlankString

<xs:simpleType name="NonBlankString">
   <xs:restriction  base="xs:string">
   <xs:pattern value=".*\S+.*"/>
   </xs:restriction>
</xs:simpleType>

HyperLinkParamValueKind

<xs:simpleType name="HyperLinkParamValueKind">
   <xs:restriction base="xs:string">
   <xs:enumeration value="Original"/>
   <xs:enumeration value="Current"/>
   </xs:restriction>
</xs:simpleType>   

Informace prvku

Obor názvů	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/TypeDef
Název schématu	Definice typu pracovní položky
Ověřovací soubor	WorkItemTypeDefinition.xsd
Typ elementu	HyperLinkType, HyperLinkParamType
Může být prázdný.	Nelze použít

Viz také

Koncepty

Určení ovládacích prvků ve formuláři pracovní položky

Návrh a přizpůsobení formuláře pracovní položky

Další zdroje

Elements (Work Item Type Definition Schema)