Administrar campos de elemento de trabajo

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

• changefield: cambia uno o más atributos de un campo.Al cambiar uno de los siguientes atributos, cámbielo para todos los tipos de elemento de trabajo y proyectos de equipo en la colección de proyectos de equipo:

  • Tipo de datos para los campos PlainText o HTML .

    Importante
    Al actualizar Team Foundation Server desde una versión anterior a la versión actual, la asignación de tipos para el campo Descripción (System.Description) se convierte automáticamente de PlainText a HTML.Con el comando changefield, puede restaurar el contenido de este campo para que muestre texto sin formato.

  • Nombre descriptivo que se muestra en la consulta de elementos de trabajo.Este nombre puede diferir del que se muestra en el formulario de elemento de trabajo.

  • Atributos de informes que incluyen el nombre del campo tal como aparece en un informe, el nombre del informe de referencia y el tipo de informe.

  • Sincronización con Active Directory: puede habilitar o deshabilitar la sincronización de los campos de nombre de persona.

• deletefield: elimina el 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.

• listfields: enumera los atributos de todos los campos o un campo especificado.

Para ejecutar la herramienta de la línea de comandos witadmin, abra una ventana de símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

En una edición de 64 bits de Windows, reemplace %programfiles% con %programfiles(x86)%.

Para obtener información general sobre los campos definidos dentro de las plantillas de proceso predeterminadas proporcionadas con Team Foundation Server, vea Referencia de campos de elementos de trabajo para Visual Studio ALM.

[!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.

Requisitos

• Para enumerar los campos, el permiso Ver información del nivel de proyecto para el proyecto de equipo del conjunto de recopilación debe estar 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 del símbolo del sistema con privilegios elevados, elija Inicio, abra el menú contextual para Símbolo del sistema y, a continuación, elija Ejecutar como administrador.Para obtener más información, vea el sitio web de Microsoft: Control de cuentas de usuario.

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

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

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

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

Parámetros

Comentarios

Campos indizados

Un índice de consulta se crea en función de los campos que tienen indización habilitada.Este índice mejora el tiempo de respuesta cuando se ejecutan consultas que incluyen campos indizados.

De forma predeterminada, se indizan los campos siguientes: Asignado a, Fecha de creación, Modificado por, Estado, Motivo, Id. de área, Id. de iteración y Tipo de elemento de trabajo.Si hay otros campos que el equipo utiliza con frecuencia en las consultas, puede agregarlas al índice de la consulta.

Sincronizar nombres de persona con Active Directory

Debe habilitar manualmente la sincronización de los campos de elemento de trabajo personalizado que se utilizan para asignar nombres de personas que hacen referencia a Active Directory.Debe habilitar la sincronización para cada campo de cada colección de proyectos de equipo que contenga campos personalizados.

Todos los campos de referencia del sistema que muestran nombres de persona tienen el atributo syncnamechanges establecido en true. Estos campos incluyen System.AuthorizedAs, System.AssignedTo, System.ChangedBy y System.CreatedBy. La sincronización se habilita para cada campo de nombre de persona definido en una de las plantillas de proceso predeterminadas.Para obtener más información, vea Referencia de campo de asignaciones y flujo de trabajo.

Una vez habilitada la sincronización, el campo ya no muestra una cadena estática.En su lugar, el campo muestra el nombre asociado a una cuenta de usuario.Al cambiar el nombre de usuario en Active Directory o en Grupo de trabajo, un campo con syncnamechanges establecido en true muestra el nuevo nombre automáticamente.

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.

Atributos que se pueden cambiar para cada tipo de elemento de trabajo

Para cambiar los atributos o valores siguientes definidos para un campo, cambie la definición de tipo de elemento de trabajo en la que el campo aparece:

• Nombre que se muestra en el formulario de elemento de trabajo.Vea Referencia de elementos Control de XML.

• Texto de ayuda.Vea Definir el texto de ayuda de un campo de elemento de trabajo.

• Valores permitidos o elementos de una lista desplegable o un menú desplegable.Vea Definir listas de usuario, listas desplegables y listas globales.

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/tfs/DefaultCollection

• Nombre del campo de elemento de trabajo: AdventureWorks.Field

• Codificación predeterminada: UTF-8

Mostrar campos

Use witadmin listfields para ver el conjunto de campos en uso y seleccionar uno para agregarlo a un tipo de elemento de trabajo.También, puede mostrar las asignaciones de atributos definidas para un campo concreto y determinar qué campos utilizan los proyectos de equipo.

Ver los atributos de un campo de elemento de trabajo

• Escriba el comando siguiente para mostrar los atributos definidos para un campo específico, como Microsoft.VSTS.Common.Issue.

  witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue
  

  Aparece la información de campo y atributos para el campo nombrado, como se muestra en el ejemplo siguiente.

  Field: Microsoft.VSTS.Common.Issue
  Name: Issue
  Type: String
  Reportable As: dimension
  Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)
  Indexed: False
  

  El parámetro Use indica el nombre de cada proyecto y el tipo de elemento de trabajo donde se utiliza el campo.Para obtener más información sobre los atributos de campo, vea Referencia de campos de elementos de trabajo para Visual Studio ALM.

