Referencia de los elementos Link y Param de XML

  • Artículo

Puede agregar un hipervínculo a un campo o una etiqueta independiente en un formulario de elemento de trabajo utilizando el elemento Link. Utilice el elemento Link en las instancias siguientes para:

  • Agregar un hipervínculo a una etiqueta de campo

  • Agregar un hipervínculo a una etiqueta independiente o a partes de texto informativo

  • Especifique la dirección URL para el contenido que se va a mostrar dentro de un formulario de elemento de trabajo

El elemento Link es un elemento secundario del elemento Control, o un elemento secundario del elemento WebpageControlTarget o WebpageControlOptions. Para obtener más información sobre estos elementos, vea Referencia de elementos Control de XML y WebpageControlOptions (Referencia de elementos de XML).

Jerarquía del esquema

WITD

   WORKITEMTYPE

       FORM

           Diseño

               Grupo

               Columna

               Tab

                     Control

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

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos y elementos secundarios

Elemento

Atributo

Descripción

Link

 

Elemento Control opcional cuando type="FieldControl".

Elemento LabelText opcional.

Elemento Text opcional.

Elemento WebpageControlOptions opcional.

Elemento contenedor para definir un hipervínculo o dirección URL. El tipo de elemento es el tipo complejo: HyperLinkType.

 

UrlRoot

El atributo Link es obligatorio.

Especifica el protocolo y el nombre del servidor de la dirección URL a la que se vincula la etiqueta. Los protocolos compatibles son HTTP, HTTPS y MAILTO.

Puede incluir el nombre del servidor especificado o puede utilizar una de las siguientes macros y opcionalmente anexar la información de la dirección adicional a una macro:

