移除、刪除或還原 Azure Boards 中的工作專案

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

工作專案可以永遠存在於您的工作追蹤數據存放區中。 您永遠不需要刪除它們。 不過，您可能想要為下列其中一個動作設定工作專案管理程式：

動作	描述
變更狀態	將工作項目的狀態變更為 移除 或 剪下，以防止其顯示在待辦事項和看板上。 您可用的狀態是以指派給工作項目類型的工作流程為基礎。
刪除	從待辦專案、面板和查詢中移除工作專案。 已刪除的工作專案會移至 回收站。
Restore	從 回收站復原已刪除的工作專案
摧毀	永久刪除工作專案，包括工作追蹤資料存放區中的所有數據。

注意

• 您目前無法封存工作項目或專案。
• 如需 Azure Artifacts 回收站的相關信息，請參閱 刪除和復原套件。

若要將工作專案從某個專案移至另一個專案，或變更工作項目類型，請參閱 移動工作專案和變更工作項目類型。

必要條件

類別	要求
許可權	- 移除、刪除和還原工作專案：必須是 參與者 群組的成員。 - 若要永久刪除工作專案：專案管理員 群組的成員或已獲得必要許可權。 - 具有 項目關係人 存取權的使用者可以檢視 回收站的內容，但無論他們獲授與的許可權為何，都無法還原或永久刪除垃圾箱中的專案。

Task

所需的權限

---

將狀態變更為 移除 或 剪下

• 區域路徑 權限設定為 允許：編輯此節點中的工作項目
• 根據預設，參與者群組的成員具有此許可權。

刪除工作專案 和
還原工作項目

• 專案層級的許可權設定為 允許：刪除和還原工作項目
• 至少 基本 存取權限。
• 根據預設，參與者群組的成員具有此許可權。

永久刪除或終結工作專案

• 專案層級許可權設定為 允許：永久刪除工作項目
• 根據預設，Project Administrators 群組的成員具有此許可權。

從命令行刪除或終結工作專案

• 專案層級許可權設定為 允許：永久刪除工作項目
• 根據預設，Project Administrators 群組的成員具有此許可權。

---

如需指派給內建群組之許可權的簡化檢視，請參閱 許可權和存取權。

注意

具有公用專案項目關係人存取權的使用者具有所有工作追蹤功能的完整存取權，就像具有基本存取權的用戶一樣。 如需詳細資訊，請參閱專案關係人存取快速參考。

移除或刪除多個工作項目

您可以處理個別工作專案，或大量修改數個工作專案。

從入口網站中，您可以從待辦專案或查詢結果頁面多重選取數個工作專案。 您也可以使用相關聯的功能執行大量更新。 若要同時刪除或還原數個工作專案，請參閱 大量修改工作專案。

您也可以使用 REST API 在批次中刪除或終結工作專案。 如需詳細資訊，請參閱 工作專案 - 刪除。

注意

此功能可從 Azure DevOps Server 2022.1 開始提供。

移除工作項目

藉由將工作專案的狀態變更為已移除，您可以有效地從待辦清單或面板檢視移除它，包括產品、組合、短跑待辦清單、面板和任務板。 [ 已移除 ] 狀態會對應至 [ 已移除 的工作流程] 類別目錄狀態。 如果您定義自定義工作流程狀態，您對應至 已移除 工作流程類別目錄狀態的任何狀態都會以類似的方式運作。 如需詳細資訊，請參閱 自定義工作流程。

若要讓移除的項目不會顯示在查詢中，您必須在 狀態 字段上新增篩選的子句。

注意

基本程式不支援 [已移除] 狀態。 它只支援敏捷式、Scrum 和 CMMI 處理工作項目類型。 當您將專案新增至 Azure DevOps Services 或 Azure DevOps Server 2019 Update 1 時，可以使用基本程式。

刪除工作專案

已刪除的工作專案不會出現在待辦專案、面板或查詢中。 當您刪除專案時，它會移至 回收站。 如果您改變想法，您可以從該處還原它。 若要刪除測試案例、測試計劃或其他與測試相關的工作項目類型，請參閱 刪除測試成品。

您可以使用下列其中一種方式移除工作專案：

