Personalizar y administrar tipos de elemento de trabajo
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.
La utilidad 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 tipos de elementos de trabajo, vea Agregar definiciones de tipo de elementos de trabajo a una plantilla de procesos.
Nota
Puede crear y modificar tipos de elementos 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 April 2010.
Permisos necesarios
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 Lectores o tener el permiso Ver los elementos de trabajo en este nodo 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, 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 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 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 |
/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. .gif "Nota") 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/AWTeam/Collection1
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/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks /v