次の方法で共有

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

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

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

Action Description
状態の変更 作業項目の状態を [削除] または [切り取り] に変更することで、作業項目がバックログやボードに表示されないようにします。 使用可能な状態は、作業項目の種類に割り当てられたワークフローに基づいて決まります。
Delete 作業項目をバックログ、ボード、クエリから削除します。 削除された作業項目はごみ箱に移動されます。
Restore 削除された作業項目をごみ箱から復元して回復します。
Destroy 作業追跡データ ストアのすべてのデータも含め、作業項目を完全に削除します。

Note

  • 現時点では、作業項目またはプロジェクトをアーカイブすることはできません。
  • Azure Artifacts のごみ箱の詳細については、「パッケージの削除と回復」を参照してください。

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

Prerequisites

Category Requirements
一般アクセス - 作業項目を削除、削除、復元するには: 共同作成者 グループのメンバー
- 作業項目を完全に削除するには: プロジェクト管理者 グループのメンバー、または必要なアクセス許可を付与します
- 関係者 アクセス権を持つユーザーは ごみ箱 の内容を表示できますが、付与されたアクセス許可に関係なく、アイテムを復元または完全に削除することはできません
状態を [削除] または [切り取り] に変更する - [エリア パス] 権限が [許可] に設定されている: このノードの作業項目を編集する
- 既定では、 共同作成者 グループのメンバーにはこのアクセス許可があります
作業項目を削除して復元する - [ 許可] に設定されたプロジェクト レベルのアクセス許可: 作業項目の削除と復元
- 少なくとも 基本 アクセス
- 既定では、 共同作成者 グループのメンバーにはこのアクセス許可があります
作業項目を完全に削除または破棄する - プロジェクトレベルの権限を 許可 に設定: 作業項目を完全に削除する
- 既定では、 プロジェクト管理者 グループのメンバーにはこのアクセス許可があります
コマンド ラインから作業項目を削除または破棄する - プロジェクトレベルの権限を 許可 に設定: 作業項目を完全に削除する
- 既定では、 プロジェクト管理者 グループのメンバーにはこのアクセス許可があります

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

Note

パブリック プロジェクトの利害関係者アクセス権を持つユーザーは、Basic アクセス権を持つユーザーと同様に、すべての作業追跡機能へのフル アクセス権を持っています。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。

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

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

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

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

Note

この機能は、Azure DevOps Server 2022.1 以降で使用できます。

作業項目を削除する

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

作業項目フォーム [削除済みへの状態変更] のスクリーンショット。

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

Note

[削除済み] 状態は、基本プロセスではサポートされていません。 アジャイル、スクラム、CMMI プロセスの作業項目の種類でのみサポートされます。 基本プロセスは、Azure DevOps Services および Azure DevOps Server 2020 以降のバージョンで使用できます。

作業項目の削除

削除された作業項目は、バックログ、ボード、またはクエリに表示されません。 削除した項目は、ごみ箱に移動します。 状況が変わった場合は、そこから復元できます。 テスト ケース、テスト計画、またはその他のテスト関連の作業項目の種類を削除するには、「テスト成果物の削除」を参照してください。

すべての作業項目を削除するには、次のいずれかの方法を使用します。

  • 作業項目フォーム
  • [作業項目] ページの [その他のアクション] メニュー
  • ボード カード コンテキスト メニュー
  • バックログまたはクエリ結果ページ
  • REST API

  1. 削除操作を始めます。

    • 作業項目フォームから作業項目を開き、[アクション] を選択して、[削除] を選択します。

      作業項目フォームのスクリーンショット。[アクション] メニューで [削除] を選択します。

    • 複数の作業項目を削除するには、バックログまたはクエリ結果リストから項目を複数選択し、 コンテキスト メニューを選択し、[削除] を選択します。

      バックログの複数選択のスクリーンショット。[アクション] メニューで [削除] を選択します。

    • ボードまたはタスクボードから作業項目を削除するには、カードのコンテキスト メニューを選択し、 [削除] を選択します。

      ボード カードのコンテキスト メニューのスクリーンショット。[削除] を選択します。

  2. 項目の削除を確認します。

    [削除の確認] ダイアログのスクリーンショット。

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

ごみ箱から作業項目を開くことはできません。 [完全に削除] オプションは、ユーザーの [作業項目を完全に削除] プロジェクト レベル アクセス許可が [許可] に設定されている場合にのみ表示されます。

Web ポータルの [ごみ箱] から、削除された作業項目を復元したり、完全に削除したりします。

  1. [ボード]>[作業項目]>[ごみ箱] を選びます。

    [ボード、作業項目] ページ、[ごみ箱を開く] のスクリーンショット。

    [ごみ箱] オプションが表示されない場合は、[その他のコマンド] を選んで、オプションのメニューから選びます。

    新しいブラウザー タブが開き、ごみ箱に追加された作業項目を一覧表示するクエリが表示されます。

  2. 復元する項目を選択し、[復元] を選択します。

    [選択した項目を復元する] のスクリーンショット。

    必要に応じて、項目を完全に削除することもできます。

  3. 選択内容を確認します。

Note

テスト計画、テスト スイート、テスト ケースなどのテスト成果物はすべて、Azure DevOps の作業項目と見なされます。 ただし、 Azure Boards でテスト成果物を削除 するために使用される方法は、テストされていない作業項目を削除する方法とは異なります。 Azure DevOps Services では、論理的な削除モデルがサポートされています。このモデルでは、テスト プランとテスト スイートが削除されてから 14 日間、論理的な削除状態になります。 ソフト削除された状態にある間は、復元できます。

コマンド ラインから作業項目を削除または破棄する

az boards work-item delete コマンドを使用して、作業項目を削除または破棄できます。 開始するには、「Azure DevOps CLI の概要」を参照してください。

Note

削除された作業項目を復元することはできますが、破棄された作業項目は復元できません。

az boards work-item delete --id
                           [--destroy]
                           [--org]
                           [--project]
                           [--yes]
  • id: 必須。 作業項目の ID。
  • destroy: 省略可能。 この作業項目を完全に削除します。
  • org: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として設定されていない場合、または git config を使用して取得された場合は必須です。 例: --org https://dev.azure.com/MyOrganizationName/.
  • project: プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_ID を使用して、既定のプロジェクトを構成できます。 既定として設定されていない場合、または git config を使用して取得された場合は必須です。
  • はい: 省略可能。 確認を求めるプロンプトを表示しません。

次のコマンドは、ID 864 のバグを完全に削除します。確認を求めるメッセージは表示されません。

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

プロセスの削除と復元

作業項目を削除すると、Azure DevOps によって次のアクションが実行されます:

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

作業項目を復元すると、Azure DevOps によって次のアクションが実行されます:

  • 作業項目の新しいリビジョンを作成します
  • [変更者/変更日] フィールドが更新され、トレーサビリティがサポートされます
  • クエリ可能になります
  • フィールドはいずれも変更されません
  • 履歴には、削除用と復元用の 2 つの新しいリビジョンが含まれています
  • 作業追跡拡張機能が再アタッチされます
  • グラフを正しく更新します。 CFD、進捗速度、バーンダウン、軽量グラフが更新され、復元された作業項目が含まれます。
  • 傾向データが復元されます
  • 作業項目がデータ ウェアハウス/キューブに戻されます
  • 前の領域パスまたは反復パスが削除された場合に、領域または反復パスのフィールドをルート ノードに設定します。

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

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

関連コンテンツ