共用方式為

淘汰工作項目追蹤 （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'

Visual Studio警告訊息

Q&A

如何修正工具？

首先，您應該調查並判斷工具是否仍需要。 我們發現許多組織在短時間內會基於特定原因建立工具。 然後，基於一個或另一個原因，此工具在不再需要時繼續執行。 在此案例中，您可以關閉工具。

如果工具仍在使用中，您必須使用以 REST 為基礎的 .NET 用戶端連結庫來重構此工具，。 重構需要您部分的一些反應工作，才能移除舊版 WIT 用戶端 OM 的參考，並以適當的 .NET 用戶端連結庫取代它們。

我們也將這個方便的 移轉指南 搭配 範例程式代碼，協助您從 WIT 用戶端 OM 轉換至 REST 型 .NET 用戶端連結庫。

資源