Risolvere i problemi di integrazione di Azure DevOps e Office

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

Azure DevOps si integra con applicazioni Microsoft Office, principalmente Excel e Project, per abilitare la modifica e la gestione bulk degli elementi di lavoro. Questa integrazione si basa sul componente aggiuntivo Azure DevOps Office Integration, che aggiunge una barra multifunzione Team alle applicazioni di Office.

Gli scenari comuni in cui possono verificarsi problemi di integrazione includono:

• barra multifunzione Missing Team: la barra multifunzione Azure DevOps Team non viene visualizzata in Excel o in altre applicazioni di Office
• Add-in not loading: il componente aggiuntivo Azure DevOps non viene caricato o disabilitato
• Problemi di autenticazione: problemi di accesso dopo la modifica della password o gli aggiornamenti dell'organizzazione
• Errori di pubblicazione: conflitti di dati o errori di convalida durante l'aggiornamento degli elementi di lavoro da Office
• Conflitti di installazione: problemi derivanti dall'installazione di Office e Visual Studio in ordini diversi

Questo articolo fornisce soluzioni dettagliate per i problemi di integrazione di Office più comuni Azure DevOps. Prima della risoluzione dei problemi, assicurarsi di disporre dei prerequisiti necessari e di comprendere lo stato corrente del supporto per l'integrazione di Office.

Installare Azure DevOps Integration 2019

Questo strumento consente di connettersi alle Azure Boards da Excel. Per installare lo strumento Azure DevOps Integration 2019, seguire questa procedura:

1. Scaricare lo strumento Azure DevOps Office Integration 2019.

2. Installare lo strumento eseguendo il file scaricato.

3. Riavviare Excel per visualizzare la barra multifunzione Team.

Se la barra multifunzione Team non è ancora visualizzata, seguire questa procedura nelle sezioni seguenti.

Abilitare il componente aggiuntivo Azure DevOps

1. In Excel selezionare File>Opzioni.

2. Selezionare Componenti aggiuntivi>Componenti aggiuntivi COM dal menu a discesa Gestisci>Vai.

   

3. Assicurarsi che sia presente una casella di controllo nel componente aggiuntivo Team Foundation.

   

4. Riavviare Excel.

Si visualizza la barra multifunzione Team.

Se la barra multifunzione Team non viene visualizzata all'avvio successivo, il comportamento di caricamento del componente aggiuntivo potrebbe essere modificato, quindi eseguire questi passaggi successivi.

Aggiornare il Registro di sistema

1. Avviare l'editor del Registro di sistema dal menu Start Windows immettendo regedit nella casella Cerca o Esegui.

   

2. Passare a uno dei percorsi seguenti contenenti TFCOfficeShim.Connect.[ versione] cartella:

   Note

   Se sono presenti più cartelle con lo stesso nome, selezionare quella con il numero di versione più alto.

   • HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Excel\Addins (se questa chiave non esiste, provare una delle opzioni seguenti)

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

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

   

3. Selezionare due volte per aprire LoadBehavior e impostare il campo dati del valore su 3. Se il valore è 0, la barra multifunzione Team non viene caricata.

4. Selezionare OK e riavviare Excel.

   Per ulteriori informazioni sulla voce LoadBehavior, vedere Voci del Registro di sistema per i componenti aggiuntivi VSTO, valori LoadBehavior.

Verificare se il componente aggiuntivo è disabilitato

1. Dal menu Excel File selezionare Opzioni.

2. Scegliere Componenti aggiuntivi dal menu a discesa Gestisci e selezionare Elementi disabilitati>Vai.

   

3. Se vedi Azure DevOps Componente aggiuntivo nell'elenco, selezionarlo e scegliere Abilita.

   

Il componente aggiuntivo di Office non viene caricato o aperto in Excel quando Visual Studio ha esito negativo

Per connettersi a Azure Boards, passare alla barra multifunzione Team e scegliere Nuovo elenco. Se la finestra di dialogo Nuovo elenco non viene aperta o viene visualizzato TF86001 o un messaggio di errore simile, potrebbe essere necessario ripristinare Visual Studio.

