通过

解决 Azure DevOps 和 Office 集成问题

  • 项目

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

如果 Microsoft Excel 中缺少团队功能区，如下图所示，请执行本文中的步骤来解决此问题。

Excel 和 Azure DevOps/Office 集成团队功能区的屏幕截图。

注意

Azure DevOps Office 集成功能齐全，没有更新或改进计划。 未来的投资将侧重于使用 CSV 文件批量导入或更新工作项的本机工具。 如果遇到 Office 集成问题，请考虑使用此替代方案。 所有 Office 集成任务都需要已安装的 Visual Studio 版本或免费的 Azure DevOps Office 集成 2019，该版本将安装 Azure DevOps Office 集成加载项。 有关先决条件，请参阅 Azure Boards 和 Office 集成。

重要

以下对象不支持 Microsoft Project 集成和 TFSFieldMapping 命令：

  • Visual Studio 2019 和 Azure DevOps Office 集成 2019。
  • Azure DevOps Server 2019 及更高版本，包括 Azure DevOps Services。

保持对 Microsoft Excel 集成的完全支持，允许批量导入和更新工作项。 使用 Microsoft Project 的替代方法包括：

安装 Azure DevOps Integration 2019

此工具允许从 Excel 连接到 Azure Boards。 若要安装 Azure DevOps Integration 2019 工具，请执行以下步骤：

  1. 下载 Azure DevOps Office Integration 2019 工具。

  2. 通过运行下载的文件安装该工具。

  3. 重启 Excel 以查看 “团队” 功能区。

如果仍然看不到 “团队” 功能区，请按照以下部分中的步骤操作。

启用 Azure DevOps 加载项

  1. 在 Excel 中，选择文件>选项。

  2. 从管理下拉菜单 >Go 中选择加载项>COM 加载项。

    用于添加 COM 加载项的序列的屏幕截图。

  3. 确保选中了 Team Foundation 加载项框。

  4. 重启 Excel。

团队功能区显示。

如果下次启动时不显示团队功能区，则加载项的加载行为可能已发生变化，那么，请执行以下步骤。

更新注册表

  1. 在“搜索”或“运行”框中输入 regedit，从 Windows 的“开始”菜单启动注册表编辑器。

    运行 regedit 命令的屏幕截图。

  2. 转到包含 TFCOfficeShim.Connect.[版本] 文件夹的以下路径之一：

    注意

    如果有多个同名的文件夹，请选择版本号最高的文件夹。

    • HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Excel\Addins（如果此密钥不存在，请尝试使用以下选项之一）

    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Excel\Addins

    • HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Office\Excel\Addins

    LoadBehavior 项的屏幕截图。

  3. 双击以打开 LoadBehavior，并将值数据字段设置为 3。 如果值为 0，则团队功能区未加载。

  4. 选择“确定”并重启 Excel。

    有关 LoadBehavior 条目的更多信息，请参阅 VSTO 加载项的注册表条目及 LoadBehavior 值。

验证加载项是否已禁用

  1. 从 Excel 的文件菜单中选择选项。

  2. 选择加载项，并从管理下拉菜单中选择禁用项>转到。

    Excel 选项、加载项、选择已禁用项的屏幕截图。

  3. 如果在列表中看到 Azure DevOps 外接程序 ，请选择它并选择“ 启用”。

    “已禁用项”对话框的屏幕截图，其中 Azure DevOps 插件已选中。

当 Visual Studio 失败时，Office 加载项无法在 Excel 中加载或打开

若要连接到 Azure Boards，请转到团队功能区，然后选择新建列表。 如果“新建列表”对话框无法打开，或者你收到 TF86001 或类似的错误消息，可能需要修复 Visual Studio。

TF86001 错误消息“Team Foundation 无法加载 Office 加载项”。

当 Visual Studio 安装在 Office Excel 或 Project 之前时，通常会发生此错误。 在这种情况下，Visual Studio Tools for Office Runtime 的配置不正确。 若要修复此错误，请修复 Visual Studio 安装。

