Migrieren von WIT-Client-OM zu REST-APIs

Azure DevOps Services

In diesem Leitfaden können Sie Ihren .NET-Code aus dem veralteten WIT-Client-OM zu modernen REST-APIs migrieren. Die Migration bietet erhebliche Vorteile:

✅ Moderne Vorteile:

• Asynchrone Vorgänge für eine bessere Leistung
• Moderne Authentifizierung mit verwalteten Identitäten und Dienstprinzipale
• Plattformübergreifende Unterstützung (.NET Core, .NET 5+ und .NET Framework)
• Aktive Entwicklung und fortlaufende Unterstützung

❌ Veraltete Beschränkungen:

• Nur auf .NET Framework und Windows beschränkt
• Synchrone, blockierende Vorgänge
• Veraltete Authentifizierungsmethoden

Übersicht zur Migration

Schritt 1: Aktualisieren von NuGet-Paketen – Ersetzen des WIT-Client-OM durch moderne REST-Clientpakete Schritt 2: Aktualisieren der Authentifizierung – Migrieren zu sicheren, modernen Authentifizierungsmethoden Schritt 3: Konvertieren von Vorgängen – Ersetzen synchroner Aufrufe durch asynchrone REST-Vorgänge

Ausführliche Codebeispiele und Schritt-für-Schritt-Migrationsbeispiele finden Sie im GitHub Azure DevOps WIT Client OM Migration Guide.

Migrationstabelle für allgemeine Szenarien

In der folgenden Tabelle wird gezeigt, wie allgemeine Arbeitsaufgabenvorgänge von einem älteren WIT-Client-OM zu modernen REST-APIs migriert werden:

Migration der Authentifizierung

Legacy-Authentifizierung (❌ Ersetzen):

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

Moderne Authentifizierung (✅ empfohlen):

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

Nächste Schritte und Ressourcen

📖 Wichtige Migrationsressourcen

• Beispiele für moderne .NET-Clientbibliotheken – Produktionsfertige Codebeispiele mit moderner Authentifizierung
• Authentifizierungsleitfaden – Auswählen der richtigen Authentifizierungsmethode für Ihr Szenario
• Konzepte von .NET-Clientbibliotheken – Grundlegendes zur modernen Clientarchitektur

🔧 Codebeispiele und -tools

• Migrationshandbuch mit Codebeispielen – GitHub-Repository mit detaillierten Migrationsbeispielen
• Dokumentation zur REST-API für Arbeitsverfolgung – Vollständige API-Referenz mit Beispielen

 Support und Community

• Azure DevOps Developer Community – Fragen stellen und Hilfe erhalten
• Probleme mit dem Migrationsleitfaden – Melden fehlender Szenarien oder Abrufen bestimmter Hilfe

🔄 Verwandte Migrationen

• Migrieren von Daten von Azure DevOps Server zu Azure DevOps Services – Leitfaden zur Dienstmigration
• Legacy-SOAP-Clientbeispiele – Referenz für andere ältere Clientmuster