Migrar do cliente WIT OM para as APIs REST

Serviços do Azure DevOps

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

✅ Vantagens modernas:

• Operações assíncronas para melhor desempenho
• Autenticação moderna com as identidades gerenciadas e as entidades de serviço
• Suporte multiplataforma (.NET Core, .NET 5+ e .NET Framework)
• Desenvolvimento ativo e suporte contínuo

❌ Limitações herdadas:

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

Visão geral da migração

Etapa 1: Atualizar pacotes NuGet – Substituir o OM do cliente WIT por pacotes de cliente REST modernos Etapa 2: Atualizar 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 de 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 itens de trabalho do WIT Client OM herdado para as 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 de migração essenciais

• Exemplos modernos da biblioteca de clientes do .NET – exemplos de código pronto para produção com autenticação moderna
• Diretrizes de autenticação – Escolha o método de autenticação correto para seu cenário
• Conceitos de bibliotecas de clientes do .NET – Noções básicas sobre a arquitetura moderna do cliente

🔧 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 Acompanhamento de Item de Trabalho – Referência completa da API com exemplos

🆘 Suporte e comunidade

• Comunidade de Desenvolvedores do Azure DevOps – 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 do Azure DevOps para o Azure DevOps Services – Diretrizes de migração de serviço
• Exemplos de cliente SOAP herdados – Referência para outros padrões de cliente herdados