將工作專案從一個小組移至另一個小組

發行項
01/03/2025

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

當您新增小組或重新組織現有的小組時，您可能需要藉由更新其區域路徑，將工作專案從一個小組轉移到另一個小組。 Azure DevOps 中的每個工作項目都會指派給區域路徑，以決定小組擁有權，並影響工作專案在待辦專案和面板上的顯示方式。

[需求] 類別下分類的工作專案會根據其指派給小組的區域路徑，出現在小組積存專案上。同樣地，將其他工作專案指派給小組的區域路徑支援根據小組擁有權的查詢和報告。

必要條件

權限：
- 若要檢視、追蹤和編輯工作專案，請將 [檢視此節點 中的工作專案] 和 [編輯此節點 中的工作專案] 權限設定為 [ 允許]。根據預設， 參與者 群組具有這些許可權。如需詳細資訊，請參閱設定工作追蹤許可權。
若要將標籤新增至工作專案，請將專案層級 的 [建立新的標籤定義 ] 權限設定為 [允許]。根據預設， 參與者 群組具有此許可權。
存取層級：
- 成為項目成員。
- 若要將新的標籤新增至工作專案，或檢視或追蹤提取要求，請至少 具有基本 存取權。
- 若要檢視或追蹤工作專案，至少 要有項目關係人 存取權。如需詳細資訊，請參閱關於存取層級。
- 所有項目成員，包括讀者群組中的成員，都可以傳送包含工作專案的電子郵件。
注意
- 為想要參與討論和檢閱進度的成員提供項目關係人存取權。這些通常是不參與程式代碼的成員，但想要檢視工作專案、待辦專案、面板和儀錶板。
- 預設情況下，公用專案中所有 參與者 和 項目關係人 都可以新增新標籤或現有標籤。在私人專案中，項目關係人只能新增現有的標記。若要控制建立新標籤的能力，請在專案層級設定 創建標籤定義 的許可權。如需詳細資訊，請參閱變更專案層級許可權。

注意

為想要參與討論和檢閱進度的成員提供項目關係人存取權。這些通常是不參與程式代碼的成員，但想要檢視工作專案、待辦專案、面板和儀錶板。

區域路徑許可權：檢視和編輯區域路徑節點下的工作專案。如需詳細資訊，請參閱修改區域或反覆項目路徑下的工作專案。
已設定的區域路徑：確定目標小組已正確設定其區域路徑。如果沒有，請在傳送工作專案之前設定必要的區域路徑。
一致的程式模型：Teams 應該使用相容的進程模型（繼承、託管的 XML 或內部部署 XML），以確保工作專案的順暢移動。
備份工作專案：建議您先備份或匯出工作專案，再執行大量移動，以避免發生錯誤時遺失數據。
工具：若要使用 Azure CLI 命令，請安裝 Azure CLI，如開始使用 Azure DevOps CLI 中所述。

權限：
- 若要檢視、追蹤和編輯工作專案，請將 [檢視此節點 中的工作專案] 和 [編輯此節點 中的工作專案] 權限設定為 [ 允許]。根據預設， 參與者 群組具有這些許可權。如需詳細資訊，請參閱設定工作追蹤許可權。
若要將標籤新增至工作專案，請將專案層級 的 [建立新的標籤定義 ] 權限設定為 [允許]。根據預設， 參與者 群組具有此許可權。
存取層級：
- 成為項目的成員。
- 若要將新的標籤新增至工作專案，或檢視或追蹤提取要求，請至少 具有基本 存取權。
- 若要檢視或追蹤工作專案，至少 要有項目關係人 存取權。如需詳細資訊，請參閱關於存取層級。
- 所有項目成員，包括讀者群組中的成員，都可以傳送包含工作專案的電子郵件。
注意
- 為想要參與討論和檢閱進度的成員提供項目關係人存取權。這些通常是不參與程式代碼的成員，但想要檢視工作專案、待辦專案、面板和儀錶板。
- 根據預設，公共專案中所有 參與者 和 項目關係人 都可以新增標籤和使用現有標籤。在私人專案中，項目關係人只能新增現有的標記。若要控制建立新標記的能力，請在專案層級設定 [建立卷標定義] 許可權。如需詳細資訊，請參閱變更專案層級許可權。

注意

為想要參與討論和檢閱進度的成員提供項目關係人存取權。這些通常是不參與程式代碼的成員，但想要檢視工作專案、待辦專案、面板和儀錶板。

區域路徑許可權：有權在 [區域路徑] 節點下檢視和編輯工作專案。如需詳細資訊，請參閱修改區域或反覆項目路徑下的工作專案。

