将工作项从一个团队移到另一个团队

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

简介

添加团队或重新组织现有团队时，可能需要通过更新其区域路径将工作项从一个团队转移到另一个团队。 Azure DevOps 中的每个工作项都分配给区域路径，该路径确定团队所有权并影响工作项在积压工作和板上的显示方式。

“要求”类别下分类的工作项根据团队的区域路径分配显示在团队积压工作上。 同样，将其他工作项分配给团队的区域路径支持基于团队所有权的查询和报告。

先决条件

• 项目访问权限： 是 项目成员。

• 权限：

  • 若要查看、关注和编辑工作项，请在此节点中查看工作项，并在此节点权限中编辑工作项设置为“允许”。 默认情况下，参与者组具有这些权限。 有关详细信息，请参阅设置工作跟踪权限。

• 若要将标记添加到工作项，请将项目级 “创建新标记定义 ”权限设置为“ 允许”。 默认情况下，参与者组拥有此权限。

• 访问级别：

  • 若要向工作项添加新标记或查看或关注拉取请求，请至少具有基本访问权限。
  • 若要查看或关注工作项，至少 具有利益干系人 访问权限。 有关详细信息，请参阅关于访问级别。
  • 所有项目成员（包括 读者 组中的项目成员）都可以发送电子邮件，其中包含工作项。

  注意

  • 为希望参与讨论和评审进度的成员提供 利益干系人访问权限 。 这些成员通常不参与代码，但想要查看工作项、积压工作、面板和仪表板。
  • 利益干系人 无法添加新标记，即使权限是显式设置的，但由于其访问级别。 有关详细信息，请参阅利益干系人访问快速参考。

• 区域路径权限：有权查看和编辑区域路径节点下的工作项。 有关详细信息，请参阅“ 修改区域或迭代路径”下的工作项。
• 配置的区域路径：确保目标团队已正确配置其区域路径。 否则，在传输工作项之前设置所需的区域路径。
• 一致的进程模型：Teams 应使用兼容的进程模型（继承的、托管的 XML 或本地 XML）来确保工作项的无缝移动。
• 备份工作项：建议在执行批量移动之前备份或导出工作项，以防止发生错误时数据丢失。
• 工具：若要使用 Azure CLI 命令，请安装 Azure CLI，如 Azure DevOps CLI 入门中所述。

在团队下移动工作项

若要在团队下移动工作项，请执行以下步骤：

1. 为要重新分配的所有工作项创建查询。

2. 多选这些属于每个团队的项，然后批量编辑区域路径。

   

3. 批量修改后，批量保存。

   

使用 Azure CLI 移动工作项

可以通过更新其区域路径，使用 az boards 工作项更新 移动单个工作项。

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

参数

• id：必需。 要更新的工作项的 ID。
• area：可选。 区域的绝对路径。 示例：--path \ProjectName\Area\AreaName。
• assigned-to：可选。 人员的姓名，工作项分配给了 Jamal。
• description：可选。 工作项的说明。
• discussion：可选。 要添加到工作项中的讨论的注释。
• fields：可选。 要设置的自定义字段的空格分隔“字段=值”对。
• iteration：可选。 迭代的绝对路径。 示例：\ProjectName\Iteration\IterationName。
• open：可选。 在默认 Web 浏览器中打开工作项。
• reason：可选。 工作项状态的原因。
• state：可选。 工作项的状态，例如：“活动”。
• title：可选。 工作项的标题。

示例

使用 Azure DevOps CLI 一次只能移动一个工作项。 在此示例中，我们移动 Fabrikam Fiber\Production Planning 区域路径下的工作项 ID=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

验证团队积压工作

将工作项从一个团队移到另一个团队后，检查团队积压工作以确保显示这些项。 有关详细信息，请参阅创建积压工作 (backlog)。

如果遇到任何问题，请查看设置项目的积压工作和面板。

相关文章

• 创建或添加团队
• 了解团队和敏捷工具