Mostrar todos los campos de una colección de proyectos de equipo

• Escriba el comando siguiente para mostrar todos los campos definidos para una colección de proyectos de equipo.

  witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
  

  Aparece información de campo para todos los campos de la colección de proyectos nombrada.Vea Referencia de campos de elementos de trabajo para Visual Studio ALM.

Mostrar campos que no se usan

• Escriba el comando siguiente para mostrar los campos que ya no se utilizan en la colección de proyectos de equipo por cualquier tipo de elemento de trabajo.

  witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /unused
  

  Aparece la información de campo y atributos para cada campo que no se utiliza, como se muestra en este ejemplo.

  Field: Microsoft.VSTS.CMMI.TaskType
  Name: Task Type
  Type: String
  Reportable As: dimension
  Use: Not In Use
  Indexed: False
  
  Field: Microsoft.VSTSUE.Common.Flag
  Name: Flag
  Type: String
  Reportable As: dimension
  Use: Not In Use
  Indexed: False
  
  Field: Microsoft.VSTSUE.Common.Progress
  Name: Progress
  Type: String
  Reportable As: dimension
  Use: Not In Use
  Indexed: False
  

Cambiar el nombre de un campo

Puede cambiar el nombre descriptivo de un campo de elemento de trabajo para cumplir las convenciones de nomenclatura que utiliza su equipo.Observe que el nuevo nombre se aplica a todos los tipos de elemento de trabajo que hacen referencia al campo modificado en todos los proyectos de equipo de la colección de proyectos.El nombre descriptivo se muestra al definir los criterios de filtro en una consulta de elementos de trabajo.El nombre que aparece en un formulario de elemento de trabajo puede ser diferente que el nombre descriptivo definido para el campo.

Para cambiar el nombre de un campo de elemento de trabajo

1. Escriba el comando siguiente para cambiar el nombre descriptivo asignado a Microsoft.VSTS.Common.Rank Important Rank.

   witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"
   

2. Cuando se le pida confirmación, escriba y y presione ENTRAR.Espere hasta que aparezca el siguiente mensaje:

   Field renamed.

Para comprobar los cambios importados a un proyecto único

1. En Team Explorer, elija Actualizar.

   Se descargan del servidor las actualizaciones más recientes, que incluyen los cambios recién hechos en el nombre de campo.Espere varios segundos a que finalice la actualización.

2. Elija Nueva consulta para crear una consulta.

3. En el Editor de consultas, elija el vínculo Haga clic aquí para agregar una cláusula para agregar una fila, seleccione la celda en blanco Campo y, en la celda, escriba Rank.El siguiente mensaje que aparece encima de la lista de resultados.Dicho mensaje indica que no se ha encontrado el campo Rank.

   Ejecutar la consulta para ver los resultados de la misma. TF51005: La consulta hace referencia a un campo que no existe.Error causado por <<Rank>>.

4. Elimine el valor Rank de la celda Campo y escriba Important Rank en ella.

5. Seleccione <> en la celda Operador y escriba 1 en la celda Valor.

6. En la barra de herramientas Consulta, elija Ejecutar.

7. Abrir el menú contextual para cualquier fila de los resultados y seleccione Opciones de columna.Desplácese hacia abajo en la lista Columnasdisponibles.Observe que ya no aparece el campo Rank, pero sí aparece el campo Important Rank.

8. Seleccione Important Rank en el cuadro Columnas disponibles y, a continuación, elija el botón > (agregar columnas seleccionadas).Elija Aceptar.

   Observe que el nombre descriptivo para Microsoft.VSTS.Common.Rank se ha cambiado de Rank a Important Rank en todo el generador de consultas y en la lista de resultados.

9. Cierre la consulta.Elija No cuando se le pida que guarde la consulta.

