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

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Importante

Para el modelo de proceso XML local, puede usar witadmin para enumerar, importar, exportar y modificar un proceso para un proyecto. En el caso de los modelos de proceso XML heredados y hospedados, solo puede usar witadmin para enumerar y exportar información del proceso. Para obtener información general sobre los modelos de proceso y lo que se admite, consulte Personalización de la experiencia de seguimiento del trabajo.

Puede cambiar el seguimiento del progreso de su equipo mediante la creación y personalización de objetos que realizan un seguimiento de los 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 elementos de trabajo.

Además, en el caso de los servidores de Azure DevOps locales, puede administrar los tipos de resolución, los errores y los tipos de error que se usan con la administración de casos de prueba con el comando fieldmapping de tcm.

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.

Imagen conceptual de objetos de seguimiento de elementos de trabajo.

Para la mayoría de los comandos, debe ser miembro de los grupos project Administración istrators o Project Collection Administración istrators. Para obtener más información, consulte Cambio de permisos de nivel de colección de proyectos.

Ejecución de la herramienta de witadmin línea de comandos

Para ejecutar la witadmin herramienta de línea de comandos, abra una ventana del símbolo del sistema donde está instalado Visual Studio. La witadmin herramienta de línea de comandos se instala con cualquier versión de Visual Studio. Para acceder a esta herramienta, instale la versión gratuita de Visual Studio Community o Visual Studio Team Explorer.

Nota:

Para conectarse a Azure DevOps Services, se recomienda usar la versión más reciente de Visual Studio o Visual Studio Community.

Nota:

Para conectarse a un servidor local, se recomienda usar la misma versión o posterior de Visual Studio que azure DevOps Server. Por ejemplo, si se conecta a Azure DevOps Server 2019, conéctese al proyecto desde una versión de Visual Studio 2019.

Para Visual Studio 2022

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

o ProfessionalEnterprise en lugar de , dependiendo de Communityla versión instalada.

Para Visual Studio 2019

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

o ProfessionalEnterprise en lugar de , dependiendo de Communityla versión instalada.

Para Visual Studio 2017

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

o TeamExplorerProfessional en lugar de , dependiendo de Enterprisela versión instalada.

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 texto de ayuda para witadmin.

Parámetro Descripción
/? o help Muestra la sintaxis y los parámetros de la herramienta de witadmin línea de comandos.
command /help
o
command /?		 Muestra la sintaxis y los parámetros del witadmin comando que especifique.

Archivos de definición XML

Puede personalizar todos los objetos de seguimiento de trabajo (como, los tipos de elementos de trabajo, la configuración de procesos, las listas globales) mediante la actualización de sus definiciones XML. Si no está familiarizado con la personalización del seguimiento del trabajo, consulte Personalización de la experiencia de seguimiento del trabajo.

Ejecute comandos witadmin en Azure DevOps Services o en una instancia local de Azure DevOps Server. Como se muestra en las listas de comandos siguientes, solo se admiten los comandos witadmin que enumeran o exportan archivos para Azure DevOps Services.

Tipos de elementos de trabajo

Los elementos de trabajo se usan para realizar un seguimiento de todo lo que necesita para realizar el seguimiento. Cada elemento de trabajo se basa en un tipo de elemento de trabajo. Cada tipo de elemento de trabajo define los campos disponibles en los que almacenar información. Los tipos de elementos de trabajo disponibles dependen del proceso que usó cuando se creó el proyecto (Agile, Scrum, Basic o CMMI). Para más información, consulte Seguimiento de los elementos de trabajo en casos de usuario, problemas, errores, características y epopeyas de Azure Boards.

Para el modelo de proceso heredado, puede agregar y eliminar tipos de elementos de trabajo desde el portal web. Para obtener más información, vea Agregar y administrar tipos de elementos de trabajo (proceso de herencia).

Comando

Azure DevOps Services

Azure DevOps Server

destroywitd: eliminar un tipo de elemento de trabajo

✔️

exportwitd: exportación de un archivo de tipo de elemento de trabajo

✔️

✔️

importwitd: importar un archivo de tipo de elemento de trabajo

✔️

listwitd: Enumeración de tipos de elementos de trabajo

✔️

✔️

renamewitd: cambie el nombre para mostrar de un tipo de elemento de trabajo.

✔️

Campos

Los campos se usan para realizar un seguimiento del estado y la información asociados a los elementos de trabajo. Los campos se definen para una organización o colección. Para obtener más información, consulte Campos y atributos de elementos de trabajo. Para buscar la descripción de un campo específico, consulte Descripciones de campos para campos predeterminados y de elementos de trabajo usados en plantillas de proceso.

