使用 Microsoft Excel 批量添加或修改工作项

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

提示

若要批量导入或更新工作项，可以使用 Web 门户或 CSV 导入功能，这是建议的方法。

在需要添加或修改多个工作项、将链接和附件添加到多个工作项等时，使用 Microsoft Excel 可节省时间。 也可以使用本机 Excel 功能来支持其他操作，例如对列求和、复制和粘贴行、将数据填充到单元格中等等。

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

注意

macOS 不受支持。 即使已安装 Visual Studio for Mac，也不支持从 Excel 连接到 Azure DevOps。

先决条件

必备项	说明
Microsoft Excel 2010 或更高版本	包括 Microsoft Office Excel 365。
Azure DevOps Office Integration 2019（免费）	获取 Azure DevOps Office Integration 插件的唯一方式是，安装最新版本的 Visual Studio 或 Azure DevOps Office Integration 安装程序。 插件支持从 Excel 连接到 Azure Boards 和 Azure DevOps Server。
项目的成员	如果还没有 Azure Boards 项目，请现在创建一个。
权限设置为“允许”：“查看此节点的工作项”和“编辑此节点的工作项”	默认情况下，参与者组设置了此权限。 有关详细信息，请参阅为工作跟踪设置权限和访问权限。
利益干系人访问权限或更高	有关详细信息，请参阅利益干系人访问快速参考。
Visual Studio（至少 VS 2015.1 或更高版本）或 Team Foundation Server Office 集成 2015 更新 2 或更高版本	若要使用“选择用户”功能，可以下载 Visual Studio Community 的免费版本。 获取此功能可避免因用户名拼写错误以及必须从数量较多的用户帐户分配用户名时出现的数据验证错误。

有关兼容性要求的详细信息，请参阅与 Azure DevOps Server 的兼容性。

使用列表和查询类型

可以使用任何查询类型和列表类型添加、修改、发布和刷新工作项。

使用简单列表可一次性批量添加或修改多种类型的工作项，如积压工作项、任务、bug 或问题。

使用树列表可批量添加或修改工作项及其树扑拓链接。 执行以下最佳做法：

• 使用输入列表、简单列表：导入工作项列表或创建新工作项，无层次结构
• 使用输入列表、树列表：完成自上而下的计划和导入分层链接的工作项
• 使用查询列表、树列表：查看和修改许多现有工作项的链接关系的层次结构。
• 使用查询列表、简单列表：批量更新工作项列表或创建新工作项，无层次结构

查询类型

查询类型：

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

Azure Boards 支持三种查询类型。 每个查询旁边的图标指示查询类型。 前两种查询类型（工作项的简单列表和工作项和直接链接）是作为简单列表查询导入的。

只有工作项树查询作为树列表导入。 直接链接查询以简单列表的形式导入到 Excel，因为 Excel 中不支持修改多种类型的链接。

树列表

可以批量添加工作项的嵌套列表，例如工作分解结构或一组分层的用户情景和客户体验。 例如，可以将任务、子任务和 bug 的嵌套列表（如下图所示）或链接任务添加到产品积压工作项。

列表类型：

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

父子链接或其他树拓扑链接类型支持创建分层积压工作结构。 参与层次结构的工作项类型因流程而异，如下图所示。

层次结构

敏捷流程

下图显示了“敏捷”流程积压工作项的层次结构：

• 用户情景和任务用于跟踪工作。

• 错误跟踪代码缺陷。

• 长篇故事和功能用于在较大的方案中对工作进行分组。

  

每个团队都可以通过配置使用错误 设置来配置他们管理“错误”工作项（与“用户情景”或“任务”工作项级别相同）的方式。 有关使用这些工作项类型的详细信息，请参阅敏捷流程。

基本流程

下图显示了基本流程积压工作项的层次结构：

• 问题和任务用于跟踪工作。
• 长篇故事用于在较大的方案中对工作进行分组。

基本流程适用于 Azure DevOps Server 2019 更新 1 及更高版本。

有关使用这些工作项类型的详细信息，请参阅规划和跟踪工作。

Scrum 流程

下图显示了 Scrum 流程积压工作项d 层次结构：

• 产品积压工作项和任务用于跟踪工作。

• 错误跟踪代码缺陷。

• 长篇故事和功能用于在较大的方案中对工作进行分组。

  