• 工作項目表單
• 工作專案 頁面更多動作 功能表
• 看板卡片 上下文選單
• 待辦專案或查詢結果頁面
• REST API

1. 起始刪除工作：

   • 從工作項目表單中，開啟工作專案，選擇 [動作]，然後選取 [刪除]。

     

   • 若要刪除數個工作專案，請從待辦專案或查詢結果清單中進行多重選取，選擇操作功能表，然後選取 [刪除]。

     

   • 若要從面板或任務板刪除工作專案，請選擇 卡片的操作功能表，然後選取 [ 刪除]。

     

2. 確認您想要刪除項目。

   

還原或刪除工作項目

您無法從 回收站開啟工作專案。 只有在您的專案層級的永久刪除工作專案的許可權設定為允許時，您才會看到永久刪除選項。

還原已刪除的工作專案，或從入口網站 回收站永久刪除它們。

1. 選取 面板>工作項目>回收站.

   

   如果您沒有看到 [回收站 ] 選項，請選擇 [更多命令... ]，然後從選項選單選取 。

   新的瀏覽器索引標籤隨即開啟，其中會列出新增至 回收站的工作專案。

2. 選取您要還原的專案，然後選擇 [ 還原]。

   

   您可以選擇是否永久刪除項目。

3. 確認選擇。

備註

已刪除的測試成品不會出現在回收站中，無法還原。 當您刪除測試成品時，其所有相關聯的子專案，例如子測試套件、所有組態的測試點、測試人員、測試結果歷程記錄，以及其他相關聯的歷程記錄也會被刪除。 基礎測試案例工作專案不會被刪除。

從命令行刪除或終結工作專案

您可以使用 az boards work-item delete 命令來刪除或終結工作專案。 若要開始使用，請參閱 開始使用 Azure DevOps CLI。

注意

您可以還原 已刪除 的工作專案，但無法還原 已終結 的工作專案。

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

• id：必要。 工作項目的標識碼。
• destroy：選擇性。 永久刪除此工作專案。
• 組織：Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設值或未使用 git config 選取，則為必填項。 範例：--org https://dev.azure.com/MyOrganizationName/。
• 專案：專案的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設或使用 git config來挑選，則為必要項。
• 是：選擇性。 請勿提示確認。

下列命令會永久刪除標識碼為 864 的 Bug，且不會提示您進行確認。

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

刪除和還原流程

當您刪除工作專案時，Azure DevOps 會執行下列動作：

• 產生工作項目的新版本
• 更新變更者/變更日期欄位以支援可追溯性
• 完整地保留工作專案，包括所有欄位分配、附件、標籤和連結。
• 導致工作專案變成無法查詢，因此不會出現在任何工作追蹤體驗、查詢結果或報表中
• 正確更新圖表。 已更新CFD、速度、燃盡和輕量圖表，以移除已刪除的工作專案。
• 移除工作追蹤擴充套件
• 保留趨勢數據，但最新的值除外
• 從資料倉儲/cube 中移除工作專案，如同永久刪除一般。

當您還原工作專案時，Azure DevOps 會執行下列動作：

• 導致生成工作項目的新修訂版
• 更新 變更者和變更日期欄位以支援可追溯性
• 變成可查詢
• 所有欄位都保持不變
• 歷程記錄包含兩個新的修訂，一個用於刪除，另一個用於還原
• 重新附加工作追蹤延伸模組
• 正確更新圖表。 已更新 CFD、速度、燃盡圖和輕量型圖表，以包含已還原的工作專案。
• 還原趨勢數據
• 將工作專案重新新增至資料倉儲/多維資料集
• 如果刪除先前的區域路徑或反覆項目路徑，請將區域或反覆項目路徑欄位設定為根節點

使用 REST API 刪除、還原和終結工作專案

若要以程式設計方式刪除、還原和終結工作專案，請參閱下列其中一個 REST API 資源：

• 回收站 REST API 參考
• 工作專案 - 刪除 REST API 參考

相關文章

• 使用 [工作專案] 頁面檢視和新增工作專案
• 刪除測試成品
• 設定工作追蹤的許可權和存取權
• 變更專案層級許可權
• 利害關係人存取簡易參考