Compartir a través de


Desuso del seguimiento de elementos de trabajo (WIT) y el OM del cliente de prueba

Azure DevOps Services

WIT y Test Client OM forman parte del SDK de TFS más amplio. Son un conjunto de API basadas en SOAP que se pueden usar para crear herramientas para ejecutar operaciones en Azure DevOps. Estas API basadas en SOAP se han reemplazado por el conjunto de puntos de conexión modernos basados en REST. Por lo tanto, estamos en proceso de dejar de usar las API basadas en SOAP (OM de cliente) para WIT y Test.

Nota:

WIT y Test Client OM para Azure DevOps han quedado en desuso en la versión más reciente de Visual Studio 2019 y el paquete Microsoft.TeamFoundationServer.ExtendedClient . Esto significa que no hay ninguna nueva funcionalidad de seguimiento o prueba de elementos de trabajo incluida en el OM de cliente.

Modelos de objetos afectados

Solo el SISTEMA WIT y el OM del cliente de prueba están en desuso. Otras áreas como compilación y control de código fuente no están en una programación de desuso en este momento.

Impacto

Si su organización usa el OM de cliente WIT en herramientas que se ejecutan en Azure DevOps, se recomienda empezar a migrar esas herramientas para dejar de usar el OM de cliente WIT y empezar a usar los nuevos puntos de conexión basados en REST .

La actualización del código para usar REST es fundamental para garantizar que las herramientas funcionen a medida que publicamos nuevas funcionalidades en Azure Boards y Azure Test.

Advertencias de Visual Studio

Las referencias a las versiones más recientes de WIT Client OM generan una advertencia obsoleta. Esto incluye los archivos DLL que vienen con Visual Studio 2019 y Azure DevOps 2019. Esta es una advertencia de ejemplo que puede recibir...

CS0618: "WorkItemType" está obsoleto: "para obtener más información, vea la documentación en https://aka.ms/witclientom"

warning message in Visual Studio

Preguntas y respuestas

Cómo corregir mis herramientas?

Lo primero que debe investigar y determinar si la herramienta sigue siendo necesaria. Hemos encontrado que muchas organizaciones crean una herramienta por un motivo específico durante un breve período de tiempo. A continuación, por un motivo u otro, esa herramienta continúa ejecutándose cuando ya no es necesaria. En este escenario, puede apagar la herramienta.

Si la herramienta sigue siendo de uso, debe refactorizar esa herramienta mediante las bibliotecas cliente de .NET basadas en REST. La refactorización requiere que algunas reacciones funcionen por su parte para quitar las referencias al ANTIGUO OM del cliente WIT y reemplazarlas por las bibliotecas cliente de .NET adecuadas.

También hemos reunido esta guía de migración útil con código de ejemplo para ayudar a la transición de WIT Client OM a las bibliotecas cliente de .NET basadas en REST.

Recursos