Rozwiązywanie problemów z integracją usługi Azure DevOps i pakietu Office

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

Usługa Azure DevOps integruje się z aplikacjami pakietu Microsoft Office, głównie excel i Project, aby umożliwić zbiorcze edytowanie elementów roboczych i zarządzanie nimi. Ta integracja opiera się na dodatku Azure DevOps Office Integration, który dodaje wstążkę Team do aplikacji pakietu Office.

Typowe scenariusze, w których mogą wystąpić problemy z integracją, obejmują:

• Brak wstążki Zespołu: wstążka zespołu usługi Azure DevOps nie jest wyświetlana w programie Excel ani w innych aplikacjach pakietu Office
• Dodatek nie jest ładowany: dodatek Usługi Azure DevOps nie może załadować lub jest wyłączony
• Problemy z uwierzytelnianiem: Problemy z logowaniem po zmianie hasła lub aktualizacjach organizacyjnych
• Błędy publikowania: konflikty danych lub błędy walidacji podczas aktualizowania elementów roboczych z pakietu Office
• Konflikty instalacji: problemy wynikające z instalowania pakietu Office i programu Visual Studio w różnych zamówieniach

Ten artykuł zawiera szczegółowe rozwiązania typowych problemów z integracją pakietu Office w usłudze Azure DevOps. Przed rozwiązaniem problemów upewnij się, że masz niezbędne wymagania wstępne i zapoznaj się z bieżącym stanem obsługi integracji pakietu Office.

Instalowanie integracji usługi Azure DevOps 2019

To narzędzie umożliwia nawiązywanie połączenia z usługą Azure Boards z poziomu programu Excel. Aby zainstalować narzędzie Azure DevOps Integration 2019, wykonaj następujące kroki:

1. Pobierz narzędzie Azure DevOps Office Integration 2019.

2. Zainstaluj narzędzie, uruchamiając pobrany plik.

3. Uruchom ponownie program Excel, aby wyświetlić wstążkę Team .

Jeśli nadal nie widzisz wstążki Zespół , wykonaj kroki opisane w poniższych sekcjach.

Włączanie dodatku usługi Azure DevOps

1. W programie Excel wybierz pozycję Opcje pliku>.

2. Wybierz Dodatki>COM Add-ins z menu Zarządzaj rozwijanego, a następnie >.

   

3. Upewnij się, że jest zaznaczone pole Team Foundation Add-in.

   

4. Uruchom ponownie program Excel.

Zostanie wyświetlona wstążka Zespół .

Jeśli wstążka Team nie jest wyświetlana podczas następnego uruchamiania, zachowanie ładowania dodatku może zostać zmienione, więc wykonaj następujące następne kroki.

Aktualizowanie rejestru

1. Uruchom Edytor rejestru z menu Start systemu Windows, wprowadzając tekst regedit w polu Wyszukaj lub Uruchom.

   

2. Przejdź do jednej z następujących ścieżek zawierających TFCOfficeShim.Connect.[ version] folder:

   Note

   Jeśli istnieje wiele folderów o tej samej nazwie, wybierz jeden z najwyższym numerem wersji.

   • HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Excel\Addins (jeśli ten klucz nie istnieje, wypróbuj jedną z następujących opcji)

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

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

   

3. Wybierz dwukrotnie, aby otworzyć pozycję LoadBehavior i ustaw dane wartości na 3. Jeśli wartość to 0 wstążka Zespół nie zostanie załadowana.

4. Wybierz przycisk OK i uruchom ponownie program Excel.

   Aby uzyskać więcej informacji na temat wpisu LoadBehavior, zobacz Wpisy rejestru dla dodatków VSTO, wartości LoadBehavior.

Sprawdź, czy dodatek jest wyłączony

1. W menu Plik programu Excel wybierz pozycję Opcje.

2. Wybierz pozycję Dodatki, a następnie z menu rozwijanego Zarządzaj wybierz pozycję Wyłączone elementy>.Przejdź.

   

3. Jeśli na liście zostanie wyświetlona pozycja Dodaj do usługi Azure DevOps, wybierz ją i wybierz pozycję Włącz.

   

Dodatek pakietu Office nie ładuje się ani nie otwiera w programie Excel, gdy program Visual Studio ulegnie awarii

Aby nawiązać połączenie z usługą Azure Boards, przejdź do wstążki Zespół i wybierz pozycję Nowa lista. Jeśli otwarcie okna dialogowego Nowa lista nie powiedzie się lub zostanie wyświetlony TF86001 lub podobny komunikat o błędzie, może być konieczne naprawienie programu Visual Studio.

