解決 Azure DevOps 和 Office 整合問題

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

Azure DevOps 整合 Microsoft Office 應用程式，主要是 Excel 和 Project，提供大量編輯與管理工作項目的功能。 此整合依賴 Azure DevOps Office 整合增益集，其將 小組 功能區新增至您的 Office 應用程式。

您可能會遇到整合問題的常見案例包括：

• 遺漏小組功能區：Azure DevOps 小組功能區不會出現在 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 以查看 Team 功能區。

如果您仍然看不到 [ 小組 ] 功能區，請執行下列各節中的步驟。

啟用 Azure DevOps 附加元件

1. 在Excel中，選取 [檔案>選項]。

2. 在管理下拉式選單中，選取>，然後選取COM 增益集，最後選擇執行。

   

3. 請確定 [Team Foundation 外掛程式] 方塊中已打勾。

   

4. 重新啟動 Excel。

小組 功能區顯示。

如果團隊功能區在下一次啟動時未出現，附加元件的載入行為可能已更改，因此請執行以下步驟。

更新登錄檔

1. 在 [搜尋] 或 [執行] 方塊中輸入 regedit ，從 Windows [開始] 選單啟動註冊表編輯器。

   

2. 移至下列其中一個路徑，其中包含 TFCOfficeShim.Connect。[version] 資料夾：

   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，Team 功能區就無法載入。

4. 選取 [ 確定 ]，然後重新啟動Excel。

   如需 LoadBehavior 項目的詳細資訊，請參閱 用於 VSTO 增益集的登錄項目及 LoadBehavior 的值。

確認外掛程式是否已停用

1. 從 [Excel 檔案] 選單中，選取 [ 選項]。

2. 選擇 增益集，然後從 管理 下拉功能表中，選取 停用的項目>，然後選擇 移至。

   

3. 如果您在清單中看到 Azure DevOps 附加元件，請選擇它並選取 啟用。

   

當 Visual Studio 失敗時，Office 增益集無法在 Excel 中載入或開啟。

若要連線到 Azure Boards，請移至 [小組 ] 功能區，然後選擇 [ 新增清單]。 如果 [新增清單] 對話框無法開啟，或您收到TF86001或類似的錯誤訊息，您可能需要修復 Visual Studio。

在 Office Excel 或 Project 之前安裝 Visual Studio 時，通常會發生此錯誤。 在此情況下，Visual Studio Tools for Office Runtime 的設定不正確。 若要修正此錯誤，請修復您的 Visual Studio 安裝。

Prerequisites

安裝 Visual Studio 以確保您可以存取 Visual Studio 命令提示字元和 Gacutil.exe （全域程式集緩存工具）。 如果您沒有 Visual Studio，您可以免費安裝 Visual Studio Community 版本。

執行 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 並查看 Azure DevOps Office 整合工具增益集。

如果之前的步驟沒有幫助，試試以下步驟：

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 中開啟從 Team Explorer 觸發的工作項目清單時，您可能會收到錯誤訊息。 如需詳細資訊，請參閱 如何解決'無法將類型為 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\
   • Microsoft 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
   

利用 AI 來排解 Office 整合問題

以下 Copilot Chat 範例提示有助於你排除 Azure DevOps 與 Office 整合問題。 將此提示複製貼上到 Copilot Chat，並用你的具體資訊取代佔位符。

為了獲得最佳的 AI 協助，請提供具體細節，例如錯誤訊息、Office 版本、Azure DevOps 外掛狀態，以及 Office 應用程式中是否顯示 Team 功能區。

I'm having this Azure DevOps Office integration issue: [PASTE YOUR ERROR MESSAGE OR DESCRIBE THE PROBLEM]

Office integration details:
- Office version: [Microsoft 365/Office 2021/2019/2016/2013]
- Excel/Project version: [SPECIFIC VERSION NUMBER if known]
- Azure DevOps add-in status: [Enabled/Disabled/Missing/Not visible]
- Team ribbon visibility: [Visible/Missing/Grayed out]
- Error code: [ERROR CODE like TF86001, TF80070, TF31003 if applicable]
- Visual Studio version: [VERSION if installed]
- Installation order: [Office first or Visual Studio first]
- Recent changes: [Password change, Office update, etc.]

Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the Office integration problem
2. Fix the add-in installation, registry settings, or authentication issue
3. Verify the Azure DevOps Team ribbon appears and functions correctly

Context: This is for Azure DevOps Office integration with Excel or Project. The issue might be related to add-in loading, COM registration, authentication, assembly conflicts, or installation problems.

Copilot 是由 AI 所提供，因此可能會有驚喜和錯誤。 如需詳細資訊，請參閱 Copilot 一般使用常見問題。

相關內容

• 大量修改工作專案（網頁入口）
• 使用 CSV 檔案批量導入或更新工作項目
• 常見問題：在連接至 Azure Boards 的 Excel 中工作
• 新增或移除附加元件