Deprecazione del rilevamento dell'elemento di lavoro (WIT) e dell'OM del client di test

Servizi di Azure DevOps

WIT e Test Client OM fanno parte dell'SDK TFS più ampio. Sono un set di API basate su SOAP che possono essere usate per creare strumenti per eseguire operazioni su Azure DevOps. Queste API basate su SOAP sono state sostituite dal set di endpoint moderni basati su REST. Di conseguenza, è in corso la deprecazione delle API basate su SOAP (OM client) per WIT e Test.

Nota

WIT e Test Client OM per Azure DevOps sono stati deprecati nella versione più recente di Visual Studio 2019 e nel pacchetto Microsoft.TeamFoundationServer.ExtendedClient . Ciò significa che non esiste alcuna nuova funzionalità di rilevamento o test degli elementi di lavoro inclusa nell'OM client.

Modelli a oggetti interessati

Solo WIT e Test Client OM sono deprecati. Altre aree, ad esempio la compilazione e il controllo del codice sorgente, non sono in base a una pianificazione di deprecazione in questo momento.

Impatto

Se l'organizzazione usa WIT Client OM negli strumenti eseguiti su Azure DevOps, è consigliabile iniziare a eseguire la migrazione di tali strumenti per interrompere l'uso di WIT Client OM e iniziare a usare i nuovi endpoint basati su REST .

L'aggiornamento del codice per l'uso di REST è fondamentale per garantire che gli strumenti funzionino man mano che vengono rilasciate nuove funzionalità in Azure Boards e test di Azure.

Avvisi di Visual Studio

Tutti i riferimenti alle versioni più recenti di WIT Client OM generano un avviso obsoleto. Sono incluse le dll fornite con Visual Studio 2019 e Azure DevOps 2019. Ecco un esempio di avviso che potresti ricevere...

CS0618: 'WorkItemType' è obsoleto: 'per altre informazioni, vedere la documentazione all'indirizzo https://aka.ms/witclientom'

warning message in Visual Studio

Domande e risposte

Ricerca per categorie correggere gli strumenti?

Prima di tutto è necessario analizzare e determinare se lo strumento è ancora necessario. Abbiamo scoperto che molte organizzazioni creano uno strumento per un motivo specifico per un breve periodo di tempo. Quindi, per un motivo o un altro, tale strumento continua a essere eseguito quando non è più necessario. Per questo scenario, è possibile arrestare lo strumento.

Se lo strumento è ancora in uso, è necessario effettuare il refactoring dello strumento usando le librerie client .NET basate su REST. Il refactoring richiede alcune operazioni di reazione da parte dell'utente per rimuovere i riferimenti all'OM client WIT precedente e sostituirli con le librerie client .NET appropriate.

Questa utile guida alla migrazione è stata anche messa insieme con codice di esempio per facilitare la transizione da WIT Client OM alle librerie client .NET basate su REST.

Risorse