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 próximas secciones 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	Requerido.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 Texten 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

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)