Ten błąd zwykle występuje, gdy program Visual Studio jest zainstalowany przed programem Office Excel lub Project. W takim przypadku środowisko uruchomieniowe Visual Studio Tools dla pakietu Office nie jest poprawnie skonfigurowane. Aby naprawić ten błąd, napraw instalację programu Visual Studio.

Prerequisites

Zainstaluj Visual Studio, aby upewnić się, że masz dostęp do wiersza polecenia Visual Studio i Gacutil.exe (narzędzie do globalnej pamięci podręcznej zestawów). Jeśli nie masz programu Visual Studio, możesz bezpłatnie zainstalować program Visual Studio Community Edition.

Uruchamianie narzędzia Gacutil

1. Otwórz wiersz polecenia programu Visual Studio i wybierz polecenie , aby uruchomić go jako administrator.

   

2. Uruchom następujące polecenia zgodnie z Twoim oprogramowaniem.

   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 i 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. Po pomyślnym uruchomieniu GACUTIL poleceń uruchom ponownie program Excel i poszukaj dodatku Azure DevOps Integration Tool for Office.

Jeśli poprzednie kroki nie pomogą, spróbuj wykonać następne kroki:

1. Napraw pakiet Office.
2. Odinstaluj pakiet Office, a następnie zainstaluj ponownie pakiet Office.
3. Skontaktuj się z firmą Microsoft za pośrednictwem społeczności deweloperów.

Użytkownik nie może zalogować się do usługi Azure DevOps z programu Excel po zmianie hasła

Jeśli zmieniono hasło sieciowe i zaczniesz otrzymywać błędy uwierzytelniania przy użyciu nowych informacji o koncie, może wystąpić znany problem. Token przechowywany w programie Visual Studio nie jest już prawidłowy, ale system nie rozpoznaje potrzeby jego odświeżania. Nie musisz podejmować żadnych działań; token wygasa w końcu, a uwierzytelnianie zacznie działać ponownie, choć opóźnienie jest nieprzewidywalne. Użyj następującego obejścia, aby ręcznie usunąć token.

Usuwanie tokenu z rejestru

1. Zamknij wszystkie otwarte wystąpienia programu Excel.

2. Zapisz, a następnie wyczyść ścieżkę rejestru, uruchamiając następujące polecenia z wiersza polecenia z podwyższonym poziomem uprawnień (uruchom jako administrator):

   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. Otwórz program Excel i wyświetli monit o zalogowanie się podczas nawiązywania połączenia z usługą Azure DevOps.

Zaczekaj na wygaśnięcie tokenu lub usuń ten klucz reg za każdym razem, gdy hasło ulegnie zmianie, jeśli zostanie skonfigurowane w sposób, który powoduje ten problem.

Sporadyczne problemy z odświeżaniem i publikowaniem

Jeśli podczas odświeżania lub publikowania wystąpi błąd, mogą istnieć zasady dostępu warunkowego w identyfikatorze Entra firmy Microsoft. Aby rozwiązać ten problem, wyczyść zawartość folderu: %LOCALAPPDATA%\.IdentityService.

Nie można rzutować obiektu COM typu Microsoft.Office.Interop.Excel.ApplicationClass

Podczas otwierania listy elementów roboczych w Excelu, zainicjowanej z poziomu Team Explorer, może pojawić się komunikat o błędzie. Aby uzyskać więcej informacji, zobacz Jak rozwiązać problem "Nie można rzutować obiektu COM typu Microsoft.Office.Interop.Excel.ApplicationClass" na typ interfejsu "Microsoft.Office.Interop.Excel._Application".

Rozwiązywanie konfliktów danych podczas publikowania lub odświeżania danych programu Excel

Konflikt danych występuje podczas próby opublikowania elementu roboczego z programu Excel, a wersja tego elementu roboczego różni się od wersji w bazie danych elementów roboczych. W poniższym przykładzie pokazano, jak dwóch członków zespołu może utworzyć taki konflikt:

1. Członek zespołu otwiera kopię elementu roboczego na liście elementów roboczych w programie Excel lub programie Project.
2. Członek zespołu A edytuje element roboczy i wprowadza jeden zestaw zmian.
3. Członek zespołu B edytuje ten sam element roboczy i wprowadza inny zestaw zmian i publikuje te zmiany.
4. Członek zespołu A kończy edytowanie elementu roboczego i próbuje opublikować zmiany w elemencie roboczym.
5. Program Excel lub Project wyświetla okno dialogowe błędy publikowania elementów roboczych, które pokazuje elementy, których nie można opublikować.

