Controlar cómo se muestran los campos de elementos de trabajo

Artículo
11/18/2015

En el formulario de elemento de trabajo, puede controlar el nombre de etiqueta, la posición, el tamaño del cuadro de texto y otros controles relacionados con la presentación de campos numéricos, de texto sin formato, de fechas y de elementos de trabajo de ruta de acceso de árbol. Para mostrar estos campos, debe especificar el atributo Control del elemento Type correcto entre las siguientes opciones:

DateTimeControl: se usa para mostrar campos de fecha con formato cuyo tipo de campo es DateTime.
FieldControl: se usa para mostrar campos de texto sin formato o numéricos y listas de valores de los campos con el tipo de campo String, Identity, Integer, Double y PlainText.
HtmlFieldControl: se usa para mostrar campos con formato de texto enriquecido y varias líneas cuyo tipo de campo es HTML.
WorkItemClassificationControl: se usa para mostrar los campos de ruta de acceso jerárquica con el tipo de campo TreePath.

Para obtener más información sobre otros controles Type, vea los temas siguientes:

En este tema

Controlar el tamaño y la presentación de los campos de datos
Etiquetar y agregar campos en dos ubicaciones del formulario
Crear un campo de solo lectura
Agregar campos numéricos y de texto sin formato
Agregar campos de texto con formato
Agregar campos de fecha o calendario
Agregar campos de rutas de acceso de área e iteración

Controlar el tamaño y la presentación de los campos de datos

Puede controlar el espaciado y el tamaño de cada campo de datos mediante los atributos opcionales que se describen en la tabla siguiente.

Nota

El tamaño global de cada campo de entrada de datos viene determinado por diversos factores: los atributos asignados al campo, el tamaño del contenedor y el área asignada a otros campos del formulario.Si no se especifica un tamaño mínimo en los campos, se asignan los valores predeterminados.Sin embargo, los atributos que están asignados a otros campos del formulario pueden afectar al tamaño de los campos.El número de columnas y el tamaño horizontal que asigne al campo más grande de cada columna determinará la dimensión horizontal de un formulario.El número de campos que especifique en un grupo vertical y el tamaño vertical que asigne a cada campo determinará el tamaño de la parte superior del formulario y también el tamaño de la parte inferior del mismo.

Atributo	Descripción	Ejemplo de un valor de modelo
MinimumSize	Especifica el tamaño mínimo (Ancho , Alto) del control. Cuando el tamaño del contenedor del control es menor que este tamaño, aparecen barras de desplazamiento horizontales y verticales.	(100,100)
Margin	Especifica, en píxeles, la cantidad de espacio que debe haber alrededor del control, y entre este y sus elementos colindantes (superior, inferior, izquierda, derecha).	(2,0,2,0)
Padding	Especifica, en píxeles, la cantidad de espacio que debe haber alrededor del borde exterior del control (superior, inferior, izquierda, derecha).	(2,0,2,0)

Etiquetar y agregar campos en dos ubicaciones del formulario

En cada control de formulario, puede especificar una etiqueta opcional y determinar la posición de la etiqueta utilizando los atributos Label y LabelPosition. La etiqueta puede especificar un nombre distinto al nombre descriptivo asignado por FIELD. Si no se especifica ninguna etiqueta, se usa el nombre descriptivo. Sin embargo, tenga en cuenta que el nombre descriptivo se usa siempre cuando un miembro del equipo ejecuta una consulta para buscar los elementos de trabajo. El tamaño máximo de la etiqueta es de 80 caracteres.

Nota

Debe establecer la misma posición de etiqueta en todos los controles definidos en el mismo grupo.

Si desea agregar el campo en varias áreas del formulario, por ejemplo, en la parte superior del formulario y en una pestaña, puede hacerlo utilizando el atributo Name. El atributo Name solo identifica que este control es diferente al otro control agregado al formulario.

Crear un campo de solo lectura

Puede marcar un campo como de solo lectura mediante uno de estos dos métodos. En el primer método, deberá agregar el elemento READONLY como elemento secundario del elemento FIELD en la sección FIELDS de la definición de tipos. Si usa el elemento READONLY, puede especificar si ciertos usuarios pueden modificar el campo. Como se muestra en el siguiente ejemplo, solo los administradores de programas pueden modificar el campo Sub-Title.

<FIELD name="Sub-Title" refname="ACME.ACE.SubTitle" type="String" >
<READONLY for="[Global]\Team Foundation Valid Users" not="Program Managers"/>
</FIELD>

En el segundo método, deberá especificar el atributo ReadOnly del elemento CONTROL. En este método, todos los usuarios están restringidos y no pueden modificar el campo.

Control FieldName=" ACME.ACE.SubTitle" Type="FieldControl" Label="Sub-Title" LabelPosition="Left" ReadOnly="True" />

Agregar campos numéricos y de texto