Para el modelo de proceso heredado, puede ver y eliminar campos desde el portal web. Para obtener más información, vea Agregar y administrar campos (proceso de herencia).

Comando

Azure DevOps Services

Azure DevOps Server

deletefield: eliminar un campo

✔️

listfields: enumerar atributos de campo

✔️

✔️

changefield: cambiar un atributo de campo

✔️

renamewitd: cambiar un nombre para mostrar de WIT

✔️

Categorías

Las categorías asocian uno o varios tipos de elementos de trabajo que pertenecen a la misma categoría. Azure Boards se basa en definiciones de categorías predeterminadas, muchas de las cuales especifican un único tipo de elemento de trabajo por categoría. Para más información, consulte Uso de categorías para agrupar tipos de elemento de trabajo.

Comando

Azure DevOps Services

Azure DevOps Server

exportcategories: exportar el archivo Categories

✔️

✔️

importcategories: importar el archivo Categories

✔️

Use diferentes tipos de vínculo para administrar las distintas relaciones entre los elementos de trabajo. En el caso de los modelos de proceso XML local y XML hospedado, puede definir tipos de vínculo personalizados. Para obtener más información, vea Vincular elementos de trabajo a otros objetos y guía de referencia para los tipos de vínculo.

Comando

Azure DevOps Services

Azure DevOps Server

deletelinktype: eliminar un tipo de vínculo

✔️

exportlinktype: exportar un archivo de tipo de vínculo

✔️

✔️

listlinktypes: muestra los tipos de vínculo definidos.

✔️

✔️

reactivatelinktype: reactivar o cambiar el nombre de un tipo de vínculo

✔️

Listas globales

Las listas globales son listas de selección que puede incluir dentro de uno o varios campos y definiciones de tipo de elemento de trabajo. Puede compartir elementos de lista entre varios tipos de elementos de trabajo para una colección de proyectos mediante la inclusión de los elementos de lista en uno o varios elementos GLOBALLIST . Para obtener más información, vea Referencia de elementos XML GLOBALLIST.

Comando

Azure DevOps Services

Azure DevOps Server

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

Con el flujo de trabajo global, puede definir y actualizar campos y listas globales que se aplican a todos los tipos de elementos de trabajo de un proyecto o colección. Para obtener más información, consulte Referencia de elementos XML de flujo de trabajo global.

Comando

Azure DevOps Services

Azure DevOps Server

exportglobalworkflow: exportación del archivo de flujo de trabajo global

✔️

importglobalworkflow: importación del archivo de flujo de trabajo global

✔️

Configuración de proceso

La configuración del proceso define la configuración predeterminada y las funcionalidades funcionales a las que los equipos pueden acceder mediante Azure Boards. La configuración determina los tipos de elementos de trabajo que aparecen en el trabajo pendiente del producto, trabajos pendientes de sprint, panel Kanban y panel de tareas. Para obtener más información sobre la configuración del proceso y lo que puede personalizar, consulte Configuración de procesos.

Para el modelo de proceso heredado, puede personalizar los trabajos pendientes desde el portal web. Para más información, consulte Personalización de los trabajos pendientes o paneles (proceso de herencia).

Comando

Azure DevOps Services

Azure DevOps Server

exportprocessconfig: exportación del archivo ProcessConfiguration

✔️

✔️

importprocessconfig: importar el archivo ProcessConfiguration

✔️

Caché de cliente

Después de ciertas operaciones de mantenimiento, los equipos cliente requieren una actualización de caché. Después de mover, restaurar, cambiar el nombre o conmutar por error un servidor de capa de datos o de nivel de aplicación, debe actualizar la caché para realizar el seguimiento de elementos de trabajo y los usuarios deben actualizar la caché del control de versiones en los equipos cliente.

El comando siguiente witadmin solo está disponible para Azure DevOps Server local.

  • rebuildcache: recompilación de la memoria caché del cliente

Asignación de campos de administración de casos de prueba

Para personalizar los tipos de resolución, el tipo de elemento de trabajo de errores y los tipos de error que se usan al trabajar con planes de prueba de Azure, puede usar el siguiente comando tcm . Este comando solo está disponible para las versiones locales de Azure DevOps Server.

  • tcm fieldmapping: importe o exporte un archivo que defina los tipos de resolución, errores o errores que se van a usar con la administración de casos de prueba.