Elementy XML Link and Param — Odwołanie

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

Elementy nadrzędne

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

Zobacz też

Koncepcje

Określanie sterowania formularzem elementu pracy

Projektowanie formularza elementu roboczego