Referencia de los elementos LabelText y Text de XML

Puede agregar una etiqueta independiente o texto informativo a un formulario de elemento de trabajo utilizando el elemento LabelText. La etiqueta no está asociada con ningún campo de elemento de trabajo. Opcionalmente, puede agregar un hipervínculo a una parte o a la totalidad del texto.

El elemento LabelText es un elemento secundario del elemento Control.

Jerarquía del esquema

WITD

   WORKITEMTYPE

       FORM

           Diseño

               Grupo

               Columna

               TabGroup

                  Tab

                     Control

<LabelText>
   <Text>
      <Link OpenInNewWindow="true | false" UrlPath="URLLinkWithParameters">
         <Param index="IndexValue " value="ParamValue " type ="Original | Current"/>
      </Link>
      LabelText
   </Text>
</LabelText>

Atributos y elementos

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

Atributos y elementos secundarios

Elemento	Descripción
LabelText	Elemento Control obligatorio cuando type="LabelControl". Elemento contenedor de una etiqueta independiente o texto informativo. El tipo de elemento es el tipo complejo: LabelElementType. Este elemento sobrescribe el valor especificado por el atributo Label especificado por el elemento Control.
Text	Elemento LabelText obligatorio. Elemento contenedor para la información o etiqueta que aparecerá en el formulario de elemento de trabajo. Si el elemento Link se especifica dentro de la etiqueta, se hipervincula la parte del texto dentro del elemento. Si no se especifica el elemento Link, el texto se representa sin un hipervínculo. Diferentes partes del texto de la etiqueta se pueden hipervincular a diferentes direcciones URL. Varios valores de elemento de texto se pueden especificar en una serie. El tipo de elemento es el tipo complejo: TextElementType. Si no se especifica el elemento Text, el texto de atributo Label del elemento Control aparece en el formulario de elemento de trabajo.
Link	Elemento Text opcional. El elemento contenedor del hipervínculo que va a aplicarse a un campo o etiqueta independiente que aparece en el formulario de elemento de trabajo. El tipo de elemento es HyperLinkType. Nota Debe especificar el atributo Label en un elemento Control al especificar un elemento Link secundario. Para obtener más información, vea Referencia de los elementos Link y Param de XML.

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.

Comentarios

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. 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: Etiqueta independiente

Descripción

En el ejemplo siguiente se agrega el texto sin formato "Escriba los detalles sobre cómo reproducir el error en el espacio siguiente:" a un formulario de elemento de trabajo.

Código

<Control Type="LabelControl" Label=" Enter details about how to reproduce the bug in the space below:">
   <LabelText>
      <Text>Enter details about how to reproduce the bug in the space below:
      </Text>
   </LabelText>
</Control>

Ejemplo: Etiqueta independiente con hipervínculo

Descripción

En el siguiente ejemplo se agrega un hipervínculo etiquetado "¿Cómo utilizo este elemento de trabajo"? a un formulario de elemento de trabajo.

Código

<Control Type="LabelControl" Label="How do I use this work item?">
   <LabelText>
      <Text>
   <Link UrlRoot="http://www.live.com"></Link>
      How do I use this work item?
      </Text>
   </LabelText>
</Control>

Ejemplo: El hipervínculo aplicado a partes de texto

Descripción

En el ejemplo siguiente se agrega una etiqueta de dos partes a un formulario de elemento de trabajo. La primera parte, "Ruta de acceso de iteración", está asociada a un hipervínculo. La segunda parte," (debe tener 3 niveles de profundidad)" aparece en el formulario de elemento de trabajo como texto sin formato.

Código

<Control Type="FieldControl" FieldName="System.IterationPath" LabelPosition="Left">
   <LabelText>
      <Text>
         <Link UrlRoot="@WssSiteUrl/render.aspx?wit=bug&amp;topic=Iteration">
         </Link>
      Iteration Path
      </Text>
      <Text> (must be 3 levels deep)</Text>
   </LabelText>
</Control>

Definiciones de esquema

Puede descargar los archivos de esquema para los tipos de definición de elementos de trabajo en la siguiente página del sitio web de Microsoft: Process Template and Work Item Schemas for Visual Studio Team Foundation. Para obtener más información sobre cómo utilizar los archivos de esquema, vea la siguiente página en el sitio web de Microsoft: Using the Schemas to Edit Work Item Types and Process Templates for Team Foundation in Visual Studio.

Elemento: LabelText

<xs:element name="LabelText" type="LabelElementType" minOccurs="0" maxOccurs="1" />
<xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />

Tipo complejo: LabelElementType

<xs:complexType name="LabelElementType">
   <xs:sequence>
      <xs:element name="Text" type="TextElementType" minOccurs="1" maxOccurs="unbounded" />
   </xs:sequence>
</xs:complexType>

Tipo complejo: TextElementType

<xs:complexType name="TextElementType" mixed="true">
   <xs:sequence>
      <xs:element name="Link" type="HyperLinkType" minOccurs="0" maxOccurs="1" />
   </xs:sequence>
</xs:complexType>

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 sintaxis del atributo UrlPath especificado para el elemento Link.	Corrección de errores de contenido.
Marzo de 2011	Se ha corregido la estructura de casos de un ejemplo y la mayoría de los elementos. Se ha agregado información acerca de dónde puede obtener acceso a los archivos de esquema.	Comentarios de los clientes.
Enero de 2011	Se han quitado vínculos a temas que se han retirado.	Mejora de la información.