弃用工作项跟踪 (WIT) 和测试客户端 OM

Azure DevOps Services

WIT 和测试客户端 OM 是更广泛的 TFS SDK 的一部分。 它们是一组基于 SOAP 的 API,可用于创建工具以针对Azure DevOps运行操作。 这些基于 SOAP 的 API 已替换为基于 REST 的新式终结点集。 因此,我们正在弃用基于 SOAP 的 API, (用于 WIT 和测试的客户端 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 的任何引用都会导致警告已过时。 这包括 2019 年 Visual Studio 和 Azure DevOps 2019 附带的 dll。 下面是你可能会收到的示例警告...

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

warning message in Visual Studio

问答

如何实现修复工具?

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

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

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

资源