淘汰工作項目追蹤 (WIT) 和測試用戶端 OM

Azure DevOps Services

WIT 和測試用戶端 OM 是更廣泛的 TFS SDK 的一部分。 它們是一組 SOAP 型 API,可用來建立工具,以針對 Azure DevOps 執行作業。 這些 SOAP 型 API 已由一組以新式 REST 為基礎的端點所取代。 因此,我們正在取代適用於 WIT 和測試的 SOAP 型 API(用戶端 OM)。

注意

適用於 Azure DevOps 的 WIT 和測試用戶端 OM 已在最新版本 Visual Studio 2019 和 Microsoft.TeamFoundationServer.ExtendedClient 套件中淘汰。 這表示,用戶端 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 用戶端連結庫。

資源