Rozwiązywanie konfliktu danych

1. W oknie dialogowym Błędów Publikowania Elementów Roboczych, dla każdego elementu roboczego w polu Nieopublikowanych Elementów Roboczych, które ma Konflikt w kolumnie Zagadnienie, wykonaj następujące kroki.
2. W polu Nieopublikowane elementy robocze wybierz element roboczy.
   Obszar Szczegóły zawiera listę konfliktów dla wybranego zadania. Kolumna Konfliktowe pole pokazuje nazwę pola, w którym występuje konflikt. Kolumny Wersja lokalna i Server zawierają odpowiednio dane lokalne i serwera, a pole wyboru jest wyświetlane obok danych w każdej z tych kolumn.
3. Dla każdego wiersza w polu Szczegóły zaznacz pole wyboru obok poprawnej wartości.
   Po wybraniu wersji lokalnej dane w programie Office Excel lub programie Office Project zastępują dane na serwerze. W przypadku wybrania wersji serwera dane serwera zastępują dane w programie Office Excel lub programie Office Project.
4. Wybierz Publikuj.

Usuwanie błędów walidacji danych występujących podczas publikowania z programu Excel

Błąd sprawdzania poprawności danych występuje, gdy zmiana listy elementów roboczych lub planu projektu narusza regułę typu elementu roboczego. W poniższych przykładach przedstawiono typowe błędy walidacji danych:

• Ktoś przypisuje element roboczy do członka zespołu, którego nazwa nie znajduje się na liście dozwolonych wartości
• Ktoś tworzy element roboczy, ale zapomina o ukończeniu wymaganego pola, takiego jak typ elementu roboczego.

Jeśli podczas próby opublikowania zmian wystąpi błąd sprawdzania poprawności danych, zostanie wyświetlone okno dialogowe Błędy publikowania elementów roboczych, a na liście Nieopublikowane elementy robocze w kolumnie Problem pojawi się fraza Błąd weryfikacji lub inna fraza zawierająca Nieprawidłowy.

Usuwanie błędu sprawdzania poprawności danych

Możesz użyć okna dialogowego błędów publikowania elementów roboczych, aby rozwiązać problem z błędem weryfikacji danych.

1. W oknie dialogowym Błędy publikowania elementów roboczych dla każdego elementu roboczego, który jest wyświetlany z błędem weryfikacji danych, wykonaj następujące kroki.

   Note

   Jeśli błąd sprawdzania poprawności danych jest nieprawidłowym typem elementu roboczego, przycisk Edytuj element roboczy nie jest widoczny, a formularz elementu roboczego nie jest widoczny. Należy usunąć błąd w arkuszu programu Office Excel lub planie programu Office Project. Aby uzyskać informacje na temat sposobu rozwiązywania błędu w programie Office Excel, zobacz następną procedurę w tym artykule.

2. W nieopublikowanych elementów roboczych zaznacz element roboczy, a następnie wybierz Edytuj element roboczy.

   Zostanie wyświetlony formularz elementu roboczego.

3. W formularzu elementu roboczego przejrzyj informacje i popraw wartość.

4. Wybierz pozycję Zamknij, aby zapisać zmiany i zamknąć formularz elementu roboczego.

5. Po skorygowaniu błędów walidacji danych wybierz pozycję Publikuj, aby opublikować poprawione elementy robocze.

   Note

   Ten krok publikuje tylko poprawione elementy robocze. Jeśli nie rozwiążesz błędu sprawdzania poprawności danych, ten element roboczy nie zostanie opublikowany.

6. Wybierz Zamknij, aby zamknąć okno dialogowe błędów publikowania elementów roboczych.

Usuwanie błędu sprawdzania poprawności danych przy użyciu sprawdzania błędów w programie Excel

Za pomocą narzędzi programu Office Excel można znaleźć i usunąć błąd na liście elementów roboczych. Aby uzyskać więcej informacji na temat korzystania z narzędzi sprawdzania błędów programu Office Excel, zobacz Pomoc programu Office Excel.

Usuwanie błędu sprawdzania poprawności danych przy użyciu sprawdzania błędów w programie Excel 2007

1. W programie Microsoft Excel wybierz kartę Formuły.
2. W grupie Inspekcja formuł wybierz Sprawdzanie błędów.
   Jeśli narzędzie sprawdzania błędów wykryje błąd, zostanie wyświetlone okno dialogowe Sprawdzanie błędów .
