witAdmin: Personalize e gerencie objetos para acompanhar o trabalho

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Importante

Para o modelo de processo XML local, você pode usar witadmin para listar, importar, exportar e modificar um processo para um projeto. Para os modelos de processo XML herdado e hospedado, você só pode usar witadmin para listar e exportar informações do processo. Para obter uma visão geral dos modelos de processo e do que é suportado, consulte Personalizar sua experiência de acompanhamento de trabalho.

Pode alterar a forma como acompanha o progresso da sua equipa criando e personalizando objetos que controlam itens de trabalho. Usando a ferramenta de linha de comando witadmin , você pode criar, excluir, importar e exportar objetos como categorias, listas globais, fluxo de trabalho global, tipos de links e tipos de itens de trabalho. Você também pode excluir, listar ou alterar os atributos dos campos de item de trabalho.

Além disso, para Servidores de DevOps do Azure locais, você pode gerenciar os tipos de resolução, bugs e tipos de falha usados com o gerenciamento de casos de teste com o comando tcm fieldmapping .

Como mostra a ilustração a seguir, você gerencia categorias, tipos e itens de trabalho para cada projeto. Você gerencia listas globais, tipos de links e campos no item de trabalho para cada coleção de projetos. Você pode personalizar o fluxo de trabalho global para um projeto ou uma coleção.

Imagem conceitual de objetos de rastreamento de item de trabalho.

Para a maioria dos comandos, você deve ser membro dos grupos Administradores de Projeto ou Administradores de Coleção de Projetos. Para obter mais informações, consulte Alterar permissões no nível da coleção do projeto.

Executar a ferramenta de linha de witadmin comando

Para executar a ferramenta de linha de comando, abra uma janela de prompt de comando onde o witadmin Visual Studio está instalado. A witadmin ferramenta de linha de comando é instalada com qualquer versão do Visual Studio. Você pode acessar essa ferramenta instalando a versão gratuita do Visual Studio Community ou do Visual Studio Team Explorer.

Nota

Para se conectar aos Serviços de DevOps do Azure, recomendamos que você use a versão mais recente do Visual Studio ou da Comunidade do Visual Studio.

Nota

Para se conectar a um servidor local, recomendamos que você use a mesma versão ou posterior do Visual Studio como seu Servidor de DevOps do Azure. Por exemplo, se você se conectar ao Azure DevOps Server 2019, conecte-se ao seu projeto a partir de uma versão do Visual Studio 2019.

Para o Visual Studio 2022

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

Enterprise ou Professional no lugar de Community, dependendo da versão instalada.

Para o Visual Studio 2019

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

Enterprise ou Professional no lugar de Community, dependendo da versão instalada.

Para Visual Studio 2017

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

Professional ou TeamExplorer no lugar de Enterprise, dependendo da versão instalada.

Numa edição de 32 bits do Windows, substitua %programfiles(x86)% por %programfiles%. Você pode instalar o Visual Studio Community (que fornece acesso ao Team Explorer) ou o Visual Studio Team Explorer 2017 gratuitamente.

Parâmetros globais

Você pode usar os seguintes parâmetros para exibir o texto de ajuda do witadmin.

Parâmetro Description
/? ou help Exibe a sintaxe e os parâmetros da ferramenta de witadmin linha de comando.
command /help
ou
command /?		 Exibe a sintaxe e os parâmetros do witadmin comando especificado.

Arquivos de definição XML

Você personaliza todos os objetos de controle de trabalho, como tipos de item de trabalho, configuração de processo, listas globais, atualizando suas definições XML. Se você é novo na personalização do acompanhamento de trabalho, consulte Personalizar sua experiência de acompanhamento de trabalho.

Você executa comandos witadmin nos Serviços de DevOps do Azure ou em um Servidor de DevOps do Azure local. Conforme mostrado nas listas de comandos a seguir, somente os comandos witadmin que listam ou exportam arquivos têm suporte para os Serviços de DevOps do Azure.

Tipos de item de trabalho

Os itens de trabalho são usados para rastrear qualquer coisa que você precise rastrear. Cada item de trabalho é baseado em um tipo de item de trabalho. Cada tipo de item de trabalho define os campos disponíveis nos quais armazenar informações. Os tipos de item de trabalho disponíveis dependem do processo que você usou quando seu projeto foi criado (Agile, Scrum, Basic ou CMMI). Para obter mais informações, consulte Controlar seus itens de trabalho em histórias de usuário, problemas, bugs, recursos e épicos do Azure Boards.

Para o modelo de processo herdado, você pode adicionar e excluir tipos de item de trabalho do portal da Web. Para obter mais informações, consulte Adicionar e gerenciar tipos de item de trabalho (processo de herança).

Comando

Serviços de DevOps do Azure

Azure DevOps Server

destroywitd: Excluir um tipo de item de trabalho

✔️

exportwitd: Exportar um arquivo de tipo de item de trabalho

✔️

✔️

importwitd: Importar um arquivo de tipo de item de trabalho

✔️

