Migrar de OM de cliente WIT para APIs REST

Serviços de DevOps do Azure

Este guia ajuda a migrar o seu código .NET do cliente WIT OM preterido para APIs REST modernas. A migração oferece benefícios significativos:

✅ Vantagens modernas:

• Operações assíncronas para melhor desempenho
• Autenticação moderna com identidades geridas e principais de serviço
• Suporte entre plataformas (.NET Core, .NET 5+ e .NET Framework)
• Desenvolvimento ativo e apoio contínuo

❌ Limitações do legado:

• Limitado apenas ao .NET Framework e Windows
• Operações de bloqueio síncronas
• Métodos de autenticação desatualizados

Visão geral da migração

1º Passo: Atualizar pacotes NuGet - Substitua o OM do cliente WIT por pacotes de cliente REST modernos Etapa 2: Atualizar a autenticação - Migrar para métodos de autenticação seguros e modernos Etapa 3: Converter operações - substituir chamadas síncronas por operações REST assíncronas

Para obter exemplos de código detalhados e exemplos de migração passo a passo, consulte o Guia de Migração do OM do Cliente WIT do GitHub Azure DevOps.

Tabela de migração de cenários comuns

A tabela a seguir mostra como migrar operações comuns de item de trabalho do OM do cliente WIT herdado para APIs REST modernas:

Migração de autenticação

Autenticação herdada (❌ Substituir):

// WIT Client OM with basic authentication
using (var tpc = new TfsTeamProjectCollection(new Uri(collectionUri)))
{
    tpc.Authenticate();
    var workItemStore = tpc.GetService<WorkItemStore>();
}

Autenticação moderna (✅ Recomendado):

// REST client with managed identity (for Azure-hosted apps)
var credentials = new VssAzureIdentityCredential();
using var connection = new VssConnection(new Uri(collectionUri), credentials);
var witClient = connection.GetClient<WorkItemTrackingHttpClient>();

// Alternative: Service principal for CI/CD
// var credentials = new VssServicePrincipalCredential(clientId, clientSecret, tenantId);

// Alternative: PAT for development/testing
// var credentials = new VssBasicCredential(string.Empty, personalAccessToken);

Próximas etapas e recursos

📖 Recursos essenciais de migração

• Exemplos modernos de biblioteca de cliente .NET - Exemplos de código prontos para produção com autenticação moderna
• Diretrizes de autenticação - Escolha o método de autenticação certo para o seu cenário
• Conceitos de bibliotecas de cliente .NET - Compreendendo a arquitetura de cliente moderna

🔧 Exemplos de código e ferramentas

• Guia de migração com exemplos de código - repositório GitHub com exemplos detalhados de migração
• Documentação da API REST de rastreamento de item de trabalho - Referência completa da API com exemplos

🆘 Apoio e comunidade

• Azure DevOps Developer Community - Faça perguntas e obtenha ajuda
• Problemas do guia de migração - Relatar cenários ausentes ou obter ajuda específica

🔄 Migrações relacionadas

• Migrar dados do Servidor de DevOps do Azure para os Serviços de DevOps do Azure - Diretrizes de migração de serviço
• Exemplos de cliente SOAP herdado - Referência para outros padrões de cliente herdados