Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

本文介绍如何在需要添加或修改多个工作项、向多个工作项添加链接和附件等时使用 Microsoft Excel 节省时间。 还可以使用本机 Excel 功能执行作,例如对列求和、复制和粘贴行或将数据填充到单元格中。

若要批量导入或更新工作项,请使用 Web 门户 CSV 导入 功能(建议)。

有关连接到 Excel 的信息,请参阅 将 Azure Boards 连接到 Office 客户端 。 有关 Excel 与 Azure DevOps 集成的特定问题的解答,请参阅 常见问题解答:使用连接到 Azure Boards 的 Excel

Prerequisites

- Microsoft Excel 2010 或更高版本,包括Microsoft Office Excel 365。
Azure DevOps Office Integration 2019 。 若要下载,请滚动到 “所有下载 ”,选择 “其他工具”、“框架”和“可再发行组件 ”,然后选择 Azure DevOps Office Integration 2019 旁边的 “下载 ”。 或者,可以通过安装 Visual Studio 最新版本之一来获取插件。 插件支持从 Excel 连接到 Azure Boards 和 Azure DevOps Server。
Visual Studio 2015.1 或更高版本 Team Foundation Server Office Integration 2015 Update 2 或更高版本
- 若要使用 “选择用户 ”功能,请下载 Visual Studio Community 的免费版本。 此功能有助于避免拼写错误的用户名导致的数据验证错误,在从大量用户帐户分配用户名时非常有用。 - Microsoft Excel 2010 或更高版本,包括Microsoft Office Excel 365。
Azure DevOps Office Integration 2019 。 若要下载,请滚动到 “所有下载 ”,选择 “其他工具”、“框架”和“可再发行组件 ”,然后选择 Azure DevOps Office Integration 2019 旁边的 “下载 ”。 或者,可以通过安装 Visual Studio 最新版本之一来获取插件。 插件支持从 Excel 连接到 Azure Boards 和 Azure DevOps Server。
- 若要使用 选择用户 功能,请安装 Visual Studio 2015.1 或更高版本 Azure DevOps Office Integration 2019 或更高版本 。 可以下载免费版本的 Visual Studio Community。 此功能有助于避免拼写错误的用户名导致的数据验证错误,在从大量用户帐户分配用户名时非常有用。 输入列表、树列表 :完成自上而下的计划和发布父子链接的工作项。 查询列表、简单列表 :基于工作项的查询创建 Excel 报表。 若要创建 Excel 报表,必须将项目集合配置为支持 Analytics 报告。 有关详细信息,请参阅 从工作项查询创建 Excel 报表 查询列表、树列表 :查看和修改许多现有工作项的层次结构和父子链接关系。

Excel 提供了以下查询类型:

:指示是 输入列表 查询标题 :指示工作项列表与指定的 查询 相关联。

Azure Boards 支持三种查询类型,由每个查询旁边的图标指示:

工作项简单列表 :作为简单列表查询导入。 工作项和直接链接 :作为简单列表查询导入。 工作项树 :作为树列表导入。

直接链接查询作为平面列表导入 Excel,因为 Excel 不支持修改多种类型的链接。

可以批量添加工作项的嵌套列表,例如工作明细或分层用户情景。 例如,可以添加任务、子任务和 bug 的嵌套列表,或将任务链接到产品积压工作项。

Excel 提供了以下列表类型:

简单列表 :显示一个 标题 列的工作项的简单列表。 不支持链接管理。 树列表 :支持在工作项之间创建和更新树拓扑链接(例如父子链接)的工作项的分层列表。 这些列表包括两个或更多个 标题 列。

若要导入分层列表,请参阅本文后面部分 将工作项的分层列表添加或导入为树列表

我的查询与共享的查询

可以在 Excel 中打开在 Azure Boards 中定义的任何查询,包括“我的查询”和“共享查询”下的查询。 但是,如果计划与其他团队成员共享工作簿,请使用共享查询。 其他团队成员无法基于存储在“我的查询”文件夹下的个人查询访问工作簿或工作表。

使用 Excel 功能