每个团队都可以通过配置使用错误设置来配置他们管理错误（与“产品积压工作项”或“任务”级别相同）的方式。 有关使用这些工作项类型的详细信息，请参阅 Scrum 流程。

CMMI 流程

下图显示了 CMMI 流程积压工作项的层次结构：

• 要求和任务用于跟踪工作。

• 错误跟踪代码缺陷。

• 长篇故事和功能用于在较大的方案中对工作进行分组。

  

每个团队都可以通过配置使用错误设置来配置他们管理错误（与要求或任务级别相同）的方式。 有关使用这些工作项类型的详细信息，请参阅 CMMI 流程。

若要导入分层列表，请参阅本文后面的添加或导入工作项的分层列表。

我的查询与共享的查询

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

使用 Excel 功能

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

功能：

• 设置单元格格式或对单元格或列应用条件格式
• 从一个单元格剪切并粘贴到其他单元格
• 剪切并粘贴单行
• 对列求和或添加其他公式
• 向下填充单元格
• 筛选器
• 向工作簿添加多个工作表

Excel 中的每个工作表可以包含不同的输入列表或查询。 但是，工作簿中的所有工作表都必须连接到组织或项目集合中的同一项目。

使用已连接到 Azure Boards 的工作表时，以下功能的工作方式略有不同。

• 每个单元格或单元格的列对应于一个工作项字段。 每个字段都与一个数据类型相关联。 不能将数据输入到不符合该字段的数据类型和要求的 Excel 单元格中。
• 一次只能在工作表中插入一行。
• 可以在工作表中复制和粘贴多行。
• 若要在层次结构中移动工作项，请剪切整行，并将其粘贴到要作为其父级的工作项下。
• 使用减少缩进和缩进更改工作项在树中的位置。
• 撤消 (Ctrl Z) 可能不起作用。 如果执行要还原的操作，可以刷新工作表。

建议经常发布和刷新工作表，确保本地工作与 Azure Boards 数据存储保持同步。 有关 Excel 的详细信息，请参阅基本 Excel 任务。

对工作项进行排序

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

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

如果要保持工作项的特定顺序，可以考虑添加自定义字段来管理排序顺序，然后在 Excel 中使用该字段对工作项的简单列表进行排序。 但是，此选项不会更改积压工作中显示的顺序。

可以/无法使用 Excel 执行的任务

下面是可以以及不能从 Excel 工作表执行的任务：

可以执行的操作：

• 添加标记并使用标记批量更新工作项，如添加工作项标记以对列表和面板进行分类和筛选中所述。 将标记字段添加到工作表。 添加多个以分号 (;) 分隔的标记。
• 将简单文本添加到格式文本字段，但如果要批量更新多个工作项，可能会在现有工作项中丢失格式设置。
• 脱机工作，然后重新连接并发布更改。 有关详细信息，请参阅将 Azure Boards 连接到 Office 客户端、脱机工作和重新连接。

不能执行的操作：

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

将工作项导入为简单列表

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

   注意

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

2. 在 Excel 中，首先创建一个空白工作表。 如果没有看到团队功能区（在 Excel 2007 中是团队菜单），请参阅 Azure DevOps Office 集成问题。

3. 从“团队”功能区中选择新建列表。

   

4. 在新建列表对话框中，选择输入列表。

   

5. 工作表现在作为输入列表 (Query[None])、简单列表绑定到项目。

   

6. 指定要添加的工作项的标题和类型。

   

   选择工作项类型后，“状态”和“原因”字段会自动填充默认值。

7. 发布工作表。

   

   请确保光标停留在包含数据的单元格中。 否则，发布按钮可能显示为“已禁用”。

   工作项现在具有 ID 号。

   

8. 若要向其他字段分配值，请打开选择列，添加字段，分配值，然后发布更改。

   提示

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

9. 若要打开工作项以添加详细信息，请选择要打开的工作项，然后选择在 Web 访问中打开。 在执行此操作之前，请确保发布所做的任何更改。

   

   Web 浏览器随即打开，显示工作项。 如果对工作项进行更改，请立即刷新工作表以捕获更改。

将工作项导入为树列表

可以使用父子链接或其他树拓扑链接类型添加链接的工作项的层次结构。

重要

请不要对树列表进行排序。 对树列表进行排序可能更改分层链接关系。

