Referencia de los elementos LabelText y Text de XML

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Importante

Este artículo se aplica a la personalización de proyectos para los modelos de proceso XML locales. Para obtener información general sobre los modelos de proceso, consulte Personalización de la experiencia de seguimiento de trabajo.

Puede agregar una etiqueta independiente o texto informativo a un formulario de elemento de trabajo mediante el LabelText elemento . 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. Vea Modificar o agregar un tipo de elemento de trabajo personalizado.

El elemento LabelText es un elemento secundario del elemento Control.

Sintaxis

<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 requerido cuando type="LabelControl" .
Elemento contenedor de una etiqueta independiente o texto informativo.

Este elemento sobrescribe el valor especificado por el Label atributo especificado por el elemento Control .
Text Elemento LabelText requerido.

Elemento contenedor para la información o etiqueta que aparecerá en el formulario de elemento de trabajo. Si el elemento se especifica dentro de la etiqueta , la parte Link del texto dentro del elemento se hipervínculo. Si no Link se especifica el elemento , 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.


Si no se especifica el elemento, el texto del atributo de Text elemento aparece en el formulario del elemento de ControlLabel 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: Debe especificar el atributo en un elemento al especificar un elemento ControlLink secundario.
Para obtener más información, vea Vincular y param.

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 e hipervínculo agregando varios Text elementos en un elemento LabelText .

El elemento solo lo reconocen los clientes que ejecutan LabelText Visual Studio 2015 o versiones comparables posteriores. El atributo Label se especifica en un elemento Control . Para los clientes que ejecutan Visual Studio 2015 o versiones comparables posteriores, el texto proporcionado por el elemento aparece en el formulario LabelText de elemento de trabajo. Para los clientes que ejecutan versiones anteriores, el texto especificado por el atributo Control de elemento aparece en el formulario de elemento de Label trabajo.

Ejemplo: Etiqueta independiente

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.

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

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.

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

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.

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