Migrer de l'OM Client WIT vers des API REST

Azure DevOps Services

Ce guide vous aide à migrer votre code .NET de l’om client WIT déconseillé vers des API REST modernes. La migration offre des avantages significatifs :

✅ Avantages modernes :

• Opérations asynchrones pour améliorer les performances
• Authentification moderne avec identités gérées et principaux de service
• Prise en charge multiplateforme (.NET Core, .NET 5+ et .NET Framework)
• Développement actif et support continu

❌ Limitations héritées :

• Limité à .NET Framework et à Windows uniquement
• Opérations synchrones et bloquantes
• Méthodes d’authentification obsolètes

Vue d’ensemble de la migration

Étape 1 : Mettre à jour les packages NuGet - Remplacer le modèle de client WIT par les packages clients REST modernes Étape 2 : Mise à jour de l’authentification - Migrer vers des méthodes d’authentification sécurisées, méthodes d’authentification modernes Étape 3 : Convertir les opérations - Remplacer les appels synchrones par des opérations REST asynchrones

Pour obtenir des exemples de code détaillés et des exemples de migration pas à pas, consultez le Guide de migration du modèle client WIT Azure DevOps GitHub.

Table de migration de scénarios courants

Le tableau suivant montre comment migrer les opérations courantes sur les éléments de travail de l’ancien client WIT OM vers les API REST modernes :

Migration de l’authentification

Authentification héritée (❌ remplacer) :

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

Authentification moderne (✅ recommandé) :

// 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);

Étapes et ressources suivantes

📖 Ressources de migration essentielles

• Exemples de bibliothèques clientes .NET modernes - Exemples de code prêts pour la production avec l’authentification moderne
• Conseils d’authentification - Choisir la méthode d’authentification appropriée pour votre scénario
• Concepts des bibliothèques clientes .NET - Présentation de l’architecture cliente moderne

🔧 Exemples de code et outils

• Guide de migration avec des exemples de code - Référentiel GitHub avec des exemples de migration détaillés
• Documentation de l’API REST Suivi des éléments de travail - Référence d’API complète avec des exemples

🆘 Support et communauté

• Communauté des développeurs Azure DevOps - Poser des questions et obtenir de l’aide
• Problèmes liés au guide de migration - Signaler des scénarios manquants ou obtenir de l’aide spécifique

🔄 Migrations associées

• Migrer des données d’Azure DevOps Server vers Azure DevOps Services - Conseils de migration de service
• Exemples de clients SOAP legacy - Référence pour d’autres schémas de clients legacy