1. 从上一过程的步骤 5 开始，将简单列表、输入列表转换为树列表。 在简单列表中选择一个单元格，然后选择“添加树级别”。

   

   如果禁用了添加树级别，表示你正在从查询列表中操作。 若要将列表转换为树列表，必须先将列表重新配置为输入列表。

2. 选择向层次结构添加工作项时要使用的链接类型，然后选择“转换”。 最常见的选择是父子。 只能从树拓扑链接类型中进行选择。 有关详细信息，请参阅链接类型拓扑和限制。

   

   列表类型已更改为“树”，并显示第二个“标题”列。

   

3. 若要向层次结构添加更多级别，请再次选择“添加树级别”。 例如，如果要添加长篇故事、功能和用户情景的层次结构，需要具有“标题 1”、“标题 2”和“标题 3”列。

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

4. 保存 Excel 文件。

5. 输入要导入的层次结构的工作项类型和标题。 当你选择工作项类型后，状态字段将自动填充默认值。

   

6. 发布工作表。

   

   请确保光标停留在包含数据的单元格中。 否则，发布按钮可能显示为“已禁用”。

   ID 现在已分配给你的工作项。 在后台，所选的链接类型用于链接层次结构中的每个工作项。 长篇故事链接到功能，功能链接到用户情景。

7. 若要检查已创建的链接，请选择一个工作项，然后选择链接和附件。

   例如，此处我们显示了为导入的功能创建的子级和父级链接。

   

8. 若要在要添加子集的工作项下输入行，请选择该行，然后选择添加子项。

   

9. 若要向其他字段分配值，请打开选择列，添加字段，分配值，然后发布更改。

10. 若要更改层次结构，请剪切并粘贴工作项的行，将其置于新父级下。 请确保选择整个表行。 当你发布更改时，会删除旧的分层链接，并创建新的分层链接。

    可以使用 或 缩进/减少缩进图标来降级或提升树层次结构中的工作项。 该列顶部的标题应显示为标题 n，如果不是，请添加一个树级别。

移除树级别

1. 首先，在移除树级别之前发布已对工作项进行的更改。 移除树级别需要刷新，这会覆盖工作项列表中的数据。 你会丢失尚未发布的任何数据。

2. 接下来，删除在要移除的树级标题编号列（编号最大的列）下的任何内容。 此列应为树中编号最高的列。

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

   如果尝试删除列，则将收到错误消息。

树列表的使用技巧

• Excel 会解释标题列中的数据以确定工作项之间的链接模式。 发布更改时，以下任何情况都会导致错误、无效链接或在不正确的工作项之间创建树链接：
  • 层次结构中工作项之间的一行是空白的
  • 工作项的标题位于错误的列中。 请确保为每个子工作项输入标题。
  • 在一行内有多个标题列包含数据。 请仅在每行中的一个标题列中输入文本。
  • 列表已排序。 请不要对树列表进行排序。 对树列表进行排序可能更改分层链接关系。 如果你确实对树列表进行了排序，则可通过立即刷新来从此操作恢复。
• 若要纠正错误，请参阅解决无效链接。
• 父子链接的工作项只能有一个父级。 你无法将同一工作项任务添加到两个积压工作 (backlog) 项。 相反，你需要定义不同的工作项任务。

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

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

提示

请遵循以下提示，使你的工作保持同步：

• 首次打开已保存的工作表时，请使用 （刷新）从数据存储下载最新数据。
• 使用选择列将列添加到工作表中，从而将数据输入到附加字段。
• 为了避免数据冲突，请经常发布你的添加项和修改项。
• 为了防止数据丢失，请在发布或刷新之前，定期保存你的工作簿。

1. 在 Web 门户或 Visual Studio 中，创建包含要更新的工作项的工作项查询。 有关详细信息，请参阅使用查询编辑器创建和保存托管查询。

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

3. 如果已从 Web 门户或 Visual Studio 打开了查询，则已完成。 进行任何需要的更改。 打开选择列，添加字段，进行分配，然后发布更改。

4. 如果从 Excel 开始，请打开一个空白的工作表。 只要从工作簿绑定到的同一项目中选择查询，就可以将工作表添加到现有的工作簿中。

5. 从“团队”功能区中选择新建列表。

   

6. 在新建列表对话框中，选择查询列表，然后从下拉菜单中选择所需的查询。

   

   每个查询旁边的图标指示查询类型。 前两种查询类型（工作项的简单列表和工作项和直接链接）是作为简单列表查询导入的。 只有工作项树查询作为树列表导入。

   

