使用 Microsoft Excel 批量添加或修改工作项
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
当您需要添加或修改多个工作项、向多个工作项添加链接和附件等时，请使用 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（免费） | 通过安装最新版本的 Visual Studio 或 Azure DevOps Office 集成安装程序之一来安装 Azure DevOps Office 集成插件。 插件支持从 Excel 连接到 Azure Boards 和 Azure DevOps Server。 |
| 项目的成员 | 如果还没有 Azure Boards 项目，请现在创建一个。 |
| 权限设置为“允许”：“查看此节点的工作项”和“编辑此节点的工作项” | 默认情况下，参与者组设置了此权限。 有关详细信息，请参阅为工作跟踪设置权限和访问权限。 |
| 利益干系人访问权限或更高 | 有关详细信息，请参阅利益干系人访问快速参考。 |
| 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（免费） | 通过安装最新版本的 Visual Studio 或 Azure DevOps 独立 Office 集成安装程序之一来安装插件。 Azure DevOps Office Integration 2019 插件支持从 Excel、Project 和基于 PowerPoint 的情节提要工具连接到 Azure Boards 和 Azure DevOps。 |
| 项目的成员 | 若要连接到 Azure Boards 项目，必须是项目的成员。 如果还没有 Azure Boards 项目，请现在创建一个。 |
| 权限设置为“允许”：“查看此节点的工作项”和“编辑此节点的工作项” | 默认情况下，参与者组设置了此权限。 有关详细信息，请参阅为工作跟踪设置权限和访问权限。 |
| 利益干系人访问权限或更高 | 有关详细信息，请参阅利益干系人访问快速参考。 |
| Visual Studio 2015.1 或更高版本 或 Azure DevOps Office Integration 2019 或更高版本 | 若要使用 “选择用户 ”功能，请安装 Visual Studio 2015.1 或更高版本 或 Azure DevOps Office Integration 2019 或更高版本。 可以下载免费版本的 Visual Studio Community。 此功能通过拼写错误用户名来帮助避免数据验证错误，在从大量用户帐户分配用户名时非常有用。 |
有关详细信息，请参阅 与 Azure DevOps Server 的兼容性。
使用列表和查询类型
可以使用任何查询类型和列表类型添加、修改、发布和刷新工作项。
请遵循以下最佳实践：
- 输入列表、平面列表：导入工作项列表或创建新工作项而不使用层次结构。
- 输入列表、树列表：完成自上而下规划和导入分层链接的工作项。
- 查询列表、树列表：查看和修改许多现有工作项的链接关系的层次结构。
- 查询列表、平面列表：批量更新工作项列表或创建新工作项而不使用层次结构。
- 输入列表、平面列表：导入工作项列表或创建新工作项而不使用层次结构。
- 输入列表、树列表：完成自上而下规划并发布父子链接工作项。
- 查询列表，平面列表：基于工作项的查询创建 Excel 报表。 若要创建 Excel 报表，必须将项目集合配置为支持 Analytics 报告。 有关详细信息，请参阅从工作项查询创建 Excel 报表。
- 查询列表、树列表：查看和修改许多现有工作项的层次结构和父子链接关系。
查询类型
查询类型：
- 无：指示 输入列表。
- 查询标题：指示工作项列表与指定的查询相关联。
Azure Boards 支持三种查询类型，由每个查询旁边的图标指示：
- 工作项的平面列表：作为平面列表查询导入。
- 工作项和直接链接：作为平面列表查询导入。
- 工作项树：作为树列表导入。
直接链接查询作为平面列表导入到 Excel 中，因为 Excel 不支持修改多种类型的链接。
树列表
可以批量添加工作项的嵌套列表，例如工作分解结构或一组分层用户情景和客户体验。 例如，可以添加任务、子任务和 bug 的嵌套列表，或将任务链接到产品积压工作项。
列表类型：
- 平面列表：具有单个 “标题 ”列的工作项的简单列表。 不支持链接管理。
- 树列表：支持在工作项之间创建和更新树拓扑链接（如父子链接）的工作项的分层列表。 这些列表包括两个或更多个标题列。
父子链接或其他树拓扑链接类型支持创建分层积压工作结构。 参与层次结构的工作项类型因流程而异，如下图所示。
层次结构
下图显示了“敏捷”流程积压工作项的层次结构：
- 用户情景和任务用于跟踪工作。
- 错误跟踪代码缺陷。
- 长篇故事和功能用于在较大的方案中对工作进行分组。
每个团队都可以在与用户故事或任务工作项相同的级别上配置如何管理 Bug 工作项。 使用“处理 bug”设置。 有关使用这些工作项类型的详细信息，请参阅敏捷流程。
若要导入分层列表，请参阅本文后面的添加或导入工作项的分层列表。
我的查询与共享的查询
可以打开在 Excel 中的 Azure Boards 中定义的任何查询，包括“我的查询”和“共享查询”下的查询。 但是，如果计划与其他团队成员共享工作簿，请使用共享查询。 其他团队成员无法基于存储在“我的查询”文件夹下的个人查询访问工作簿或工作表。
使用 Excel 功能
处理工作项列表时，可以使用大多数 Excel 功能。
功能：
- 设置单元格格式或对单元格或列应用条件格式
- 从一个单元格剪切并粘贴到其他单元格
- 剪切并粘贴单行
- 对列求和或添加其他公式
- 向下填充单元格
- 筛选器
- 向工作簿添加多个工作表
Excel 中的每个工作表可以包含不同的输入列表或查询。 但是，工作簿中的所有工作表都必须连接到组织或项目集合中的同一项目。
使用连接到 Azure Boards 的工作表时，以下功能的行为不同。
- 每个单元格或单元格的列对应于一个工作项字段。 每个字段都与一个数据类型相关联。 不能将数据输入到不符合该字段的数据类型和要求的 Excel 单元格中。
- 一次只能在工作表中插入一行。
- 可以在工作表中复制和粘贴多行。
- 若要在层次结构中移动工作项，请剪切整行，并将其粘贴到要作为其父级的工作项下。
- 使用减少缩进和缩进更改工作项在树中的位置。
- 撤消 (Ctrl Z) 可能不起作用。 如果执行要还原的操作，可以刷新工作表。
建议经常发布和刷新工作表，确保本地工作与 Azure Boards 数据存储保持同步。 有关 Excel 的详细信息，请参阅基本 Excel 任务。
对工作项进行排序
可以使用 Excel 排序功能对工作项简单列表进行排序。 但是，如果要从树列表中工作，则不想执行任何类型的排序。 这样做会更改树结构，因此会更改工作项之间的链接。
如果要使用 Excel 管理工作项在团队积压工作中出现的顺序，可以使用堆栈级别或积压工作优先级字段（敏捷流程或 Scrum 流程）。 可以在这些字段中设置值、发布工作表和刷新积压工作。 积压工作项应根据从低到高的数字重新排序。 但是，下次从积压工作重新排序时，你输入的值可能会发生改变。
若要维护工作项的特定顺序，请考虑添加自定义字段来管理排序顺序。 然后，可以在 Excel 中使用此字段对工作项的平面列表进行排序。 此选项不会更改工作项在积压工作项中的显示顺序。
可以/无法使用 Excel 执行的任务
下面是可以以及不能从 Excel 工作表执行的任务：
可以执行的操作：
- 添加标记并使用标记批量更新工作项，如添加工作项标记以对列表和面板进行分类和筛选中所述。 将标记字段添加到工作表。 添加多个以分号 (;) 分隔的标记。
- 将简单文本添加到格式文本字段，但如果要批量更新多个工作项，可能会在现有工作项中丢失格式设置。
- 脱机工作，然后重新连接并发布更改。 有关详细信息，请参阅将 Azure Boards 连接到 Office 客户端、脱机工作和重新连接。
不能执行的操作：
- 删除工作项
- 更改现有工作项的工作项类型
- 将工作项移动到另一个项目
- 导入或更新测试用例步骤或其他测试项目
- 在除新状态之外的任何其他状态下添加工作项
- 添加到工作项讨论线程
- 链接到远程工作项。
- 删除工作项
- 更改现有工作项的工作项类型
- 将工作项移动到另一个项目
- 导入或更新测试用例步骤或其他测试项目
- 在除新状态之外的任何其他状态下添加工作项
- 添加到工作项讨论线程。
- 删除工作项
- 导入或更新测试用例步骤或其他测试项目
- 在除新状态之外的任何其他状态下添加工作项
- 添加到工作项讨论线程
将工作项导入为简单列表
打开 Excel 并连接到 Azure Boards 项目。 使用将 Azure DevOps 项目连接到 Excel 中提供的四种方法之一。
注意
在云中连接到 Azure Boards 时，将自动选择团队项目集合，因为只有一个集合与 Azure DevOps Services 组织相关联。 在本地服务器中连接到 Azure Boards 时，需要先选择团队项目集合，然后再选择项目。
在 Excel 中，首先创建一个空白工作表。 如果没有看到团队功能区（在 Excel 2007 中是团队菜单），请参阅 Azure DevOps Office 集成问题。
从“团队”功能区中选择新建列表。
在新建列表对话框中，选择输入列表。
工作表现在作为输入列表 (Query[None])、简单列表绑定到项目。
指定要添加的工作项的标题和类型。
选择工作项类型后，“状态”和“原因”字段会自动填充默认值。
发布工作表。
请确保光标停留在包含数据的单元格中。 否则，发布按钮可能显示为“已禁用”。
工作项现在具有 ID 号。
若要向其他字段分配值，请打开选择列，添加字段，分配值，然后发布更改。
提示
将工作项添加到团队积压工作项时，请确保指定团队的区域路径和迭代路径。 如果需要添加区域路径或迭代路径，请选择“ 编辑区域”和“迭代”。 此链接将在 Web 浏览器中打开“项目设置” 页。 有关详细信息，请参阅定义区域路径并分配给团队和定义迭代路径并配置团队迭代。
若要打开工作项以添加详细信息，请选择要打开的工作项，然后选择在 Web 访问中打开。 在完成之前，请确保发布所做的任何更改。
Web 浏览器随即打开，显示工作项。 如果对工作项进行更改，请立即刷新工作表以捕获更改。
将工作项导入为树列表
可以使用父子链接或其他树拓扑链接类型添加链接的工作项的层次结构。
重要
避免对树列表进行排序，因为它可以更改分层链接关系。
从上一过程的步骤 5 开始，将简单列表、输入列表转换为树列表。 在简单列表中选择一个单元格，然后选择“添加树级别”。
如果禁用了添加树级别，表示你正在从查询列表中操作。 若要将列表转换为树列表，必须先将列表重新配置为输入列表。
选择向层次结构添加工作项时要使用的链接类型，然后选择“转换”。 最常见的选择是父子。 只能从树拓扑链接类型中进行选择。 有关详细信息，请参阅链接类型拓扑和限制。
列表类型已更改为“树”，并显示第二个“标题”列。
若要向层次结构添加更多级别，请再次选择“添加树级别”。 例如，如果要添加长篇故事、功能和用户情景的层次结构，需要具有“标题 1”、“标题 2”和“标题 3”列。
如果要添加任务，请添加另一个树级别以包含四个标题列。 若要删除列，请参阅删除树级别。
保存 Excel 文件。
输入要导入的层次结构的工作项类型和标题。 当你选择工作项类型后，状态字段将自动填充默认值。
发布工作表。
请确保光标停留在包含数据的单元格中。 否则，发布按钮可能显示为“已禁用”。
ID 现在已分配给你的工作项。 在后台，所选的链接类型用于链接层次结构中的每个工作项。 史诗链接到功能。 功能链接到用户情景。
若要检查已创建的链接，请选择一个工作项，然后选择链接和附件。
例如，此处我们显示了为导入的功能创建的子级和父级链接。
若要在要添加子集的工作项下输入行，请选择该行，然后选择添加子项。
若要向其他字段分配值，请打开选择列，添加字段，分配值，然后发布更改。
若要更改层次结构，请剪切并粘贴工作项的整行，将其放置在新父级下。 发布更改时，会删除旧的分层链接，并创建新的分层链接。
可以使用 
或 
缩进/减少缩进图标来降级或提升树层次结构中的工作项。 确保列顶部的标题读取 Title n;否则，请添加树级别。
移除树级别
首先，在删除树级别之前发布对工作项所做的更改。 移除树级别需要刷新，这会覆盖工作项列表中的数据。 你丢失了未发布的任何数据。
接下来，删除要删除的树级标题编号列下的任何内容（编号最高的列）。 此列应为树中编号最高的列。
刷新工作表。 包含“标题”空值的列将被移除。
如果尝试删除列，则将收到错误消息。
树列表的使用技巧
Excel 使用标题列中的数据来确定工作项之间的链接模式。 发布更改时，以下任一条件都可能导致错误、无效链接或创建错误工作项之间的树链接：
- 工作项之间的行在层次结构中为空。
- 工作项的标题位于错误的列中。 确保为每个子工作项输入标题。
- 多个 标题 列包含行中的数据。 每行只输入一个标题列中的文本。
- 列表已排序。 避免对树列表进行排序，因为它可以更改分层链接关系。 如果对树列表进行排序，请立即刷新来恢复。
若要纠正错误，请参阅解决无效链接。
此外，父子链接工作项只能有一个父项。 你无法将同一工作项任务添加到两个积压工作 (backlog) 项。 而是定义不同的工作项任务。
使用查询列表批量更新工作项
批量更新多个工作项的最简单方法是为要更新的工作项创建查询，然后在 Excel 中打开该查询。
提示
使用以下提示使工作保持同步：
- 首次打开保存的工作表以从数据存储下载最新数据时，请使用
（刷新）。 - 使用
（选择列）向工作表添加列，以输入其他字段的数据。 - 经常发布添加和修改以避免数据冲突。
- 定期保存工作簿以防止在发布或刷新之前丢失数据。
在 Web 门户或 Visual Studio 中，创建包含要更新的工作项的工作项查询。 有关详细信息，请参阅使用查询编辑器创建和保存托管查询。
打开 Excel 并连接到 Azure Boards 项目。 使用将 Azure DevOps 项目连接到 Excel 中提供的四种方法之一。
如果已从 Web 门户或 Visual Studio 打开了查询，则已完成。 进行任何需要的更改。 打开选择列，添加字段，进行分配，然后发布更改。
如果从 Excel 开始，请打开一个空白的工作表。 只要从工作簿绑定到的同一项目中选择查询，就可以将工作表添加到现有的工作簿中。
从“团队”功能区中选择新建列表。
在新建列表对话框中，选择查询列表，然后从下拉菜单中选择所需的查询。
每个查询旁边的图标指示查询类型。 前两种查询类型（工作项的简单列表和工作项和直接链接）是作为简单列表查询导入的。 只有工作项树查询作为树列表导入。
将工作项导入到 Excel 后，进行所需的修改并发布更改。
如果使用的是树列表，另请参阅导入工作项的分层列表中提供的信息。
启用树命令
如果树组命令不可用，则工作表配置为平面列表或查询列表。 若要启用树组命令，请根据树查询将列表转换为输入列表或列表。 有关详细信息，请参阅更改列表类型或查询的下一部分。
更改列表类型或查询
可以更改工作表中列出的工作项。 具体而言，你可以：
- 将简单列表更改为树列表
- 从查询列表更改为输入列表
- 从输入列表更改为查询列表
- 更改工作表引用的查询
可以将平面列表更改为树列表。 但是，如果列表是查询列表，则需要先重新配置它。 如果树组命令已禁用，则表示平面或查询列表。
若要将查询列表转换为输入列表，请执行以下步骤。
发布变更。
在“团队”功能区上，选择“配置”、“列表”。
选择仅刷新工作项，然后选择应用。
此选项将查询列表更改为输入列表。
若要从输入列表转换为查询列表，请选择从查询刷新，选择查询，然后选择应用。
将现有的工作项添加到工作表
如果正在处理查询，请修改查询以包含所需的工作项。 然后刷新列表。 其他工作项将显示在列表中。
如果使用的是输入列表，请完成以下步骤。
在团队功能区中，选择获取工作项。
从三个可用选项中选择所需的方法。
如果工作项是在另一个项目中定义的，首先选择“项目”。 然后，进行选择：
- 查询。 定义包含所需工作项集或超集的查询时，请使用此方法。
- ID。 如果知道要链接到的工作项的 ID，请使用此方法。 在 ID 框中，键入要查找的工作项的 ID，用逗号或空格分隔。
- 标题包含。 使用此方法可查找标题字段中具有通用单词或短语的工作项。 在和类型列表中，选择要检索的工作项的类型。
注意
若要最大程度地减少运行查询所需的时间，请缩小搜索的筛选条件范围。
选择 “查找”。
仅列出为所选项目定义的工作项和指定的工作项类型。 若要对列字段进行排序，请选择列标题。
在返回的工作项列表中，选择一个或多个工作项的复选框。
- 选择应链接到当前工作项的每个工作项。 还可以在选择某个工作项时按 Shift 键，或者在选择多个工作项时按 Ctrl 键。
- 选择全选可以选择列表中的所有工作项。
添加或删除列字段
如果使用新建列表启动工作表，则只会看到一组默认字段列。 可以使用“团队”功能区上的选择列添加列。
如果从现有查询启动工作表，则会看到为查询定义的所有列字段。 在那里，可以使用选择列添加列。 但是，添加内容不会修改基础查询。
若要为其他字段分配值，请选择列选项以添加相关联的字段。
- 若要根据工作项类型筛选字段，请选择工作项类型。
- 若要移动或删除字段，请选择该字段，然后选择 > 或 < 图标。
- 若要更改字段顺序，请使用向上和向下箭头在列表中向上或向下移动字段。
- 可以添加格式文本字段（如“说明”字段），但在发布时可能会丢失部分格式。
字段显示在工作表中后，分配值并发布更新。 使用标识字段（接受用户帐户的标识字段）时，请参阅下一部分内容，选择用户帐户。
保存工作表。
选择用户帐户
使用“选择用户”功能查找用户帐户并将值分配给人员命名字段。 此功能还提供对最近使用的 （MRU） 值的访问权限。 如果团队拥有数百或数千个用户帐户，此功能特别有用。
提示
如果没有“选择用户”功能，则必须在数据库中准确输入用户名，否则在尝试发布时会收到数据验证错误。
如果没有最新版本的 Visual Studio（2015.1 或更高版本，请立即获取它）。 需要有最新更新才能访问“选择用户”功能。
选择一个标识或以用户命名的字段来激活“团队”功能区中的选择用户功能。
标识或人员命名字段包含用户标识。 这些字段通常与用户帐户数据库同步，例如Microsoft Entra ID、Active Directory 或工作组。
开始输入用户帐户的名称，“分配用户”对话框将自动筛选结果，直到可以选择所需的帐户。
输入一个字母以跳转到以该字母开头的名称。 仅识别用户名;帐户别名不是。 选择用户名时，Excel 会记住最近所做的选择，从而可以直接从字段中选择用户帐户。
链接工作项
可以从链接和附件对话框的链接选项卡完成许多操作。 具体而言，你可以：
- 查看为所选的工作项定义的现有链接
- 将指向所选工作项的链接添加到一个或多个工作项或选定的对象
- 删除链接
- 打开链接的工作项（在 Web 门户中打开）
- 编辑现有链接的链接类型
- 将列添加到“链接”列表，并按该列表排序
有关链接工作项的详细信息，请参阅链接用户情景、问题、bug 和其他工作项。
查看和添加链接
不能使用“链接和附件”对话框批量更新工作项链接。 若要批量更新树拓扑链接类型，请改用树列表。
若要将工作项链接到其他工作项，请选择该工作项，然后选择链接和附件。 从“链接”选项卡中，选择 “链接到” ，然后选择 要链接到的链接类型和 工作项。 选择确定，然后选择发布。
完成后，选择“关闭”关闭对话框。
若要将多个工作项链接到同一工作项，请对连续行使用 Ctrl-select 进行多选，或为非连续行选择 Shift-select。
查找要链接的工作项
在“添加链接”对话框中，可以打开辅助对话以选择要链接到的一个或多个工作项。 如果计划使用保存的查询查找和列出工作项，请先 定义查询。
在“添加链接”对话框中，选择“浏览”（Visual Studio）以打开以下对话框。
选择链接的工作项对话框的工作方式与获取工作项对话框相同。 有关详细信息，请参阅本文前面所述的将现有的工作项添加到工作表。
向链接列表添加列
在链接选项卡中，选择
列图标，然后添加要显示的字段。 在这里，我们添加了“分配到”和“状态”字段。
若要对链接重新排序，请选择字段以对该字段上的列表进行排序。
此对话框的工作方式与获取工作项对话框相同。 请参阅本文前面所述的将现有的工作项添加到工作表。
打开链接工作项
从“链接”选项卡中，选择链接的工作项，右键单击以打开上下文菜单，然后选择“打开链接项”。
工作项将在 Web 门户中打开。
编辑链接并更改链接类型
可以编辑任何列出的链接，包括更改链接类型和链接的工作项。
选择链接，然后选择
编辑 图标。根据需要更改链接类型。
若要更改链接到的工作项，请输入工作项的 ID，或选择“浏览”以查找要链接到的工作项。
选择链接的工作项对话框的工作方式与获取工作项对话框相同。 有关详细信息，请参阅本文前面所述的将现有的工作项添加到工作表。
添加附件
打开工作项，然后选择链接和附件>附件。
选择要附加的文件，然后选择确定>发布。
完成后，选择关闭。
可选：若要向多个工作项添加一个或多个相同的附件，请使用 Ctrl-select 作为连续行，或 为非连续行选择 Shift-select 。
创建报表
可以从 Web 门户为简单列表查询创建报表或图表。 请参阅通过创建基于状态和趋势查询的图表来跟踪进度。
重要
只能从本地 Azure DevOps Server 使用 新报表创建 Excel 报表 。 这些报表要求将项目的集合配置为支持 SQL Server Analytics Server。
选择“新建报表”。
有关详细信息，请参阅从工作项查询创建 Excel 报表。
解决发布错误
若要解决在 Excel 中工作时可能出现的发布错误，请参阅以下文章之一：
- 解决数据冲突：自上次从 Excel 发布以来，当 Azure Boards 中的字段值发生更改时，会发生数据冲突。
- 解决数据验证错误：如果字段值违反该字段和工作项类型的规则，则会发生数据验证错误。
- 解决树层次结构中的无效链接：当工作组成员将 Excel 中的工作项视为层次结构或树列表时，将发生无效链接，然后以中断工作项之间的依赖关系的方式移动或排序工作项。 若要解决此错误，请查看错误消息并重新定位工作项以还原正确的结构。
- 解决错误 TF208104：分层链接关系已锁定：
如果收到错误TF208104，则发布对字段所做的更改，但链接层次结构的更改不会。 发生此错误是因为另一个进程（如 Project Server 集成）锁定了工作项的至少一个链接关系。