Compartir a través de

Tutorial: Administrar campos de un tipo de elemento de trabajo

  • Artículo

Actualización: noviembre 2007

En este tutorial se explica cómo ver, cambiar de nombre y eliminar los campos utilizados por los tipos de elementos de trabajo en Team Foundation Server. Los campos pueden abarcar muchos tipos de elementos de trabajo en varios proyectos de equipo.

Esta sección contiene los siguientes procedimientos:

  • Ver campos   En este procedimiento, genera y, a continuación, ve los campos de un tipo de elemento de trabajo.

  • Cambiar el nombre de los campos   En este procedimiento, cambiará el nombre de un campo y verá dónde aparece dicho cambio en el formulario.

  • Eliminar campos   En este procedimiento, eliminará un campo que ha agregado al formulario de elemento de trabajo en un procedimiento anterior.

Requisitos previos

Realice los pasos de Tutorial: Realizar personalizaciones básicas en un tipo de elemento de trabajo y Tutorial: Realizar personalizaciones avanzadas en un tipo de elemento de trabajo.

Si puede establecer una conexión con un servidor de Team Foundation Server y dispone de los permisos necesarios, puede administrar los campos de un tipo de elemento de trabajo en un símbolo del sistema, un archivo por lotes o un archivo de script. Para ello, deberá usar la utilidad Símbolo del sistema de Visual Studio 2008 o bien establecer varias variables de entorno en el símbolo del sistema actual utilizando vsvars32 como se describe en el ejemplo siguiente. Para obtener más información sobre cómo unirse a un proyecto de equipo, vea Tutorial: Unirse a un proyecto de equipo.

Para habilitar los comandos de Team Foundation en un símbolo del sistema

  • Haga clic en Inicio, en Todos los programas, elija Microsoft Visual Studio 2008, Visual Studio Tools y haga clic en Símbolo del sistema de Visual Studio 2008.

O bien puede ejecutar vsvars32 en la ruta de acceso de instalación de Visual Studio, que suele ser Unidad:\Archivos de programa\Microsoft Visual Studio 9.0\Common7\Tools.

Permisos necesarios

Debe ser miembro del grupo Administradores de Team Foundation o miembro del grupo Project Administrators del proyecto para poder llevar a cabo este procedimiento. Para obtener más información, vea Permisos de Team Foundation Server.

Ver campos

Para ver los campos

  1. Abra un símbolo del sistema de Visual Studio.

  2. Genere todos los campos definidos en el servidor de Team Foundation Server en un archivo de texto; para ello, escriba lo siguiente en el símbolo del sistema y, a continuación, presione ENTRAR.

  3. witfields view /s:"Nombre del servidor de Team Foundation Server"

    Aparecerá la lista de campos con la siguiente información:

    Campo:

    El nombre de referencia del campo.

    Nombre:

    El nombre descriptivo del campo.

    Tipo:

    El tipo de datos del campo.

    Reportable como:

    La configuración de informes del campo.

    Uso:

    Los proyectos de equipo que utilizan este campo y los tipos de elementos de trabajo en los que aparece.

Cambiar el nombre de los campos

Para cambiar el nombre de los campos

  1. En el símbolo del sistema de Visual Studio, escriba lo siguiente y presione ENTRAR.

    witfields rename /s:"Nombre del servidor de Team Foundation Server" Microsoft.VSTS.Common.Rank Importance

    Este comando cambia el nombre del campo Rank a Importance.

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

    Field renamed.

  3. En la ventana de Team Explorer en Visual Studio, haga clic en Actualizar para descargar las últimas actualizaciones desde el servidor.

    Espere varios segundos hasta que se carguen todos los nodos. Los nodos que se están cargando muestran la cadena trabajando.

  4. Haga clic con el botón secundario del mouse en el nodo Elementos de trabajo y seleccione Agregar consulta para crear una nueva consulta.

  5. Haga clic en el área con la etiqueta Haga clic aquí para agregar una cláusula para agregar una nueva fila. A continuación, seleccione la celda en blanco Campo. Escriba Rank en la celda. Observe el siguiente mensaje que aparece por 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>>.

  6. Elimine el valor Rank de la celda Campo y escriba Importance en ella.

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

  8. En el menú Equipo, haga clic en Ejecutar consulta.

  9. Haga clic con el botón secundario del mouse en cualquier fila de los resultados y seleccione Opciones de columna. Desplácese hacia abajo en la lista Columnas disponibles. Observe que ya no aparece el campo Rank, pero sí aparece el campo Importance.

  10. Seleccione Importance en el cuadro Columnas disponibles y, a continuación, haga clic en el botón Agregar columnas seleccionadas, (>). Haga clic en Aceptar.

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

  11. Haga clic en Cerrar para cerrar la consulta. Haga clic en No cuando se le pida que guarde la consulta.

  12. Cree un nuevo elemento de trabajo de Tarea especial. Para ello, haga clic con el botón secundario en el nodo Elementos de trabajo, elija Agregar elemento de trabajo y haga clic en Tarea especial.

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

  13. 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:

       Consulte el procedimiento "Personalizar la etiqueta de un campo" de Tutorial: Realizar personalizaciones avanzadas en un tipo de elemento de trabajo para obtener más información sobre cómo cambiar las etiquetas de los campos de los formularios de los elementos de trabajo.

  14. Haga clic en Cerrar para cerrar la nueva Tarea especial. Haga clic en No cuando se le pida que guarde el elemento de trabajo.