Questo errore si verifica in genere quando Visual Studio viene installato prima di Office Excel o Project. In questo caso, gli strumenti di Visual Studio per Office Runtime non sono configurati correttamente. Per correggere questo errore, ripristinare l'installazione Visual Studio.

Prerequisites

Installare Visual Studio per assicurarsi di avere accesso al prompt dei comandi Visual Studio e al Gacutil.exe (strumento Global Assembly Cache). Se non si dispone di Visual Studio, è possibile installare gratuitamente Visual Studio Community Edition.

Eseguire lo strumento Gacutil

1. Aprire il prompt dei comandi Visual Studio e scegliere di eseguirlo come amministratore.

   

2. Eseguire i comandi seguenti in base al software:

   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 e 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. Dopo aver eseguito correttamente i comandi GACUTIL, riavviare Excel e cercare il componente aggiuntivo Azure DevOps Integration Tool per Office.

Se i passaggi precedenti non sono utili, provare i passaggi successivi:

1. Ripristinare Office.
2. Disinstallare Office e quindi reinstallare Office.
3. Contattare Microsoft tramite il Developer Community.

L'utente non può accedere a Azure DevOps da Excel dopo la modifica della password

Se è stata modificata la password di rete e si inizia a ricevere errori di autenticazione con le nuove informazioni sull'account, potrebbe verificarsi un problema noto. Il token archiviato in Visual Studio non è più valido, ma il sistema non riconosce la necessità di aggiornarla. Non è necessario intraprendere alcuna azione; il token scade alla fine e l'autenticazione inizia a funzionare di nuovo, anche se il ritardo è imprevedibile. Usare la soluzione alternativa seguente per rimuovere manualmente il token.

Rimuovere il token dal Registro di sistema

1. Chiudere tutte le istanze Excel aperte.

2. Salvare e quindi cancellare il percorso del Registro di sistema eseguendo i comandi seguenti da un prompt dei comandi con privilegi elevati (esegui come amministratore):

   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. Aprire Excel e richiede l'accesso quando si connette a Azure DevOps.

Attendere che il token scada o eliminare questa chiave reg ogni volta che una password viene modificata se configurata in modo da causare questo problema.

Problemi intermittenti durante l'aggiornamento e la pubblicazione

Se si verifica un errore durante l'aggiornamento o la pubblicazione, potrebbero essere presenti criteri di accesso condizionale in Microsoft Entra ID. Per risolvere questo problema, cancellare il contenuto della cartella : %LOCALAPPDATA%\.IdentityService.

Impossibile eseguire il cast dell'oggetto COM di tipo Microsoft. Office.Interop. Excel. ApplicationClass

È possibile che venga visualizzato un messaggio di errore quando si apre un elenco di elementi di lavoro in Excel attivato da Team Explorer. Per altre informazioni, vedere Come risolvere 'Impossibile eseguire il cast dell'oggetto COM di tipo Microsoft. Office.Interop. Excel. ApplicationClass' per il tipo di interfaccia 'Microsoft. Office.Interop. Excel._Application.'

Risolvere i conflitti di dati durante la pubblicazione o l'aggiornamento dei dati Excel

Si verifica un conflitto di dati quando si tenta di pubblicare un elemento di lavoro da Excel e la versione dell'elemento di lavoro è diversa dalla versione nel database dell'elemento di lavoro. L'esempio seguente illustra come due membri del team possono creare un conflitto di questo tipo:

1. Un membro del team apre una copia di un elemento di lavoro in un elenco di elementi di lavoro in Excel o Project.
2. Membro del team A modifica l'elemento di lavoro e apporta un set di modifiche.
3. Il membro del team B modifica lo stesso elemento di lavoro e crea un set diverso di modifiche e pubblica tali modifiche.
4. Il membro del team A termina la modifica dell'elemento di lavoro e tenta di pubblicare le modifiche nell'elemento di lavoro.
5. Excel o Project visualizza la finestra di dialogo Errori di pubblicazione elementi di lavoro che mostra gli elementi che non è stato possibile pubblicare.