在小組下移動工作專案

若要在小組下移動工作專案，請執行下列步驟：

建立您想要重新指派之所有工作項目的查詢。
多重選取屬於每個小組的專案，然後大量編輯區域路徑。

入口網站的螢幕快照，[查詢] 頁面，[大量修改] 選取工作專案。

大量修改之後，請大量儲存。

大量儲存已編輯工作項目的螢幕快照。

使用 Azure CLI 移動工作專案

您可以使用 az boards work-item update 來藉由更新其區域路徑來移動單一工作專案。

az boards work-item update --id
                           [--area]
                           [--assigned-to]
                           [--description]
                           [--discussion]
                           [--fields]
                           [--iteration]
                           [--open]
                           [--reason]
                           [--state]
                           [--title]

參數

id：必要。要更新之工作項目的標識碼。
區域：選擇性。區域的絕對路徑。範例：-path \ProjectName\Area\AreaName。
assigned-to：選擇性。工作專案指派給 Jamal 的人員名稱。
描述：選擇性。工作專案的描述。
討論：選擇性。要新增至工作項目中討論的批注。
欄位：選擇性。您要設定之自訂欄位的空間分隔「field=value」組。
反覆運算：選擇性。反覆項目的絕對路徑。範例：\ProjectName\Iteration\IterationName。
open：選擇性。在預設網頁瀏覽器中開啟工作專案。
reason：選擇性。工作項目狀態的原因。
state：選擇性。工作項目的狀態，例如作用中。
title：選擇性。工作項目的標題。

範例

您一次只能使用 Azure DevOps CLI 移動一個工作專案。在此範例中，我們會在 Fabrikam Fiber\Production Planning 區域路徑下移動工作專案識別碼=148。

az boards work-item update --id 148 --area "Fabrikam Fiber\Production Planning" --output yaml

下列 YAML 輸出提供針對工作項目所定義之每個欄位的資訊。

fields:
  Microsoft.VSTS.Common.Priority: 2
  Microsoft.VSTS.Common.StackRank: 1500000001.0
  Microsoft.VSTS.Common.StateChangeDate: '2021-11-23T22:26:28.27Z'
  Microsoft.VSTS.Common.ValueArea: Business
  System.AreaPath: Fabrikam Fiber\Production Planning
  System.AssignedTo:
    _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.BoardColumn: Backlog
  System.ChangedBy:
   _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.ChangedDate: '2022-05-19T22:58:52.93Z'
  System.CommentCount: 0
  System.CreatedBy:
   _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.CreatedDate: '2021-11-23T22:26:28.27Z'
  System.Description: <div>This user story is for documentation purposes.&nbsp; </div>
  System.IterationPath: Fabrikam Fiber\Release 2\Sprint 1
  System.Reason: New
  System.State: New
  System.TeamProject: Fabrikam Fiber
  System.Title: Test the Request feedback functionality
  System.WorkItemType: User Story
  WEF_10182DA5BCCD4CE2A43629FFBD290EF2_Kanban.Column: Backlog
id: 148
relations:
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/152
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/153
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/151
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/149
rev: 5
url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/148

確認可見度

當您將工作專案從一個小組移至另一個小組之後，如果您沒有看到工作專案，請執行下列動作：

重新整理：重新整理面板，或如果新增的工作專案未出現，選取 顯示更多專案。
驗證團隊：確認您選擇了正確的團隊，以確保項目出現在待辦項目中。
確認區域路徑：確認已移動的工作專案已指派給對應至小組待辦專案的正確區域路徑。每個小組都有特定的區域路徑，可決定哪些工作項目會顯示在其待辦專案上。此動作對於確保待辦專案中的可見度至關重要。
確認工作迭代路徑：檢查短衝刺迭代路徑。短衝待辦清單只會顯示分配給所選短衝的迭代路徑的工作項目。
確認工作專案類型和篩選：檢閱待辦專案篩選條件，並正確分類工作專案類型，以確保所有相關專案都顯示。

如需詳細資訊，請參閱設定專案的待辦事項和看板。

共用方式為

將工作專案從一個小組移至另一個小組

必要條件

在小組下移動工作專案

使用 Azure CLI 移動工作專案

參數

範例

確認可見度

意見反應

其他資源

共用方式為

將工作專案從一個小組移至另一個小組

必要條件

在小組下移動工作專案

使用 Azure CLI 移動工作專案

參數

範例

確認可見度

相關文章

意見反應

其他資源