将 Azure Boards 连接到 Office 客户端

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

若要支持工作跟踪的相关工作，可以使用 Microsoft Excel。 可以在联机模式下工作，在这种模式下可连接到 Azure Boards 或 Azure DevOps Server。 或者，也可以在脱机模式下工作，在这种模式下可访问本地计算机和文档。

提示

若要批量导入或更新工作项，请使用 Web 门户或 CSV 导入。

支持的 Office 客户端和 Azure DevOps 版本

下表指示了每个 Azure DevOps 版本支持的 Office 客户端。 不支持 MacOS。 即使已安装 Visual Studio for Mac，也不支持从 Excel 或任何其他 Office 客户端连接到 Azure DevOps。

---

Azure DevOps/Visual Studio 版本

Excel

Project¹

PowerPoint 情节提要²

---

Azure DevOps Services
Azure DevOps Server 2020
Azure DevOps Server 2019 Visual Studio 2022
Visual Studio 2019
Azure DevOps Office Integration 2019

✔

TFS 2018
Visual Studio 2017

✔

✔

✔

注意

1. Azure DevOps Server 2019 及更高版本不再支持 Project 集成和 TFSFieldMapping 命令。 可以使用市场扩展之一获得支持。
2. 从 Visual Studio 2019 和 Azure DevOps Office Integration 2019 开始，不再支持从 PowerPoint 中将 PowerPoint 文件链接到工作项。 仍然可以从工作项内使用情节提要链接来链接到 PowerPoint。 此外，还弃用了适用于 PowerPoint Storyboarding 的 Visual Studio 库。

先决条件

从 Office 客户端连接到 Azure Boards 项目需要以下软件和权限。

• 要将 Excel 连接到 Azure Boards，请安装 Office Excel 2010 或更高版本，包括 Office Excel 365。
• 所有 Office 集成任务都要求已安装某一版本的 Visual Studio 或免费的 Azure DevOps Office Integration 2019。
• 获取 Azure DevOps Office Integration 插件的唯一方式是，安装最新版本的 Visual Studio 或 Azure DevOps Office Integration。 该插件支持从 Excel 连接到 Azure DevOps。
• 若要连接到 Azure Boards 项目，你需要是该项目的成员。 如果还没有 Azure Boards 项目，可以创建一个项目。

• Microsoft Excel 2010 或更高版本，包括 Microsoft Office Excel 365
• Visual Studio 2013 或更高版本或 Team Foundation Server Standalone Office Integration（免费）
• 在 Azure Boards 中连接到项目的权限。

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

重要

如果在安装了早期版本的 Office 的计算机上安装 Microsoft Office 2010，可能会收到以下错误。

Team Foundation 错误、接口未注册（异常来自 HRESULT: 0x80040155）

修复 Office 后，也许能够解决此错误。 可通过打开“控制面板”，选择“卸载或更改程序”，打开 Office 2010 的上下文菜单，然后选择“更改”来访问“修复”选项。 有关详细信息，请参阅 Azure DevOps-Office 集成问题。

发布和刷新工作项

从 Excel 添加或更新工作项时，会创建工作项的本地副本。 为了使数据保持同步，请务必在打开本地文件时刷新该文件，并在长时间联机会话期间频繁地发布和刷新。

起初，本地文档中的数据与数据库中的数据是一致的。 但是，你或其他团队成员可能会更改工作项相关的数据，使这两个位置的数据变得不同。 若要查看数据库中的最近更改，请刷新文档。 刷新会将数据存储中的最新值下载到本地文档。 若要将更改从文档写入数据库，请发布更改。 发布可将所做的更改上载到用于跟踪数据存储的工作项。

为了使本地数据存储和 Azure Boards 中的工作项保持同步，需要经常执行发布和刷新。

Azure DevOps 和 Excel

若要使用 Excel 进行工作，请参阅使用 Excel 批量添加工作项。

将 Azure DevOps 项目连接到 Excel

要使用 Excel 添加或修改工作项，请将工作表连接到项目。 建立此连接会将文档绑定到 Azure DevOps 项目以交换信息。

注意

• 虽然本节内容说明了如何将 Excel 连接到 Azure Boards 项目，但连接到 PowerPoint 的步骤是类似的。
• 在云中连接到 Azure Boards 时，将自动选择“团队项目集合”，因为只有一个集合与 Azure DevOps Services 组织相关联。 在本地服务器中连接到 Azure Boards 时，需要先选择“团队项目集合”，然后再选择项目。

可以从 Web 门户、Excel 或 Visual Studio/团队资源管理器开始工作。 工作表与工作项列表或工作项查询相关联。

在 Excel 中打开查询（Web 门户）

此连接方法要求已安装 Azure DevOps 在 Excel 中打开。 它还需要 Visual Studio 2017 或更高版本。

1. 从 Web 浏览器中，(1) 检查是否选择了正确的项目，(2) 选择板>查询，然后 (3) 选择全部。

   

2. 选择要在 Excel 中打开的查询。

3. 在结果选项卡中，选择 操作图标。

   

从客户端连接到 Azure Boards

若要从 Office 客户端连接到 Azure DevOps Services 项目，请执行以下步骤。

1. 首先创建一个空白工作表。

2. 如果客户端已登录到用户帐户，请确保它是 Azure DevOps 用户帐户。 如果没有登录，请选择帐户名称，然后以其他用户身份登录。

   

3. 如果没有看到团队功能区（在 Office 2007 中是团队菜单），请参阅 Azure DevOps Office 集成问题。

4. 选择团队，将光标放入 Cell A1，然后选择新建列表。

   

