Azure Boardsでテスト成果物を削除する

Azure DevOps サービス |Azure DevOps Server |Azure DevOps Server 2022

テスト計画、テスト スイート、テスト ケースなどのテスト成果物はすべて、Azure DevOps内の作業項目です。 削除はAzure DevOps Serverに永続的ですが、Azure DevOps サービスでは回復可能です。 削除プロセスと回復オプションを理解することは、安全に削除するのに役立ちます。

ヒント

この記事の後半でAI を使用してこのタスクに役立てる方法をご説明します。または、Azure DevOps MCP Server で AI サポートを有効にする方法を参照して作業を開始できます。

削除動作を理解する

削除動作は、Azure DevOps サービスとAzure DevOps Serverによって異なります。 各プラットフォームが削除を処理する方法と使用可能な回復オプションを理解すると、自信を持って削除できます。

Azure DevOps サービスの削除モデル

Azure DevOps Services では、論理的な削除モデルがサポートされています。 テスト 計画またはテスト スイートを削除すると、完全に削除される前に 14 日間の復旧期間が入力されます。

テスト成果物を削除するとどうなりますか

  1. TCM データ ストアから削除する

    • 削除したテスト成果物が、テスト ケース管理 (TCM) データ ストアから削除されます。
    • テスト成果物に関連付けられている基になる作業項目が削除されます。

  2. 子項目を削除する

    • バックグラウンド ジョブによって、TCM データ ストアと基になる作業項目の両方からすべての子項目の削除が開始されます。
    • 削除する成果物の数によっては、このプロセスは数分かかる場合があります。

  3. 論理的な削除

    • 作業項目追跡データ ストアと TCM データ ストアの両方のすべての情報は論理的な削除状態になり、14 日以内に復元できます。

  4. 完全な削除

    • どのような状況でも、削除されたデータを再アクティブ化または復元することはできません。

削除されたテスト計画またはテスト スイートを 14 日間の論理的な削除フェーズで復元するには:

  1. List API を実行して、復元する テスト プラン/Test Suite を取得します。
  2. 復元するテスト プラン/テスト スイートを含む応答が List API から返された場合は、それらを復元するために Test Plan/Test Suite の PATCH API を実行します。
  3. List API が復元するテスト 計画またはテスト スイートを返さない場合、システムから完全に削除され、復元できません。

削除されたテスト プランまたはスイートを復元する

14日間のソフト削除期間中は、削除されたテスト計画とスイートを復元できます:

  1. List API を実行して、復元する テスト プラン/Test Suite を取得します。
  2. List API が、復元する Test Plan/Test Suite を含む応答を返した場合は、それらを復元するために Test Plan/Test Suite 用の PATCH API を実行してください。
  3. List API が復元するテスト 計画またはスイートを返さない場合、完全に削除され、復旧できません。

重要な制限事項

  • 削除後、テスト計画とテスト スイートは 14 日間ソフト削除状態で保持されます。 この期間が経過すると、それらは完全に削除され、復元できません。
  • テスト計画またはスイートを復元すると、すべての子アーティファクト (テスト スイート、テスト ケース) も復元されます。
  • テスト計画とスイートに関連付けられているテスト実行の復元はサポートされていません。
  • API またはポータル以外のメソッドによって削除されたテスト ケースは完全に削除され、復元できません。

Azure DevOps Server削除モデル

重要

永続的および元に戻せない削除: Azure DevOps Serverでは、テスト 計画、テスト スイート、テスト ケース、共有ステップ、共有パラメーターなど、テスト成果物の完全な削除のみがサポートされます。 削除された成果物は復元できません。また、関連するすべての子項目 (テスト結果など) も削除されます。 さらに、テスト成果物の一括削除はサポートされていません。

この操作を元に戻すことはできないため、テスト成果物を削除する前に必要な情報をバックアップします。

テスト成果物を削除するとどうなりますか

  1. TCM データ ストアからの削除:

    • 削除したテスト成果物が、テスト ケース管理 (TCM) データ ストアから削除されます。
    • テスト成果物に関連付けられている基になる作業項目が削除されます。

  2. 子項目の削除:

    • バックグラウンド ジョブによって、TCM データ ストアと基になる作業項目の両方からすべての子項目の削除が開始されます。
    • 削除する成果物の数によっては、このプロセスは数分かかる場合があります。

  3. 完全な削除:

    • このプロセスでは、作業項目追跡データ ストアと TCM データ ストアの両方のすべての情報が完全に削除されます。
    • どのような状況でも、削除されたデータを再アクティブ化または復元することはできません。

前提条件