Eliminar campos

Requisito previo: Se ha finalizado el procedimiento "Agregar un campo" de Tutorial: Realizar personalizaciones básicas en un tipo de elemento de trabajo.

Para eliminar campos

  1. Intente eliminar el campo Category que ha agregado en el procedimiento Agregar un campo. Para ello, escriba lo siguiente en el símbolo del sistema de Visual Studio y, a continuación, presione ENTRAR.

    witfields delete /s:"Nombre del servidor de Team Foundation Server" MyCompany.MyProcess.Category

    El mensaje de error que aparece indica que no se puede eliminar el campo porque lo está utilizando un proyecto de equipo.

  2. Escriba el siguiente comando y, a continuación, presione ENTRAR.

    witexport /f "ruta de acceso del archivo\specialtask.xml" /t "nombre de Team Foundation Server" /p WITLab /n "Special Task"

    De esta forma, se volverá a exportar a un archivo XML la definición del tipo de elemento de trabajo de Tarea especial desde el servidor de Team Foundation Server, incluida la nueva definición del campo Microsoft.VSTS.Common.Rank que usa su nuevo nombre descriptivo después de haberlo cambiado en el procedimiento Cambiar el nombre de los campos.

    Nota:

    Si ejecuta Windows Vista, es posible que no tenga permisos de acceso a determinadas carpetas. Si intenta exportar el tipo de elemento de trabajo a una ubicación para la que no tiene derechos de acceso, la tecnología de virtualización del Registro redirige automáticamente el archivo exportado y lo guarda en el almacén virtual. Para obtener más información, vea https://go.microsoft.com/fwlink/?LinkId=92325 y https://go.microsoft.com/fwlink/?LinkId=92323. Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos de acceso.

    Recibe el siguiente mensaje al finalizar la operación de exportación:

    Work item type export complete.

  3. En Visual Studio, haga clic en Archivo, elija Abrir y haga clic en Archivo.

    Aparecerá el cuadro de diálogo Abrir archivo.

    Nota:

    Si está abierto SpecialTask.xml, puede recibir un mensaje en el que se le pregunte si desea volver a cargar el archivo en Visual Studio. Haga clic en Sí para volver a cargarlo.

  4. En Buscar en, cambie a la ubicación a la que ha exportado el archivo.

  5. Haga clic en el archivo specialtask.xml y, a continuación, en Abrir.

  6. Haga clic en No si se le pregunta sobre los finales de línea.

  7. Busque y elimine la definición del campo Category, mostrada en el siguiente fragmento de código XML:

    <FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension"><HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT>  <WHEN field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">    <ALLOWEDVALUES>      <LISTITEM value="Planning" />      <LISTITEM value="Review" />    </ALLOWEDVALUES>  </WHEN>  <WHENNOT field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">    <ALLOWEDVALUES>      <LISTITEM value="Process Management" />      <LISTITEM value="Planning" />      <LISTITEM value="Execution" />      <LISTITEM value="Review" />    </ALLOWEDVALUES>  </WHENNOT></FIELD>

  8. En la sección <Layout>, busque el siguiente fragmento de código XML y elimine las secciones resaltadas para eliminar el campo:

    <Group Label="Classification">
  <Column PercentWidth="50">    <Group>
      <Column PercentWidth="100">
        <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
        <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
      </Column>
    </Group>  </Column>  <Column PercentWidth="50">    <Group>      <Column PercentWidth="100">        <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />      </Column>    </Group>  </Column>
</Group>

  9. Haga clic en Guardar para guardar los cambios en el archivo XML.

  10. Importe el tipo de elemento de trabajo de Tarea especial modificado a Team Foundation Server. Para ello, en el símbolo del sistema de Visual Studio, escriba lo siguiente y, a continuación, presione ENTRAR:

    witimport /f "ruta de acceso del archivo\specialtask.xml" /t "nombre de Team Foundation Server" /p WITLab

    Esta operación importa el tipo de elemento de trabajo specialtask al servidor de Team Foundation Server. Recibe el siguiente mensaje al finalizar la operación de importación:

    Work item type import complete.

  11. Compruebe que el campo Category ya no lo utiliza ningún tipo de elemento de trabajo; para ello, escriba lo siguiente en el símbolo del sistema y, a continuación, presione ENTRAR.

    witfields view /s:"Nombre del servidor de Team Foundation Server" MyCompany.MyProcess.Category

    La herramienta witfields muestra que el campo Category “No está en uso”.

    Field: MyCompany.MyProcess.Category

    Name: Category

    Type: String

    Reportable As: dimension

    Use: Not In Use

  12. Ahora que el campo Category ya no lo utiliza ningún tipo de elemento de trabajo, elimínelo definitivamente del servidor de Team Foundation Server; para ello, escriba lo siguiente en el símbolo del sistema y, a continuación, presione ENTRAR. Escriba y cuando aparezca la pregunta de confirmación para completar este paso.

    witfields delete /s:"Nombre del servidor de Team Foundation Server" MyCompany.MyProcess.Category

Vea también

Tareas

Tutorial: Realizar personalizaciones básicas en un tipo de elemento de trabajo

Tutorial: Realizar personalizaciones avanzadas en un tipo de elemento de trabajo

Otros recursos

Personalizar tipos de elemento de trabajo