FIELD (Definición) (Elemento)

Puede usar el elemento FIELD (Definition) para definir un campo de elemento de trabajo y especificar las reglas y condiciones que se aplican a él. Los atributos que asigna a un campo determinan cómo aparece en un formulario de elemento de trabajo y si está disponible para la inclusión en informes. Administra el conjunto de asignaciones de campo de una colección de proyectos de equipo. Por consiguiente, los atributos que asigna a los campos que se definen en un tipo de elemento de trabajo deben coincidir en todos los tipos de elementos de trabajo de todos los proyectos de equipo de una colección. Además, todos los campos reportables de todas las colecciones se exportan a las bases de datos de almacenamiento de datos.

Nota

Para obtener información acerca del elemento FIELD (Flujo de trabajo), que utiliza para especificar las reglas y condiciones a los campos durante un cambio de estado o transición del flujo de trabajo, vea FIELD (Workflow) (elemento).

Puede cambiar las asignaciones de atributos que efectúa a los campos existentes de una colección utilizando la herramienta de comando witadmin. Para obtener más información, vea Administrar campos de elemento de trabajo [witadmin].

Jerarquía del esquema

WITD

   WORKITEMTYPE

      FIELDS

            FIELD

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

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" syncnamechanges ="true | false" reportable="Dimension | Detail | Measure" formula="sum" reportingname="ReportingDisplayName" reportingrefname="ReportingReferenceName" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

Atributos y elementos

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

Atributos

