Dokumentacja elementów Link i Param kodu XML

Można dodać hiperłącze do pola lub etykiety autonomicznej na formularza elementu pracy przy użyciu Link elementu. Możesz użyć Link elementu w sytuacji, gdy do:

• Dodaj hiperłącze do etykiety pola

• Dodaj hiperłącze do etykiety autonomicznej lub fragmenty tekstu informacyjnego

• Określ adres URL dla zawartości mają być wyświetlane w formularzu elementu pracy

Aby dodać elementy do formularza, możesz modyfikować definicję typu elementu roboczego. Zobacz Modyfikowanie lub dodawanie dostosowanego typu elementu pracy.

Link Element jest element podrzędny elementu Control elementu lub element podrzędny elementu WebpageControlTarget lub WebpageControlOptions elementów. Aby uzyskać więcej informacji na temat tych elementów, zobacz Element formantu XML — Odwołanie i Dokumentacja elementów XML WebpageControlOptions.

Schemat hierarchii

WITD

   WORKITEMTYPE

       FORMULARZ

           Układ

               Grupa

               Kolumna

               Tabulacja

                     Formant

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Elementy podrzędne i atrybuty

Element	Atrybut	Opis
Link		Opcjonalny Control elementu po type="FieldControl". Opcjonalny LabelText elementu. Opcjonalny Text elementu. Opcjonalny WebpageControlOptions elementu. Kontener elementu do definiowania hiperłącze lub adres URL. Typ elementu jest typ złożony: HyperLinkType.
	UrlRoot	Wymagane Link atrybutu. Określa protokół i nazwa serwera adresu URL, do którego etykieta łącza. Obsługiwane protokoły to HTTP, HTTPS i MAILTO. Można albo hardcode określonej nazwy serwera lub można użyć jednej z następujących makra i opcjonalnie Dołącz dodatkowe informacje o adresie do makra: Uwaga Każdego łącza makra do adresu URL, który jest zdefiniowany włączone dla projektu zespołowego w postaci elementów roboczych, dla której Link zdefiniowano elementu.Jeśli zasobów nie są obsługiwane lub włączone dla projektu zespołowego, pojawi się błąd "nie można odnaleźć strony". @PortalPage: Adres URL witryny programu SharePoint dla bieżącego projektu zespołowego (na przykład http://nazwa_serwera/sites/collectionName/TeamProjectName). @ProcessGuidance: Adres URL witryny programu SharePoint dla wskazówki dotyczące procesów dla projektów zespołowych. @ReportManagerUrl: Adres URL serwera, który jest hostem Report Manager dla bieżącego projektu zespołowego. Umożliwia to łącze do widoku folderów raportów (na przykład https://serverName/Reports/Pages/Folder.aspx?ItemPath=/collectionName/teamProjectName). @ReportServiceSiteUrl: Adres URL serwera, który jest hostem SQL Server usług Reporting Services dla bieżącego zespołu projektu oraz ścieżka podstawowa dla projektu zespołowego (na przykład http://nazwa_serwera/Reports/Pages/reportservice.asmx? ItemPath = /collectionName/teamProjectName). Aby określić wartość ustalony dla dwóch pierwszych makra, można także otworzyć ustawienia portalu projektu dla projektów zespołowych. Aby uzyskać więcej informacji, zobacz Konfigurowanie lub przekierowywanie sterowania procesami. Typ atrybutu jest typu prostego: NonBlankString.
	UrlPath	Opcjonalny Link atrybutu. Określa ścieżkę URL hiperłącza. Ten atrybut umożliwia określenie zmiennych parametrów, które są określane w czasie wykonywania. Typ atrybutu jest typu prostego: NonBlankString.
Param		Opcjonalny Link elementu. Wymagany, gdy UrlPath jest określony. Określa wartość do zastosowania w celu określenia adresu URL hiperłącza po UrlPath jest określony. Typ elementu jest typ złożony: HyperLinkParamType.
	Index	Wymagane Param atrybutu. Określa indeks parametru, gdzie wartość musi być sformatowany jako ciąg adresu URL. Nie jest to wymagane, aby zamówić wartości indeks sekwencyjnie; Jednakże muszą one odpowiadać liczbę indeks w URLPath ciągu. Typ atrybutu PositiveInteger. Pierwsza liczba indeks musi mieć wartość 0.
	Value	Wymagane Param atrybutu. Określa liczbę skojarzonych z wartością dla ścieżki adresu URL hiperłącza. Określa wartość, która musi mieć format do URLPath ciągu. Wartości muszą być prawidłowe odwołanie nazw z polami używanymi w definicji typu elementu pracy. @Me Zmienna jest obsługiwany. Nazwa bieżącego członek zespołu jest wyświetlanie formularza elementu pracy zostaje zastąpiony. Wpisy wartości nie jest uwzględniana Typ atrybutu xs:string.
	Type	Opcjonalny Param atrybutu. Określa, że oryginalne wartości pola musi być używany dla parametru. Typ atrybutu jest typu prostego:HyperLinkParamValueKind. Prawidłowe wartości mieszczą się w następujący sposób: Original: Określa używanie oryginalnej wartości parametrów, aby określić ścieżkę adresu URL. Current: Określa bieżącą wartość parametru do określenia ze ścieżką URL. Jeśli ten atrybut nie jest określony, bieżącą wartość tego pola jest używana jako parametr

Elementy nadrzędne

Element	Opis
Formant	Parametr wymagany. Definiuje pole, tekst, hiperłącze lub innego elementu sterowania pojawi się w formularzu elementu pracy.
LabelText	Opcjonalny Control elementu. Element kontenera dla etykiety pojawi się w formularzu elementu pracy.
Tekst	Opcjonalny LabelText elementu. Kontener element label pojawi się w formularzu elementu pracy lub informacji.
WebpageControlOptions	Opcjonalny Control elementu. Element kontenera, który określa opcje dla formantu strony sieci Web. Aby uzyskać więcej informacji, zobacz wyświetlania zawartości sieci Web, w ramach formularza elementu pracy.

Uwagi

Domyślne zachowanie Link element jest otwarcie hiperłącza w formularzu elementu roboczego lub strony sieci Web. Jeśli hiperłącze jest przypisany do otwierania w nowym oknie (cel = "_blank"), a następnie zewnętrznej przeglądarce jest otwarty.

Tekst zwykły i hiperłącze można połączyć przez dodanie wielu Text elementów w LabelText elementu.

LabelText Element jest tylko rozpoznawany przez klientów, które przebiegają w najnowszej wersji programu Team Explorer. W związku z tym, należy określić Label atrybutu w Control elementu po określeniu element podrzędny Link elementu. Dla klientów, które przebiegają w najnowszej wersji programu Team Explorer, tekst udostępnione przez LabelText element jest wyświetlany w postaci elementów roboczych. Dla klientów, które przebiegają w poprzednich wersjach programu Team Explorer, tekst określony przez Control elementu Label atrybutu pojawia się w postaci elementów roboczych.

Przykład: Określanie hiperłącze z parametrami

Opis

W poniższym przykładzie pokazano, jak można zdefiniować hiperłącze zawierającego łącze do procesu wskazówek na temat iteracji:

http://nazwa_serwera/sites/collectionName/NazwaProjektu/render.aspx?wit=bug & amp; temat = iteracji

Nazwa projektu jest tworzony na podstawie wartość przypisana do pola System.Project.

Kod

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

Przykład: Dodawanie hiperłącze do etykiety autonomicznej

Opis

W poniższym przykładzie pokazano, jak można przypisać hiperłącze tekst "pracy elementu wskazówek" na formularzu elementu pracy.

Kod

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

Przykład: Dodawanie hiperłącze do pola

Opis

W poniższym przykładzie pokazano, jak dodać hiperłącze etykietę dla pola formularza elementu pracy.

Kod

<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>

Definicje schematu

• HyperLinkType

• NonBlankString

• HyperLinkParamType

• HyperLinkParamValueKind

Typ złożony: 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>   

Informacje o elementach

Przestrzeń nazw	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/TypeDef
Nazwa schematu	Definicja typu elementu roboczego
Sprawdzanie poprawności plików	WorkItemTypeDefinition.xsd
Typ elementu	HyperLinkType, HyperLinkParamType
Może być pusta.	Nie dotyczy

Zobacz też

Koncepcje

Określanie sterowania formularzem elementu pracy

Projektowanie formularza elementu roboczego