Trabajar con campos de elementos de trabajo

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.

Defina un campo por la sintaxis XML siguiente en el archivo de definición 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="sum" >
   <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

El tipo de un campo define la naturaleza y el tamaño de los datos que puede almacenar en el campo. Un campo puede tener sólo un tipo definido dentro de una colección de proyectos de equipo. Ésta es una restricción que anima a las organizaciones a utilizar campos comunes para distintos proyectos y tipos de elemento 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). Agregue un campo de DateTime a un formulario de elemento de trabajo utilizando los atributos de FieldControl o de DateTimeControltype.
Double	Especifica un valor de coma flotante. Los campos de tipo Double se utilizan frecuentemente en filtros de consulta y listas de resultados. Agregue un campo de Double a un formulario de elemento de trabajo utilizando el atributo de 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. Agregue el campo de System.History a un formulario de elemento de trabajo utilizando el atributo de 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 está fuertemente tipado en HTML para la presentación de información más completa. Agregue un campo de HTML a un formulario de elemento de trabajo utilizando el atributo de 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. Agregue un campo de Integer a un formulario de elemento de trabajo utilizando el atributo de FieldControltype.
PlainText	Admite la entrada de una cadena de texto con más de 255 caracteres Unicode. Agregue un campo de PlainText a un formulario de elemento de trabajo utilizando el atributo de tipo de FieldControl y limitado al texto sin formato, o el atributo de 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. Agregue un campo de String a un formulario de elemento de trabajo utilizando el atributo de 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. Agregue campos de System.AreaPath y de System.IterationPath a un formulario de elemento de trabajo utilizando el atributo de WorkItemClassificationControl type.

Volver al principio

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 . Establezca el atributo reportable a None, a Detail, a Dimension, o a Measure, dependiendo de si y cómo desea el campo que se incluirá en informes. 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 . Asignar una etiqueta diferente a un campo que se utiliza cuando los datos aparecen en los informes. Si no especifica un valor, se usa el nombre descriptivo asignado para el atributo name.

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

  Utilice este atributo para combinar o diverja 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 admitir 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 Perspectivas y grupos de medidas proporcionadas 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

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

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

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 predeterminadas que TFS proporciona comienza por Microsoft.VSTS y después 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 Microsoft 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 obtener información general de todo el sistema y campos predefinidos definidos para las plantillas de proceso predeterminadas que TFS proporciona, vea Referencia de campos de elementos de trabajo para Visual Studio ALM. 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

Además de los atributos que puede cambiar para un campo de elemento de trabajo, hay varios atributos que cambiables y virtualmente ocultos para cada campo. Puede buscar las asignaciones de estos campos utilizando el Explorador del campo de elemento de trabajo. Tenga acceso a la herramienta desde el Explorador del campo de elemento de trabajo de la herramienta avanzada del editor.

Nota

La herramienta avanzada del editor proporciona una interfaz gráfica de usuario para personalizar las plantillas de proceso de Team Foundation Server. Puede utilizar esta herramienta para importar y exportar tipos de elemento de trabajo, para modificar el contenido de la plantilla de proceso, y explorar el conjunto de campos definidos para una colección de proyectos de equipo. Para obtener más información, consulte la siguiente página en el sitio web de Microsoft: Herramientas avanzadas para el servidor Team Foundation.

Referencia

Conceptos

Otros recursos