Trabajar con campos de elementos de trabajo

Utilice campos de elemento de trabajo para realizar el seguimiento de los datos para un tipo de elemento de trabajo y definir los criterios de filtro para las consultas, así como para generar los informes. Todos los elemento de datos, salvo los campos de datos básicos del sistema, de los que desee hacer seguimiento, utilizar para definir el flujo de trabajo o que aparezcan en el formulario de un tipo de elemento de trabajo se deben definir como campos de elemento de trabajo. Puede definir campos de elementos de trabajo dentro de la definición de un tipo de elemento de trabajo o de un flujo de trabajo global.

Los campos del elemento de trabajo se mantienen para una colección de proyectos de equipo. Agregue los campos al realizar una de las siguientes tareas:

• Crea un proyecto de equipo. Todos los campos que se definen dentro de las definiciones de los tipos de elementos de trabajo o flujos de trabajo globales que estén definidos para la plantilla de proceso seleccionada. Para obtener más información, vea Campos de elementos de trabajo (Agile) o Campos de elementos de trabajo (CMMI). Los campos de sistema básicos se definen automáticamente para cada tipo de elemento de trabajo definido para un proyecto de equipo. Para obtener una lista de estos campos, vea Usar campos del sistema y campos definidos por las plantillas de proceso de MSF.

• Importa una nueva definición de tipo de elemento de trabajo. Todos los campos nuevos definidos dentro de la definición de un tipo de elemento de trabajo se agregan a la colección. Para obtener más información, vea Referencia de todos los elementos XML WITD.

• Importa una definición de flujo de trabajo global. Todos los nuevos campos que se definen dentro del flujo de trabajo global se agregan a la colección. Los flujos de trabajo globales se definen para mantener un conjunto de elementos de trabajo que comparten varios tipos de elementos de trabajo. Para obtener más información, vea Personalizar el flujo de trabajo.

• Asigna una colección de proyectos a una instancia de Project Web App (PWA). Después de instalar Visual Studio Team Foundation Server 2010 y el Feature Pack de Integración de Project Server, configure la integración asignando varios componentes de Team Foundation. Al asignar una colección, se importa una definición de flujo de trabajo global que admite varios campos en campos de Project Server. Para obtener más información, vea Campos de Project Server agregados para admitir la sincronización de datos.

Todos los campos definidos en todos los tipos de elemento de trabajo y todos los flujos de trabajo global para todos los proyectos de equipo constituyen el conjunto completo de campos que se define para la colección de proyectos. Puede cambiar el atributo, cambiar el nombre y eliminar los campos existentes. Sin embargo, se incurre en ciertos costos al realizar estos tipos de cambios. Para obtener más información, vea Personalizar datos de seguimiento, formularios, flujos de trabajo y otros objetos de proyecto.

Para agregar, quitar o personalizar un campo de una colección, modifique el contenido XML para la definición de un tipo de elemento de trabajo o flujo de trabajo global. Defina cada campo a través de un elemento FIELD dentro de la sección FIELDS de la definición para o un tipo de elemento de trabajo o el flujo de trabajo global. Para obtener más información sobre la estructura y localización de estos archivos, vea Referencia de todos los elementos XML WITD y Personalizar el flujo de trabajo.

En este tema

• Estructura de la sintaxis de FIELD (Definition)

• Tipos de datos de campo

• Atributos para informes asignados a los campos

• Campos indizados

• Elementos secundarios de FIELD (Definition)

• Campos del sistema y campos predefinidos

Estructura de la sintaxis de FIELD (Definition)

Cada elemento FIELD (Definition) tiene un solo nombre, que es opcional, y un nombre de referencia, que se obligatorio. El nombre de referencia debe ser único dentro de la colección. Para obtener más información, vea Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo.

Importante
Puede cambiar el nombre descriptivo de un campo utilizando la herramienta de la línea de comandos witadmin changefield. Ahora bien, el cambio del nombre de un campo afecta a todos los tipos de elemento de trabajo de todos los proyectos de equipo dentro de la colección.

Puede definir un campo con el siguiente archivo de sintaxis de definición XML para el tipo de elemento de trabajo.

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | 
DateTime | PlainText | HTML | History | TreePath | GUID " syncnamechanges="true | false" reportingname="reportingDisplayName" reportingrefname="reportingReferenceName"
reportable="Dimension | Detail | Measure" formula="avg" >
   <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>

Para obtener más información, vea FIELD (Definición) (Elemento).

Volver al principio

Tipos de datos de campo

El tipo de un campo define la naturaleza y el tamaño de los datos que puede almacenar en el campo. Un campo solamente puede tener un tipo por Team Foundation Server. Ésta es una restricción que anima a las organizaciones a utilizar campos comunes para distintos proyectos y tipos de elementos de trabajo.