カテゴリ 必要条件
アクセス レベル テスト成果物を管理または削除するための Basic + Test Plans または Visual Studio Enterprise。 Basic アクセス権を持つユーザーは、孤立したテスト ケース (テスト プランまたはスイートにリンクされていないテスト ケース) のみを削除できます。
アクセス許可 - テストの実行 Project Administrators グループのメンバー、またはプロジェクト レベルの テスト実行の削除 アクセス許可が 許可 に設定されていること。
アクセス許可 — テスト計画とスイート Project Administrators グループのメンバー、または [エリア パス] ノード レベルの [テスト プランの管理] または [テスト スイートの管理] アクセス許可が [許可] に設定されている。

Note

プロジェクト管理者でない場合は、プロジェクト レベルの Delete テスト実行 アクセス許可と、該当するエリア パス ノード レベルのアクセス許可の両方が必要です。

ヒント

適切なアクセス許可があるかどうかわからない場合 「 削除のアクセス許可の確認 」セクションを参照してください。

テスト エクスペリエンスをサポートする作業項目の種類

次の図は、テスト エクスペリエンスをサポートし、Microsoft Test Manager と連携する一連の作業項目の種類を示しています。 これらの作業項目の種類は、示されているリンクの種類を使用してリンクされます。

テスト管理作業項目の種類を示すスクリーンショット。

Web ポータルまたは Microsoft Test Manager から、テスト スイート用に定義されたテスト ケースと、テスト計画用に定義されたテスト スイートを表示することができます。 ただし、これらのオブジェクトはリンクの種類を通して相互に接続されることはありません。 これらの作業項目の種類で使用される各フィールドの定義については、ビルドとテストの統合フィールドに基づくクエリに関する記事を参照してください。

テスト成果物を削除する

Warning

テスト成果物の削除は永続的であり、元に戻すことはできません。 Azure DevOps サービスでは、削除されたテスト プランとテスト スイートを復元するために 14 日間あります。 Azure DevOps Serverでは、削除は即時かつ永続的です。 削除を確認する前に、選択内容を慎重に確認してください。

テスト ケースの削除

  1. 削除するテスト ケースに移動します。
  2. [アクション] メニューから [ 完全に削除 ] を選択します。
  3. 表示されるダイアログで削除を確認します。

Web フォームからのテスト ケースおよび関連するテスト成果物の削除。

Note

[完全に削除] オプションは、必要なアクセス許可とアクセス レベルがある場合にのみ使用できます。

テスト スイートを削除する

  1. 削除するテスト スイートに移動します。
  2. [アクション] メニューから [ 完全に削除 ] を選択します。
  3. 表示されるダイアログで削除を確認します。

テスト成果物の削除の確認ダイアログ。

テスト計画を削除する

オプション A: テスト計画ビューから削除する

  1. 削除したいテスト計画に移動します。
  2. [アクション] メニューから [ 完全に削除 ] を選択します。
  3. 表示されるダイアログで削除を確認します。

オプション B: テスト 計画ハブから削除する

  1. テスト計画を開きます。
  2. 削除するテスト 計画を一覧から見つけます。
  3. テスト計画を右クリックします (または、プランの横にある ··· メニュー アイコンを選択します)。
  4. を選択して、を削除します。
  5. 削除を確認します。

[テスト計画] ページでテスト計画を削除するスクリーンショット。

共有ステップまたは共有パラメーターを削除する

  1. 削除する共有ステップまたは共有パラメーターを開きます。
  2. [ 参照の表示 ] を選択すると、この項目にリンクされているすべてのテスト ケースが表示されます。
  3. テスト ケースごとに開き、共有ステップまたはパラメーターへのリンクを削除します。
  4. すべての参照を削除した後、共有ステップまたはパラメーターに戻り、[ 完全に削除] を選択します。
  5. 削除を確認します。

Note

[完全に削除] オプションが無効になっている場合は、すべての参照を削除したことを確認します。 システムは、テスト ケースがまだ参照する共有ステップまたはパラメーターの削除をブロックします。

スクリーンショットは、フォームからの共有ステップの削除を示しています。

削除のアクセス許可を確認する

テスト成果物を削除する前に、必要なアクセス許可があることを確認します。

  1. プロジェクト設定>Permissions に移動します。
  2. ユーザー アカウントまたはチームを検索します。
  3. 次のアクセス許可が [許可] に設定されていることを確認します。
    • テスト実行の削除 (テスト結果の削除用)
    • テスト 計画の管理 または テスト スイートの管理 (テスト 計画とスイートの削除用)
  4. アクセス レベルが Basic + Test Plans 以上であることを確認します。
  5. アクセス許可が正しくない場合は、プロジェクト管理者に問い合わせてください。

詳細については、「 テスト成果物のアクセス許可の管理」を参照してください。

テスト成果物の削除のトラブルシューティング

[完全に削除] オプションが表示されない