listwitd: Listar tipos de item de trabalho

✔️

✔️

renamewitd: Alterar o nome para exibição de um tipo de item de trabalho

✔️

Campos

Os campos são usados para controlar o status e as informações associadas aos itens de trabalho. Os campos são definidos para uma organização ou coleção. Para obter mais informações, consulte Campos e atributos de item de trabalho. Para procurar a descrição de um campo específico, consulte Descrições de campos para campos padrão e de item de trabalho usados em modelos de processo.

Para o modelo de processo herdado, você pode exibir e excluir campos do portal da Web. Para obter mais informações, consulte Adicionar e gerenciar campos (Processo de herança).

Comando

Serviços de DevOps do Azure

Azure DevOps Server

deletefield: Eliminar um campo

✔️

listfields: Listar atributos de campo

✔️

✔️

changefield: Alterar um atributo de campo

✔️

renamewitd: Alterar um nome de exibição WIT

✔️

Categorias

As categorias associam um ou mais tipos de item de trabalho como pertencentes à mesma categoria. Os Painéis do Azure dependem de definições de categoria padrão, muitas das quais especificam um único tipo de item de trabalho por categoria. Para obter mais informações, consulte Usar categorias para agrupar tipos de item de trabalho.

Comando

Serviços de DevOps do Azure

Azure DevOps Server

exportcategories: Exportar o arquivo de categorias

✔️

✔️

importcategories: Importar o arquivo de categorias

✔️

Use diferentes tipos de link para gerenciar as várias relações entre itens de trabalho. Para modelos de processo XML local e XML hospedado, você pode definir tipos de link personalizados. Para obter mais informações, consulte Vincular itens de trabalho a outros objetos e Guia de referência para tipos de link.

Comando

Serviços de DevOps do Azure

Azure DevOps Server

deletelinktype: Excluir um tipo de link

✔️

exportlinktype: Exportar um arquivo de tipo de link

✔️

✔️

listlinktypes: Listar os tipos de link definidos

✔️

✔️

reactivatelinktype: Reativar ou renomear um tipo de link

✔️

Listas globais

Listas globais são listas de opções que você pode incluir em um ou mais campos e definições de tipo de item de trabalho. Você pode compartilhar itens de lista entre vários tipos de item de trabalho para uma coleção de projetos incluindo os itens de lista em um ou mais elementos GLOBALLIST . Para obter mais informações, consulte Referência do elemento XML GLOBALLIST.

Comando

Serviços de DevOps do Azure

Azure DevOps Server

destroygloballist: Excluir uma lista global

✔️

exportgloballist: Exportar a lista global

✔️

✔️

importgloballist: Importar a lista global

✔️

listgloballist: Listar todos os nomes de listas globais

✔️

✔️

Fluxo de trabalho global

Com o fluxo de trabalho global, você pode definir e atualizar campos e listas globais que se aplicam a todos os tipos de item de trabalho em um projeto ou coleção. Para obter mais informações, consulte Referência de elemento XML do fluxo de trabalho global.

Comando

Serviços de DevOps do Azure

Azure DevOps Server

exportglobalworkflow: Exportar o arquivo de fluxo de trabalho global

✔️

importglobalworkflow: Importar o arquivo de fluxo de trabalho global

✔️

Configuração do processo

A configuração do processo define a configuração padrão e os recursos funcionais que suas equipes podem acessar usando os Painéis do Azure. A configuração determina os tipos de item de trabalho que aparecem na lista de pendências do produto, listas de pendências de sprint, quadro Kanban e quadro de tarefas. Para obter mais informações sobre a configuração do processo e o que você pode personalizar, consulte Configuração do processo.

Para o modelo de processo herdado, você pode personalizar listas de pendências do portal da Web. Para obter mais informações, consulte Personalizar suas listas de pendências ou quadros (processo de herança).

Comando

Serviços de DevOps do Azure

Azure DevOps Server

exportprocessconfig: Exportar o arquivo ProcessConfiguration

✔️

✔️

importprocessconfig: Importar o arquivo ProcessConfiguration

✔️

Cache do cliente

Após determinadas operações de manutenção, os computadores clientes requerem uma atualização de cache. Depois de mover, restaurar, renomear ou fazer failover de um servidor de camada de dados ou de camada de aplicativo, você deve atualizar o cache para controlar itens de trabalho e os usuários devem atualizar o cache de controle de versão em computadores cliente.

O comando a seguir witadmin só está disponível para o Azure DevOps Server local.

  • rebuildcache: Reconstruir o cache do cliente

Mapeamento de campo de gerenciamento de casos de teste

Para personalizar os tipos de resolução, o tipo de item de trabalho de bug e os tipos de falha usados ao trabalhar com os Planos de Teste do Azure, você pode usar o seguinte comando tcm . Este comando só está disponível para versões locais do Azure DevOps Server.

  • tcm fieldmapping: importe ou exporte um arquivo que define os tipos de resolução, bug ou tipos de falha a serem usados com o gerenciamento de casos de teste.