Risolvere un conflitto di dati

1. Nella finestra di dialogo errori di pubblicazione degli elementi di lavoro, per ogni elemento di lavoro nella casella elementi di lavoro non pubblicati che ha conflitto nella colonna problema, seguire questi passaggi.
2. Nella casella elementi di lavoro non pubblicati selezionare l'elemento di lavoro.
   L'area Dettagli mostra un elenco di conflitti per l'elemento di lavoro selezionato. La colonna, relativa al campo in conflitto , mostra il nome del campo in cui si verifica il conflitto. La Versione Locale e la Versione Server mostrano rispettivamente i dati locali e quelli del server, ed una casella di controllo appare accanto ai dati in ognuna di queste colonne.
3. Per ogni riga nella casella Dettagli selezionare la casella di controllo accanto al valore corretto.
   Quando si seleziona la versione locale, i dati in Office Excel o Office Project sovrascrivono i dati sul server. Se si seleziona la versione del server, i dati del server sovrascrivono i dati in Office Excel o Office Project.
4. Seleziona Pubblica.

Risolvere gli errori di convalida dei dati che si verificano durante la pubblicazione da Excel

Si verifica un errore di convalida dei dati quando una modifica nell'elenco degli elementi di lavoro o nel piano di progetto viola la regola di un tipo di elemento di lavoro. Gli esempi seguenti mostrano errori comuni di convalida dei dati:

• Un utente assegna un elemento di lavoro a un membro del team il cui nome non è incluso nell'elenco dei valori consentiti
• Un utente crea un elemento di lavoro, ma dimentica di completare un campo obbligatorio, ad esempio il tipo di elemento di lavoro.

Se si verifica un errore di convalida dei dati quando si tenta di pubblicare modifiche, viene visualizzata la finestra di dialogo Errori di pubblicazione degli elementi di lavoro e nell'elenco Elementi di lavoro non pubblicati la colonna Problema mostra Errore di convalida o un'altra frase contenente Non valido.

Risolvere un errore di convalida dei dati

È possibile utilizzare la finestra di dialogo Errori di Pubblicazione degli Elementi di Lavoro per risolvere un errore di convalida dei dati.

1. Nella finestra di dialogo Errori di Pubblicazione degli Elementi di Lavoro, per ogni elemento di lavoro che appare con un errore di convalida dei dati, seguire questi passaggi.

   Note

   Se l'errore di convalida dei dati riguarda un tipo di elemento di lavoro non valido, il pulsante Modifica elemento di lavoro non è visibile e non viene visualizzato un modulo dell'elemento di lavoro. È necessario correggere l'errore nel foglio di lavoro di Office Excel o nel piano office Project. Per informazioni su come risolvere un errore in Office Excel, vedere la procedura successiva in questo articolo.

2. Nella casella Elementi di lavoro non pubblicati selezionare l'elemento di lavoro e quindi selezionare Modifica elemento di lavoro.

   Viene visualizzato un modulo dell'elemento di lavoro.

3. Nel modulo dell'elemento di lavoro esaminare le informazioni e correggere il valore.

4. Selezionare Chiudi per salvare le modifiche e chiudere il modulo dell'elemento di lavoro.

5. Dopo aver corretto gli errori di convalida dei dati, selezionare Pubblica per pubblicare gli elementi di lavoro corretti.

   Note

   Questo passaggio pubblica solo gli elementi di lavoro che hai corretto. Se non si risolve un errore di convalida dei dati, l'elemento di lavoro non viene pubblicato.

6. Selezionare Chiudi per chiudere la finestra di dialogo errori di pubblicazione degli elementi di lavoro.

Risolvere un errore di convalida dei dati usando il controllo degli errori Excel

È possibile usare gli strumenti di office Excel per trovare e risolvere un errore in un elenco di elementi di lavoro. Per altre informazioni sull'uso degli strumenti di controllo degli errori di Office Excel, vedere la Guida di Office Excel.

Risolvere un errore di convalida dei dati usando il controllo degli errori Excel 2007

