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

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:

• Especificar controles de formulario de elemento de trabajo

• Proporcionar texto de ayuda, hipervínculos o contenido web en un formulario de elemento de trabajo

• Definir controles de vínculos para restringir las relaciones de los vínculos

• Agregar el control de datos adjuntos

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.

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.

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

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.

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

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

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"

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.

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

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

Vea también

Conceptos

Agregar o modificar campos de elementos de trabajo para admitir la creación de informes

Agregar el control de datos adjuntos

Definir controles de vínculos para restringir las relaciones de los vínculos

Otros recursos

Proporcionar texto de ayuda, hipervínculos o contenido web en un formulario de elemento de trabajo