{"id":43895,"date":"2018-05-21T17:54:32","date_gmt":"2018-05-22T01:54:32","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/devops\/?p=43895"},"modified":"2019-08-19T05:22:15","modified_gmt":"2019-08-19T13:22:15","slug":"announcing-the-deprecation-of-the-wit-and-test-client-om-at-jan-1-2020-2","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/announcing-the-deprecation-of-the-wit-and-test-client-om-at-jan-1-2020-2\/","title":{"rendered":"Announcing the deprecation of the WIT and Test Client OM"},"content":{"rendered":"

Updated contents on April 2, 2019<\/em><\/p>\n

Since the first version of Team Foundation Server (TFS) in 2005, we have provided a set of SOAP APIs for programmatic interaction with Work Items and Tests. In recent years, REST has replaced SOAP as the preferred method for building integrations offering a simpler and more flexible programming model, support for multiple data formats, and superior performance and scalability. As our REST APIs have matured we’ve reached a point where we feel it’s time to announce the deprecation of the Work Item and Test SOAP APIs.<\/p>\n

Starting in Visual Studio 2019 and Azure DevOps Server 2019, all work item and test methods in the Microsoft.TeamFoundationServer.ExtendedClient are marked as obsolete. Our ExtendedClient nuget package will also be updated with the obsolete attributes.<\/p>\n

It is important to note that current functionality in the WIT Client will not change and is still supported as is. However, we will not be investing in the WIT Client OM as new Azure Boards and Azure Test features are released.<\/p>\n

If you are a consumer of these SOAP APIs we recommend to plan for a migration to REST<\/a>. The table below outlines a deprecation matrix of what you can expect across both SOAP and REST.<\/p>\n

Azure DevOps Server<\/strong><\/p>\n\n\n\n\n\n\n\n
\n <\/td>\n\n TFS 2018\n <\/td>\n\n Server 2019\n <\/td>\n\n Server 2020+\n <\/td>\n<\/tr>\n
\n SOAP\n <\/td>\n\n WIT\n <\/td>\n\n Yes\n <\/td>\n\n Deprecated\n <\/td>\n\n Deprecated\n <\/td>\n<\/tr>\n
\n Test\n <\/td>\n\n Yes\n <\/td>\n\n Deprecated\n <\/td>\n\n Deprecated\n <\/td>\n<\/tr>\n
\n REST\n <\/td>\n\n WIT\n <\/td>\n\n Yes\n <\/td>\n\n Yes\n <\/td>\n\n Yes\n <\/td>\n<\/tr>\n
\n Test\n <\/td>\n\n Partial\n <\/td>\n\n Yes\n <\/td>\n\n Yes\n <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n \u00a0\n<\/div>\n

Azure DevOps Service<\/strong><\/p>\n\n\n\n\n\n\n\n
\n <\/td>\n\n Starting in 2019\n <\/td>\n<\/tr>\n
\n SOAP\n <\/td>\n\n WIT\n <\/td>\n\n Deprecated\n <\/td>\n<\/tr>\n
\n Test\n <\/td>\n\n Deprecated\n <\/td>\n<\/tr>\n
\n REST\n <\/td>\n\n WIT\n <\/td>\n\n Yes\n <\/td>\n<\/tr>\n
\n Test\n <\/td>\n\n Yes\n <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n \u00a0\n<\/div>\n

Additional resources<\/h2>\n