Personalizar y administrar tipos de elemento de trabajo

Artículo
02/20/2013

Puede administrar los tipos de elemento de trabajo de un proyecto de equipo utilizando los siguientes comandos witadmin:

destroywitd: destruye un tipo de elemento de trabajo, y destruye cada elemento de trabajo de ese tipo permanentemente sin recuperación posible.
exportwitd: exporta la definición de un tipo de elemento de trabajo a un archivo XML o a la ventana del símbolo del sistema.
importwitd: importa los tipos de elemento de trabajo de un archivo de definición XML en un proyecto de equipo en un servidor que ejecuta Team Foundation Server.Si un tipo de elemento de trabajo con el mismo nombre ya existe, la nueva definición del tipo de elemento de trabajo sobrescribe al existente.Si el tipo de elemento de trabajo aún no existe, este comando crea un nuevo tipo de elemento de trabajo.Para validar el XML que define un tipo de elemento de trabajo, pero no importar el archivo, use la opción /v.
listwitd: muestra los nombres de los tipos de elemento de trabajo en el proyecto especificado en la ventana del símbolo del sistema.
renamewitd: cambia el nombre para mostrar de un tipo de elemento de trabajo dentro de un proyecto concreto.Después de ejecutar este comando, los elementos de trabajo de este tipo muestran el nuevo nombre.

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 más información sobre los tipos de elemento de trabajo, vea Agregar definiciones de tipo de elementos de trabajo a una plantilla de procesos.

[!NOTA]

Puede crear y modificar tipos de elemento de trabajo mediante Process Editor, una herramienta avanzada para 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 la colección de proyectos de equipo en la que se definen los tipos de elemento de trabajo, debe tener los siguientes permisos establecidos:

Para exportar o enumerar tipos de elemento de trabajo, deberá ser miembro del grupo Project Administrators o tener el permiso Ver información de nivel de proyecto establecido en Permitir.
Para destruir, importar o cambiar el nombre de los tipos de elemento de trabajo, 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 destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

Parámetros

Parámetro	Descripción
/collection:CollectionURL	Especifica el 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
/p:Proyecto	El proyecto de equipo para el que se van a administrar los tipos de elementos de trabajo.Este proyecto de equipo se debe definir en la colección de proyectos especificada por el parámetro /collection. Se requiere el parámetro /p a menos que ejecute el comando importwitd con la opción /v.
/n:TypeName	El nombre del tipo de elemento de trabajo que se desea destruir, exportar, importar o cambiar el nombre.
/f:FileName	La ruta de acceso y nombre de archivo del archivo de definición XML que contiene los tipos de elementos de trabajo que se van a exportar o importar.Si omite este parámetro al utilizar el comando exportwitd, el XML aparece en la ventana del símbolo del sistema. Nota Si usa Windows Vista, es posible que no tenga permisos para determinadas carpetas.Si intenta exportar el tipo de elemento de trabajo a una ubicación para la que no tiene permisos, la tecnología de virtualización del Registro redirige automáticamente el archivo exportado y lo guarda en el almacén virtual.Para evitar esta redirección, puede exportar el archivo a una ubicación para la que tenga permisos. Para obtener más información sobre la virtualización del Registro, vea el sitio web de Microsoft: Virtualización del Registro y Common file and registry virtualization issues in Windows Vista.
/e:Codificación	Nombre de un formato de codificación de .NET Framework 2.0.El comando utiliza la codificación especificada para exportar o importar los datos XML.Por ejemplo, /e:utf-7 especifica la codificación Unicode (UTF-7).Si omite este parámetro, witadmin intenta detectar la codificación, y si se produce un error en la detección, witadmin utiliza UTF-8.
/exportgloballists	Exporta las definiciones de listas globales a las que el tipo de elemento de trabajo hace referencia.Las definiciones de las listas globales se insertarán en la definición XML del tipo de elemento de trabajo.Cuando no se especifica, se omiten las definiciones de las listas globales.
/v	Valida el XML que define el tipo de elemento de trabajo, pero no importa el archivo de definición XML. Nota Puede validar la definición de tipo sin especificar un proyecto de equipo.Las referencias a los grupos de ámbito de proyecto se omiten.
/new:NewName	El nuevo nombre del tipo de elemento de trabajo.
/noprompt	Deshabilita el aviso para la confirmación.
/? o help	Muestra ayuda sobre el comando en la ventana del símbolo del sistema.

Comentarios

Al utilizar el comando destroywitd, se destruyen todos los siguientes objetos:

El tipo de elemento de trabajo
Todos los elementos de trabajo de ese tipo
Las entradas correspondientes de las tablas de elementos de trabajo, las tablas de texto largo y las tablas de vínculos
Objetos en la caché de metadatos del tipo de elemento de trabajo

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 proyecto: AdventureWorks
Nombre del archivo de entrada o salida: myworkitems.xml
Nombre del tipo de elemento de trabajo: myworkitem
Codificación predeterminada: UTF-8

Exportar la definición de un tipo de elemento de trabajo

El siguiente comando exporta la definición de myworkitem al archivo, myworkitems.xml.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

En el ejemplo siguiente se exporta el elemento de trabajo utilizando la codificación Unicode (UTF-7).

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Exportar la definición de un tipo de elemento de trabajo y sus listas globales a las que se hace referencia

El ejemplo siguiente exporta el tipo de elemento de trabajo y sus listas globales a las que hace referencia.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Mostrar la definición de un tipo de elemento de trabajo

En el siguiente ejemplo se muestra la definición del tipo de elemento de trabajo en la ventana del símbolo del sistema.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

Importar la definición de tipos de elemento de trabajo

En el siguiente ejemplo se importa la definición del elemento de trabajo del archivo XML.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

Validar la definición XML de los tipos de elemento de trabajo

En el siguiente ejemplo se valida el XML que define el tipo de elemento de trabajo pero no se importa la definición.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

Vea también

Share via