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. Utilice DateTimeControl para proporcionar un selector de calendario para elegir una fecha para un campo, como se muestra en la siguiente ilustración. .png "Campo Calendario")
|
Double |
FieldControl |
FieldControl se usa para proporcionar un campo de texto a fin de especificar o mostrar campos Double. |
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. .png "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. |
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. .png "Campo HTML mostrado en el formulario del elemento de trabajo")
|
Integer |
FieldControl |
FieldControl se usa para proporcionar un campo de control para un campo Integer. |
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. |
String |
FieldControl |
FieldControl se usa para proporcionar un campo de control para un campo String. Los campos String se limitan a 255 caracteres. |
TreePath |
WorkItemClassificationControl |
WorkItemClassificationControl se utiliza para proporcionar una zona de control para un campo TreePath. |
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. .gif "Nota") Nota
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. Nota
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
.png "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. .png "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. .png "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. |