Azure Boardsで作業項目を削除、削除、または復元する

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

作業項目は、作業追跡データ ストアに永続的に残ることができます。 ファイルを手動で削除する必要は一切ありません。 ただし、次のいずれかのアクションを実行するために、作業項目管理プロセスを設定することが推奨されます。

作業項目をあるプロジェクトから別のプロジェクトに移動したり、作業項目の種類を変更したりするには、「作業項目の移動と作業項目の種類の変更」を参照してください。

Prerequisites

組み込みグループに割り当てられたアクセス許可の簡略化されたビューについては、「アクセス許可とアクセス権」を参照してください。

複数の作業項目をクリアまたは削除する

個々の作業項目に対して操作を実行したり、複数の作業項目を一括変更したりできます。

Web ポータルで、バックログまたはクエリ結果ページから複数の作業項目を複数選択できます。 関連付けられている機能を使用して一括更新を行うこともできます。 複数の作業項目を同時に削除または復元するには、「作業項目を一括で変更する」を参照してください。

REST API を使用して、作業項目を一括で削除または破棄することもできます。 詳細については、「作業項目 - 削除」を参照してください。

作業項目を削除する

作業項目の 状態 を [削除済み] に変更すると、バックログまたはボード ビュー (製品、ポートフォリオ、スプリント バックログ、ボード、タスクボード) から効果的に削除されます。 [削除済み] 状態は、ワークフロー カテゴリ状態の [削除済み] に対応します。 カスタム ワークフローの状態を定義する場合、 削除された ワークフロー カテゴリの状態にマップする状態も同様の方法で動作します。 詳細については、ワークフローのカスタマイズに関するページを参照してください。

削除された項目がクエリに表示されないようにするには、[ 状態 ] フィールドにフィルターを適用する句を追加します。

作業項目の削除

削除された作業項目は、バックログ、ボード、またはクエリに表示されません。 削除した項目は、ごみ箱に移動します。 アイテムを復元または完全に削除するまで、アイテムはごみ箱に残ります。 テスト ケース、テスト計画、またはその他のテスト関連の作業項目の種類を削除するには、「テスト成果物の削除」を参照してください。

作業項目を復元または破棄する

ごみ箱から作業項目を開くことはできません。 ごみ箱によってアイテムが自動的に削除されることはありません。 復元または完全に削除するまで、ごみ箱に残っています。 [完全に削除] オプションは、作業項目を完全に削除するプロジェクト レベルのアクセス許可が [許可] に設定されている場合にのみ使用できます。

az boards work-item delete --id
                           [--destroy]
                           [--org]
                           [--project]
                           [--yes] 

az boards work-item delete --id 864 --destroy --yes

プロセスの削除と復元

作業項目を削除すると、Azure DevOpsは次のアクションを実行します:

• 作業項目の新しいリビジョンを生成します。
• 更新は、追跡可能性をサポートするために、変更者/変更日フィールドに行われます。
• すべてのフィールドの割り当て、添付ファイル、タグ、リンクなど、作業項目を完全に保持します。
• 作業項目をクエリ不可にし、作業追跡エクスペリエンス、クエリ結果、またはレポートに表示されないようにします。
• グラフを正しく更新します。 CFD、速度、バーンダウン、軽量グラフが更新され、削除された作業項目が削除されます。
• 作業追跡拡張機能を削除します。
• 最新の値を除き、傾向データを保持します。
• 作業項目が完全に削除された場合と同様に、データ ウェアハウス/キューブから作業項目を削除します。

作業項目を復元すると、Azure DevOpsは次のアクションを実行します:

• 作業項目の新しいリビジョンを作成します。
• 変更者/変更日フィールドを追跡可能性をサポートするように更新します。
• 作業項目をクエリ可能にします。
• すべてのフィールドを変更せずに保持します。
• 履歴に 2 つの新しいリビジョンを追加します。1 つは削除用、1 つは復元用です。
• 作業追跡拡張機能を再添付します。
• グラフを正しく更新します。 CFDチャート、速度チャート、バーンダウンチャート、軽量チャートが、復元された作業項目を含むように更新されます。
• 傾向データを復元します。
• 作業項目をデータ ウェアハウス/キューブに戻します。
• 前の領域パスまたは反復パスが削除された場合は、領域または反復パスのフィールドをルート ノードに設定します。

REST API を使用して作業項目を削除、復元、破棄する

プログラムによって作業項目を削除、復元、破棄するには、次のいずれかの REST API リソースを参照してください。

• ごみ箱の REST API リファレンス
• 作業項目 - REST API リファレンスを削除する

AI を使用して削除する作業項目を検索する

エージェント モードで Azure Boards MCP Server を AI エージェントに接続する場合は、自然言語プロンプトを使用して、作業項目を削除または削除する前に、作業項目を検索および更新できます。

関連コンテンツ

• [作業項目] ページを使用して作業項目を表示および追加する
• テスト成果物を削除
• 作業追跡の権限とアクセスを設定する
• プロジェクト レベルのアクセス許可を変更する
• 利害関係者アクセスのクイック リファレンス