5. 此时会打开“连接到 Azure DevOps Server”对话框。

   

   如果是使用 Azure DevOps 用户帐户登录到 Office 客户端，你有权访问的云和本地的一组服务器会自动填充到下拉菜单中。

   如果尚未登录、使用的是较旧版本的 Office 客户端，或者以前未连接到任何服务器，请立即添加它们。

6. 添加要连接到的服务器。

   (1) 选择服务器...，(2) 选择添加...，(3) 输入 Azure Boards 组织的 URL，(4) 检查预览是否与输入的 URL 匹配。 然后选择确定。

   

   如果无法连接，请添加为团队成员。

7. 选择服务器后，选择要连接到的项目，然后选择连接。

   

   确保 Azure DevOps 用户帐户显示在对话框的底部。 如果没有显示，请选择切换用户并登录到正确的帐户。

8. 在“新建列表”对话框中，选择输入列表。 或者，如果要处理查询中定义的工作项列表，请选择查询列表。

   

将客户端连接到本地 Azure DevOps

若要从 Office 客户端连接到 Azure DevOps Server 项目，请执行以下步骤。

1. 首先创建一个空白工作表。

2. 如果客户端已登录到用户帐户，请确保它为你所有。 如果没有登录，请选择帐户名称，然后以其他用户身份登录。

   

3. 如果没有看到团队功能区（在 Office 2007 中是团队菜单），请参阅 Azure DevOps-Office 集成问题。

4. 选择团队选项卡，将光标置于单元格 A1 中，然后选择新建列表。

   

   此时会打开“连接到 Azure DevOps Server”对话框。

   

   如果是使用 Azure DevOps 用户帐户登录到 Office 客户端，你有权访问的云和本地的一组服务器会自动填充到下拉菜单中。

   如果尚未登录、使用的是较旧版本的 Office 客户端，或者以前未连接到任何服务器，请立即添加它们。

5. 添加要连接到的服务器。

   (1) 选择“服务器...”，(2) 选择“添加...”，(3) 输入 Azure DevOps Server 实例的名称。 如果部署使用的是非默认端口号，请根据需要更改端口号。 预览条目应显示部署的正确 URL。 (4) 选择确定。

   

   选择关闭以关闭“添加/删除服务器”对话框。 在“选择 Azure DevOps Server”对话框中，确保已选择你添加的服务器，然后选择连接。

   如果无法连接，请添加为团队成员。

6. 选择服务器后，选择要连接到的项目，然后选择连接。

   

   确保 Azure DevOps 用户帐户显示在对话框的底部。 如果没有显示，请选择切换用户并登录到正确的帐户。

7. 在“新建列表”对话框中，选择输入列表。 或者，如果要处理查询中定义的工作项列表，请选择查询列表。

   

从 Visual Studio 打开 Excel

1. 打开 Visual Studio，然后打开团队资源管理器。

   重要

   要在 Visual Studio/Team Explorer 中操作，请选择工具>选项>工作项>常规>旧版体验。 有关详细信息，请参阅在 Visual Studio 中设置工作项体验。

   

2. 连接到包含要添加或更新的工作项的 Azure DevOps 项目。 有关详细信息，请参阅连接到项目。

3. 右键单击要打开的查询并进行选择。

   

   Excel 随即打开，其中包含所选查询中列出的工作项。

有关详细信息，请参阅使用 Excel 批量添加工作项。

提示

可以使用 Excel 工作簿中的多个工作表来处理不同的输入或查询列表。 但是，每个工作簿只能连接到一个项目。

脱机工作并重新连接到 Azure Boards

在 Excel 中工作的一个优点是可以脱机工作并添加或修改工作项。 以下过程演示了如何断开 Excel 工作项列表与 Azure Boards 的连接。 然后，可以稍后重新连接，将文档与工作项数据库同步。

注意

如果包含 Excel 文档的工作项的项目移动到其他组织或 Azure DevOps Server 实例，必须重新配置文档连接到的服务器。 有关详细信息，请参阅本文前面提供的将 Azure DevOps 项目连接到 Excel。

断开文档文件与网络的连接

若要断开 Excel 文档文件与网络的连接，请执行以下操作：

1. 在脱机时打开要更改的文档。

2. 刷新工作项列表，从工作项数据库中检索最新信息。 在 Excel 中，在“团队”功能区上的“工作项”组中，选择“刷新”。

3. 将要修改的所有字段的列添加到工作项列表。 当工作项列表与服务器断开连接时，无法添加列。

4. 断开计算机与网络的连接，或保存工作项列表文件，并将其复制到另一台计算机。

   此时可能会出现一条错误消息，指出 Office 程序无法与 Azure DevOps Server 建立连接。

5. 根据需要修改或更新工作项列表。

   当工作项文档与系统断开连接时，无法在工作项之间创建大多数类型的链接。 例外情况是 Excel 树列表中的父子链接。

将文件重新连接到 Azure Boards

若要重新连接 Excel 文档文件，请执行以下操作：

1. 将计算机重新连接到网络，或将文件复制到已连接到 Azure Boards 的计算机。

2. 如果已脱机更改文档，请在 Excel 中，在“团队”功能区上的“工作项”组中，选择“发布”。

3. 如果未脱机更改文档，请在 Excel 中，在“团队”功能区上的“工作项”组中，选择“刷新”。

4. 解决发生的任何数据验证错误或冲突。

市场扩展

以下市场扩展支持 Azure DevOps 和 Office 产品之间的集成。

• Azure DevOps 在 Excel 中打开：在 Excel 中打开选定的查询。
• Office 365 集成：将可配置的 Azure DevOps 事件的通知推送到 Office 365 组。

相关文章

• 批量修改工作项（Web 门户）
• 使用 CSV 文件批量导入或更新工作项
• 常见问题解答：使用连接到 Azure Boards 的 Excel
• 创建积压工作