Compartir a través de


Especificar controles de formulario de elemento de trabajo

Puede usar la información que se proporciona en este tema como una referencia rápida para el elemento Control, sus elementos secundarios y sus atributos. Para cada campo o control de formulario que se desee mostrar en un formulario de elemento de trabajo, se agrega un elemento Control. Puede personalizar un formulario de elemento de trabajo para mostrar información que ayude a su equipo a utilizar el formulario correctamente. Puede agregar campos y controles de elemento de trabajo que le permiten especificar y ver los datos de los que desea realizar un seguimiento. El elemento Control proporciona nueve valores para el atributo Type que puede utilizar para agregar campos o para mostrar campos o texto sin formato o de hipervínculo. Además, puede definir controles especiales para agregar vínculos y datos adjuntos, mostrar contenido basado en web, o crear su propio control y agregarlo a un formulario de elemento de trabajo.

En este tema

  • Agregar campos de elemento de trabajo a un formulario de elemento de trabajo

  • Agregar controles especiales a un formulario de elemento de trabajo

  • Agregar controles personalizados a un formulario de elemento de trabajo

Agregar campos de elemento de trabajo a un formulario de elemento de trabajo

Al personalizar el formulario de elemento de trabajo, suele agregar un subconjunto de los campos de elemento de trabajo definidos para el tipo de elemento de trabajo que desea que aparezca en el formulario. Las definiciones de campo controlan numerosos aspectos de los datos que se muestran o de los datos que se pueden especificar en el formulario. Para obtener más información, vea Definir campos de elementos de trabajo.

Cada campo de elemento de trabajo está asociado a un tipo de datos. Puede utilizar la información de la siguiente tabla para determinar el tipo de campo que un atributo Type del elemento Control admite. Utilice el atributo Label para especificar el texto que se muestra junto al control. Utilice el atributo LabelPosition relacionado para especificar dónde aparece la etiqueta en relación con el control. Para obtener más información, vea Controlar cómo se muestran los campos de los elementos de trabajo.

Nota

No puede cambiar los valores de los campos del sistema, que se actualizan automáticamente. Por ejemplo, los campos Fecha de creación y Creado por se definen la primera vez que se guarda un elemento de trabajo. Sin embargo, puede utilizar estos campos en los criterios de búsqueda. Para obtener una descripción de cada campo del sistema, vea Usar campos del sistema y campos definidos por las plantillas de proceso de MSF.

Tipo de campo

Atributo Type del elemento Control

Uso

DateTime

FieldControl

DateTimeControl

FieldControl se usa para proporcionar un campo de texto a fin de especificar o mostrar un campo de tipo de datos DateTime.

<Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" />

Utilice DateTimeControl para proporcionar un selector de calendario para elegir una fecha para un campo, como se muestra en la siguiente ilustración.

Campo Calendario
<Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />

Double

FieldControl

FieldControl se usa para proporcionar un campo de texto a fin de especificar o mostrar campos Double.

<Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />

Historial

WorkItemLogControl

Utilice WorkItemLogControl para proporcionar un campo de control para los campos de historial que realizan el seguimiento de los hilos de discusión y otra información histórica, como se muestra en la siguiente ilustración.

Pestaña y campo Historial en formulario del elemento de trabajo

Puede utilizar este control solo para admitir la presentación del campo de historial de un elemento de trabajo, el campo de elemento de trabajo System.History. Con este control, puede expandir y contraer los detalles sobre las revisiones históricas de un elemento de trabajo. También puede aplicar formato al texto que agregue al campo de historial.

<Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description
and History" LabelPosition="Top" Dock="Fill" />

HTML

HTMLControl

Utilice HTMLControl para proporcionar un campo de control que permita a los campos HTML capturar formato de texto enriquecido, como se muestra en la siguiente ilustración.

Campo HTML mostrado en el formulario del elemento de trabajo
<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />

Integer

FieldControl

FieldControl se usa para proporcionar un campo de control para un campo Integer.

<Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />

PlainText

FieldControl

Utilice FieldControl para proporcionar un campo de control para un campo PlainText, como un cuadro de texto con descripciones que pueden superar los 255 caracteres.

<Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />

String

FieldControl

FieldControl se usa para proporcionar un campo de control para un campo String. Los campos String se limitan a 255 caracteres.

<Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />

TreePath

WorkItemClassificationControl

WorkItemClassificationControl se utiliza para proporcionar una zona de control para un campo TreePath.

<Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />

Atributos Field del elemento Control opcionales para todos los tipos de control

Los siguientes atributos opcionales solo se pueden especificar para los tipos de control enumerados.

Attribute

Descripción

Field

Especifica el control que está asociado al campo de elemento de trabajo.

Label

Especifica el texto visible en el formulario que identifica el control. Escriba una cadena que no supere los 80 caracteres.

NotaNota
Puede adjuntar un hipervínculo a la etiqueta de un campo que se agrega al formulario de elemento de trabajo mediante FieldControl.Este control es útil para proporcionar un vínculo a información sobre el modo de usar el campo.Para obtener más información, vea Proporcionar texto de ayuda, guía de procesos, contenido web y vínculos con páginas web en un formulario de elemento de trabajo.

LabelPosition

Especifica la posición de la etiqueta relativa a los datos del control. Defina una cadena a partir de uno de los valores siguientes: Top, Bottom, Left y Right.

Dock

Especifica la alineación de la etiqueta con el lado indicado del contenedor o ajusta el campo de modo que rellene el contenedor. Especifica una cadena de uno de los siguientes valores: Fill, Top, Bottom, Left y Right.