1. In Microsoft Excel selezionare la scheda Formulas.
2. Nel gruppo Controllo Formula selezionare Verifica Errori.
   Se lo strumento di controllo degli errori rileva un errore, viene visualizzata la finestra di dialogo controllo errori.
3. Per informazioni di base sull'errore, vedere il testo che descrive l'errore nella finestra di dialogo "Controllo Errori" . Per altre informazioni sull'errore, selezionare Guida su questo errore.
4. Nell'elenco degli elementi di lavoro selezionare la cella contenente l'errore e quindi correggere il valore.
5. Nella finestra di dialogo controllo errori selezionare Riprendi per trovare l'errore di convalida dei dati successivo.
   • Se nella finestra di dialogo controllo errori viene visualizzato un altro errore, ripetere i due passaggi precedenti per risolvere l'errore.
   • Se viene visualizzato un messaggio che indica il controllo degli errori completato, selezionare OK per chiudere sia questo messaggio che la finestra di dialogo Controllo errori.

Risolvere TF80070: si è verificato un errore durante l'esecuzione dell'operazione

L'errore TF80070 si verifica in genere a causa di conflitti di associazione di assembly tra versioni diverse della libreria Newtonsoft.Json usata dall'integrazione di Azure DevOps per Office e altre applicazioni installate.

Sintomi

Questo errore può verificarsi quando:

• Tentare di connettersi a Azure DevOps da Excel
• Aprire o aggiornare gli elenchi degli elementi di lavoro in Excel
• Pubblicare le modifiche da Excel a Azure DevOps

Risoluzione

Risolvere questo problema creando un file di configurazione che reindirizza le associazioni di assembly alla versione corretta della libreria Newtonsoft.Json.

1. Individuare la cartella di installazione Excel. I percorsi tipici sono:

   • 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. Creare un nuovo file di testo nella cartella di installazione Excel e denominarlo excel.exe.config.

   Important

   Sono necessari privilegi di amministratore per creare file nella directory di installazione di Office. Fare clic con il pulsante destro del mouse su Blocco note e selezionare Esegui come amministratore prima di creare il file.

3. Aggiungere il contenuto XML seguente al excel.exe.config file:

   <?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. Salvare il file e assicurarsi che il nome sia esattamente excel.exe.config (non excel.exe.config.txt).

5. Chiudere tutte le istanze di Excel e riavviare Excel.

6. Testare la connessione tentando di connettersi di nuovo a Azure DevOps da Excel.

Se il problema persiste dopo aver completato i passaggi precedenti per la risoluzione dei problemi, è consigliabile ripristinare il profilo dell'utente e verificare la presenza di file di sistema danneggiati.

1. Aprire il prompt dei comandi o PowerShell come amministratore.

2. Eseguire lo strumento DISM per ripristinare l'immagine Windows:

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   

3. Al termine di Gestione e manutenzione immagini distribuzione, eseguire il Controllo file di sistema.

   sfc /scannow
   

Usare l'intelligenza artificiale per risolvere i problemi di integrazione di Office

L'esempio seguente di prompt per Copilot Chat che aiuta a risolvere i problemi di integrazione di Azure DevOps e Office. Copiare e incollare questa richiesta in Copilot Chat, sostituendo i segnaposto con le informazioni specifiche.

Per ottenere un'assistenza ottimale per l'intelligenza artificiale, includere dettagli specifici, ad esempio il messaggio di errore esatto, la versione di Office, lo stato del componente aggiuntivo di Azure DevOps e se la barra multifunzione del Team è visibile nelle applicazioni di 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 è basato sull'IA, quindi sono possibili sorprese ed errori. Per ulteriori informazioni, consultare le FAQ sull'uso generale di Copilot.

Contenuti correlati

• Modificare in blocco gli incarichi di lavoro (Portale Web)
• Importare o aggiornare in blocco gli elementi di lavoro con i file CSV
• FAQs: Lavorare in Excel con Azure Boards
• Aggiungere o rimuovere componenti aggiuntivi
• Tutte le guide alla risoluzione dei problemi e le domande frequenti