XML-Elementreferenz für Link und Param
Sie können einem Feld oder einer eigenständigen Bezeichnung auf einem Arbeitsaufgabenformular mit dem Link-Element einen Link hinzufügen. Das Link-Element wird in den folgenden Instanzen für diese Zwecke verwendet:
Einer Feldbezeichnung einen Link hinzufügen
Einer eigenständigen Bezeichnung oder Teilen von Informationstext einen Link hinzufügen
Angeben der URL für Inhalt, der innerhalb eines Arbeitsaufgabenformulars angezeigt werden soll
Das Link-Element ist entweder ein untergeordnetes Element des Control-Elements oder ein untergeordnetes Element des WebpageControlTarget- oder WebpageControlOptions-Elements. Weitere Informationen zu diesen Elementen finden Sie unter XML-Elementreferenz für Control sowie unter XML-Elementreferenz für WebpageControlOptions.
Schemahierarchie
<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>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.
Untergeordnete Elemente und Attribute
Element |
Attribute |
Beschreibungen |
---|---|---|
Link |
|
Optionales Control-Element, wenn type="FieldControl". Optionales LabelText-Element. Optionales Text-Element. Optionales WebpageControlOptions-Element. Containerelement zum Definieren eines Links oder einer URL. Der Elementtyp ist der komplexe Typ HyperLinkType. |
|
UrlRoot |
Erforderliches Link-Attribut. Gibt das Protokoll und den Servernamen der URL an, auf die die Bezeichnung verweist. Unterstützte Protokolle sind HTTP, HTTPS und MAILTO. Sie können den angegebenen Servernamen hart kodieren, oder Sie können eines der folgenden Makros verwenden und weitere Adressinformationen optional an ein Makro anfügen:
Hinweis
Jedes Makro verknüpft zu der URL, die für das Teamprojekt des Arbeitselementformulars definiert und aktiviert ist, für das das Link-Element definiert wurden.Wenn irgendeine der Ressourcen nicht bereitgestellt oder für das Teamprojekt aktiviert wird, tritt ein "Seite nicht gefunden"-Fehler auf.
Um den hartcodierten Wert für die ersten zwei Makros zu bestimmen, können Sie die Projektportaleinstellungen für ein Teamprojekt öffnen. Weitere Informationen finden Sie unter Zugreifen auf Teamprojektportale und Prozessleitfäden. Der Attributtyp ist ein einfacher Typ: NonBlankString. |
|
UrlPath |
Optionales Link-Attribut. Gibt einen URL-Pfad für den Link an. Sie geben variable Parameter, die zur Laufzeit bestimmt werden, mithilfe dieses Attributs an. Der Attributtyp ist ein einfacher Typ: NonBlankString. |
Param |
|
Optionales Link-Element. Erforderlich, wenn UrlPath angegeben ist. Gibt einen Wert an, mit dem die URL des Links bestimmt wird, wenn UrlPath angegeben ist. Der Elementtyp ist der komplexe Typ HyperLinkParamType. |
|
index |
Erforderliches Param-Attribut. Gibt den Index des Parameters an, wobei der Wert in die URL-Zeichenfolge formatiert werden muss. Es ist nicht erforderlich, die Indexwerte sequenziell anzufordern; sie müssen jedoch zur Nummer des Indexes in der URLPath-Zeichenfolge passen. Der Attributtyp ist PositiveInteger. Die erste Indexzahl sollte 1 sein. |
|
value |
Erforderliches Param-Attribut. Gibt die mit dem Wert für einen URL-Pfad für den Link zugeordnete Zahl an. Gibt einen Wert an, der in die URLPath-Zeichenfolge konvertiert werden muss. Werte müssen gültige Verweisnamen von Feldern sein, die in der Arbeitsaufgaben-Typdefinition verwendet wurden. Die @Me-Variable wird unterstützt. Es wird durch den Namen des aktuellen Teammitglieds ersetzt, das das aktuelle Arbeitsaufgabenformular anzeigt. Bei Werteinträgen wird keine Groß-/Kleinschreibung berücksichtigt. Der Attributtyp ist xs:string. |
|
type |
Optionales Param-Attribut. Gibt an, dass der ursprüngliche Wert des Felds für den Parameter verwendet werden muss. Der Attributtyp ist ein einfacher Typ:HyperLinkParamValueKind. Gültige Werte sind:
Wenn dieses Attribut nicht angegeben ist, wird der aktuelle Wert des Felds als Parameter verwendet. |
Übergeordnete Elemente
Element |
Beschreibungen |
---|---|
Erforderlich. Definiert ein Feld, Text, einen Link oder ein anderes Steuerelement, das auf dem Arbeitsaufgabenformular angezeigt wird. |
|
Optionales Control-Element. Containerelement für eine Bezeichnung, die im Arbeitsaufgabenformular angezeigt wird. |
|
Optionales LabelText-Element. Containerelement für die Informationen oder die Bezeichnung, die im Arbeitsaufgabenformular angezeigt werden. |
|
Optionales Control-Element. Containerelement, das die Optionen für das Webseiten-Steuerelement angibt. Weitere Informationen finden Sie unter Displaying Web Content within a Work Item Form: WebpageControlOptions Elements. |
Hinweise
Das Standardverhalten des LINK-Elements ist, den Link im Arbeitsaufgabenformular oder der Webseite zu öffnen. Wenn der Link in einem neuen Fenster (target="_blank") geöffnet wird, wird ein externer Browser geöffnet.
Sie können einfachen und durch Links verbundenen Text durch Hinzufügen von mehreren TEXT-Elementen in einem LABELTEXT-Element kombinieren.
Das LABELTEXT-Element wird nur von Clients erkannt, die die neueste Version von Team Explorer ausführen. Daher muss das Label-Attribut in einem CONTROL-Element angegeben werden, wenn Sie ein untergeordnetes LINK-Element angeben. Bei Clients, die die aktuellste Version von Team Explorer ausführen, erscheint der Text, der vom LABELTEXT-Element bereitgestellt wurde, im Arbeitsaufgabenformular. Bei Clients, die frühere Versionen von Team Explorer ausführen, erscheint der Text, der vom CONTROL-Element-Label-Attribut angegeben wurde, im Arbeitsaufgabenformular.
Beispiel: Angeben eines Links mit Parametern
Beschreibungen
Im folgenden Beispiel wird gezeigt, wie Sie einen Link definieren können, der zum Prozessleitfaden für das Iterationsthema verweist:
https://serverName/sites/collectionName/projectName/render.aspx?wit=bug&topic=Iteration
Der Name des Projekts wird vom dem System.Project-Feld zugewiesenen Wert abgeleitet.
Code
<Link UrlRoot="https://serverName" UrlPath="sites/{0}/render.aspx?wit=bug&topic=Iteration">
<Param index="1 " value="System.Project"/>
</Link>
Beispiel: Hinzufügen eines Links zu einer eigenständigen Bezeichnung
Beschreibungen
Im folgenden Beispiel wird veranschaulicht, wie Sie dem Text "Arbeitsaufgabenleitfaden" einen Link hinzufügen können.
Code
<Control type="LabelControl">
<LabelText>
<Text>
<Link UrlRoot="https://www.msn.com" />
work item guidance
</Text>
</LabelText>
</Control>
Beispiel: Hinzufügen eines Links zu einem Feld
Beschreibungen
Im folgenden Beispiel wird veranschaulicht, wie Sie einer Feldbezeichnung auf dem Arbeitsaufgabenformular einen Link hinzufügen können.
Code
<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>
Schemadefinitionen
HyperLinkType
NonBlankString
HyperLinkParamType
HyperLinkParamValueKind
Komplexer 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>
Elementinformationen
Namespace |
https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef |
Schemaname |
Arbeitsaufgabentypdefinition |
Validierungsdatei |
WorkItemTypeDefinition.xsd |
Elementtyp |
HyperLinkType, HyperLinkParamType |
Kann leer sein |
Nicht zutreffend |
Siehe auch
Konzepte
Angeben von Steuerelementen für Arbeitsaufgabenformulare
Entwerfen und Anpassen eines Arbeitsaufgabenformulars
Weitere Ressourcen
Elements (Work Item Type Definition Schema)
Änderungsprotokoll
Datum |
Versionsgeschichte |
Grund |
---|---|---|
Mai 2011 |
Der Fall von mehreren Elementen und Attributen von XML-Syntax wurde korrigiert. In der Schemadefinition zur Arbeitsaufgabenverfolgung werden alle untergeordneten Elemente des FORM-Elements mit Binnenversalien und Großbuchstaben in den Namen aller anderen Elemente definiert. |
Korrektur inhaltlicher Fehler. |
Januar 2011 |
Links zu nicht mehr vorhandenen Themen wurden entfernt. |
Informationsergänzung. |