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

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

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

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

Prerequisites

有关详细信息，请参阅 客户端与 Azure DevOps Server 的兼容性。

局限性

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

使用列表和查询类型

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

• 使用平面列表 可以同时批量添加或修改多种类型的工作项，例如积压工作项、任务、bug 或问题。
• 使用树列表可批量添加或修改工作项及其树扑拓链接。

请遵循以下最佳实践：

查询类型

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 工作表中工作时，不支持以下任务：

将工作项导入为简单列表

使用以下过程将工作项导入为平面列表：

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

   Note

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

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

3. 将光标放在第一个表格单元格中。 在 “团队 ”功能区中，选择“ 新建列表”：

   

4. 在“ 新建列表 ”对话框中，选择“ 输入”列表，然后选择“ 确定” ：

   

   工作表现在作为输入列表（Query[None]）、平面列表绑定到项目：

   

5. 输入要添加的工作项的 标题 值，然后选择 “工作项类型 ”值：

   

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

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

   

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

   

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

   Tip

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

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

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

   

   Web 浏览器随即打开，显示工作项。

   如果对工作项进行更改，请立即刷新工作表以捕获更改。

将工作项导入为树列表

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

1. 从 上一过程中 的步骤开始，将工作表绑定到项目。

2. 将平面输入列表工作表转换为树列表。 在列表中选择一个单元格，然后在“团队”功能区中选择“添加树级别”

   

   如果 “添加树级别 ”选项不可用，则列表是 查询列表。 若要将列表转换为树列表，必须先将列表重新配置为输入列表。

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

   

   列表类型更改为“树”，此时会显示另一个“标题”列。 初始标题列标记为标题 1 ，新的标题列标记为 标题 2：

   

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

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

5. 保存 Excel 文件。

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

   

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

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

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

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

   

9. 若要将子级添加到新表行中的工作项，请选择工作项，然后在“团队”功能区中选择“添加子级”：

   

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

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

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

移除树级别

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

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

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

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

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

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

树列表的使用技巧

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

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

若要解决错误，请参阅 常见问题解答。

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

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

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

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

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

3. 更新工作项：

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

     1. 在“团队”功能区中选择“选择列”。

     2. 进行更新并发布更改。

   • 从 Excel：如果从 Excel 开始，则需要准备包含要更新的项的工作表：

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

     2. 将光标放在第一个表格单元格中。 在 “团队 ”功能区中，选择“ 新建列表”：

        

     3. 在“ 新建列表 ”对话框中，选择 “查询”列表，并使用下拉列表选择要使用的查询：

        

        每个查询旁边的图标指示查询类型，如 查询类型中所述。

        选择“确定”。

        工作表现在使用查询绑定到项目：

        

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

        如果使用树列表，请查看本文前面的 “导入工作项层次结构列表”中的指南。

启用树命令

如果“团队”功能区中不提供树命令（添加子级、缩进等），则工作表当前配置为平面列表或查询列表：

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

更改列表类型或查询

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

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

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

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

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

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

   

3. 在“ 配置列表属性 ”对话框中，仅选择“ 刷新工作项”，然后选择“ 应用：

   

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

可以使用此方法将输入列表转换为查询列表：

1. 在“ 配置列表属性 ”对话框中，选择“ 从查询刷新”。

2. 选择查询以填充工作表，然后选择 “应用：

   

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

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

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

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

   

2. 在 “获取工作项 ”对话框中，选择用于获取工作项的方法：

   

   如果工作项在另一个项目中定义，请先选择“项目”。 然后，选择：

   • 保存的查询：定义包含所需工作项集或超集的查询时，请使用此方法。

   • ID：当你知道要链接到的工作项的 ID 时，请使用此方法。

     • 在 ID 框中，输入要查找的工作项的 ID，用逗号或空格分隔。

   • 标题包含：使用此方法查找在“标题”字段中具有常用词或短语的工作项。 在和类型列表中，选择要检索的工作项的类型。

   Tip

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

3. 选择 “查找”。

   • 仅列出为所选项目定义的工作项和指定的工作项类型。
   • 复 选标记指示当前工作表视图中已存在的工作项。
   • 若要对列字段进行排序，请选择列标签。 还可以调整列宽以查看更多详细信息。

4. 在返回的工作项列表中，选中 要添加的每个工作项的复选框。

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

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

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

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

添加或删除列字段

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

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

1. 若要将值分配给其他字段，请选择 “列选项 ”以添加感兴趣的字段：

   

   • 若要根据工作项类型筛选字段，请选择工作项类型。

   • 若要向工作表集添加字段，请选择 “可用列 ”列表中的字段，然后选择 向右箭头。

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

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

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

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

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

3. 保存工作表。

选择用户帐户

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

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

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

   

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

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

   

   • 输入一个字母以跳到以该字母开头的名称。 仅识别用户名，而不是帐户别名。

   • 当你选择用户名时，Excel 会记住你最近的选择，这允许你直接从字段中选择用户帐户。

   

链接工作项

可以从“链接和附件”对话框的“链接”选项卡完成许多作：

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

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

查看和添加链接

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

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

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

2. 在 “链接和附件 ”对话框中，选择“ 链接 ”选项卡，然后选择“ 链接到”。

3. 在“添加到工作项<”>对话框中，标识要链接到的工作项：

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

   2. 选择要链接到的所有工作项的标识符（工作项 ID）。 有关详细信息，请参阅下一部分， 查找要链接的工作项。

   3. 选择“确定”。

   

4. 在“团队”功能区中选择“发布”，然后关闭对话框。

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

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

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

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

查找要链接的工作项

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

1. 在“添加工作<项>链接”对话框中，选择“浏览”（Visual Studio）：

   

2. 在“ 选择链接的工作项 ”对话框中，选择要链接到的工作项的方法：

   

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

向“链接”列表添加列

可以修改 链接 列表的可见列：

1. 在工作表中选择工作项，然后在“团队”功能区中选择“链接和附件”。

2. 在 “链接和附件 ”对话框中，选择“ 链接 ”选项卡，然后选择“ 列选项”。

3. 在 “列选项 ”对话框中，选择要显示的字段：

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

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

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

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

   

打开链接工作项

可以从 “链接和附件 ”对话框打开链接的工作项，

• 在“ 链接 ”选项卡中，右键单击链接的工作项，然后选择“ 打开链接的项目”

  

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

编辑链接并更改链接类型

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

1. 在“链接和附件”对话框中，选择要更新的链接，然后选择“编辑链接”。

2. 在 “编辑链接 ”对话框中，根据需要更改链接类型：

   

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

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

添加附件

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

1. 选择工作项，然后选择 “链接和附件”。

2. 在“工作项<的链接和附件>”对话框中，选择“附件”选项卡。

3. 选择“添加”，然后选择要附加的文件：

   

   选择“确定”。

4. 选择“ 发布”，然后关闭对话框。

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

创建报表

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

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

  

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

解决发布错误

以下文章提供了解决在 Excel 中工作时可能出现的发布错误的故障排除指南：

• 解决数据冲突：自上次从 Excel 发布以来，当 Azure Boards 中的字段值发生更改时，会发生数据冲突。

• 解决数据验证错误：当字段值违反该字段和工作项类型的规则时，会发生数据验证错误。

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

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

相关内容

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