Administrar campos de elemento de trabajo

Artículo
08/10/2011

Puede administrar los campos de tipo de elemento de trabajo definidos para una colección de proyectos de equipo utilizando los siguientes comandos witadmin:

deletefield: elimina el campo especificado.
listfields: enumera los atributos de todos los campos o un campo especificado.
indexfield: activa o desactiva la indización del campo especificado. 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.

changefield: cambia uno o más atributos de un campo, como el nombre descriptivo del campo, los atributos de notificación de almacenamiento de datos o la capacidad de sincronizar un campo que contiene nombres de personas. Cuando se habilita la sincronización, el campo se actualiza cuando se realizan actualizaciones en Active Directory o un grupo de trabajo. Para obtener información sobre cómo utilizar los campos para notificar, vea Trabajar con campos de elementos de trabajo.

Importante
Al actualizar de una versión anterior a la versión actual, en todos los campos integrados, el atributo syncnamechanges está establecido en true para todos los campos String que contienen nombres de personas. Sin embargo, debe asignar manualmente el atributo a cualquier campo personalizado que utilice para almacenar nombres de personas y que desea sincronizar. Para obtener más información, vea Actualizar los campos de nombres de roles personalizados para la sincronización con Active Directory o con grupos de trabajo.

Al actualizar de una versión anterior a la versión actual, en todos los campos integrados, el atributo syncnamechanges está establecido en true para todos los campos String que contienen nombres de personas. Sin embargo, debe asignar manualmente el atributo a cualquier campo personalizado que utilice para almacenar nombres de personas y que desea sincronizar. Para obtener más información, vea Actualizar los campos de nombres de roles personalizados para la sincronización con Active Directory o con grupos de trabajo.

La herramienta de línea de comandos witadmin se encuentra en Unidad::\Archivos de programa\Microsoft Visual Studio 10.0\Common7\IDE en el equipo cliente que ejecuta Team Explorer.

Para obtener más información sobre los campos, vea Definir campos de elementos de trabajo.

Nota

Puede crear y modificar los campos de elementos de trabajo utilizando el Editor de procesos, una herramienta avanzada de Visual Studio. No se ofrece soporte técnico para esta herramienta. Para obtener más información, vea la página siguiente en el sitio web de Microsoft: Team Foundation Server Power Tools April 2010.

Permisos necesarios

Para la colección de proyectos de equipo en la que se definen los campos de tipo de elemento de trabajo, debe tener los siguientes permisos establecidos:

Para mostrar campos, deberá ser un miembro del grupo Lectores o tener el permiso Ver los elementos de trabajo en este nodo establecido en Permitir.
Para eliminar o cambiar el nombre de los campos o cambiar las características del informe de errores de un campo, debe ser miembro del grupo de seguridad Administradores de Team Foundation o del grupo de seguridad Administradores del proyecto.

Para obtener más información, vea Permisos de Team Foundation Server y Grupos predeterminados, permisos y roles de Team Foundation Server.

Nota

Incluso si ha iniciado sesión con permisos administrativos, debe abrir una ventana de símbolo del sistema con privilegios elevados para ejecutar esta función en un servidor que ejecute Windows Server 2008. Para abrir una ventana de símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en Ejecutar como administrador. Para obtener más información, vea el sitio web de Microsoft: Control de cuentas de usuario.

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

witadmin indexfield /collection:CollectionURL /n:Name /index:on|off 

witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]

Parámetros

