Migreren van WIT Client OM naar REST API's

Azure DevOps Services

Deze handleiding helpt u bij het migreren van uw .NET-code van de afgeschafte WIT Client OM naar moderne REST API's. De migratie biedt aanzienlijke voordelen:

✅ Moderne voordelen:

• Asynchrone bewerkingen voor betere prestaties
• Moderne verificatie met beheerde identiteiten en serviceprincipes
• Platformoverschrijdende ondersteuning (.NET Core, .NET 5+ en .NET Framework)
• Actieve ontwikkeling en doorlopende ondersteuning

❌ Verouderde beperkingen:

• Beperkt tot alleen .NET Framework en Windows
• Synchrone, blokkerende bewerkingen
• Verouderde verificatiemethoden

Migratieoverzicht

Stap 1: NuGet-pakketten bijwerken - WIT Client OM vervangen door moderne REST-clientpakketten Stap 2: Verificatie bijwerken - Migreren naar veilige, moderne verificatiemethoden Stap 3: Bewerkingen converteren - Synchrone aanroepen vervangen door asynchrone REST-bewerkingen

Zie de Migratiehandleiding voor GitHub Azure DevOps WIT Client OM voor gedetailleerde codevoorbeelden en stapsgewijze migratievoorbeelden.

Migratietabel voor veelvoorkomende scenario's

In de volgende tabel ziet u hoe u algemene werkitembewerkingen migreert van verouderde WIT Client OM naar moderne REST API's:

Verificatiemigratie

Legacy-authenticatie (❌ vervangen):

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

Moderne verificatie (✅ aanbevolen):

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

Volgende stappen en middelen

📖 Essentiële migratieresources

• Voorbeelden van moderne .NET-clientbibliotheek - Codevoorbeelden die gereed zijn voor productie met moderne verificatie
• Verificatierichtlijnen : de juiste verificatiemethode kiezen voor uw scenario
• Concepten van .NET-clientbibliotheken - Inzicht in de moderne clientarchitectuur

🔧 Codevoorbeelden en hulpprogramma's

• Migratiehandleiding met codevoorbeelden - GitHub-opslagplaats met gedetailleerde migratievoorbeelden
• REST API-documentatie voor het bijhouden van werkitems - Volledige API-verwijzing met voorbeelden

🆘 Ondersteuning en community

• Azure DevOps Developer Community - Vragen stellen en hulp krijgen
• Problemen met migratiehandleiding - Ontbrekende scenario's melden of specifieke hulp krijgen

🔄 Gerelateerde migraties

• Gegevens migreren van Azure DevOps Server naar Azure DevOps Services - Richtlijnen voor servicemigratie
• Verouderde SOAP-clientvoorbeelden - Naslaginformatie voor andere verouderde clientpatronen