witAdmin: Personalizar y administrar objetos para el seguimiento de elementos de trabajo
Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Importante
Con witadmin, puede modificar los archivos de definición XML para admitir el modelo de proceso XML local. Para obtener información general sobre los modelos de proceso y lo que se admite, consulte Personalización de la experiencia de seguimiento de trabajo.
Puede cambiar la forma de realizar el seguimiento del progreso del equipo creando y personalizando objetos para el seguimiento de elementos de trabajo. Mediante la herramienta de línea de comandos witadmin, puede crear, eliminar, importar y exportar objetos como categorías, listas globales, flujo de trabajo global, tipos de vínculos y tipos de elementos de trabajo. También puede eliminar, enumerar o cambiar los atributos de los campos de elemento de trabajo.
Nota
La herramienta de línea de comandos witadmin no se admite en Azure DevOps Services. En su lugar, se usan procesos heredados.
Como se muestra en la ilustración siguiente, se administran categorías y tipos de elementos de trabajo y para cada proyecto. Puede administrar listas globales, tipos de vínculos y campos en el elemento de trabajo para cada colección de proyectos. Puede personalizar el flujo de trabajo global para un proyecto o una colección.
trabajo
Sugerencia
Con witadmin, puede importar y exportar archivos de definición. Otras herramientas que puede usar incluyen el Editor de procesos (requiere que haya instalado una versión de Visual Studio). Instale el editor de plantillas de proceso desde Visual Studio Marketplace.
O bien, puede usar TFS Team Project Manager,un cliente de código abierto disponible en GitHub.
Sugerencia
Con witadmin, puede importar y exportar archivos de definición. Otras herramientas que puede usar incluyen el Editor de procesos (requiere que haya instalado una versión de Visual Studio). Instale el editor de plantillas de proceso de TFS desde Visual Studio Marketplace. Puede usar esta versión del Editor de procesos para modificar los formularios de elementos de trabajo de estilo antiguo. No se puede usar para editar formularios asociados a los nuevos formularios web forms.
O bien, puede usar TFS Team Project Manager,un cliente de código abierto disponible en GitHub.
Sugerencia
Con witadmin, puede importar y exportar archivos de definición. Otras herramientas que puede usar incluyen el Editor de procesos (requiere que haya instalado una versión de Visual Studio). Instale TFS Power Tools. O bien, puede usar TFS Team Project Manager,un cliente de código abierto disponible en GitHub.
Para la mayoría de los comandos, debe ser miembro de los grupos administradores de Project o Project administradores de recopilación. Para obtener más información, vea Agregar un administrador.
Ejecución de la herramienta de línea de comandos witadmin
Para ejecutar la herramienta de línea de comandos witadmin, abra una ventana del símbolo del sistema Visual Studio está instalado. La herramienta de línea de comandos witadmin se instala con cualquier versión de Visual Studio. Puede acceder a esta herramienta instalando la versión gratuita de Visual Studio Community o Visual Studio Team Explorer.
Nota
Si se conecta a un servidor local, debe usar la misma versión o posterior de Visual Studio o Team Explorer que Azure DevOps Server o TFS. Por ejemplo, si se conecta a una instancia de TFS 2017, debe conectarse desde Visual Studio 2017 o Team Explorer 2017. No hay ninguna versión Team Explorer 2015.
Visual Studio cliente de 2019 Team Explorer 2019:
%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
o , TeamExplorer o en lugar de , en función de la versión que haya ProfessionalEnterpriseCommunity instalado.
Visual Studio cliente de 2017 Team Explorer 2017:
%programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
o , TeamExplorer o en lugar de , en función de la versión que haya ProfessionalEnterpriseCommunity instalado.
Visual Studio cliente de 2015:
cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
Visual Studio 2013 cliente:
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
Team Explorer cliente de 2013:
cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
En una edición de 32 bits de Windows, reemplace %programfiles(x86)% por %programfiles%. Puede instalar Visual Studio Community (que proporciona acceso a Team Explorer) o Visual Studio Team Explorer 2017 de forma gratuita.
Parámetros globales
Puede usar los parámetros siguientes para mostrar el texto de ayuda de witadmin.
| Parámetro | Descripción |
|---|---|
| /help o bien /? |
Muestra la sintaxis y los parámetros de la herramienta de línea de comandos witadmin. |
| command /help o bien comando /? |
Muestra la sintaxis y los parámetros del comando witadmin que especifique. |
comandos witadmin
Puede personalizar todos los objetos de seguimiento de trabajo,como los tipos de elementos de trabajo (WIT), la configuración de procesos y las listas globales, mediante la actualización de sus definiciones XML.
Los comandos witadmin se ejecutan en una base de datos Azure DevOps Server. Si no está nuevo en la personalización del seguimiento del trabajo, consulte Personalización de la experiencia de seguimiento de trabajo.
tipos de elemento de trabajo
- destroywitd:eliminar un WIT
- exportwitd:Exportación de un archivo WIT
- importwitd:Importar un archivo WIT
- listwitd:enumeración de nombres WIT
- renamewitd:cambiar un nombre para mostrar wit
Fields
- deletefield:eliminación de un campo
- listfields:enumerar atributos de campo
- changefield:cambio de un atributo de campo
- deletefield:eliminación de un campo
- listfields:enumerar atributos de campo
- indexfield:activar o desactivar la indexación de campos
- changefield:cambio de un atributo de campo
Configuración de proceso
- exportprocessconfig:exportación del archivo ProcessConfiguration
- importprocessconfig:importar el archivo ProcessConfiguration
Tipos de vínculo
- deletelinktype:elimina un tipo de vínculo
- exportlinktype:exportación de un archivo de tipo de vínculo
- importlinktype:importar un archivo de tipo de vínculo
- listlinktypes:enumera los tipos de vínculo definidos
- reactivatelinktype:reactivar o cambiar el nombre de un tipo de vínculo
Listas globales
- destroygloballist:eliminar una lista global
- exportgloballist:exportación de la lista global
- importgloballist:importación de la lista global
- listgloballist:enumera todos los nombres de lista global
Flujo de trabajo global
- exportglobalworkflow:exportación del archivo de flujo de trabajo global
- importglobalworkflow:importación del archivo de flujo de trabajo global
Elementos de trabajo
- destroywi:elimina permanentemente elementos de trabajo
Caché de cliente
- rebuildcache:recompilación de la caché del cliente
Categorías
- exportcategories:exportar el archivo Categories
- importcategories:importar el archivo Categories