Udostępnij za pośrednictwem

Wycofanie śledzenia elementów roboczych (WIT) i testowego elementu testowego

  • Artykuł

Azure DevOps Services

WIT i testowe OM klienta są częścią szerszego zestawu TFS SDK. Są to zestaw interfejsów API opartych na protokole SOAP, które mogą służyć do tworzenia narzędzi do uruchamiania operacji względem usługi Azure DevOps. Te interfejsy API oparte na protokole SOAP zostały zastąpione zestawem nowoczesnych punktów końcowych opartych na protokole REST. W związku z tym jesteśmy w trakcie wycofania interfejsów API opartych na protokole SOAP (Client OM) dla WIT i Test.

Uwaga

Pakiet Microsoft.TeamFoundationServer.ExtendedClient został przestarzały w najnowszej wersji programu Visual Studio 2019 i pakietu Microsoft.TeamFoundationServer.ExtendedClient . Oznacza to, że nie ma nowych funkcji śledzenia ani testowania elementów roboczych zawartych w elemencie Client OM.

Modele obiektów, których dotyczy problem

Przestarzałe są tylko elementy WIT i Test client OM. Inne obszary, takie jak kompilacja i kontrola źródła, nie są obecnie w harmonogramie wycofywania.

Wpływ

Jeśli Twoja organizacja korzysta z funkcji OM klienta WIT w narzędziach uruchomionych w usłudze Azure DevOps, zalecamy rozpoczęcie migracji tych narzędzi, aby przestać używać OM klienta WIT i zacząć korzystać z nowych punktów końcowych opartych na protokole REST .

Aktualizowanie kodu w celu korzystania z interfejsu REST jest niezbędne, aby upewnić się, że narzędzia działają w miarę wydawania nowych funkcji w usługach Azure Boards i Azure Test.

Ostrzeżenia programu Visual Studio

Wszelkie odwołania do najnowszych wersji OM klienta WIT powodują przestarzałe ostrzeżenie. Obejmuje to biblioteki DLL dostarczane z programem Visual Studio 2019 i usługą Azure DevOps 2019. Oto przykładowe ostrzeżenie, które może zostać wyświetlone...

CS0618: "WorkItemType" jest przestarzały: "aby uzyskać więcej informacji, zobacz dokumentację pod adresem https://aka.ms/witclientom"

warning message in Visual Studio

Pytania i odpowiedzi

Jak mogę naprawić moje narzędzia?

Najpierw należy zbadać i określić, czy narzędzie jest nadal potrzebne. Odkryliśmy, że wiele organizacji tworzy narzędzie z określonego powodu przez krótki czas. Następnie z jednego lub innego powodu to narzędzie nadal działa, gdy nie jest już potrzebne. W tym scenariuszu można zamknąć narzędzie.

Jeśli narzędzie jest nadal używane, należy ponownie refaktoryzować to narzędzie przy użyciu bibliotek klienckich platformy .NET opartych na protokole REST. Refaktoryzacja wymaga wykonania pewnych działań w celu usunięcia odwołań do starego modelu obiektów klienta WIT i zastąpienia ich odpowiednimi bibliotekami klienta platformy .NET.

Połączyliśmy również ten przydatny przewodnik migracji z przykładowym kodem , aby ułatwić przejście z modelu OM klienta WIT do bibliotek klienckich platformy .NET opartych na protokole REST.

Zasoby