10. Cree un nuevo elemento de trabajo de Tarea.Elija el vínculo Nuevos elementos de trabajo y después elija Tarea.

    Este elemento de trabajo se crea a partir del tipo de elemento de trabajo que ha cambiado e importado.

11. En el cuadro Estado, observe que la etiqueta del campo que se ha cambiado de nombre, Rank, no ha cambiado.Esto es debido a que el ámbito de las etiquetas de los campos de los formularios de elemento de trabajo es el proyecto de equipo principal y éstas son independientes del nombre de campo que se acaba de especificar, que se aplica a todo el servidor.

    [!NOTA]

    Para obtener más información sobre cómo cambiar las etiquetas de campo en formularios de elemento de trabajo, consulte Cambiar la etiqueta de un campo.

12. Cierre la nueva tarea y elija No cuando se le pida que guarde el elemento de trabajo.

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/tfs/DefaultCollection /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/tfs/DefaultCollection /n:AdventureWorks.Field /reportingtype:measure

Habilitar la sincronización de un campo personalizado de nombre de persona

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

Comprobar el tipo de datos del campo que desea convertir

• Compruebe el tipo de datos asignado al campo, por ejemplo, MyCompany.CustomerName, que desea sincronizar escribiendo el comando siguiente:

  witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName
  

Habilitar la sincronización

1. Para habilitar la sincronización para un campo con nombre de persona, escriba el comando siguiente y sustituya los datos de los argumentos que se muestran aquí:

   witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true
   

2. Aparecerá el indicador de confirmación siguiente:

   This will change properties for field {0} on the Team Foundation Server.Do you want to continue?

3. Escriba 0 para confirmar que desea cambiar el campo, o 1 cancelar la solicitud.

   Si la solicitud de cambio se realiza correctamente, aparecerá el mensaje de confirmación siguiente:

   The field was updated.

   Si la solicitud de cambio produce un error, aparecerá un mensaje de error.Los errores más comunes que se pueden cometer son intentar cambiar un campo de referencia del sistema o un campo de un tipo de datos distinto de String.No se admiten estas operaciones.

Eliminar un campo

Antes de eliminar un campo, compruebe que el campo no está en uso.Si el campo está en uso, primero debe quitar el campo de los tipos de elemento de trabajo que lo utilizan antes de eliminarlo de la colección de proyectos de equipo.El siguiente comando elimina el campo AdventureWorks.Field de AdventureWorksServer de Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field

Comprobar que un campo no está en uso

1. Escriba el siguiente comando, especificando el nombre de referencia del campo de elemento de trabajo, como MyCompany.MyProcess.MyField.

   witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.MyProcess.MyField
   

   En la información mostrada para el campo, compruebe que el valor para Use es "Not In Use" como sigue en este ejemplo.

   Field: MyCompany.MyProcess.MyField
   Name: MyField
   Type: String
   Reportable As: dimension
   Use: Not In Use
   Indexed: False
   

2. Si el campo Use indica que el campo está en uso, debe eliminarlo de cada tipo de elemento de trabajo para cada proyecto de equipo que se muestre.Por ejemplo, el campo Microsoft.VSTS.TCM.SystemInfo indica que esta siendo utilizado por los tipos de elemento de trabajo Error y Defecto de código para cuatro proyectos: Arroyo, Desert, Palm y Springs.

   Field: Microsoft.VSTS.TCM.SystemInfo
   Name: System Info
   Type: Html
   Reportable As: None
   Use: Arroyo (Bug), Desert (Bug), Palm (Bug), Springs (Bug, Code Defect)
   Indexed: False
   

   Antes de poder eliminar este campo, debe quitarlo de cada uno de los tipos de elemento de trabajo enumerados para cada proyecto de equipo para el que esté definido.Para quitar el campo, modifique la definición del tipo de elemento de trabajo eliminando los elementos FIELD y Control que contienen el nombre de referencia de campo.Vea Personalizar y administrar tipos de elemento de trabajo [witadmin], FIELD (Definición) (Elemento) y Referencia de elementos Control de XML.

Eliminar un campo de una colección de proyectos de equipo

• Escriba el comando siguiente para eliminar el campo de MyCompany.MyProcess.MyField y después elija Entrar.

  witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName
  

  Escriba y cuando aparezca la pregunta de confirmación para completar este paso.

Vea también

Conceptos

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

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

Referencia de campos de elementos de trabajo para Visual Studio ALM

Referencia de campos para informe para Visual Studio ALM

Otros recursos

witAdmin: Personalizar y administrar objetos para el seguimiento de elementos de trabajo