注意

有关身份验证问题（如 TF31003 和 TF30063），请参阅 用户帐户没有权限。

先决条件

安装 Visual Studio，确保有权访问 Visual Studio 命令提示符和 Gacutil.exe（全局程序集缓存工具）。 如果未安装 Visual Studio，则可以免费安装 Visual Studio Community Edition。

运行 Gacutil 工具

  1. 打开 Visual Studio 命令提示符，并选择以管理员身份运行它。

    VS2015 开发人员命令提示符的开始菜单的屏幕截图，其中包含“以管理员身份运行”

  2. 根据软件运行以下命令：

    软件 命令
    Microsoft 365 GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.14.0.Microsoft.Office.Interop.Excel\15.0.0.0__71e9bce111e9429c\Policy.14.0.Microsoft.Office.Interop.Excel.dll
    GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.14.0.office\15.0.0.0__71e9bce111e9429c\Policy.14.0.Office.dll
    Office 2016 和 Office 2013 GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.12.0.Microsoft.Office.Interop.Excel\15.0.0.0__71e9bce111e9429c\Policy.12.0.Microsoft.Office.Interop.Excel.dll<\br>GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.12.0.office\15.0.0.0__71e9bce111e9429c\Policy.12.0.Office.dll
    Office 2010 GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.12.0.Microsoft.Office.Interop.Excel\14.0.0.0__71e9bce111e9429c\Policy.12.0.Microsoft.Office.Interop.Excel.dll<\br>GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.12.0.office\14.0.0.0__71e9bce111e9429c\Policy.12.0.Office.dll

  3. 成功运行 GACUTIL 命令后，重启 Excel，并查找适用于 Office 的 Azure DevOps 集成工具加载项。

如果前面的步骤不起作用，试试下面的步骤：

  1. 维修办公室。
  2. 卸载 Office，然后重新安装 Office。
  3. 通过开发人员社区联系 Microsoft。

更改密码后，用户无法从 Excel 登录到 Azure DevOps

如果你更改了网络密码并开始收到新帐户信息的身份验证错误，则你可能遇到了一个已知问题。 存储在 Visual Studio 中的令牌不再有效，但系统无法识别它需要刷新。 无需执行任何操作；令牌最终过期，身份验证将重新开始工作，尽管延迟是不可预知的。 使用以下解决方法手动删除令牌。

从注册表中删除令牌

  1. 关闭所有打开的 Excel 实例。

  2. 通过从提升的命令提示符（以管理员身份运行）运行以下命令，保存并清除注册表路径：

    reg export HKEY_CURRENT_USER\SOFTWARE\Microsoft\VSCommon\14.0\ClientServices\TokenStorage\VisualStudio\VssApp %TEMP%\oicreds.reg

    reg delete HKEY_CURRENT_USER\SOFTWARE\Microsoft\VSCommon\14.0\ClientServices\TokenStorage\VisualStudio\VssApp

  3. 打开 Excel，当连接到 Azure DevOps 后，系统会提示登录。

等待令牌过期，或者在每次密码更改时删除此注册表项（如果配置方式导致此问题）。

执行刷新和发布时出现间歇性问题

如果在刷新或发布过程中遇到错误，则 Microsoft Entra ID 中可能存在条件访问策略。 若要解决此问题，请清除文件夹 %LOCALAPPDATA%\.IdentityService 的内容。

无法强制转换 Microsoft.Office.Interop.Excel.ApplicationClass 类型的 COM 对象

在 Excel 中打开从团队资源管理器触发的工作项列表时，可能会收到错误消息。 有关详细信息，请参阅如何解决“无法将 Microsoft.Office.Interop.Excel.ApplicationClass 类型的 COM 对象强制转换为接口类型‘Microsoft.Office.Interop.Excel._Application。’”。

解决发布或刷新 Excel 数据时的数据冲突

