Referenční dokumentace XML elementů odkazů a parametrů
Můžete přidat hypertextový odkaz na pole nebo popisek samostatné na formuláře pracovních položek s použitím Link elementu.Můžete použít Link element v následujících případech na:
Přidání popisku pole hypertextového odkazu
Přidat hypertextový odkaz na samostatný popisek nebo části informační text
Zadejte adresu URL pro obsah, který se má zobrazit v rámci formuláře pracovních položek
Chcete-li přidat elementy do formuláře, upravte definici pro typ pracovní položky.Další informace naleznete v tématu Úprava nebo přidání vlastního typu pracovní položky (WIT).
Link Element je podřízený element elementu Control elementu nebo podřízený element elementu WebpageControlTarget nebo WebpageControlOptions elementy.Další informace o těchto prvků, naleznete v části Control – referenční dokumentace elementu XML a Referenční dokumentace XML elementů WebpageControlOptions.
Schéma hierarchie
<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters"> <Param Index="IndexValue " Value="ParamValue " Type ="Original | Current"/> </Link>
Atributy a elementy
Následující části popisují atributy, podřízené prvky a nadřazené prvky.
Podřízené prvky a atributy
Prvek |
Atribut |
Popis |
|---|---|---|
Link |
|
Volitelný Control element při type="FieldControl". Volitelný LabelText elementu. Volitelný Text elementu. Volitelný WebpageControlOptions elementu. Element kontejneru pro definování hypertextový odkaz nebo adresu URL.Typ elementu je komplexní typ: HyperLinkType. |
|
UrlRoot |
Požadovaný atribut typu Link. Určuje protokol a název serveru adresy URL, na který odkazy popisku.Podporované protokoly jsou HTTP, HTTPS a MAILTO. Je možné buď napevno do kódu zadaný název serveru, nebo můžete použít jeden z následujících makra a volitelně připojit další informace o adrese do makra:
Chcete-li určit pevně zakódovaná hodnotu pro první dvě makra, můžete otevřít nastavení portálu projektu pro týmový projekt.Další informace naleznete v tématu Konfigurace nebo přesměrování pokynů k procesu. Typ atributu je jednoduchý typ: NonBlankString. |
|
UrlPath |
Volitelný atribut typu Link. Určuje cestu adresy URL pro hypertextový odkaz.Tento atribut se slouží k určení proměnných parametrů, které jsou určeny v době běhu.Typ atributu je jednoduchý typ: NonBlankString. |
Param |
|
Volitelný Link elementu.Požadováno, pokud UrlPath je zadán. Určuje hodnotu, která slouží k určení adresy URL hypertextového odkazu při UrlPath je zadán. Typ elementu je komplexní typ: HyperLinkParamType. |
|
Index |
Požadovaný atribut typu Param. Určuje index parametru, kde hodnota musí být formátována do řetězce adresy URL.Není to nutné ke třídění hodnoty indexu postupně; však musí odpovídat počtu index v poli URLPath řetězec. Typ atributu je PositiveInteger.První číslo index musí být 0. |
|
Value |
Požadovaný atribut typu Param. Určuje počet asociovaná s hodnotou pro adresu URL pro hypertextový odkaz. Určuje hodnotu, která musí být ve formátu do URLPath řetězec.Hodnoty musí být platný odkaz názvy poli použitými v definici pracovní položky typu. @Me Proměnná je podporována.Je nahrazen s názvem aktuálního člena týmu, který je zobrazení Formulář pracovní položky.Hodnota položky nejsou malá a velká písmena Typ atributu je xs:string. |
|
Type |
Volitelný atribut typu Param. Určuje, že původní hodnota pole musí být použitý pro parametr.Typ atributu je jednoduchý typ:HyperLinkParamValueKind. Platné hodnoty jsou následující:
Pokud tento atribut není zadán, je použita aktuální hodnota pole jako parametr |
Nadřazené elementy
Prvek |
Popis |
|---|---|
Požadováno.Definuje pole, text, hypertextový odkaz nebo jiného elementu ovládacího prvku na formulář pracovní položky. |
|
Volitelný Control elementu. Element kontejneru pro popisek zobrazit ve formuláři pracovní položky. |
|
Volitelný LabelText elementu. Kontejner prvku informace nebo popisku na formulář pracovní položky. |
|
Volitelný Control elementu. Element kontejneru, 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 element je hypertextový odkaz otevřete formulář pracovní položka nebo webové stránky.Pokud je chcete-li otevřít v novém okně vytvořené hypertextový odkaz (cílový = "_blank"), pak je otevřen externí prohlížeče.
Můžete kombinovat s hypertextovým odkazem a prostý text přidáním více Text elementů v LabelText elementu.
LabelText Element pouze rozpozná klientů, které jsou spuštěny na nejnovější verzi Průzkumník týmových projektů.Proto je třeba zadat Label atributu v Control element při zadání podřízený Link elementu.Pro klienty, které jsou spuštěny na nejnovější verzi Průzkumník týmových projektů, text poskytnutý LabelText element se zobrazí ve formuláři pracovní položku.Pro klienty, kteří jsou s předchozími verzemi systému Průzkumník týmových projektů, textem určeným parametrem Control element Label atribut se zobrazí ve formuláři pracovní položku.
Příklad: Zadání hypertextový odkaz s parametry
Popis
Následující příklad ukazuje, jak můžete definovat hypertextový odkaz odkazující na pokyny k procesu pro iteraci tématu:
http://název_serveru/sites/collectionName/projectName/render.aspx?wit=bug & amp; téma = iterace
Název projektu je odvozen od hodnota přiřazená k poli System.Project.
Kód
<Link UrlRoot="https://serverName" UrlPath="sites/{0}/render.aspx?wit=bug&topic=Iteration">
<Param Index="0" Value="System.Project" />
</Link>
Příklad: Přidání hypertextový odkaz na samostatné popisky
Popis
Následující příklad ukazuje, jak lze přiřadit hypertextový odkaz na text "pracovní položka doprovodné materiály" na formuláře pracovních položek.
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ý odkaz na pole
Popis
Následující příklad ukazuje, jak můžete přidat hypertextový odkaz na popisek pro pole ve formuláři pracovní položku.
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ématu
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 o elementu
Obor názvů |
https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/TypeDef |
Název schématu |
Definice typu pracovní položky |
Ověření souboru |
WorkItemTypeDefinition.xsd |
Typ elementu |
HyperLinkType, HyperLinkParamType |
Může být prázdný |
Nelze použít |