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

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019 | TFS 2018

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 la 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 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 elementos de trabajo.

Además, para 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 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.

Objetos de seguimiento de elementos de 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.

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 proyectos o Administradores de colecciones de proyectos. Para obtener más información, consulte Cambio de permisos de nivel de colección de proyectos.

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 donde está instalado Visual Studio. La herramienta de línea de comandos witadmin 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

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. 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 de Team Explorer 2015.

Cliente de Visual Studio 2019 o Team Explorer 2019:

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

o , TeamExplorerProfessional o Enterprise en lugar de , dependiendo de Communityla versión que haya instalado.

Cliente de Visual Studio 2017 o Team Explorer 2017:

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

o , TeamExplorerProfessional o Enterprise en lugar de , dependiendo de Communityla versión que haya instalado.

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
/help
o
/?
Muestra la sintaxis y los parámetros de la herramienta de línea de comandos witadmin .
command /help
o
comando /?
Muestra la sintaxis y los parámetros del comando witadmin que especifique.

Archivos de definición XML

Puede personalizar todos los objetos de seguimiento de trabajo( como, tipos de elementos de trabajo, configuración de procesos, 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 un Azure DevOps Server local. Como se muestra en las listas de comandos siguientes, solo se admiten los comandos witadmin que enumeran o exportan archivos para el 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ó al crear el proyecto (Agile, Scrum, Basic o CMMI). Para más información, consulte Seguimiento de los elementos de trabajo en Azure Boards casos de usuario, problemas, errores, características y epopeyas.

Para el modelo de proceso heredado, puede agregar y eliminar tipos de elementos de trabajo desde el portal web. Para obtener información sobre cómo hacerlo, consulte 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: exportar un archivo de tipo de elemento de trabajo

✔️

✔️

importwitd: importar un archivo de tipo de elemento de trabajo

✔️

listwitd: Enumerar tipos de elementos de trabajo

✔️

✔️

renamewitd: cambiar el nombre para mostrar de un tipo de elemento de trabajo

✔️


Fields

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

Para el modelo de proceso heredado, puede ver y eliminar campos desde el portal web. Para obtener información sobre cómo hacerlo, consulte Agregar y administrar campos (proceso de herencia).


Comando

Azure DevOps Services

Azure DevOps Server


deletefield: eliminar un campo

✔️

listfields: atributos de campo de lista

✔️

✔️

indexfield: activar o desactivar la indexación de campos

✔️

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 las definiciones de categoría predeterminadas, muchas de las cuales especifican un único tipo de elemento de trabajo por categoría. Para obtener información sobre las categorías y cómo se usan, consulte Uso de categorías para agrupar tipos de elementos 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 sobre los tipos de vínculo predeterminados, consulte Administrar dependencias, vincular elementos de trabajo 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: exportación de un archivo de tipo de vínculo

✔️

✔️

importlinktype: importación de un archivo de tipo de vínculo

✔️

listlinktypes: enumerar 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, consulte Referencia del elemento XML GLOBALLIST.


Comando

Azure DevOps Services

Azure DevOps Server


destroygloballist: eliminar una lista global

✔️

exportgloballist: exportar la lista global

✔️

✔️

importgloballist: importar la lista global

✔️

listgloballist: enumerar 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 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, los trabajos pendientes de sprint, la placa Kanban y el panel de tareas. Para obtener información sobre la configuración del proceso y lo que puede personalizar, consulte ProcessConfiguration.

Para el modelo de proceso heredado, puede personalizar trabajos pendientes desde el portal web. Para obtener información sobre cómo hacerlo, consulte Personalización de los trabajos pendientes o paneles (proceso de herencia).


Comando

Azure DevOps Services

Azure DevOps Server


exportprocessconfig: Exportar el archivo ProcessConfiguration

✔️

✔️

importprocessconfig: Importar el archivo ProcessConfiguration

✔️


Elementos de trabajo

El siguiente comando witadmin solo está disponible para TFS 2018.1 y versiones anteriores. Ha quedado en desuso para TFS 2018.2 y versiones posteriores. Para obtener más información sobre cómo eliminar permanentemente elementos de trabajo para versiones posteriores, vea Quitar, eliminar o restaurar elementos de trabajo.

  • destroywi: eliminar permanentemente elementos de trabajo

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 capa de aplicación, debe actualizar la memoria caché para realizar el seguimiento de los elementos de trabajo y los usuarios deben actualizar la memoria caché de control de versiones en los equipos cliente.

El siguiente comando 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 usados al trabajar con Azure Test Plans, puede usar el siguiente comando tcm. Este comando solo está disponible para Azure DevOps Server versiones locales.

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