Elemento FIELD (Elemento WORKITEMTYPE)

Actualización: noviembre 2007

Define un campo de elemento de trabajo, y especifica las reglas y condiciones que se aplican a él.

Jerarquía del esquema

WITD (Elemento) [Esquema de definición de tipo de elemento de trabajo)

    Elemento WORKITEMTYPE (Esquema de definición del tipo de elemento de trabajo)

        Elemento FIELDS (Elemento WORKITEMTYPE)

            Elemento FIELD (Elemento WORKITEMTYPE)

<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo	Descripción
name	Atributo FieldDefinition necesario. Nombre descriptivo del campo donde se aplican las reglas y la condición. Para obtener más información, vea Nombres de campo.
refname	Atributo FieldDefinition necesario. Nombre de referencia del campo donde se aplican las reglas y condiciones. El nombre de referencia debe coincidir con el nombre de referencia definido en el elemento FIELD de la definición de campo. Para obtener más información, vea Nombres de referencia de campos.
type	Atributo FieldDefinition necesario. Tipo de valor que el campo acepta. Para obtener más información, vea Tipos de campo.
reportable	Atributo FieldDefinition opcional. Los datos del campo se exportarán al almacén de datos y se podrán incluir en informes. Para obtener más información, vea Utilizar campos para crear informes.
formula	Atributo FieldDefinition opcional. Tipo de agregación del tipo reportable measure. Actualmente, sum es el único tipo de agregación admitido para measure. Para obtener más información, vea witfields.

Elementos secundarios

Elemento	Descripción
Elemento HELPTEXT (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Define el texto mostrado en la información sobre herramientas del campo.
Elemento REQUIRED (Esquema de definición de tipo de elemento de trabajo)	Elemento opcional. Define el campo como necesario.
Elemento READONLY (Esquema de definición de tipo de elemento de trabajo)	Elemento opcional. Define el campo como de sólo lectura.
Elemento EMPTY (Esquema de definición de tipo de elemento de trabajo)	Elemento opcional. Define el campo como vacío.
Elemento FROZEN (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Define el campo como inmovilizado. Un campo inmovilizado no puede cambiarse a un valor no vacío después de confirmar los cambios. Sin embargo, se puede borrar manualmente el campo, guardar el elemento de trabajo y, a continuación, especificar un valor diferente.
Elemento CANNOTLOSEVALUE (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Define el campo de modo que no pueda perder su valor. Esto significa que el campo actual no se puede borrar ni vaciar después de que obtenga un valor.
Elemento NOTSAMEAS (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Especifica otro campo cuyo valor no puede ser idéntico al valor del campo actual.
Elemento VALIDUSER (Esquema de definición de tipo de elemento de trabajo)	Elemento opcional. Especifica que la lista de valores permitidos debe incluir solo los usuarios válidos del sistema.
Elemento ALLOWEXISTINGVALUE (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Define el campo de modo que permita el valor existente. Esto significa que se permitirán los valores de campo que ya existen, incluso si no son válidos. Todos los valores de campo nuevos deben ser válidos.
Elemento MATCH (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Define un modelo para el campo con el que debe coincidir el valor de campo.
Elemento ALLOWEDVALUES (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Define una lista de valores permitidos para el campo. Los valores permitidos son los valores que están disponibles para su selección en una lista de campos de los formularios de elementos de trabajo y en el generador de consultas. Debe seleccionar uno de estos valores.
Elemento SUGGESTEDVALUES (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Define una lista de valores sugeridos para el campo. Los valores sugeridos son los valores que están disponibles para su selección en una lista de campos de los formularios de elementos de trabajo y en el generador de consultas. Además de los valores que figuran en la lista, puede agregar otros valores.
Elemento PROHIBITEDVALUES (Esquema de definición de tipo de elemento de trabajo)	Elemento opcional. Define una lista de valores prohibidos para el campo.
Elemento DEFAULT (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Define un valor predeterminado para el campo.
Elemento COPY (Esquema de definición de tipo de elemento de trabajo)	Elemento opcional. Especifica otro campo que contiene un valor que se va a copiar en el campo actual.
Elemento SERVERDEFAULT (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Especifica un componente del servidor que proporcionará el valor para el campo.
Elemento WHEN (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Especifica una o más reglas que se aplicarán al campo actual cuando otro campo tenga un valor concreto.
Elemento WHENNOT (Esquema de definición de tipo de elemento de trabajo)	Elemento opcional. Aplica una o más reglas al campo actual cuando otro campo no tiene un valor concreto.
Elemento WHENCHANGED (Esquema de definición de tipo de elemento de trabajo)	Elemento opcional. Aplica una o más reglas al campo actual cuando se cambia el valor de un campo concreto.
Elemento WHENNOTCHANGED (Esquema de definición del tipo de elemento de trabajo)	Elemento opcional. Aplica una o más reglas al campo actual cuando no se cambia el valor de un campo concreto.

Elementos primarios

Elemento	Descripción
Elemento FIELDS (Elemento WORKITEMTYPE)	Elemento necesario. Contiene las definiciones de los campos de tipos de elementos de trabajo.

Comentarios

FIELD es un elemento secundario necesario de FIELDS.

minOccurs="1"

maxOccurs="unbounded"

Ejemplo

<FIELD name="field display name" refname="field reference name" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath" reportable="Dimension | Detail | Measure" formula="sum">
    <HELPTEXT>…</HELPTEXT>
    <REQUIRED>…</REQUIRED>
    <READONLY>…</READONLY>
    <EMPTY>…</EMPTY>
    <FROZEN>…</FROZEN>
    <CANNOTLOSEVALUE>…</CANNOTLOSEVALUE>
    <NOTSAMEAS>…</NOTSAMEAS>
    <VALIDUSER>…</VALIDUSER>
    <ALLOWEXISTINGVALUE>…</ALLOWEXISTINGVALUE>
    <MATCH>…</MATCH>
    <ALLOWEDVALUES>…</ALLOWEDVALUES>
    <SUGGESTEDVALUES>…</SUGGESTEDVALUES>
    <PROHIBITEDVALUES>…</PROHIBITEDVALUES>
    <DEFAULT>…</DEFAULT>
    <COPY>…</COPY>
    <SERVERDEFAULT>…</SERVERDEFAULT>
    <WHEN>…</WHEN>
    <WHENNOT>…</WHENNOT>
    <WHENCHANGED>…</WHENCHANGED>
    <WHENNOTCHANGED>…</WHENNOTCHANGED>
</FIELD>

Información de elemento

Espacio de nombres	https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef
Nombre de esquema	Definición del tipo de elemento de trabajo
Archivo de validación	WorkItemTypeDefinition.xsd
Tipo de elemento	FieldDefinition, tipo complejo (Elemento WORKITEMTYPE)
Puede estar vacío	Sí

Vea también

Referencia

Elemento HELPTEXT (Esquema de definición del tipo de elemento de trabajo)

Otros recursos

Esquema de definición del tipo de elemento de trabajo

Definir campos de tipo de elemento de trabajo