En la lista siguiente se muestran los tipos de campos compatibles:

Tipo de datos	Descripción
DateTime	Especifica una fecha según la Hora universal coordinada (Hora UTC). Puede agregar un campo DateTime a un formulario de elemento de trabajo utilizando los atributos FieldControl o DateTimeControl type.
Double	Especifica un valor de coma flotante. Los campos de tipo Double se utilizan frecuentemente en filtros de consulta y listas de resultados. Puede agregar un campo Double a un formulario de elemento de trabajo utilizando el atributo FieldControltype.
GUID	Especifica un campo que contendrá un identificador único. No puede agregar un campo GUID a un formulario de elemento de trabajo.
History	Permite ver los hilos de discusión y 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. Puede agregar el campo System.History a un formulario de elemento de trabajo utilizando el atributo WorkItemLogControltype que admite controles de formato de texto enriquecido.
HTML	Admite la capacidad de capturar datos de texto enriquecido y utilizar descripciones de texto más largas, tales como una descripción de elemento de trabajo. Un campo HTML se diferencia de un campo PlainText en que el primero tiene establecimiento inflexible de tipos HTML para la presentación de información más completa. Puede agregar un campo HTML a un formulario de elemento de trabajo utilizando el atributo HTMLControltype que admite controles de formato de texto enriquecido.
Integer	Especifica un valor entero de 32 bits con signo. Los campos de tipo Integer se utilizan frecuentemente en filtros de consulta y listas de resultados. Puede agregar un campo Integer a un formulario de elemento de trabajo utilizando el atributo FieldControltype.
PlainText	Admite la entrada de una cadena de texto con más de 255 caracteres Unicode. Puede agregar un campo PlainText a un formulario de elemento de trabajo utilizando el atributo de tipo FieldControl, limitado al texto sin formato, o el atributo HTMLControltype que admite controles de formato de texto enriquecido.
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. Los campos de tipo String se utilizan frecuentemente en filtros de consulta y listas de resultados. Puede agregar un campo String a un formulario de elemento de trabajo utilizando el atributo FieldControltype.
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 para 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. Puede agregar los campos System.AreaPath y System.IterationPath a un formulario de elemento de trabajo utilizando el atributo WorkItemClassificationControl type.

Volver al principio

Atributos para informes que están asignados a campos

Algunos valores de campo son especialmente útiles para crear informes. Con el lenguaje de definición de tipos de elemento de trabajo, puede especificar los siguientes atributos opcionales:

• reportable. El atributo reportable se establece en None, Detail, Dimension o Measure, dependiendo de si desea incluir el campo en los informes y cómo desea que se incluya. Los datos de campos que tienen un valor distinto de None para este atributo se exportan al almacén de datos y se pueden incluir en informes.

  Al agregar un campo existente a un tipo de elemento de trabajo, se utiliza el valor actual para el atributo reportable. Al agregar un campo a un tipo de elemento de trabajo, los informes están deshabilitados a menos que lo especifique explícitamente utilizando el atributo reportable.

• reportingname. Puede asignar una etiqueta diferente a un campo que se utilice cuando los datos aparezcan en los informes. Si no especifica un valor, se usa el nombre descriptivo asignado para el atributo name.

• reportingrefname. Puede asignar un nombre de referencia diferente a un campo que se utilice cuando se exporten los datos al almacén de datos relacional. Si no especifica un valor, se usa el valor asignado al atributo refname.

  Puede usar este atributo para combinar o diferenciar los campos incluidos en los informes. Para combinar dos campos que tienen nombres de referencia distintos y están definidos en colecciones de proyectos diferentes, asigne el mismo valor de reportingrefname a ambos campos. Para distinguir dos campos con el mismo nombre de referencia que están definidos en colecciones de proyectos diferentes, asigne un valor de reportingrefname diferente a cada campo.

Después de definir un campo, puede usar el comando witadmin changefield en un símbolo del sistema para cambiar el valor de todos los atributos salvo refname.

Para obtener información sobre los procedimientos recomendados para asignar etiquetas a los campos para los informes, vea Agregar y modificar campos de elementos de trabajo para la compatibilidad con la creación de informes.

Volver al principio

Valores del atributo reportable

Como se observa en la siguiente tabla, se puede asignar uno de los siguientes valores al atributo reportable: ninguno, dimensión, detalle y medida.

Nota

Puede hacer un campo reportable después de que se haya utilizado para un elemento de trabajo. Después de establecer el valor reportable, las nuevas revisiones del elemento de trabajo que se copian en el almacén de datos contendrán el valor del campo. Sin embargo, las revisiones que ya estén en el almacén de datos no se rellenarán de manera retroactiva con los valores existentes.

