解决 Azure DevOps 和 Office 集成问题

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

Azure DevOps 与 Microsoft Office 应用程序（主要是 Excel 和 Project）集成，以便批量编辑和管理工作项。 此集成依赖于 Azure DevOps Office 集成加载项，该加载项将 团队 功能区添加到 Office 应用程序。

可能会遇到集成问题的常见方案包括：

• 缺少团队功能区：Azure DevOps Team 功能区不会显示在 Excel 或其他 Office 应用程序中
• 加载项未加载：Azure DevOps 加载项无法加载或被禁用
• 身份验证问题：密码更改或组织更新后的登录问题
• 发布错误：从 Office 更新工作项时出现数据冲突或验证错误
• 安装冲突：因按不同顺序安装 Office 和 Visual Studio 而引起的问题

本文提供最常见的 Azure DevOps Office 集成问题的分步解决方案。 在进行故障排除之前，请确保具备必要的先决条件并了解 Office 集成支持的当前状态。

安装 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 加载项。

   

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

   

4. 重启 Excel。

团队功能区显示。

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

更新注册表

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

   

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

   Note

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

   • 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

   

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

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

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

验证加载项是否已禁用

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

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

   

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

   

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

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

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

Prerequisites

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

运行 Gacutil 工具

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

   

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

   Software	Commands
   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. 修复 Microsoft Office。
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. 在 工作项发布错误 对话框中，对于出现数据验证错误的每个工作项，请执行以下步骤。

   Note

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

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

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

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

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

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

   Note

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

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

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

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

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

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

解决TF80070：执行作时出错

TF80070错误通常是由于 Azure DevOps Office 集成和其他已安装应用程序使用的 Newtonsoft.Json 库的不同版本之间的程序集绑定冲突导致的。

症状

在以下情况下可能会遇到此错误：

• 尝试从 Excel 连接到 Azure DevOps
• 在 Excel 中打开或刷新工作项列表
• 将 Excel 中的更改发布到 Azure DevOps

决议

通过创建将程序集绑定重定向到 Newtonsoft.Json 库的正确版本的配置文件来解决此问题。

1. 找到 Excel 安装文件夹。 典型路径包括：

   • Microsoft 365/Office 2016-2021： C:\Program Files\Microsoft Office\root\Office16\
   • Office 2013： C:\Program Files\Microsoft Office\Office15\
   • Office 2010： C:\Program Files\Microsoft Office\Office14\

2. 在 Excel 安装文件夹中创建新的文本文件并将其命名 excel.exe.config。

   Important

   你需要管理员权限才能在 Office 安装目录中创建文件。 右键单击 记事本 ，在创建文件之前选择“ 以管理员身份运行 ”。

3. 将以下 XML 内容添加到 excel.exe.config 该文件：

   <?xml version="1.0" encoding="utf-8"?>
   <configuration>
     <runtime>
       <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
           <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30AD4FE6B2A6AEED" culture="neutral"/>
           <bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="13.0.0.0"/>
         </dependentAssembly>
       </assemblyBinding>
     </runtime>
   </configuration>
   

4. 保存文件并确保该文件正好命名为excel.exe.config（而不是excel.exe.config.txt）。

5. 关闭所有 Excel 实例并重启 Excel。

6. 通过再次尝试从 Excel 连接到 Azure DevOps 来测试连接。

如果在完成前面的故障排除步骤后问题仍然存在，请考虑修复用户的配置文件并检查损坏的系统文件。

1. 以管理员身份打开命令提示符或 PowerShell。

2. 运行 DISM 工具以修复 Windows 映像：

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   

3. DISM 完成后，运行系统文件检查器：

   sfc /scannow
   

相关内容

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