NotaNota
Cada macro se vincula a la dirección URL que se define y habilita para el proyecto de equipo del formulario de elemento de trabajo para el que se define el elemento Link.Si cualquiera de los recursos no se proporciona o habilita para el proyecto de equipo, aparecerá un error "página no encontrada".

  • @PortalPage: la dirección URL del sitio de SharePoint para el proyecto de equipo actual (por ejemplo, http://nombre de servidor/sitios/nombreColección/nombreDeProyectoDeEquipo).

  • @ProcessGuidanceUrl: la dirección URL del sitio de SharePoint de la guía de procesos del proyecto actual.

  • @ReportManagerUrl: la dirección URL del servidor que alberga Administrador de informes para el proyecto de equipo actual. Esto proporciona un vínculo a la vista de carpetas para los informes (por ejemplo, http://nombre de servidor/Informes/Páginas/Folder.aspx? ItemPath =/nombreColección/nombreDeProyectoDeEquipo).

  • @ReportServiceSiteUrl: la dirección URL del servidor que hospeda SQL ServerReporting Services para el proyecto de equipo actual más la ruta de acceso base para el proyecto de equipo (por ejemplo, http://nombre de servidor/Informes/Páginas/reportservice.asmx?ItemPath=/nombreColección/nombreDeProyectoDeEquipo).

Para determinar el valor codificado para las dos primeras macros, puede abrir la configuración del portal del proyecto para un proyecto de equipo. Para obtener más información, vea Acceso a la guía de procesos y al portal del proyecto de equipo.

El tipo de atributo es el tipo simple: NonBlankString.

 

UrlPath

Atributo Link opcional.

Especifica una ruta de acceso a la dirección URL para el hipervínculo. Utilice este atributo para especificar parámetros variables que se determinan en tiempo de ejecución. El tipo de atributo es el tipo simple: NonBlankString.

Param

 

Elemento Link opcional. Es obligatorio si se especifica UrlPath.

Especifica un valor que se va a usar para determinar la dirección URL del hipervínculo cuando se especifica UrlPath.

El tipo de elemento es el tipo complejo: HyperLinkParamType.

 

index

El atributo Param es obligatorio.

Especifica el índice del parámetro donde se debe dar formato al valor en la cadena de dirección URL. No hace falta ordenar los valores de índice secuencialmente; sin embargo, deben coincidir con el número del índice de la cadena URLPath.

El tipo de atributo es PositiveInteger. El primer número de índice debería ser 1.

 

value

El atributo Param es obligatorio.

Especifica el número asociado al valor de una ruta de acceso de la dirección URL del hipervínculo.

Especifica un valor al que se debe asignar formato en la cadena URLPath. Los valores deben ser nombres de referencia válidos de campos utilizados en la definición del tipo de elemento de trabajo.

Se admite la variable @Me. Se reemplaza con el nombre del miembro del equipo actual que está viendo el formulario de elemento de trabajo. Las entradas de valor no distinguen entre mayúsculas y minúsculas

El tipo de atributo es xs:string.

 

type

Atributo Param opcional.

Especifica que el valor original del campo se debe utilizar para el parámetro. El tipo de atributo es el tipo simple:HyperLinkParamValueKind.

Los valores válidos son los siguientes:

  • Original: especifica el uso del valor de parámetro original para determinar la ruta de acceso de la dirección URL.

  • Current: especifica el uso del valor de parámetro actual para determinar la ruta de acceso de la dirección URL.

Si no se especifica este atributo, el valor actual del campo se utiliza como parámetro

Elementos primarios

Elemento

Descripción

Control

Obligatorio. Define un campo, texto, hipervínculo u otro elemento de control que aparecerá en el formulario de elemento de trabajo.

LabelText

Elemento Control opcional.

Elemento contenedor de una etiqueta que aparecerá en el formulario de elemento de trabajo.

Text

Elemento LabelText opcional.

Elemento contenedor para la información o etiqueta que aparecerá en el formulario de elemento de trabajo.

WebpageControlOptions

Elemento Control opcional.

Elemento contenedor que especifica las opciones para el control de página web.

Para obtener más información, vea Displaying Web Content within a Work Item Form: WebpageControlOptions Elements.

Comentarios

El comportamiento predeterminado del elemento LINK es abrir el hipervínculo en el formulario de elemento de trabajo o la página web. Si el hipervínculo se crea para abrirse en una nueva ventana (target="_blank"), se abre un explorador externo.

Puede combinar texto sin formato y con hipervínculos agregando varios elementos TEXT en un elemento LABELTEXT.

Solo los clientes que están ejecutando la última versión de Team Explorer reconocen el elemento LABELTEXT. Por consiguiente, debe especificar el atributo Label en un elemento CONTROL al especificar un elemento LINK secundario. Para los clientes que ejecutan la última versión de Team Explorer, el texto especificado por el elemento LABELTEXT aparece en el formulario de elemento de trabajo. Para los clientes que ejecutan versiones anteriores de Team Explorer, el texto especificado por el atributo Label del elemento CONTROL aparece en el formulario de elemento de trabajo.

Ejemplo: Especificar un hipervínculo con parámetros

Descripción

El ejemplo siguiente muestra cómo puede definir un hipervínculo que se vincula a la guía de procesos del tema Iteración:

http://nombreServidor/sitios/nombreColección/nombreProyecto/render.aspx?wit=bug&amp;topic=Iteration

El nombre del proyecto se deriva del valor asignado al campo System.Project.

Código

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

Ejemplo: Agregar un hipervínculo a una etiqueta independiente

Descripción

El ejemplo siguiente muestra cómo puede asignar un hipervínculo al texto "guía de elementos de trabajo" en un formulario de elemento de trabajo.

Código

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

Ejemplo: Agregar un hipervínculo a un campo

Descripción

El ejemplo siguiente muestra cómo puede agregar un hipervínculo a la etiqueta de un campo en un formulario de elemento de trabajo.

Código

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

Definiciones de esquema

  • HyperLinkType

  • NonBlankString

  • HyperLinkParamType

  • HyperLinkParamValueKind

Tipo complejo: 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>

Información del elemento

Espacio de nombres

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef

Nombre de esquema

Definición del tipo de elemento de trabajo

Archivo de validación

WorkItemTypeDefinition.xsd

Tipo de elemento

HyperLinkType, HyperLinkParamType

Puede estar vacío

No es aplicable

Vea también

Conceptos

Especificar controles de formulario de elemento de trabajo

Diseñar y personalizar un formulario de elementos de trabajo

Otros recursos

Elements (Work Item Type Definition Schema)

Historial de cambios

Fecha

Historial

Motivo

Mayo de 2011

Se corrigió la letra de varios elementos y atributos de la sintaxis XML. La definición de esquema para el seguimiento de elementos de trabajo establece todos los elementos secundarios del elemento FORM con la convención Camel y escribe todas las letras de los nombres del resto de elementos en mayúsculas.

Corrección de errores de contenido.

Enero de 2011

Se han quitado vínculos a temas que se han retirado.

Mejora de la información.