7. 将工作项导入到 Excel 后，进行所需的修改并发布更改。

   如果使用的是树列表，另请参阅导入工作项的分层列表中提供的信息。

启用树命令

如果树组命令不可用，说明你的工作表已配置为简单列表、查询列表。 将列表转换为输入列表或基于树查询的列表，可以启用树组命令。 有关详细信息，请参阅更改列表类型或查询的下一部分。

更改列表类型或查询

可以更改工作表中列出的工作项。 具体而言，你可以：

• 将简单列表更改为树列表
• 从查询列表更改为输入列表
• 从输入列表更改为查询列表
• 更改工作表引用的查询

如果要将简单列表更改为树列表，可以这样做。 但是，如果列表是查询列表，则首先需要重新配置列表。 如果禁用树组命令，则它是简单列表、查询列表。

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

1. 发布所做的任何更改。

2. 在“团队”功能区上，选择“配置”、“列表”。

   

3. 选择仅刷新工作项，然后选择应用。

   此选项将查询列表更改为输入列表。

   

4. 若要从输入列表转换为查询列表，请选择从查询刷新，选择查询，然后选择应用。

   

将现有的工作项添加到工作表

如果正在处理查询，请修改查询以包含所需的工作项。 然后刷新列表。 其他工作项将显示在列表中。

如果使用的是输入列表，请完成以下步骤。

1. 在团队功能区中，选择获取工作项。

   

2. 从三个可用选项中选择所需的方法。

   

   如果工作项是在另一个项目中定义的，首先选择“项目”。 然后，进行选择：

   • 查询。 如果已定义包含所需工作项集或超集的查询，请使用此方法。
   • ID。 如果知道要链接到的工作项的 ID，请使用此方法。 在 ID 框中，键入要查找的工作项的 ID，用逗号或空格分隔。
   • 标题包含。 使用此方法可查找标题字段中具有通用单词或短语的工作项。 在和类型列表中，选择要检索的工作项的类型。

   注意

   若要最大程度地减少运行查询所需的时间，请缩小搜索的筛选条件范围。

3. 选择 “查找”。

   仅列出为所选项目定义的工作项和指定的工作项类型。 若要对列字段进行排序，请选择列标题。

4. 在返回的工作项列表中，选择一个或多个工作项的复选框。

   • 选择应链接到当前工作项的每个工作项。 还可以在单击的同时按 SHIFT 键以选择一系列工作项，或在单击的同时按 CTRL 键以选择多个工作项。
   • 选择全选可以选择列表中的所有工作项。

添加或删除列字段

如果使用新建列表启动工作表，则只会看到一组默认字段列。 可以使用“团队”功能区上的选择列添加列。

如果从现有查询启动工作表，则会看到为查询定义的所有列字段。 在那里，可以使用选择列添加列。 但是，添加内容不会修改基础查询。

1. 若要为其他字段分配值，请选择列选项以添加相关联的字段。

   

   • 若要根据工作项类型筛选字段，请选择工作项类型。
   • 若要移动或删除字段，请选择该字段，然后选择 > 或 < 图标。
   • 若要更改字段顺序，请使用向上和向下箭头在列表中向上或向下移动字段。
   • 可以添加格式文本字段（如“说明”字段），但在发布时可能会丢失部分格式。

2. 字段显示在工作表中后，分配值并发布更新。 使用标识字段（接受用户帐户的标识字段）时，请参阅下一部分内容，选择用户帐户。

3. 保存工作表。

选择用户帐户

可以使用“选择用户”功能查找用户帐户，并将值分配给以用户命名的字段。 此外，此功能还提供对最近使用的 (MRU) 值的访问权限。 如果团队包含数百个或数千个用户帐户，请使用此功能。

提示

如果没有选择用户功能，必须完全按照数据库中的用户名来输入用户名，否则在尝试发布时将收到数据验证错误。

1. 如果尚未安装或更新到最新版本的 Visual Studio（至少 VS 2015.1 或更高版本），请立即执行此操作。 需要有最新更新才能访问“选择用户”功能。

2. 选择一个标识或以用户命名的字段来激活“团队”功能区中的选择用户功能。

   

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

