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

[アーティクル]
04/16/2024

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 リソースを参照してください。

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

前提条件