考えられる原因:

  • アクセス レベルが Basic + Test Plans より低い。
  • このアーティファクトに必要な権限がありません。
  • この場所に対するエリア パスのアクセス許可がありません。

解決方法:

  1. アクセス レベルを確認します。 [プロファイル]>[セキュリティ ] に移動して、現在のアクセス レベルを確認します。
  2. アクセス許可を確認する: 削除アクセス許可の確認を参照してください。
  3. プロジェクト管理者でない場合は、管理者に必要なアクセス許可を割り当てるように依頼してください。

削除が遅い、またはタイムアウトする

考えられる原因:

  • テストアーティファクトには、複数の子要素（テストケース、テストスイート、テスト結果）があります。
  • バックグラウンド ジョブが削除を処理しています。
  • ネットワーク接続の問題

解決方法:

  • 大規模な削除には数分かかる場合があります。 バックグラウンド ジョブが完了するまで、しばらくお待ちください。
  • 数分待ってからページを更新し、削除を確認します。
  • ネットワーク接続を確認し、もう一度やり直してください。

削除後も成果物が表示されます (Azure DevOps サービス)

考えられる原因:

  • アーティファクトはソフト削除の状態です（14日間の回復期間）。

解決方法:

  • Azure DevOps サービスでは、削除されたテスト プランとテスト スイートは、14 日間の復旧期間中も一部のビューに表示されたままです。
  • 成果物は 14 日後に完全に削除されます。
  • この期間中に成果物を復元するには、 削除されたテスト 計画またはスイートの復元 (上記の概要セクション) を参照してください。

共有ステップまたはパラメーターを削除できない

考えられる原因:

  • 共有ステップまたはパラメーターには、引き続きテスト ケースからの参照があります。

解決方法:

  1. 共有ステップまたはパラメーターを開きます。
  2. リンクされているすべてのテスト ケースを表示するには、[ 参照の表示 ] を選択します。
  3. 各テスト ケースを開き、リンクを削除します。
  4. 削除を再試行してください。

詳細については、上記の 「共有ステップまたは共有パラメーターの削除 」を参照してください。

REST API を使用してテスト成果物を削除する

Azure DevOps REST API を使用して、テスト成果物をプログラムで削除することもできます。 この方法は、自動化、一括削除、CI/CD パイプラインとの統合に役立ちます。

テスト ケースの削除

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/testcase/{testCaseId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

テスト スイートを削除する

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}/suites/{suiteId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

テスト計画を削除する

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

Note

  • {organization}、{project}、{planId}、{suiteId}、および{testCaseId}を実際の値に置き換えます。
  • API バージョン 7.1 以降を使用します。 REST API のバージョン管理で現在のバージョンを確認します。
  • Azure DevOps サービスでは、14 日間の論理的な削除ウィンドウで、API を使用して削除された成果物を復元できます。
  • Azure DevOps Serverでは、API を使用した削除は永続的です。
  • 個人用アクセス トークン (PAT) または OAuth トークンを使用して認証します。

完全な API の詳細については、 テスト 計画のごみ箱 API リファレンスを参照してください。

AI を使用してテスト成果物を削除する

組織の Azure DevOps MCP サーバーを構成する場合は、それを使用して、自然言語を使用して大規模なテスト成果物を検索および削除できます。 この方法は、手動で実行するのが困難な一括削除や複雑なクエリに特に役立ちます。

自然言語クエリの一般的なパターンを次に示します。

Task プロンプトの例
テスト計画を削除する Delete test plan <TestPlanName> in project <Contoso>
古いテスト成果物を検索する List all test plans in project <Contoso> that aren't updated in the last 6 months
破棄されたテスト スイートを削除する Find all test suites in project <Contoso> that have no test runs in the last 90 days and delete them
重複するテスト ケースを検索する Identify duplicate test cases in test suite <SuiteName> that have the same title and steps
タグによるテスト ケースの一括削除 Delete all test cases marked with tag "deprecated" in project <Contoso>
孤立した共有ステップを削除する Find shared steps in project <Contoso> that aren't referenced by any test cases
削除の影響を確認する Before I delete test plan <TestPlanName>, show me how many test cases, test suites, and test runs are associated with it
古いテスト結果を削除する Delete all test results older than 1 year from test plan <TestPlanName>
成果物のクリーンアップを計画する What test artifacts in project <Contoso> can I safely delete to clean up the test data

Note

エージェント モードと MCP サーバーでは自然言語が使用されるため、これらのプロンプトを調整したり、フォローアップの質問をして結果を絞り込むことができます。 Azure DevOps Serverでは、テスト成果物の削除は永続的であり、復元できないため、選択内容を慎重に確認してください。

関連コンテンツ

  • Last updated on