3. 开始输入用户帐户的名称，“分配用户”对话框将自动筛选结果，直到可以选择所需的帐户。

   

   输入一个字母，在开头部分以制表符显示以该字母开头的名称。 仅输入用户名，因为无法识别帐户别名。 当你选择用户名时，Excel 会记住你最近的选择，你可以直接从字段中选择用户帐户。

   

链接工作项

可以从链接和附件对话框的链接选项卡完成许多操作。 具体而言，你可以：

• 查看为所选的工作项定义的现有链接
• 将指向所选工作项的链接添加到一个或多个工作项或选定的对象
• 删除链接
• 打开链接的工作项（在 Web 门户中打开）
• 编辑现有链接的链接类型
• 将列添加到“链接”列表，并按该列表排序

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

查看和添加链接

不能使用“链接和附件”对话框批量更新工作项链接。 只能使用树列表批量更新树拓扑链接类型。

1. 若要将工作项链接到其他工作项，请选择该工作项，然后选择链接和附件。 在“链接”选项卡中，选择链接到，然后选择链接类型和要链接到的工作项。 选择确定，然后选择发布。

   

2. 完成后，选择“关闭”关闭对话框。

3. 若要将多个工作项链接到同一个工作项，请对连续的行按住 Ctrl 并单击，或对非连续行按住 Shift 并单击进行多选。

查找要链接到的工作项

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

在“添加链接”对话框中，选择浏览按钮 (Visual Studio)，打开以下对话框。

选择链接的工作项对话框的工作方式与获取工作项对话框相同。 有关详细信息，请参阅本文前面所述的将现有的工作项添加到工作表。

向链接列表添加列

1. 在链接选项卡中，选择 列图标，然后添加要显示的字段。 在这里，我们添加了“分配到”和“状态”字段。

   

2. 若要对链接重新排序，请选择字段以对该字段上的列表进行排序。

   

此对话框的工作方式与获取工作项对话框相同。 请参阅本文前面所述的将现有的工作项添加到工作表。

打开链接工作项

在链接选项卡中，选择链接的工作项，右键单击以打开上下文菜单，然后选择打开链接的项。

工作项将在 Web 门户中打开。

编辑链接并更改链接类型

可以编辑列出的任何链接。 可以更改链接类型和链接到的工作项。

1. 选择链接，然后选择 编辑 图标。

2. 根据需要更改链接类型。

   

3. 若要更改链接到的工作项，请输入工作项的 ID，或选择浏览找到链接到的工作项。

   选择链接的工作项对话框的工作方式与获取工作项对话框相同。 有关详细信息，请参阅本文前面所述的将现有的工作项添加到工作表。

添加附件

1. 打开工作项，然后选择链接和附件>附件。

   选择要附加的文件，然后选择确定>发布。

   

   完成后，选择“关闭”关闭对话框。

2. 可选：若要将相同的附件添加到多个工作项，请对连续的行按住 Ctrl 并单击，或对非连续行按住 Shift 并单击进行多选。

创建报表

可以从 Web 门户为简单列表查询创建报表或图表。 请参阅通过创建基于状态和趋势查询的图表来跟踪进度。

重要

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

选择“新建报表”。

有关详细信息，请参阅从工作项查询创建 Excel 报表。

解决发布错误

若要解决在 Excel 中工作时可能出现的发布错误，请参阅以下文章之一：

• 解决数据冲突：自上次从 Excel 发布以来，当 Azure Boards 中的字段值发生更改时，会发生数据冲突。
• 解决数据验证错误：如果字段值违反该字段和工作项类型的规则，则会发生数据验证错误。
• 解决树层次结构中的无效链接：如果团队成员以层次结构或树列表的形式在 Excel 中查看工作项，并且移动了某个工作项或对列表进行排序，从而破坏了工作项之间的依赖关系，则会出现无效链接。 通过查看错误消息和重新定位工作项来反映工作项结构，可解决此错误。
• 解决错误 TF208104：分层链接关系已锁定：
  如果收到错误 TF208104，说明已发布对字段所做的更改。 但不会发布对链接层次结构的更改。 至少有一个为工作项定义的链接关系被另一个进程锁定，例如 Project Server 集成。

后续步骤

集成 Azure Boards 和 GitHub

相关文章

• 批量修改工作项（Web 门户）
• 使用 CSV 文件批量导入或更新工作项
• Azure DevOps Office 集成问题
• 常见问题解答：使用连接到 Azure Boards 的 Excel
• 查看和添加工作项
• 基本 Excel 任务