Use el tipo FieldControl para agregar campos numéricos y de texto sin formato a un formulario. Este atributo se usa también para agregar listas de selección, campos que se usan para mostrar nombres de personas (como Asignado a o Propietario) y números enteros y reales. El control del campo debe hacer referencia a un campo por su nombre de referencia. La etiqueta de campo puede ser texto sin formato o con un estilo de hipervínculo. Para obtener más información, vea Proporcionar texto de ayuda, hipervínculos o contenido web en un formulario de elemento de trabajo.

Campos numéricos enteros, de texto y de lista de selección

Grupo de varios campos

Puede controlar el formato de los campos numéricos y la longitud máxima de caracteres que se puede escribir en un campo numérico o de texto utilizando los atributos opcionales que se describen en la siguiente tabla.

Atributo	Descripción
NumberFormat	Especifica los caracteres que se pueden escribir en el control de campo. Los valores válidos son los siguientes: WholeNumbers, SignedWholeNumbers, DecimalNumbers y SignedDecimalNumbers.
MaxLength	Especifica la longitud máxima de caracteres que se puede utilizar para un control de campo.

En el código siguiente se muestra la sintaxis que se usa para crear el grupo de campos que se muestra en la ilustración anterior.

<TABGROUP>
<TAB Label="Planning">
<Group Label="Status" Padding="(0,0,0,3)">
   <Column PercentWidth="100">
      <Control FieldName="Microsoft.DevDiv.Importance" Type="FieldControl" Label="Importance" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Commitment" Type="FieldControl" Label="Commitment / Confidence" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.VisionDoc" Type="FieldControl" Label="Vision Doc" LabelPosition="Left" />
      <Control FieldName="Microsoft.DeveloperDivision.Features.EstimatedCost" Type="FieldControl" Label="Estimated Cost" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="BU (Use Area Path)" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Website" Type="FieldControl" Label="Website" LabelPosition="Left" />
   </Column>
</Group>
   . . .
</TAB>
</TABGROUP>

Agregar campos de texto con formato

Puede usar el tipo HTMLFieldControl para agregar campos cuyo tipo de datos es HTML. Este control proporciona compatibilidad para mostrar el texto con formato en varias líneas.

Campo HTML

Campo HTML mostrado en el formulario del elemento de trabajo

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.ReproSteps" Label="Repro Steps"
LabelPosition="Top" MinimumSize="(100,500)" />

Sugerencia

Cuando agregue en un formulario varios elementos HTMLFieldControl que se van a apilar verticalmente, debe especificar el atributo MinimumSize de cada control de campo.De este modo, podrá conseguir que todos los cuadros de texto tengan un tamaño similar.De lo contrario, el último elemento de control HTML cambiará de tamaño para rellenar el formulario y los elementos anteriores aparecerán juntos con cuadros de texto más pequeños.

Agregar campos de fecha o calendario

Puede usar el tipo DateTimeControl para proporcionar a los usuarios un selector de calendario en el que puedan seleccionar una fecha para un campo DateTime. Mediante este control, puede seleccionar rápidamente una fecha y hora para el campo.

Campo de calendario con Format="Short"

Campo Calendario

Por ejemplo, puede especificar la fecha de inicio que prefiera o una fecha de revisión futura.

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"
Label="Preferred Start Date:" LabelPosition="Left" Format="Short" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Format="Time" />

Puede controlar el formato del campo DateTime utilizando los atributos opcionales que se describen en la tabla siguiente.

Atributo	Descripción
Format	Especifica el formato del campo de fecha y hora que se corresponde con un valor de la enumeración DateTimePickerFormat. Los valores válidos son los siguientes: Custom, Long, Short, Time. Cuando especifica Custom, también debe indicar el atributo CustomFormat.
CustomFormat	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. Por ejemplo: Format="Custom" CustomFormat = "MMM dd, 'del año' aaaa" Para más información, visite el sitio web de Microsoft: DateTimePicker.CustomFormat (Propiedad).

Format

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

Cuando especifica Custom, también debe indicar el atributo CustomFormat.

CustomFormat

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. Por ejemplo:

Format="Custom"

CustomFormat = "MMM dd, 'del año' aaaa"

Para más información, visite el sitio web de Microsoft: DateTimePicker.CustomFormat (Propiedad).

Agregar campos de rutas de acceso de área e iteración

Puede usar el tipo WorkItemClassificationControl para agregar campos cuyo tipo de datos es TreePath. Este control proporciona compatibilidad para mostrar campos de ruta de acceso de área e iteración en forma de árbol anidado y jerárquico. El árbol muestra nodos jerárquicos que puede expandir y contraer.

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

Nota

Puede usar WorkItemClassificationControl para mostrar los campos System.AreaPath y System.IterationPath.No puede mostrar ningún otro tipo de campo o campo personalizado utilizando este control.

Para obtener más información, vea Agregar y modificar rutas de acceso de área e iteración.