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. Podívejte se na téma Ú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

WITD

   WORKITEMTYPE

       FORMULÁŘ

           Rozložení

               Skupina

               Sloupec

               Tabulátor

                     Ovládací prvek

<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

Element	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é Link atributu. 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: Poznámka Každý macro odkazuje na adresu URL, která je definováni a povoleni pro týmový projekt ve formuláři pracovní položky, pro kterou Link element je definován.Pokud některý ze zdrojů nejsou zajištěna nebo povolena pro týmový projekt, se zobrazí chybu "stránka nebyla nalezena". @PortalPage: Adresa URL webu služby SharePoint pro aktuální týmový projekt (například http://název_serveru/sites/collectionName/TeamProjectName). @ProcessGuidance: Adresa URL webu služby SharePoint pro pokyny k procesu pro týmový projekt. @ReportManagerUrl: Adresa URL serveru, který je hostitelem správce sestav pro aktuální týmový projekt. Poskytuje odkaz na zobrazení složky pro sestavy (například https://serverName/Reports/Pages/Folder.aspx?ItemPath=/collectionName/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ý projekt (například http://název_serveru/Reports/Pages/reportservice.asmx? ItemPath = /collectionName/teamProjectName). 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ý Link atributu. 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é Param atributu. 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é Param atributu. 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ý Param atributu. 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í: Original: Určuje použití původní hodnota parametru k určení cesty URL. Current: Určuje použití aktuální hodnota parametru k určení cesty URL. Pokud tento atribut není zadán, je použita aktuální hodnota pole jako parametr

Nadřazené elementy

Element	Popis
Ovládací prvek	Požadováno. Definuje pole, text, hypertextový odkaz nebo jiného elementu ovládacího prvku na formulář pracovní položky.
LabelText	Volitelný Control elementu. Element kontejneru pro popisek zobrazit ve formuláři pracovní položky.
Text	Volitelný LabelText elementu. Kontejner prvku informace nebo popisku na formulář pracovní položky.
WebpageControlOptions	Volitelný Control elementu. Element kontejneru, který určuje možnosti pro ovládací prvek webové stránky. Další informace naleznete v tématu zobrazení webový obsah v rámci formuláře pracovních položek.

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 prvku, když zadáte 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&amp;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

Viz také

Koncepty

Specify work item form controls

Design the work item form