3. Aby uzyskać podstawowe informacje o błędzie, zobacz tekst opisujący błąd w oknie dialogowym sprawdzania błędów . Aby uzyskać więcej informacji na temat błędu, wybierz pozycję Pomoc dotyczącą tego błędu.
4. Na liście elementów roboczych wybierz komórkę zawierającą błąd, a następnie popraw wartość.
5. W oknie dialogowym Sprawdzanie błędów wybierz pozycję Wznów, aby znaleźć następny błąd weryfikacji danych.
   • Jeśli w oknie dialogowym sprawdzanie błędów zostanie wyświetlony inny błąd, powtórz dwa poprzednie kroki, aby rozwiązać błąd.
   • Jeśli zostanie wyświetlony komunikat informujący o zakończeniu sprawdzania błędów, wybierz pozycję OK, aby zamknąć zarówno ten komunikat, jak i okno dialogowe Sprawdzania błędów .

Rozwiązywanie TF80070: Wystąpił błąd podczas wykonywania operacji

Błąd TF80070 występuje zazwyczaj z powodu konfliktów powiązań zestawów między różnymi wersjami biblioteki Newtonsoft.Json używanej przez integrację Azure DevOps Office i innymi zainstalowanymi aplikacjami.

Objawy

Ten błąd może wystąpić, gdy:

• Próba nawiązania połączenia z usługą Azure DevOps z poziomu programu Excel
• Otwieranie lub odświeżanie list elementów roboczych w programie Excel
• Publikowanie zmian z programu Excel do usługi Azure DevOps

Rezolucja

Rozwiąż ten problem, tworząc plik konfiguracji, który przekierowuje powiązania zestawów do poprawnej wersji biblioteki Newtonsoft.Json.

1. Znajdź folder instalacyjny programu Excel. Typowe ścieżki to:

   • 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. Utwórz nowy plik tekstowy w folderze instalacyjnym programu Excel i nadaj mu excel.exe.confignazwę .

   Important

   Do tworzenia plików w katalogu instalacyjnym pakietu Office potrzebne są uprawnienia administratora. Kliknij prawym przyciskiem myszy Notatnik i wybierz polecenie Uruchom jako administrator przed utworzeniem pliku.

3. Dodaj następującą zawartość XML do excel.exe.config pliku:

   <?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. Zapisz plik i upewnij się, że nazwa jest dokładnie excel.exe.config (a nie excel.exe.config.txt).

5. Zamknij wszystkie wystąpienia programu Excel i uruchom ponownie program Excel.

6. Przetestuj połączenie, próbując ponownie nawiązać połączenie z usługą Azure DevOps z programu Excel.

Jeśli problem będzie się powtarzać po wykonaniu poprzednich kroków rozwiązywania problemów, rozważ naprawienie profilu użytkownika i sprawdzenie uszkodzonych plików systemowych.

1. Otwórz wiersz polecenia lub program PowerShell jako administrator.

2. Uruchom narzędzie DISM, aby naprawić obraz systemu Windows:

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   

3. Po zakończeniu programu DISM uruchom systemowy moduł sprawdzania plików:

   sfc /scannow
   

Rozwiązywanie problemów z integracją pakietu Office przy użyciu sztucznej inteligencji

Poniższy przykład monitu czatu Copilot ułatwia rozwiązywanie problemów z integracją Azure DevOps oraz Office. Skopiuj i wklej ten monit do aplikacji Copilot Chat, zastępując symbole zastępcze określonymi informacjami.

Aby uzyskać najlepszą pomoc w zakresie sztucznej inteligencji, dołącz szczegółowe informacje, takie jak dokładny komunikat o błędzie, wersja pakietu Office, stan dodatku Usługi Azure DevOps oraz to, czy wstążka Team jest widoczna w aplikacjach pakietu Office.

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 jest obsługiwany przez sztuczną inteligencję, więc możliwe są niespodzianki i błędy. Aby uzyskać więcej informacji, zobacz także Copilot często zadawane pytania dotyczące ogólnego użytkowania.

Treści powiązane

• Zbiorcza zmiana elementów roboczych (portal internetowy)
• Zbiorcze importowanie lub aktualizowanie elementów roboczych przy użyciu plików CSV
• Często zadawane pytania: Praca w programie Excel połączona z usługą Azure Boards
• Dodawanie lub usuwanie dodatków