当你使用工作项列表时,可以使用大多数 Excel 功能。

  • 设置单元格格式或对单元格或列应用条件格式
  • 从一个单元格剪切并粘贴到其他单元格
  • 剪切并粘贴单行
  • 对列求和或添加其他公式
  • 向下填充单元格
  • Filter
  • 向工作簿添加多个工作表
  • Excel 中的每个工作表可以包含不同的输入列表或查询。 但是,工作簿中的所有工作表都必须连接到组织或项目集合中的同一项目。

    使用连接到 Azure Boards 的工作表时,以下功能的行为方式不同。

  • 每个单元格或单元格的列对应于一个工作项字段。 每个字段都与一个数据类型相关联。 不能将数据输入到不符合该字段的数据类型和要求的 Excel 单元格中。
  • 一次只能在工作表中插入一行。
  • 可以在工作表中复制和粘贴多行。
  • 若要在层次结构中移动工作项,请剪切整行,并将其粘贴到要作为其父级的工作项下。
  • 使用 减少缩进 缩进 更改工作项在树中的位置。
  • “撤消”( Ctrl + Z )作可能无法正常工作。 若要还原作,请刷新工作表。
  • 建议经常发布和刷新工作表,确保本地工作与 Azure Boards 数据存储保持同步。 有关 Excel 的详细信息,请参阅 基本 Excel 任务

    对工作项进行排序

    可以使用 Excel 排序功能 对工作项平面列表进行排序。 但是,如果要从树列表中工作,则不想执行任何类型的排序。 这样做会更改树结构,因此会更改工作项之间的链接。

    如果要使用 Excel 管理工作项在 团队积压工作中显示的 顺序,可以使用 Stack 排名 积压优先级 字段(敏捷或 Scrum 流程)。 可以在这些字段中设置值、发布工作表和刷新积压工作。 积压工作项应根据从低到高的数字重新排序。 但是,下次从积压工作重新排序时,你输入的值可能会发生改变。

    若要维护工作项的特定顺序,请考虑添加一个自定义字段来管理排序顺序。 然后,可以在 Excel 中使用此字段对工作项的简单列表进行排序。 此选项不会更改工作项在积压工作项中的显示顺序。

    完成 Excel 工作表中的任务

    在 Excel 工作表中工作时,可以使用以下任务:

  • 使用标记添加标记和批量更新工作项,如 “分类”中所述,使用工作项标记筛选列表和版块 。 将 标记 字段添加到工作表。 添加用分号分隔的多个标记( ; )。
  • 向富文本字段添加简单文本。 请记住,如果批量更新多个工作项,则可能丢失现有工作项的格式。
  • 脱机工作,然后重新连接并发布更改。 有关详细信息,请参阅 将 Azure Boards 连接到 Office 客户端、脱机工作和重新连接
  • 不支持的任务

    在 Excel 工作表中工作时,不支持以下任务:

  • 删除工作项
  • 更改现有工作项的工作项类型
  • 将工作项移动到另一个项目
  • 导入或更新测试用例步骤或其他测试项目
  • 在除新状态之外的任何其他状态下添加工作项
  • 添加到工作项讨论线程
  • 链接到远程工作项
  • 使用以下过程将工作项导入为平面列表:

  • 打开 Excel 并连接到 Azure Boards 项目。 使用 将 Azure DevOps 项目连接到 Excel 中提供的四种方法之一。

    连接到云中的 Azure Boards 时, 将自动选择团队项目集合 ,因为只有一个集合与 Azure DevOps Services 组织关联。 在本地服务器中连接到 Azure Boards 时,需要先选择 团队项目集合 ,然后再选择项目。

  • 在 Excel 中,首先创建一个空白工作表。 如果你没有看到 Team 功能区(如果你使用 Excel 2007,则没有看到 Team 菜单),请确保安装了 Azure DevOps Office Integration 2019 工具 。 有关详细信息,请参阅 Azure DevOps Office 集成问题

  • 将光标放在第一个表格单元格中。 在 “团队 ”功能区中,选择“ 新建列表 ”:

    当向团积压工作项中添加工作项时,请确保指定了团队的区域路径和迭代路径。 如果需要添加区域路径或迭代路径,请选择 编辑区域和迭代 。 此链接在 Web 浏览器中打开“项目设置”页面。 有关详细信息,请参阅 “定义区域路径”并分配给团队 并定义迭代路径并配置团队迭代

  • 可以通过从 Excel 在 Web 门户中打开项目,将详细信息添加到列表中的工作项。

    首先,将任何未保存的更改发布到列表。 选择工作项,然后在 “团队 ”功能区 中选择“在 Web 访问中打开 ” :

  • 若要向层次结构添加更多级别,请再次选择“ 添加树级别 ”。 例如,如果计划添加 Epics、Features 和 User Stories 的层次结构,则需要三个 标题 列。

    如果要添加任务,请添加另一个树级别以包含四个 标题 列。 若要删除列,请参阅 删除树级别

    保存 Excel 文件。

  • 输入要导入的层次结构的 工作项类型 标题 。 选择工作项类型后 ,“状态” 字段会自动填充默认值。

  • 将光标置于具有数据的任何表单元格中。 在 “团队 ”功能区中,选择“ 发布 ”。

    工作表成功发布后,表中的工作项将分配 ID 号。

    在后台,所选的链接类型用于链接层次结构中的每个工作项。 长篇故事链接到功能。 功能链接到用户情景。

  • 若要检查链接,请选择工作项,然后在 “团队” 功能区中选择 “链接和附件 ”。 以下示例显示了为导入的功能创建的子链接和父链接:

  • 若要将值分配给其他字段,请选择 “团队 ”功能区中的“ 选择列 ”。 添加字段、进行作业和发布更改。

  • 若要修改树层次结构,请剪切工作项的整个行,然后将该行粘贴到树中的新父级下。 发布更改时,会删除旧的分层链接,并创建新的分层链接。

    可以在 树作中使用树中的缩进项 Outdent 项 来降级或提升树层次结构中的工作项。 这些作可用于标记为 “标题 <编号> ”的任何列中的内容。 如果要处理没有 标题 <编号> 标签的列中的数据,请为该列添加树级别。

    移除树级别

    若要删除树层次结构中的级别,请执行以下步骤:

  • 在尝试删除树级别之前,发布对工作项所做的任何更改。

    移除树级别需要刷新,这会覆盖工作项列表中的数据。 任何未发布的数据都将丢失。

  • 删除要删除的树级 标题 <编号> 列下的任何内容。 此列应该是树中编号最高的 标题 列。

    刷新 工作表。 包含“标题”空值的列将被移除。

    如果尝试手动删除列,将收到错误消息。

    树列表的使用技巧

    Excel 会使用 标题 列中的数据以确定工作项之间的链接模式。 发布更改时,以下条件可能会导致错误、无效链接或创建错误工作项之间的树链接:

  • 层次结构中工作项之间的一行是空白的。
  • 工作项的标题位于错误的列中。 请确保为每个子工作项输入标题。
  • 在一行内有多个 标题 列包含数据。 每行只输入一个 标题 <编号> 列中的文本。
  • 列表已排序。 避免对树列表进行排序,因为它会更改分层链接关系。 如果对树列表进行排序,请立即刷新来恢复原始列表。
  • 若要解决错误,请参阅 常见问题解答 - 解决树列表中的无效链接

    此外,父子链接的工作项只能有一个父级。 你无法将同一工作项任务添加到两个积压工作 (backlog) 项。 而是定义不同的工作项任务。

    使用查询列表批量更新工作项

    批量更新多个工作项的最简单方法是使用要更新的工作项创建查询,然后在 Excel 中打开该查询。

    使用以下提示使工作保持同步

  • 首次 打开保存的工作表以从数据存储下载最新数据时使用 “刷新 ”。
  • 使用 “选择列” 函数向工作表添加列,以输入更多字段的数据。
  • 请经常发布你的添加项和修改项,以避免数据冲突。
  • 请在发布或刷新之前,定期保存你的工作簿,以防止数据丢失。
  • 在 Web 门户或 Visual Studio 中创建包含要更新的工作项的查询。 有关详细信息,请参阅 使用查询编辑器创建和保存托管查询

  • 打开 Excel 并连接到 Azure Boards 项目。 使用 将 Azure DevOps 项目连接到 Excel 中提供的四种方法之一。

  • 更新工作项:

    Web 门户或 Visual Studio:如果在 Web 门户 或 Visual Studio 中打开了查询,则可以进行更新。

  • “团队 ”功能区中选择 “选择列 ”。

  • 进行更新并发布更改。

    若要启用 命令,请将列表转换为基于树查询的输入列表或列表。 有关详细信息,请参阅下一部分, 更改列表类型或查询

    更改列表类型或查询

    通过应用其他列表类型或更改连接的查询来修改工作表中列出的工作项:

  • 将平面列表更改为树列表
  • 从查询列表更改为输入列表
  • 从输入列表更改为查询列表
  • 更改工作表引用的查询
  • 如果要将查询、平面列表更改为树列表,必须先重新配置输入。 当 “团队 ”功能区中不提供树命令( 添加子级 缩进 等)时,工作表将 配置为平面列表或查询列表。

    若要将查询列表转换为输入列表,请执行以下步骤:

  • 选择 “发布 ”以确保保存工作表中的所有更改。

  • “团队 ”功能区上,选择“ 配置 > 列表 ” :

  • 选择应链接到当前工作项的每个工作项,包括任何子节点。

  • 使用 Shift + Select 键盘快捷方式选择一系列工作项, Ctrl + Select 可从所选组中添加或删除工作项。

  • 使用 “全选” 选择列表中的所有工作项。

  • 选择 “确定” 。 工作表列表会更新以显示更改。

    添加或删除列字段

    “团队” 功能区中使用 “新建列表 ”作创建工作表时,该过程将生成一组默认字段列,例如 工作项类型 ID 状态 。 如果从现有查询创建工作表,则工作表中的列字段对应于查询中定义的字段。

    在这两种情况下,都可以使用 “团队 ”功能区中的 “选择列 ”作添加和修改列。 请记住,如果工作表是从查询创建的,则列更改不会修改基础查询。

  • 若要将值分配给其他字段,请选择 “列选项 ”以添加感兴趣的字段:

  • 若要从工作表集中删除字段,请选择 “所选列 ”列表中的字段,然后选择 向左箭头。

  • 若要更改字段在列序列中的位置,请选择该字段,然后使用 向上箭头和 向下箭头重新定位字段。 向上箭头将所选列向左移动表格列标题集。 向下箭头在表格列标题集中向右移动列。

  • 可以添加格式文本字段,例如 “说明 ”。 请记住,已发布的工作表中可能会丢失一些格式。

    选择 “确定 ”以应用列更改。

  • 在工作表中显示字段后,分配值并发布更新。 使用接受用户帐户的标识字段时,请按照下一部分的“ 选择用户帐户” 中的指南进行作。

    保存 工作表。

    选择用户帐户

    使用 “选择用户 ”功能查找用户帐户并将值分配给人员命名字段。 此功能还提供对最近使用的 (MRU) 值的访问权限。 如果团队拥有数百或数千个用户帐户,则此功能特别有用。

    如果没有 “选择用户 ”功能,则需要在数据库中输入用户名;否则,在尝试发布时会收到数据验证错误。

  • 若要使用 “选择用户 ”功能,请确认已安装 Visual Studio 2015.1 或更高版本。 如果需要配置的最新版本, 请下载并安装版本

  • 打开工作表,然后选择一个标识或人员命名字段。 选择使 “选择用户” 功能在 “团队 ”功能区中可用:

    标识或以人名命名的字段包含用户标识。 这些字段通常与用户帐户数据库同步,例如Microsoft Entra ID、Windows Server Active Directory 或工作组。

  • “分配用户 ”对话框中,输入用户帐户的名称。 键入时,文本框会自动筛选结果,直到可以选择感兴趣的帐户。

    有关链接工作项的详细信息,请参阅 链接用户情景、问题、bug 和其他工作项

    链接和附件 ”对话框不支持对工作项链接进行批量更新。 如果要批量更新树拓扑链接类型,请使用树列表。

    以下过程演示如何将工作项链接到其他工作项:

  • 选择要在工作表中更新的工作项,然后选择 “团队 ”功能区中的 “链接和附件 ”。

  • “链接和附件 ”对话框中,选择“ 链接 ”选项卡,然后选择“ 链接到 ”。

  • 在“ 添加到工作项<”> 对话框中,标识要链接到的工作项:

  • 选择要链接到的工作项 的链接类型 。 此过程需要你标识的所有工作项的相同链接类型。

  • 选择要链接到的所有工作项的标识符( 工作项 ID )。 有关详细信息,请参阅下一部分, 查找要链接的工作项

  • 选择 “确定”

    可以使用同一进程将标识的工作项链接到工作表中的多个工作项。

  • 使用 Shift + Select 键盘快捷方式在工作表中选择一系列工作项。 使用 Ctrl + Select 添加或删除所选组中的工作项。

  • 按照 “链接和附件 ”和“将链接添加到<工作项> ”对话框的过程确定要链接到的工作项。

    发布 更改时,标识的工作项将链接到工作表中选择的所有工作项。

    在“ 添加到工作项”<对话框中,可以打开“选择链接的工作项> ”对话框,选择要链接到的一个或多个工作项。 如果计划使用保存的查询查找和列出工作项,请先 定义查询

  • 在“ 添加工作<项>链接 ”对话框中,选择“ 浏览 ”(Visual Studio):

  • 若要添加字段,请在 “可用列 ”列表中选择一个或多个字段,然后选择“ 添加所选列 ”箭头。

  • 若要删除字段,请在 “所选列 ”列表中选择一个或多个字段,然后选择“ 删除所选列 ”箭头。

    可以像“ 获取工作项 ”对话框 一样配置此对话框上的字段。 有关详细信息,请参阅 向工作表添加现有工作项

  • 若要对 “链接和附件 ”对话框中的链接列表重新排序,请选择一列以对该字段上的列表进行排序:

  • 若要更改链接的工作项,请输入工作项的 ID,或选择“ 浏览 ”以查找工作项。

    使用此对话框中的字段的方式与 “获取工作项 ”对话框 相同。 有关详细信息,请参阅 向工作表添加现有工作项

    按照以下步骤将附件添加到工作项:

  • 选择工作项,然后选择 “链接和附件 ”。

  • “工作项<的链接和附件> ”对话框中,选择“ 附件 ”选项卡。

  • 选择 “添加” ,然后选择要附加的文件:

    可以使用同一进程同时向多个工作项添加相同的附件。 在工作表中,使用 Shift + Select 键盘快捷方式选择一系列工作项, Ctrl + Select 可从所选组中添加或删除工作项。 选择附件后, 发布 过程会将文件应用于所有选定的工作项。

    可以从 Web 门户为平面列表查询创建报表或图表。 有关详细信息,请参阅 通过创建基于状态和趋势查询的图表来跟踪进度

    Important

    只能使用本地 Azure DevOps Server 中的 “新建报表 ”选项创建 Excel 报表。 这些报表要求将项目的集合配置为支持 SQL Server Analytics Server。

  • 若要创建报表,请选择“ 新建报表

    解决树层次结构中的无效链接 :当层次结构或树列表中的工作项被移动或排序时,将发生无效链接,这会导致工作项之间的依赖关系中断。 若要解决此错误,请查看错误消息并重新定位工作项以还原正确的结构。

    地址错误TF208104:分层链接关系已锁定 :如果收到错误TF208104,则会发布对字段所做的更改,但不会发布对链接层次结构的更改。 发生此错误是因为另一个进程锁定了工作项的至少一个链接关系,例如 Project Server 集成。

    集成 Azure Boards 和 GitHub
  • 使用 CSV 文件批量导入或更新工作项 查看和添加工作项