作業項目追跡 (WIT) とテスト クライアント OM の廃止

  • [アーティクル]

Azure DevOps Services

WIT とテスト クライアント OM は、より広範な TFS SDK の一部です。 これらは、Azure DevOps に対して操作を実行するツールを作成するために使用できる SOAP ベースの API のセットです。 これらの SOAP ベースの API は、最新の REST ベースのエンドポイントのセットに置き換えられました。 そのため、WIT およびテスト用の SOAP ベースの API (クライアント OM) を非推奨にする処理中です。

Note

Azure DevOps 用の WIT およびテスト クライアント OM は、最新バージョンの Visual Studio 2019 および Microsoft.TeamFoundationServer.ExtendedClient パッケージで非推奨になりました。 つまり、新しい作業項目の追跡やテスト機能はクライアント OM に含まれていません。

影響を受けるオブジェクト モデル

WIT とテスト クライアント OM のみが非推奨になっています。 ビルドやソース管理などのその他の領域は、現時点では非推奨のスケジュールではありません。

影響

組織が Azure DevOps に対して実行されるツールで WIT クライアント OM を使用している場合は、これらのツールの移行を開始して WIT クライアント OM の使用を停止し、新しい REST ベースのエンドポイントの使用を開始することをお勧めします。

新しい機能を Azure Boards と Azure Test にリリースする場合、REST を使用するようにコードを更新することは、ツールを確実に動作させるために不可欠です。

Visual Studio の警告

WIT クライアント OM の最新バージョンを参照すると、古い警告が発生します。 これには、Visual Studio 2019 と Azure DevOps 2019 に付属する dll が含まれます。 警告の例を次に示します。..

CS0618: 'WorkItemType' は廃止されました: '詳細については、' のドキュメント https://aka.ms/witclientomを参照してください

warning message in Visual Studio

Q&A

ツール操作方法修正しますか?

まず、ツールがまだ必要かどうかを調査して判断する必要があります。 多くの組織が、特定の理由で短期間ツールを作成していることがわかりました。 その後、何かの理由で、そのツールは不要になったときに引き続き実行されます。 このシナリオでは、ツールをシャットダウンできます。

ツールがまだ使用されている場合は、REST ベース の .NET クライアント ライブラリを使用してそのツールをリファクタリングする必要があります。 リファクタリングでは、古い WIT クライアント OM への参照を削除し、適切な .NET クライアント ライブラリに置き換えるために、一部の反応作業が必要です。

また、WIT クライアント OM から REST ベースの .NET クライアント ライブラリへの移行に役立つサンプル コードと共に、この便利な移行ガイドもまとめられています。

リソース