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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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

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

Note

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

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

前提条件

• アクセス許可:
  • 作業項目を削除、削除、復元するには、 Contributors グループのメンバーになります。
  • 作業項目を完全に削除するには、 Project Administrators グループのメンバーであるか、必要なアクセス許可が付与されます。
  • 利害関係者アクセス権を持つユーザーはごみ箱の内容を表示できますが、付与されているアクセス許可に関係なく、ごみ箱内の項目を復元または完全に削除することはできません。

タスク

必要なアクセス許可

---

状態を [除去] または [切り取り] に変更する

• [区分パス] 権限が [許可: このノードの作業項目の編集] に設定されている
• 既定では、共同作成者グループのメンバーにはこのアクセス許可があります。

作業項目の削除および
作業項目の復元

• プロジェクト レベルのアクセス許可が [許可: 作業項目の削除と復元] に設定されている
• 基本以上のアクセス権がある。
• 既定では、共同作成者グループのメンバーにはこのアクセス許可があります。

作業項目を完全に削除または破棄する

• プロジェクト レベルのアクセス許可が [許可: 作業項目を完全に削除する] に設定されている
• 既定では、プロジェクト管理者グループのメンバーには、このアクセス許可があります。

::: moniker-end

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

• プロジェクト レベルのアクセス許可が [許可: 作業項目を完全に削除する] に設定されている
• 既定では、プロジェクト管理者グループのメンバーには、このアクセス許可があります。

---

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

注意

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

複数の作業項目を除去または削除する

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

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

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

Note

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

作業項目を削除する

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

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

注意

[削除済み] 状態は、Basic プロセスではサポートされていません。 アジャイル、スクラム、CMMI プロセスの作業項目の種類でのみサポートされます。 Basic プロセスは、プロジェクトを Azure DevOps Services または Azure DevOps Server 2019 Update 1 に追加するときに使用できます。

作業項目の削除

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

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

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

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

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

     

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

     

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

     

2. アイテムを削除することを確認します。

   

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

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

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

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

   

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

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

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

   

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

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

Note

削除されたテスト成果物はごみ箱に移動されず、復元できません。 テスト成果物を削除すると、子テスト スイート、すべての構成のテスト ポイント、テスト担当者、テスト結果履歴、その他の関連する履歴など、関連するすべての子項目も削除されます。 基になるテスト ケースの作業項目は削除されません。

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

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 を使用して取得された場合は必須です。
• yes: 省略可能。 確認を求めるプロンプトを表示しません。

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

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

プロセスの削除と復元

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

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

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

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

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

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

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

関連記事

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