Partilhar via


Descontinuação do WIT (Work Item Tracking) e do OM do cliente de teste

Serviços de DevOps do Azure

WIT e 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.

Nota

WIT e Test Client OM para Azure DevOps 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 Client OM.

Modelos de objeto 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 substituiçã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 nos Painéis do Azure e no Teste do Azure.

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 posso corrigir as 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 prático guia de migração 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