Valor del atributo	Descripción
Detail	Utilice el tipo Detail solamente para campos de tipo Integer, Double, String o DateTime. Los datos de este campo se mueven a la base de datos relacional del almacén de datos en las tablas de elementos de trabajo y del elemento de trabajo actual, pero no en el cubo de SQL Server Analysis Services. Al utilizar este tipo para campos de texto sin restricciones, puede utilizarlos en informes sin que el cubo aumente de tamaño de manera significativa.
Dimension	Utilice el tipo Dimension solamente para campos de tipo Integer, Double, String o DateTime. 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	Utilice el tipo Measure solamente para campos de tipo Integer y Double. Las medidas son los valores numéricos de los informes. Durante el procesamiento del cubo de Analysis Services, los datos se calculan previamente en los campos que están establecidos en Measure. 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. Para obtener más información acerca de los grupos de medida, vea Grupos de medidas y métricas ofrecidas en el cubo de Analysis Services para Team System. Cuando especifique Measure, debe especificar sum para el atributo formula, que devuelve la suma de cada medida a la que se hace referencia en la consulta.
None	Especifique None si no desea incluir el campo en informes. Este valor es la asignación predeterminada.

Volver al principio

Ejemplos que muestran cómo especificar informes

Ejemplo de detalle

<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

Ejemplo de dimensión

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

Ejemplo de medida

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

Campos indizados

Puede habilitar o deshabilitar la indización para un campo de elemento de trabajo utilizando el comando witadmin indexfield. Al habilitar la indización para un campo, puede aumentar el rendimiento de la búsqueda de elementos de trabajo cuyas consultas especifiquen ese campo. Si agrega un campo personalizado que utilice en muchas de sus consultas de elementos de trabajo, quizá desee habilitar la indización para ese campo. Para obtener más información, vea Administrar campos de elemento de trabajo [witadmin].

Volver al principio

Elementos secundarios de FIELD (Definition)

Hay varios elementos secundarios opcionales que puede especificar para un campo de elemento de trabajo, por ejemplo:

• Texto de ayuda. Define la información sobre herramientas o información de ayuda que se muestra para un campo en el formulario de elemento de trabajo (HELPTEXT).

• Restricciones de campo. Especifica un campo como necesario, de solo lectura, vacío, inmovilizado o que coincide con un modelo concreto (REQUIRED, READONLY, EMPTY, FROZEN, MATCH).

• Rellenado automático de valor de campo. Especifica un valor para el campo (DEFAULT, COPY, SERVERDEFAULT).

• Lista de campos. Especifica valores permitidos, sugeridos o prohibidos. (ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

• Condiciones de campo. Aplica una o más reglas a un campo cuando otro campo se modifica o no se modifica, u otro campo tiene o no tiene un valor concreto u otra condición (WHEN, WHENNOT, WHENCHANGED, WHENNOTCHANGED, CANNOTLOSEVALUE, NOTSAMEAS).

Para obtener más información, vea Referencias de todos los elementos FIELD de XML.

Volver al principio

Campos del sistema y predefinidos

Todos los campos definidos por el sistema tienen nombres de referencia que comienzan por System, por ejemplo, System.AreaPath, System.AssignedTo y así sucesivamente.

Los campos predefinidos definidos por las plantillas de proceso de Microsoft Solutions Framework (MSF) comienzan por Microsoft.VSTS y, a continuación, varían en función de su uso. Ejemplos de campos predefinidos que se utilizan habitualmente, para propósitos de programación e integración con Office Project, para la integración con Team Foundation Build y la integración con Team Foundation son los siguientes:

• Microsoft.VSTS.Common.Priority

• Microsoft.VSTS.Scheduling.DueDate

• Microsoft.VSTS.Build.FoundIn

• Microsoft.VSTS.TCM.Steps

Para ver información general de todo el sistema y campos predefinidos definidor para la plantilla de proceso MSF for Agile Software Development v5.0, vea Usar campos del sistema y campos definidos por las plantillas de proceso de MSF. Para obtener más información sobre la especificación de nombres de campos, vea Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo.

Volver al principio

Vea también

Tareas

Agregar o quitar un campo de un tipo de elemento de trabajo

Referencia

Administrar campos de elemento de trabajo [witadmin]

FIELD (Definición) (Elemento)

Conceptos

Referencia de todos los elementos XML WITD

Referencias de todos los elementos FIELD de XML

Otros recursos

Resolver los conflictos del esquema que se producen en el almacén de datos

Agregar y modificar campos de elementos de trabajo para la compatibilidad con la creación de informes

Definir campos de elementos de trabajo

Historial de cambios

Fecha	Historial	Motivo
Enero de 2011	Información agregada sobre el flujo de trabajo global y varias secciones actualizadas con vínculos a los temas relacionados. Eliminada la sección sobre la definición de esquema.	Mejora de la información.