Padding

Especifica, en píxeles, la cantidad de espacio alrededor del borde interior del control. Se proporcionan cuatro valores que corresponden a la parte superior, inferior, izquierda y derecha. Por ejemplo: (2,0,2,0).

Margin

Especifica, en píxeles, la cantidad de espacio alrededor del borde exterior del control. Se proporcionan cuatro valores que corresponden a la parte superior, inferior, izquierda y derecha. Por ejemplo: (2,0,2,0).

ReadOnly

Especifica si el campo es de sólo lectura. Indique True o False.

MinimumSize

Especifica el tamaño mínimo, en píxeles, que debe ocupar el control en el formulario. Se proporcionan dos valores que corresponden al ancho y alto. Por ejemplo: (100,100).

Name

Identifica un control de forma exclusiva. El atributo Name es obligatorio si hay varios controles en el formulario asociados al mismo campo de elemento de trabajo.

NotaNota
El atributo Name se usa para mostrar el mismo campo en más de un área en el formulario.Se especifica un valor único para el atributo Name de ambas entradas de control a fin de que el sistema identifique cada control de forma exclusiva.Es útil para mostrar el mismo control en varias ubicaciones en función del contexto de pestañas.

Atributos Field del elemento Control opcionales para tipos de control específicos

Los siguientes atributos opcionales solo se pueden especificar para los tipos de control enumerados.

Attribute

Tipos de control

Descripción

NumberFormat

FieldControl

Especifica los caracteres que se pueden escribir en el control de campo. Valores válidos: WholeNumbers, SignedWholeNumbers, DecimalNumbers y SignedDecimalNumbers.

MaxLength

FieldControl

Especifica la longitud máxima de caracteres que se puede utilizar para un control de campo.

Format

DateTimeControl

Especifica el formato del campo de fecha y hora que se corresponde con un valor de la enumeración DateTimePickerFormat. Valores válidos: Custom, Long, Short, Time.

CustomFormat

DateTimeControl

Especifica el formato personalizado que se utiliza en el campo de fecha y hora que corresponde a la sintaxis definida en la propiedad DateTimePicker.CustomFormat.

Agregar controles especiales a un formulario de elemento de trabajo

En la siguiente tabla se describen los atributos Type del elemento Control que proporcionan compatibilidad para poder administrar datos adjuntos de archivos, crear vínculos, mostrar contenido basado en web y ver otros datos que no están asociados a un campo de elemento de trabajo.

Atributo Type del elemento Control

Uso

AttachmentsControl

Se usa para adjuntar archivos a un formulario de elemento de trabajo. Este control normalmente se incluye en su propio grupo de pestañas, como se muestra en la siguiente ilustración.

Control de datos adjuntos

Ejemplo del control Attachments

Para obtener más información, vea Agregar el control de datos adjuntos.

LabelControl

Se usa para mostrar texto sin formato o de hipervínculo que no está asociado a un campo, como se muestra en la siguiente ilustración.

Ejemplo de dos hipervínculos aplicados a texto

Los elementos secundario y contenedor LabelText y Link se usan para especificar el texto, hipervínculo y posición de un campo o etiqueta cuyo texto está asociado en parte a un hipervínculo. Para obtener más información, vea Proporcionar texto de ayuda, guía de procesos, contenido web y vínculos con páginas web en un formulario de elemento de trabajo, Referencia de los elementos LabelText y Text de XML y Referencia de los elementos Link y Param de XML.

LinksControl

Se usa para crear y administrar vínculos entre elementos de trabajo. Este control normalmente se incluye en su propio grupo de pestañas, como se muestra en la siguiente ilustración.

Ejemplo de control de vínculos agregado a un formulario de elemento de trabajo

LinksControlOptions se usa para definir los filtros de vínculos y el diseño de los campos de columna que se utilizan para mostrar la lista de vínculos. Para obtener más información, vea Definir controles de vínculos para restringir las relaciones de los vínculos y LinksControlOptions (Elementos).

WebpageControl

Se utiliza para mostrar el contenido web en un formulario de elemento de trabajo. Este control se incluye normalmente en su propio grupo de pestañas. Utilice los elementos secundarios Link y WebpageControlOptions para especificar los controles necesarios para cargar el destino de la página web en el formulario de elemento de trabajo.

Para obtener más información, vea Agregar contenido web a un formulario de elemento de trabajo, WebpageControlOptions (Referencia de elementos de XML) y Referencia de los elementos Link y Param de XML.

Agregar controles personalizados a un formulario de elemento de trabajo

Además de los controles integrados, puede agregar su propio control personalizado a un formulario de elemento de trabajo.

Por ejemplo, puede agregar un control personalizado para obtener una captura de pantalla del portapapeles. También puede proporcionar un control para capturar varios valores agregando una casilla para los valores que se presentan en una lista o un menú.

Para implementar un control personalizado, debe especificar el nombre del control para el atributo Type. Para obtener más información, vea el sitio web de Microsoft: Work Item Tracking Custom Controls.

Vea también

Tareas

Agregar y personalizar un tipo de elemento de trabajo

Cambiar el diseño del formulario del elemento de trabajo

Cambiar la etiqueta de un campo

Agregar contenido web a un formulario de elemento de trabajo

Referencia

Referencia de elementos Control de XML

Conceptos

Diseñar y personalizar un formulario de elementos de trabajo

Historial de cambios

Fecha

Historial

Motivo

Junio de 2010

Se han agregado ilustraciones y se han trasladado algunas secciones a temas nuevos.

Mejora de la información.