Dépréciation du suivi des éléments de travail (WIT) et du modèle de client de test
Azure DevOps Services
WIT et Test Client OM font partie du KIT de développement logiciel (SDK) TFS plus large. Il s’agit d’un ensemble d’API basées sur SOAP qui peuvent être utilisées pour créer des outils pour exécuter des opérations sur Azure DevOps. Ces API SOAP ont été remplacées par l’ensemble de points de terminaison REST modernes. Par conséquent, nous sommes en train de déprécier les API basées sur SOAP (MODÈLE client) pour WIT et Test.
Remarque
WIT et Test Client OM pour Azure DevOps a été déconseillé dans la dernière version de Visual Studio 2019 et le package Microsoft.TeamFoundationServer.ExtendedClient . Cela signifie qu’il n’existe aucune nouvelle fonctionnalité de suivi ou de test d’élément de travail incluse dans le modèle d’objet client.
Modèles objet affectés
Seul le modèle de client WIT et test est déconseillé. D’autres domaines tels que la génération et le contrôle de code source ne sont pas prévus pour l’instant.
Impact
Si votre organisation utilise l’om client WIT dans les outils qui s’exécutent sur Azure DevOps, nous vous recommandons de commencer à migrer ces outils pour cesser d’utiliser l’om client WIT et commencer à utiliser les nouveaux points de terminaison REST .
La mise à jour de votre code pour utiliser REST est essentielle pour garantir que vos outils fonctionnent à mesure que nous mettons en production de nouvelles fonctionnalités dans Azure Boards et Azure Test.
Avertissements visual Studio
Toutes les références aux dernières versions du modèle de client WIT entraînent un avertissement obsolète. Cela inclut les dll fournies avec Visual Studio 2019 et Azure DevOps 2019. Voici un exemple d’avertissement que vous pouvez recevoir...
CS0618 : « WorkItemType » est obsolète : « pour plus d’informations, consultez la documentation à l’adresse https://aka.ms/witclientom«
Q&A
Comment faire corriger mes outils ?
Première chose que vous devez examiner et déterminer si l’outil est toujours nécessaire. Nous avons constaté que de nombreuses organisations créent un outil pour une raison spécifique pendant une courte période. Ensuite, pour une raison ou une autre, cet outil continue à s’exécuter lorsqu’il n’est plus nécessaire. Pour ce scénario, vous pouvez arrêter l’outil.
Si l’outil est toujours utilisé, vous devez refactoriser cet outil à l’aide des bibliothèques clientes .NET basées sur REST. La refactorisation nécessite un travail de réaction de votre part pour supprimer les références à l’ancien modèle de client WIT et les remplacer par les bibliothèques clientes .NET appropriées.
Nous avons également mis en place ce guide de migration pratique avec des exemples de code pour faciliter la transition de l’om client WIT aux bibliothèques clientes .NET basées sur REST.