Udostępnij za pośrednictwem

Elementy XML Link and Param — Odwołanie

  • Artykuł

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 WebpageControlOptions Elementy XML — Odwołanie.

Schemat hierarchii

WITD

   WORKITEMTYPE

       FORMULARZ

           Układ

               Grupa

               Kolumny

               klawisz Tab,

                     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

Wymagany atrybut typu Link.

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 atrybut typu Link.

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

Wymagany atrybut typu Param.

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ąg.

Typ atrybutu PositiveInteger.Pierwsza liczba indeks musi mieć wartość 0.

 

Value

Wymagany atrybut typu Param.

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ąg.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 atrybut typu Param.

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 Displaying Web Content within a Work Item Form.

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 Textelementó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 Team Explorer, tekstu określonego 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