通过

弃用工作项跟踪（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 终结点。

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

Visual Studio 警告

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

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

Visual Studio警告消息

Q&A

如何修复工具？

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

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

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

资源