Parámetro	Descripción
/collection:CollectionURL	Especifica el identificador URI de la colección de proyectos de equipo. El formato del identificador URI es el siguiente: http://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección Si no se usa ningún directorio virtual, el formato del identificador URI será el siguiente: http://NombreServidor:Puerto/NombreColección
/n:RefName /n:Name	El nombre de referencia de un campo de tipo de elemento de trabajo.
/index	Especifica habilitar o deshabilitar la indización del campo especificado. Especifique on para habilitar la indización y off para deshabilitar la indización.
/name:NewName	Especifica el nuevo nombre del campo.
/syncnamechanges	Especifica el uso del campo del elemento de trabajo para almacenar nombres y para actualizar cuando se realizan modificaciones en Active Directory o un grupo de trabajo. Esta opción solo es válida cuando un campo con el tipo de datos String se especifica para typename. Especifique true para habilitar la sincronización para el campo de datos, especifique false para deshabilitar la sincronización para el campo de datos.
/reportingname:ReportingName	Especifica el nombre del campo del almacenamiento de datos que se va a utilizar para notificar.
/reportingrefname:ReportingRefName	Especifica el nombre de referencia del campo del almacenamiento de datos que se va a utilizar para notificar.
/reportingtype:Type	Especifica cómo se utiliza el campo en el almacén de datos para notificar. Valores válidos son: dimension: Utilizado para los campos Integer, String o DateTime. detail: Utilizado para los campos Integer, Double, String o DateTime. measure: Utilizado para los campos Integer y Double. El tipo de agregación predeterminado es la suma. Puede especificar otro tipo de agregación mediante el parámetro formula. disable: Utilizado para deshabilitar los informes del campo. Para obtener más información, vea Trabajar con campos de elementos de trabajo.
/reportingformula:Formula	Especifica la fórmula de agregación que se va a utilizar cuando el campo se notifica como measure. La única fórmula compatible es sum.
/unused	Enumera todos los campos no utilizados por cualquier proyecto de equipo definido en la colección de proyectos de equipo.
/noprompt	Deshabilita el aviso de confirmación.
/? or help	Muestra ayuda sobre el comando en la ventana del símbolo del sistema.

Comentarios

Al asignar el atributo syncnamechanges a un campo String, el campo siempre acepta los nombres de usuario válidos. Sin embargo, el campo no permite nombres de grupo que están almacenados en Team Foundation Server o en Active Directory si cualquiera de las siguientes condiciones es true:

La regla VALIDUSER se especifica en todos los tipos de elemento de trabajo
La regla VALIDUSER se especifica para un tipo de elemento de trabajo
La regla ALLOWEDVALUES se especifica para un tipo de elemento de trabajo, y esa regla tiene un criterio de filtro que excluye los grupos

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

Para ver un resumen de los campos del sistema que se indizan, vea Usar campos del sistema y campos definidos por las plantillas de proceso de MSF.

Ejemplos

A menos que se especifique lo contrario, se aplican los siguientes valores en cada ejemplo:

Identificador URI de la colección de proyectos de equipo: http://AdventureWorksServer:8080/AWTeam/Collection1
Nombre del campo de elemento de trabajo: AdventureWorks.Field
Codificación predeterminada: UTF-8

Mostrar campos

El siguiente comando muestra información sobre cada campo definido para Collection1 en el servidor AdventureWorksServer:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

El comando siguiente muestra la información de campo del campo AdventureWorks.Field especificado usado por Collection1:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

El siguiente comando muestra todos los campos que Collection1 no está utilizando:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /unused

Cambiar el nombre de un campo

El comando siguiente cambia el nombre descriptivo del campo AdventureWorks.Field al que hace referencia por NewFieldName para Collection1:

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /name:NewFieldName

Cambiar el valor Notificar como de un campo

El siguiente comando especifica la capacidad de notificar el tipo de campo DateTime de AdventureWorks.CreatedOn en dimension. Este dato del campo se escribe en el almacén y en las bases de datos de Analysis Services de modo que puede utilizarse para filtrar informes.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.CreatedOn /reportingtype:dimension

El siguiente comando especifica la capacidad de notificar el tipo de campo Double de AdventureWorks.Field en measure. Todas las medidas se agregan por suma.

witadmin reportfield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /reportingtype:measure

Habilitar sincronización de un campo de nombre personalizado

El siguiente comando habilita la sincronización del campo de elemento de trabajo AW.CustomerName definido para Collection1 en AdventureWorksServer.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.CustomerName /syncnamechanges:true

Eliminar un campo

El siguiente comando elimina el campo AdventureWorks.Field de AdventureWorksServer de Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

Vea también

Compartir a través de