Sdílet prostřednictvím

Propojení a referenční elementy Param XML

  • Článek

Přidat hypertextový odkaz na pole nebo samostatný popisek ve formuláři položky práce pomocí LINK prvku. Použití LINK v následujících případech k prvku:

  • Přidat hypertextový odkaz na popisek pole

  • Přidat hypertextový odkaz na samostatný popisek nebo části informační text

  • Zadejte adresu URL pro obsah zobrazený ve formuláři položky práce

LINK Prvkem je buď dceřiný element CONTROL prvku nebo podřízený prvek WebpageControlTarget nebo WebpageControlOptions prvky. Další informace o těchto prvků naleznete v Odkaz Element XML řízení a Referenční elementy WebpageControlOptions XML.

Hierarchii schématu

WITD

   WORKITEMTYPE

       FORMULÁŘ

           ROZLOŽENÍ

               GROUP

               COLUMN

               Klávesa TAB

                     OVLÁDACÍ PRVEK

<xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
<xs:element name="Param" type="HyperLinkParamType" minOccurs="0" maxOccurs="unbounded"/>

<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

Prvek

Atribut

Popis

LINK

 

Volitelný CONTROL prvek při type="FieldControl".

Volitelný TE prvku.

Volitelný WebpageControl prvku.

Volitelný WebpageControlOptions prvku.

Prvek kontejner pro definice hypertextový odkaz nebo URL. Komplexní typ je typ prvku: HyperLinkType.

 

URLRoot

Požadované LINK atributu.

Určuje protokol a název serveru URL, které odkazy popisek. Jsou podporovány protokoly HTTP, HTTPS a MAILTO.

Můžete buď hardcode zadaný název serveru nebo můžete použít jednu následující makra a další informace o adrese volitelně přidat do makra:

PoznámkaPoznámka
Každé makro odkazy na adresu URL, která je definována a jehož povoleno formuláře položky pracovního týmu projektu LINK je definován prvek.Pokud některý z prostředků není plynulou nebo povoleno týmu projektu "page not found" Zobrazí se chyba.

  • @PortalPage: Adresu URL webu služby SharePoint pro aktuální projekt týmu (například http://název_serveru/sites/Název_kolekce/TeamProjectName).

  • @ProcessGuidanceUrl: Adresa URL webu SharePoint pokyny proces týmu projektu.

  • @ReportManagerUrl: Adresa URL serveru, který je hostitelem Správce sestav pro aktuální projekt týmu. 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 hostujícího SQL Server týmu služby Reporting Services pro aktuální projekt plus základní cesty týmu 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, otevřete nastavení portálu projektu týmu projektu. Další informace naleznete v tématu Přístup k portálu týmu projektu a orientační procesu.

Jednoduchý typ je typ atributu: NonBlankString.

 

URLPath

Volitelný LINK atributu.

Určuje cestu URL hypertextového odkazu. Pomocí tohoto atributu zadat proměnné parametrů, které jsou určeny v době běhu. Jednoduchý typ je typ atributu: NonBlankString.

PARAM

 

Volitelný LINK prvku. Požadováno při URLPath je zadán.

Určuje hodnotu určit URL hypertextového odkazu při URLPath je zadán.

Komplexní typ je typ prvku: HyperLinkParamType.

 

index

Požadované PARAM atributu.

Určuje index, kde hodnota musí být formátován do adresy URL řetězec parametru. Není nutné objednat hodnoty indexu postupně; však musí odpovídat číslu v indexu URLPath řetězec.

Typ atributu je PositiveInteger. První číslo indexu by měl být 1.

 

value

Požadované PARAM atributu.

Určuje číslo přidružené hodnoty cestu URL hypertextového odkazu.

Určuje hodnotu, která musí být formátován do URLPath řetězec. Hodnoty musí být platný odkaz názvy polí v definici typu pracovní položky.

@Me Podporovány proměnné. Je nahrazen název aktuálního člena týmu, je zobrazení formulář pracovní položky. Hodnota položky nejsou rozlišována

Typ atributu je xs:string.

 

type

Volitelný Param atributu.

Určí, že musí být původní hodnoty pole pro parametr. Typ atributu je jednoduchý typ:HyperLinkParamValueKind.

Platné hodnoty jsou:

  • Original: Určuje použití původní hodnota parametru určit adresu URL.

  • Current: Určuje pomocí aktuální hodnoty parametru určit adresu URL.

Pokud tento atribut není zadán, je použita aktuální hodnota pole jako parametr

Nadřazené prvky

Prvek

Popis

OVLÁDACÍ PRVEK

Povinné. Definuje pole, text, hypertextový odkaz nebo jiný prvek ovládací prvek na formuláři práce.

LABELTEXT

Volitelný CONTROL prvku.

Prvek kontejneru popisku na formuláři práce.

TEXT

Volitelný LABELTEXT prvku.

Prvek kontejneru informace nebo popisku na formuláři práce.

WebpageControlOptions

Volitelný CONTROL prvku.

Prvek kontejner, 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: WebpageControlOptions Elements.

Poznámky

Výchozí chování LINK prvkem je otevřít hypertextový odkaz ve formuláři položky práce nebo webové stránky. Pokud je vytvořen hypertextový odkaz otevřít v novém okně (target = "_blank"), a pak otevřít externí prohlížeče.

Můžete kombinovat s hypertextovými odkazy a prostý text přidáním více TEXT prvky LABELTEXT prvku.

LABELTEXT Prvek rozpoznáván pouze klienti se systémem nejnovější verzi Průzkumník týmu. Proto je nutné zadat Label atributu v CONTROL Při zadání podřízený prvek LINK prvku. Pro klienty, kteří používají nejnovější verzi Průzkumník týmu, podle textu LABELTEXT prvku se zobrazí ve formuláři položky práce. Pro klienty, kteří používají předchozí verze Průzkumník týmu, text určený CONTROL element Label atributu se zobrazí ve formuláři položky práce.

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

Popis

Následující příklad ukazuje, jak lze definovat hypertextový odkaz propojující proces návod 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 od hodnoty přiřazené k System.Project pole.

Kód

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

Příklad: Přidání hypertextového odkazu samostatný popisek

Popis

Následující příklad ukazuje, jak přiřadit hypertextový odkaz na text "pokyny ke zboží práce" ve formuláři položky práce.

Kód

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

Příklad: Přidání hypertextového odkazu do pole

Popis

Následující příklad ukazuje, jak lze přidat hypertextový odkaz na popisek pole ve formuláři položky práce.

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

Zadejte definici pracovní položky

Ověřovací soubor

WorkItemTypeDefinition.xsd

Typ prvku

HyperLinkType, HyperLinkParamType

Může být prázdný.

Nelze použít

Viz také

Koncepty

Určení pracovní položky ovládací prvky

Navrhování a přizpůsobení formuláře pracovní položky

Další zdroje

Elementy (práce typ položka definice schématu)

Historie změn

Datum

Poslední dokumenty

Důvod

Leden 2011

Odebrat odkazy na témata, které byly odebrány.

Rozšíření informace