將工作專案從一個小組移至另一個小組
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. </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
確認小組待辦專案
將工作專案從一個小組移至另一個小組之後,請檢查小組待辦專案以確保項目出現。 如需詳細資訊,請參閱 建立待辦專案。
如果您遇到任何問題,請檢閱 設定專案的待辦專案和面板。