Atributo	Descripción
name	Obligatorio. Nombre descriptivo del campo que aparece en los menús desplegables de las consultas de elementos de trabajo. El nombre descriptivo debe ser único en todos los campos que se definen dentro de un proyecto de equipo. Asimismo, el nombre descriptivo puede ser diferente a la etiqueta que aparece al lado del campo en el formulario del elemento de trabajo. Para obtener más información, vea Referencia de elementos Control de XML. El tipo de atributo es typelib:FieldName. Longitud mínima: 1; longitud máxima: 128. Valor de modelo: ^[^\. \[\]]+$ Ejemplo de un valor de modelo: Asignado a
refname	Obligatorio. La etiqueta única que distingue un campo de todos los demás campos definidos en la colección de proyectos de equipo. Para obtener requisitos y restricciones adicionales para los nombres descriptivos y nombres de referencia, vea Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo. El tipo de atributo es typelib:ReferenceFieldName. Longitud mínima: 1; longitud máxima: 70. Valor de modelo: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Ejemplo de un valor de modelo: Company.IssueType
type	Obligatorio. Especifica el tipo de datos que acepta el campo. Nota Los campos de colecciones de proyectos diferentes que tienen el mismo reportingrefname deben tener asignado el mismo valor para type.Si los valores difieren, se pueden producir conflictos de los datos cuando se procesa el almacenamiento de datos.Para obtener más información, vea Resolver los conflictos del esquema que se producen en el almacén de datos. En la siguiente tabla se enumeran los valores válidos de este atributo: ValorUso DateTime Especifica una fecha según la Hora universal coordinada (Hora UTC). Double Especifica un valor de coma flotante. GUID Especifica un campo que contendrá un identificador único. History Admite hilos de discusión y hace un seguimiento de otra información histórica. Nota El campo System.History es el único campo que utiliza este tipo de datos.No puede definir ningún campo personalizado utilizando este tipo de datos. HTML Admite la captura de datos de texto enriquecido y se utiliza para descripciones de texto más largas, tales como una descripción de elemento de trabajo. Integer Especifica un valor entero de 32 bits con signo. PlainText Admite la entrada de una cadena de texto con más de 255 caracteres Unicode. String Admite la entrada de una cadena de texto hasta 255 caracteres Unicode.Utilice un campo String para una etiqueta u otra cadena de texto corta hasta una línea de longitud. TreePath Especifica un campo que muestra las entradas con una estructura jerárquica o de árbol, tales como los requisitos para mostrar rutas de acceso de área e iteración de un producto. Nota Los campos System.AreaPath y System.IterationPath son los únicos campos que utilizan este tipo de datos.No puede definir ningún campo personalizado utilizando este tipo de datos.
syncnamechanges	Opcional. Especifica si el campo de elemento de trabajo se utiliza para almacenar nombres que desea actualizar cuando se realicen modificaciones en Active Directory o en un grupo de trabajo. Esta opción sólo es válida cuando type="String". El tipo de atributo es xs:boolean. Especifique true para habilitar la sincronización para el campo de datos, especifique false para deshabilitar la sincronización para el campo de datos.
reportable	Opcional. Especifica si los datos del campo están disponibles para la inclusión en los informes. Los campos con el valor predeterminado de None no se exportan al almacenamiento de datos relacional ni se procesan para el cubo de SQL Server Analysis Services. Para obtener más información sobre los campos reportables, vea Agregar y modificar campos de elementos de trabajo para la compatibilidad con la creación de informes. Nota Los campos de colecciones de proyectos diferentes que tienen el mismo valor de reportingrefname deben tener asignado el mismo valor para reportable.Si los valores difieren, se pueden producir conflictos de los datos cuando se procesa el almacenamiento de datos.Para obtener más información, vea Resolver los conflictos del esquema que se producen en el almacén de datos. En la siguiente tabla se enumeran los valores válidos de este atributo: Value Uso Detail Se puede especificar para los campos de tipo DateTime, Double, Integer o String. Los datos de este campo se mueven a la base de datos relacional del almacén de datos en las tablas de historial de elementos de trabajo y de elemento de trabajo actual, pero no en el cubo Analysis Services.Este tipo es una buena opción para los campos de texto sin restricciones porque puede utilizarlos en informes sin hacer el cubo significativamente mayor. Dimension Se puede especificar para los campos de tipo DateTime, Double, Integer o String. Los datos de este campo se incorporan a la base de datos relacional del almacén de datos y al cubo de Analysis Services como un atributo de dimensión de elemento de trabajo, de modo que los datos se puedan utilizar para filtrar los informes.Utilice este tipo para campos que tengan listas de valores válidos.El tipo de elemento de trabajo y el estado son buenos ejemplos dimensiones. Measure Sólo utilice el tipo de medida para campos de tipo Integer y Double.Las medidas son los valores numéricos de los informes.Cuando se procesa el cubo de Analysis Services, los datos se precalculan en campos cuyos atributos reportable se establecen para medir.Por ejemplo, los grupos de medida de elementos de trabajo y del elemento de trabajo actual contienen datos acumulados para los siguientes campos: Estimación original, Horas restantes y Horas completadas.Cuando especifica la medida, debe indicar el atributo formula. None Especifique None si no desea utilizar el campo para la inclusión en informes.Esta es la asignación predeterminada.
formula	Opcional. Tipo de agregación del tipo reportable measure. El único valor válido es sum, que devuelve la suma de todos los valores sobre el conjunto.
reportingname	Opcional. Especifica el nombre que aparece en los informes. Si no especifica un valor, se usa el valor asignado al atributo name. Nota Los campos de colecciones de proyectos diferentes que tienen el mismo reportingrefname deben tener asignado el mismo valor para reportingname.Si los valores difieren, se pueden producir conflictos de los datos cuando se procesa el almacenamiento de datos.Para obtener más información, vea Resolver los conflictos del esquema que se producen en el almacén de datos. El tipo de atributo es typelib:FieldName. Longitud mínima: 1; longitud máxima: 128. Valor de modelo: ^[^\. \[\]]+$ Ejemplo de un valor de modelo: Asignado a
reportingrefname	Opcional. Especifica el nombre de referencia que se utiliza cuando se procesa un campo reportable. Si no especifica un valor, se usa el valor asignado al atributo refname. Puede utilizar este atributo para combinar o divergir campos que se procesan en el almacenamiento de datos. Para combinar dos campos que tienen nombres de referencia distintos y que están definidos en colecciones de proyectos diferentes, asigne el mismo reportingrefname a ambos. Para distinguir dos campos con el mismo nombre de referencia pero que están definidos en colecciones de proyectos diferentes, asigne un valor de reportingrefname diferente a cada campo. Siempre que sea posible, deberá combinar los campos para minimizar el número de campos del almacén de datos y para mantener los campos para informes dentro del límite máximo, que es de 1024. Puede generar informes entre grupos con campos combinados. El tipo de atributo es typelib:ReferenceFieldName. Longitud mínima: 1; longitud máxima: 70. Valor de modelo: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Ejemplo de un valor de modelo: Company.IssueType

Elementos secundarios