当您尝试从 Excel 发布工作项，该工作项的版本与工作项数据库中的版本不同时，会发生数据冲突。 以下示例演示两名团队成员如何创建此类冲突：

  1. 团队成员在 Excel 或 Project 的工作项列表中打开工作项的副本。
  2. 团队成员 A 编辑了工作项并进行了一组更改。
  3. 团队成员 B 编辑同一工作项并做出一组不同的更改，并发布这些更改。
  4. 团队成员 A 完成编辑工作项后，尝试将已更改的工作项发布出去。
  5. Excel 或 Project 显示 工作项发布错误 对话框，其中显示了无法发布的项。

解决数据冲突

  1. 在工作项发布错误对话框中，对未发布的工作项框中每一个在问题列中存在冲突的工作项，执行以下步骤。
  2. 在 未发布的工作项 框中，选择工作项。
    详细信息 区域显示所选工作项的冲突列表。 冲突字段列显示发生冲突的字段的名称。 本地版本 和 服务器版本 列分别显示本地和服务器数据，每个列中的数据旁边会显示一个复选框。
  3. 对于 详细信息 框中的每一行，选中正确的值旁边的复选框。
    选择本地版本时，Office Excel 或 Office Project 中的数据将覆盖服务器上的数据。 如果选择服务器版本，则服务器数据将覆盖 Office Excel 或 Office Project 中的数据。
  4. 选择“发布” 。

注意

此步骤仅发布更正的工作项。 如果不解决与工作项相关的所有数据验证错误，则不会发布该工作项。

解决从 Excel 发布时发生的数据验证错误

当工作项列表或项目计划更改违反工作项类型的规则时，会发生数据验证错误。 以下示例显示了常见数据验证错误：

  • 某人将工作项分配给未包含在允许值列表中的团队成员
  • 有人创建工作项，但忘记完成所需字段，例如工作项类型。

如果尝试发布更改时发生数据验证错误，将显示 工作项发布错误 对话框，未发布的工作项 列表中，问题 列显示 验证错误 或包含 无效的另一个短语。

解决数据验证错误

可以使用 工作项发布错误 对话框来解决数据验证错误。

  1. 在 工作项发布错误 对话框中，对于出现数据验证错误的每个工作项，请执行以下步骤。

    注意

    如果数据验证错误是无效的工作项类型，则 “编辑工作项”按钮不可见，并且不会显示工作项窗体。 必须更正 Office Excel 工作表或 Office 项目计划中的错误。 有关如何解决 Office Excel 中的错误的信息，请参阅本文中的下一过程。

  2. 在 未发布的工作项 框中，选择工作项，然后选择 编辑工作项。

    此时将显示一个工作项窗体。

  3. 在该工作项窗体中，查看信息并更正值。

  4. 选择 “关闭” 以保存更改并关闭工作项表单。

  5. 更正数据验证错误之后，选择发布以发布已更正的工作项。

    注意

    此步骤仅发布更正的工作项。 如果未解决数据验证错误，则不会发布该工作项。

  6. 选择 关闭 以关闭 工作项发布错误 对话框。

使用 Excel 中的错误检查解决数据验证错误

可以使用 Office Excel 工具查找并解决工作项列表中的错误。 有关如何使用 Office Excel 错误检查工具的详细信息，请参阅 Office Excel 帮助。

使用 Excel 2007 中的错误检查解决数据验证错误

  1. 在Microsoft Excel 中，选择 公式 选项卡。
  2. 在公式审核组中，选择错误检查。
    如果错误检查工具发现错误，将会显示 “错误检查”对话框。
  3. 关于错误的基本信息，请参阅错误检查 对话框中描述错误的文本。 有关错误的详细信息，请选择关于此错误的帮助。
  4. 在工作项列表中，选择包含错误的单元格，然后更正值。
  5. 在错误检查对话框中，选择继续执行以找到下一个数据验证错误。
    • 如果“错误检查”对话框显示另一个错误，请重复前面的两个步骤来解决此错误。
    • 如果出现一条消息，指示错误检查已完成，请选择确定关闭此消息和错误检查对话框。