Referencia de los elementos LabelText y Text de XML

Puede agregar una etiqueta independiente o texto informativo a un formulario de elemento de trabajo mediante el elemento LabelText. La etiqueta no está asociada con ningún campo de elemento de trabajo. Si lo desea, puede agregar un hipervínculo a todo el texto o a una parte.

Para agregar elementos a un formulario, hay que modificar un tipo de elemento de trabajo. Consulte Modificar o agregar un tipo de elemento de trabajo (WIT) personalizado.

El elemento LabelText es un elemento secundario del elemento Control.

Jerarquía del esquema

WITD

   WORKITEMTYPE

       FORM

           Diseño

               Agrupar

               Columna

               TabGroup

                  Tabulador

                     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 siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos y elementos secundarios

Elemento	Descripción
LabelText	Elemento Control necesario si 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 definido por el elemento Control.
Text	Elemento LabelText necesario. 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 crea un hipervínculo con la parte del texto incluida en el elemento. Si no se especifica el elemento Link, el texto se representa sin un hipervínculo. Se pueden crear hipervínculos con diferentes partes del texto de la etiqueta y distintas direcciones URL. Se pueden especificar varios valores de elemento de texto en una serie. El tipo de elemento es el tipo complejo: TextElementType. Si no se especifica el elemento Text, el texto del atributo Control del elemento Label aparece en el formulario de elemento de trabajo.
Link	Elemento Text opcional. Elemento contenedor para el hipervínculo que se aplica a un campo o etiqueta independiente que aparece en el formulario de elemento de trabajo. El tipo de elemento es HyperLinkType. Nota Si especifica un elemento Label secundario, debe especificar también el atributo Control en un elemento Link. Para obtener más información, consulte 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

Para combinar texto sin formato y con hipervínculo, agregue varios elementos Text a un elemento LabelText.

El elemento LabelText solo es reconocido por los clientes que ejecutan la versión más reciente de Team Explorer. Por lo tanto, debe especificar el atributo Label en un elemento Control. Para los clientes que ejecutan la versión más reciente de Team Explorer, el texto proporcionado 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 Control del elemento Label aparece en el formulario de elemento de trabajo.

Ejemplo: Etiqueta independiente

Descripción

En el ejemplo siguiente se agrega el texto sin formato "Enter details about how to reproduce the bug in the space below:" 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 ejemplo siguiente se agrega un hipervínculo con la etiqueta "How do I use this work item?" 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: 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, "Iteration Path", está asociada con un hipervínculo. La segunda parte, "(must be 3 levels deep)", 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