Elemento	Descripción
ALLOWEDVALUES	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.
ALLOWEXISTINGVALUE	Opcional. Define el campo de modo que permita los valores existentes. Este elemento permite usar los valores de campo que ya existen, incluso si no son válidos. Todos los valores de campo nuevos deben ser válidos.
CANNOTLOSEVALUE	Opcional. Define el campo de modo que no pueda perder su valor. Este elemento mantiene el valor de campo actual y no se puede borrar o dejar vacío.
COPY	Opcional. Especifica otro campo que contiene un valor que se va a copiar en el campo actual.
DEFAULT	Opcional. Define un valor predeterminado para el campo.
EMPTY	Opcional. Define el campo como vacío.
FROZEN	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.
HELPTEXT	Opcional. Define el texto mostrado en la información sobre herramientas del campo.
MATCH	Opcional. Define un modelo para el campo con el que debe coincidir el valor de campo.
NOTSAMEAS	Opcional. Especifica otro campo cuyo valor no puede ser idéntico al valor del campo actual.
PROHIBITEDVALUES	Opcional. Define una lista de valores prohibidos para el campo.
READONLY	Opcional. Define el campo como de sólo lectura.
REQUIRED	Opcional. Define el campo como necesario.
SERVERDEFAULT	Opcional. Especifica un componente del servidor que proporcionará el valor para el campo.
SUGGESTEDVALUES	Opcional. Define una lista de valores propuestos 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.
VALIDUSER	Opcional. Especifica que la lista de valores permitidos debe incluir solo los usuarios válidos del sistema.
WHEN	Opcional. Especifica una o más reglas que se aplicarán al campo actual cuando otro campo tenga un valor concreto.
WHENCHANGED	Opcional. Aplica una o más reglas al campo actual cuando se cambia el valor de un campo concreto.
WHENNOT	Opcional. Aplica una o más reglas al campo actual cuando otro campo no tiene un valor concreto.
WHENNOTCHANGED	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
FIELDS	Obligatorio. Contiene las definiciones de los campos de tipos de elementos de trabajo.

Comentarios

FIELD (Definición) es un elemento secundario necesario de FIELDS (Definición).

minOccurs="1"

No puede definir más de 1.024 campos de elemento de trabajo en la misma colección de proyectos de equipo, y no puede establecer más de 1.024 campos como reportables en todas las colecciones de proyectos de equipo. Para obtener más información, vea Agregar y modificar campos de elementos de trabajo para la compatibilidad con la creación de informes.

Nota

Al agregar un campo existente a un tipo de elemento de trabajo diferente, se utilizan los valores actuales de los atributos reportables.

Para obtener requisitos y restricciones adicionales para los nombres descriptivos de campos y nombres de referencia, vea Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo. Para obtener información sobre cómo etiquetar campos para los informes, vea Agregar y modificar campos de elementos de trabajo para la compatibilidad con la creación de informes.

No puede definir ningún campo personalizado que empiece con el prefijo System.. Puede definir un campo utilizando el prefijo Microsoft.; sin embargo, no se recomienda hacerlo porque podría impedir la funcionalidad de Team Foundation Server.

Para obtener información general sobre el objeto de seguimiento de los elementos de trabajo de un campo, vea Trabajar con campos de elementos de trabajo.

Para obtener información general sobre los campos del sistema y campos predefinidos de la plantilla de proceso Microsoft Solutions Framework (MSF) for Agile Software Development v5.0 , vea Usar campos del sistema y campos definidos por las plantillas de proceso de MSF.

No se puede cambiar el nombre de los nombres de referencia de campos. Puede enumerar campos, cambiar el nombre descriptivo de los campos y cambiar los atributos de campo mediante la herramienta de la línea de comandos witadmin. Para obtener más información, vea Administrar campos de elemento de trabajo [witadmin].

Para obtener información sobre cómo se utilizan los campos en las colecciones de proyectos de equipo, vea Resolver los conflictos del esquema que se producen en el almacén de datos y Agregar y modificar campos de elementos de trabajo para la compatibilidad con la creación de informes.

Ejemplo

<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
   <HELPTEXT>Type of work involved</HELPTEXT>
   <SUGGESTEDVALUES>
      <LISTITEM value="Development"/>
      <LISTITEM value="Testing"/>
      <LISTITEM value="Requirements"/>
      <LISTITEM value="Design"/>
      <LISTITEM value="Deployment"/>
      <LISTITEM value="Documentation"/>
   </SUGGESTEDVALUES>
</FIELD>

Vea también

Referencia

Administrar campos de elemento de trabajo [witadmin]

Conceptos

Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo

Usar campos del sistema y campos definidos por las plantillas de proceso de MSF

Personalizar datos de seguimiento, formularios, flujos de trabajo y otros objetos de proyecto

Trabajar con campos de elementos de trabajo

Otros recursos

Índice de definiciones de elementos XML para tipos de elementos de trabajo

Historial de cambios

Fecha	Historial	Motivo
Enero de 2011	Ha simplificado el contenido y ha quitado los vínculos a los temas que se han quitado.	Mejora de la información.