Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020
查找有关在 Azure DevOps 中使用 Microsoft Excel 添加或修改工作项的常见问题的解答。
如果遇到连接问题，请确认满足 批量添加或修改 Excel 工作项的先决条件。 有关详细信息，请参阅 Azure Boards 和 Office 集成。
连接和版本控制支持
使用 Excel 添加或修改工作项需要什么？
从 “下载”页、“其他工具和框架”安装 Azure DevOps Office 集成加载项。 外接程序通常随 Visual Studio 或团队资源管理器一起安装。 使用 Microsoft Excel 2010 或更高版本，包括 Microsoft 365（Excel）。
Important
不支持 Microsoft Project 集成和 TFSFieldMapping 命令：
- Visual Studio 2019 与 Azure DevOps Office® Integration 2019
- Azure DevOps Server 2020 及更高版本，包括 Azure DevOps Services
请改用受支持的 Excel 集成。
安装加载项后，打开 Excel 并确认显示 “团队 ”功能区。
是否可以在 Mac 上使用 Excel？
否。 macOS 不受支持。 macOS 上的 Excel 无法通过 Office 加载项连接到 Azure DevOps。
我是否可以通过 Web 门户在 Excel 中打开查询？
是的。 在 Excel 市场扩展 中安装 Azure DevOps Open ，以便直接从 Web 门户打开查询。 或者，打开 Excel（使用 Excel 批量添加或修改工作项），然后打开在 Web 门户或团队资源管理器中创建的查询。
是否可以不使用 Excel 导入或更新工作项？
是的。 使用 Web 门户进行批量导入/更新（导入工作项）。
如何将现有 Excel 工作簿连接到 Azure DevOps？
有关分步说明，请参阅 将 Azure Boards 连接到 Office 客户端 。
如何共享包含工作项的 Excel 工作簿？
在共享之前断开工作簿与 Azure DevOps 的连接，以避免意外发布。 可以断开连接、共享或脱机工作，并稍后重新连接。 请参阅 将 Azure Boards 连接到 Office 客户端，断开文档文件与网络的连接。
在网络上使用特殊协议时，如何进行连接？
如果网络使用 TLS 1.1 或 TLS 1.2 限制，则可能会看到连接问题。 若要解决这些地址，请参阅 允许的地址列表和网络连接、要允许的域 URL。
如何禁用“团队”菜单？
若要禁用外接程序，请按照 Microsoft Office 指南作： 添加或删除加载项。
不支持的查询
Excel 不支持哪些查询宏？
以下宏仅在 Web 门户中工作：@CurrentIteration、@CurrentIteration +/- n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity、@TeamAreas。 在 Visual Studio/Team Explorer、Excel 或 Project 中打开时，包含这些宏的查询不起作用。
是否可以查看列出不同团队项目中的工作项的查询？
否。 Excel 仅显示工作簿连接到的团队项目中的工作项。 如果尝试打开跨项目查询，则会收到错误TF208015。 若要查看其他团队项目中的项目，请创建一个单独的查询并在其他工作簿中打开它;每个工作簿连接到单个团队项目。
使用链接的工作项
如何发布树列表？
为什么我的直接链接查询在 Excel 中显示为简单列表？
外接程序将直接链接查询转换为 Excel 中的平面列表。 您可以修改字段并添加工作项，但 Excel 不显示或允许您编辑直接链接查询的链接关系。
是否可以批量编辑除分层链接以外的链接类型？
否。 Excel 仅支持添加和修改分层（父子）链接。 若要批量编辑其他链接类型，请使用：
- Azure CLI：
az boards work-item relation add（/cli/azure/boards/work-item/relation）。
使用测试工作项
是否可以使用 Excel 批量添加或编辑测试用例？
否。 Excel 无法导出或导入测试用例步骤或其他测试项目。 使用 Web 门户网格视图批量编辑测试用例（使用网格视图编辑测试用例）。
发布并刷新
如何在 Excel 中显示更多字段？
使用 “新建列表 ”启动工作表以获取默认列，然后选择“团队”菜单上 的“选择列 ”以添加字段。 如果从现有查询开始，则会看到查询的列;可以通过 选择列添加更多列，但该作不会更改基础查询。
如何解决发布问题？
排查特定错误：
- 解决数据冲突： 解决数据冲突
- 解决数据验证错误： 解决数据验证错误
- 摘要值中的地址不准确： 为摘要值发布的地址不准确
如何解决树列表中的无效链接？
当 Excel 在发布过程中找到无效的链接时， “工作项发布错误 ”对话框将列出问题和行号。 在发布之前，树必须有效。 常见错误包括缺少标题或错误标题列中的错放标题。
若要更新工作项，请成为“参与者”组的成员，或者在此节点中具有“查看工作项”，并且此节点权限中的“编辑工作项”设置为“允许”。 请参阅更改项目级权限。
常见错误修复：
- TF208000：重复标题 - 删除重复项，因此只有一个标题列包含一个值，然后发布。
- TF208001：从父级断开连接的子级- 将标题移动到正确的列，然后发布。
- TF208017：第一行中缺少标题 1， 在标题 1 中添加或移动正确的标题，然后发布。
- TF208022：无法发布已排序的树列表 — 清除排序或刷新列表以还原层次结构;在发布之前重新建立父子关系。
- TF208102：Excel 对树列表进行排序 - 排序可以删除层次结构更改;发布字段更改，然后刷新以还原层次结构。
- TF208104：分层链接关系已锁定 - 锁定链接（例如，与 Project Server 同步）阻止更改层次结构;修改企业项目计划中的锁定链接或使用支持的工作流。
若要在解决问题后还原层次结构，
- 发布字段更改（团队选项卡 > 发布）。
- 选择“刷新”以还原树层次结构。
是否可以从 Excel 中删除工作项？
否。 无法从 Excel 中删除工作项。 从 Web 门户删除工作项或使用 Azure CLI： az boards work-item delete。 请参阅 移动、更改或删除工作项。
否。 无法从 Excel 中删除工作项。 从 Web 门户删除工作项，或在服务器版本上使用 witadmin 。 请参阅 “删除或删除工作项”。
使用内置 Excel 函数
是否可以在 Excel 中使用多个工作表？
是的。 每个工作表可以包含不同的输入列表或查询，但工作簿中的所有工作表必须连接到同一项目或集合。 若要处理其他项目，请打开一个新工作簿。
我能不能使用 Excel 剪切和粘贴功能？
是的。 Excel 支持剪切、粘贴、填充、格式、排序（仅限平面列表）、筛选器和公式。 可以剪切和粘贴行以重新引用项或更改列表中的链接关系。
若要拖动工作项，请选择一行或多行，打开上下文菜单，选择 “选择 > 表格行”，然后在指针变为移动指针 
时拖动。
Tip
刷新工作项列表可以将某些格式（例如日期格式）重置为服务器的设置。
如何启用“开发人员”选项卡？
请参阅在功能区上显示“开发人员”选项卡。
解决数据冲突和验证错误
如何在从 Excel 发布时解决数据验证错误？
请参阅 解决 Office 集成问题。
如何在发布或刷新 Excel 数据时解决数据冲突？
请参阅 解决 Office 集成问题。