Azure Boards の作業項目を除去、削除、または復元する
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
作業項目は、作業追跡データ ストアに永続的に保存されます。 これらを削除する必要はありません。 ただし、次のいずれかのアクションを実行するために、作業項目管理プロセスを設定することはできます。
アクション | 説明 |
---|---|
状態の変更 | 作業項目の状態を "削除" または "切り取り" に変更することで、作業項目がバックログやボードに表示されないようにします。 使用可能な状態は、作業項目の種類に割り当てられたワークフローに基づいて決まります。 |
Delete | 作業項目をバックログ、ボード、クエリから削除します。 削除された作業項目は [ごみ箱] に移動されます。 |
復元 | 削除された作業項目をごみ箱から復元して回復します。 |
Destroy | 作業追跡データ ストアのすべてのデータも含め、作業項目を完全に削除します。 |
Note
- 現時点では、作業項目またはプロジェクトをアーカイブすることはできません。
- Azure Artifacts のごみ箱の詳細については、「パッケージの削除と回復」を参照してください。
あるプロジェクトから別のプロジェクトに作業項目を移動したり、作業項目の種類を変更したりするには、作業項目の移動と作業項目の種類の変更に関する記事を参照してください。
前提条件
- 共同作成者グループのメンバーは、作業項目を除去、削除、復元できます。
- 作業項目を完全に削除するには、プロジェクト管理者グループのメンバーであるか、必要なアクセス許可が付与されている必要があります。
- 利害関係者アクセス権を持つユーザーはごみ箱の内容を表示できますが、付与されているアクセス許可に関係なく、ごみ箱内の項目を復元または完全に削除することはできません。
タスク
必要な許可
- [区分パス] 権限が [許可: このノードの作業項目の編集] に設定されている
- 既定では、共同作成者グループのメンバーにはこのアクセス許可があります。
- プロジェクト レベルのアクセス許可が [許可: 作業項目の削除と復元] に設定されている
- 基本以上のアクセス権がある。
- 既定では、共同作成者グループのメンバーにはこのアクセス許可があります。
- プロジェクト レベルのアクセス許可が [許可: 作業項目を完全に削除する] に設定されている
- 既定では、プロジェクト管理者グループのメンバーには、このアクセス許可があります。
- プロジェクト レベルのアクセス許可が [許可: 作業項目を完全に削除する] に設定されている
- 既定では、プロジェクト管理者グループのメンバーには、このアクセス許可があります。
組み込みグループに割り当てられたアクセス許可の簡略化されたビューについては、アクセス許可とアクセス権に関する記事を参照してください。
注意
パブリック プロジェクトの利害関係者アクセスが付与されたユーザーは、Basic アクセスが付与されたユーザーと同様に、すべての作業追跡機能へのフル アクセス権を持っています。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。
複数の作業項目を除去または削除する
個々の作業項目に対して操作を実行したり、複数の作業項目を一括変更したりできます。
Web ポータルで、バックログまたはクエリ結果ページから複数の作業項目を複数選択できます。 関連付けられている機能を使用して一括更新を行うこともできます。 複数の作業項目を同時に削除したり復元したりする方法については、作業項目の一括変更に関する記事を参照してください。
REST API を使用して、作業項目をバッチで削除したり破棄したりすることもできます。 詳細については、「作業項目 - 削除」を参照してください。
Note
この機能は、Azure DevOps Server 2022.1 以降で使用できます。
作業項目を削除する
作業項目の [状態] を [削除済み] に変更すると、それらは、バックログやボード ビュー (プロダクト、ポートフォリオ、スプリント バックログ、かんばんボード、タスクボード) から実質的に削除されます。 [削除済み]状態は、ワークフロー カテゴリ状態の [削除済み] に対応します。 カスタム ワークフロー状態を定義した場合は、削除済みのワークフロー カテゴリ状態にマップした状態もすべて同様に動作します。
削除された項目がクエリに表示されないようにするには、[状態] フィールドをフィルター処理する句を追加する必要があります。
注意
[削除済み] 状態は、Basic プロセスではサポートされていません。 アジャイル、スクラム、CMMI プロセスの作業項目の種類でのみサポートされます。 Basic プロセスは、プロジェクトを Azure DevOps Services または Azure DevOps Server 2019 Update 1 に追加するときに使用できます。
作業項目の削除
削除された作業項目は、バックログ、ボード、またはクエリに表示されません。 削除した項目は、ごみ箱に移動します。 状況が変わった場合は、そこから復元できます。 テスト ケース、テスト計画、またはその他のテスト関連の作業項目の種類を削除するには、「テスト成果物の削除」を参照してください。
作業項目を削除するには、次のいずれかの方法を使用します。
- 作業項目フォーム
- [作業項目] ページの
[その他のアクション] メニュー
- かんばんボードカードの
コンテキスト メニュー
- バックログまたはクエリ結果ページ
- REST API
削除操作を始めます。
- 作業項目フォームから作業項目を開き、
[アクション] を選択して、[削除] を選択します。
- 複数の作業項目を削除するには、バックログまたはクエリ結果リストから項目を複数選択し、
コンテキスト メニューを選択し、[削除] を選択します。
- かんばんまたはタスクボードから作業項目を削除するには、カードの
コンテキスト メニューを選んで、[削除] を選びます。
- 作業項目フォームから作業項目を開き、
項目を削除することを確認します。
作業項目を復元または破棄する
ごみ箱から作業項目を開くことはできません。 [完全に削除] オプションは、ユーザーの [作業項目を完全に削除] プロジェクト レベル アクセス許可が [許可] に設定されている場合にのみ表示されます。
Web ポータルの [ごみ箱] から、削除された作業項目を復元したり、完全に削除したりします。
[ボード]>[作業項目]>[ごみ箱] を選びます。
[ごみ箱] オプションが表示されない場合は、[その他のコマンド] を選んで、オプションのメニューから選びます。
新しいブラウザー タブが開き、ごみ箱に追加された作業項目を一覧表示するクエリが表示されます。
復元する項目を選択し、[復元] を選択します。
必要に応じて、項目を完全に削除することもできます。
選択内容を確認します。
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 リソースを参照してください。