通过

弃用工作项跟踪（WIT）和测试客户端 OM

  • 项目

Azure DevOps Services

WIT 和测试客户端 OM 是更广泛的 TFS SDK 的一部分。 它们是一组基于 SOAP 的 API，可用于创建针对 Azure DevOps 运行操作的工具。 这些基于 SOAP 的 API 已替换为一组基于 REST 的新式终结点。 因此，我们正在为 WIT 和测试弃用基于 SOAP 的 API（客户端 OM）。

注意

最新版本的 Visual Studio 2019 和 Microsoft.TeamFoundationServer.ExtendedClient 包中已弃用适用于 Azure DevOps 的 WIT 和测试客户端 OM。 这意味着，客户端 OM 中不包含新的工作项跟踪或测试功能。

受影响的对象模型

仅弃用 WIT 和测试客户端 OM。 其他区域（如生成和源代码管理）目前未按弃用计划进行。

影响

如果你的组织在针对 Azure DevOps 运行的工具中使用 WIT 客户端 OM，建议开始迁移这些工具以停止使用 WIT 客户端 OM，并开始使用基于 REST 的新终结点。

更新代码以使用 REST 对于确保工具在将新功能发布到 Azure Boards 和 Azure 测试时至关重要。

Visual Studio 警告

对最新版本的 WIT 客户端 OM 的任何引用都会导致警告已过时。 这包括 Visual Studio 2019 和 Azure DevOps 2019 附带的 dll。 下面是你可能会收到的示例警告...

CS0618：“WorkItemType”已过时：“有关详细信息，请参阅中的 https://aka.ms/witclientom文档

warning message in Visual Studio

问答

如何实现修复工具？

首先，应调查并确定工具是否仍需要。 我们发现，许多组织在短时间内出于特定原因创建了一个工具。 然后，出于一个或另一个原因，该工具在不再需要时继续运行。 对于此方案，可以关闭该工具。

如果该工具仍在使用，则需要使用基于 REST 的 .NET 客户端库重构该工具。 重构需要一些反应工作才能删除对旧 WIT 客户端 OM 的引用，并将其替换为相应的 .NET 客户端库。

我们还将这个方便的 迁移指南 与 示例代码 相结合，帮助你从 WIT 客户端 OM 过渡到基于 REST 的 .NET 客户端库。

资源