Substituição do WIT (Rastreamento de Item de Trabalho) e do OM do Cliente de Teste

  • Artigo

Azure DevOps Services

O WIT e o Test Client OM fazem parte do SDK mais amplo do TFS. Eles são um conjunto de APIs baseadas em SOAP que podem ser usadas para criar ferramentas para executar operações no Azure DevOps. Essas APIs baseadas em SOAP foram substituídas pelo conjunto de pontos de extremidade modernos baseados em REST. Portanto, estamos no processo de substituir as APIs baseadas em SOAP (CLIENT OM) para WIT e Test.

Observação

O WIT e o OM do Cliente de Teste para DevOps do Azure foram preteridos na versão mais recente do Visual Studio 2019 e no pacote Microsoft.TeamFoundationServer.ExtendedClient . Isso significa que não há nenhuma nova funcionalidade de rastreamento ou teste de item de trabalho incluída no OM do cliente.

Modelos de objetos afetados

Somente o WIT e o OM do cliente de teste estão sendo preteridos. Outras áreas, como compilação e controle do código-fonte, não estão em um cronograma de depreciação no momento.

Impacto

Se sua organização estiver usando o OM do Cliente WIT em ferramentas executadas no Azure DevOps, recomendamos que você comece a migrar essas ferramentas para parar de usar o OM do Cliente WIT e começar a usar os novos pontos de extremidade baseados em REST .

Atualizar seu código para usar REST é vital para garantir que suas ferramentas funcionem à medida que lançamos novas funcionalidades no Azure Boards e no Azure Test.

Avisos do Visual Studio

Quaisquer referências às versões mais recentes do WIT Client OM resultam em um aviso obsoleto. Isso inclui as dlls que vêm com o Visual Studio 2019 e o Azure DevOps 2019. Aqui está um exemplo de aviso que você pode receber...

CS0618: 'WorkItemType' está obsoleto: 'para obter mais informações, consulte a documentação em https://aka.ms/witclientom'

warning message in Visual Studio

Perguntas e respostas

Como faço para corrigir minhas ferramentas?

Primeira coisa que você deve investigar e determinar se a ferramenta ainda é necessária. Descobrimos que muitas organizações criam uma ferramenta por um motivo específico por um curto período de tempo. Então, por um motivo ou outro, essa ferramenta continua a ser executada quando não é mais necessária. Para esse cenário, você pode desligar a ferramenta.

Se a ferramenta ainda estiver em uso, você precisará refatorá-la novamente usando as bibliotecas de cliente .NET baseadas em REST. A refatoração requer algum trabalho de reação de sua parte para remover referências ao antigo OM do cliente WIT e substituí-las pelas bibliotecas de cliente .NET apropriadas.

Também reunimos este guia de migração prático com código de exemplo para ajudar na transição do OM do Cliente WIT para as bibliotecas do Cliente .NET baseadas em REST.

Recursos