Condividi tramite


Risolvere i problemi di integrazione di Office in Azure DevOps

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

Tutte le attività di integrazione di Office richiedono una versione installata di Visual Studio o l'integrazione gratuita di Azure DevOps Office 2019. Il software installa il componente aggiuntivo Integrazione di Office di Azure DevOps o il componente aggiuntivo integrazione di Team Foundation Office. Per un elenco dei prerequisiti, vedere Azure Boards e Integrazione di Office.

Se la barra multifunzione Team in Microsoft Excel non è visualizzata, come illustrato nell'immagine seguente, è possibile risolvere il problema con le procedure fornite in questo articolo.

Screenshot della barra multifunzione team di integrazione di Excel TFS-Office.

Importante

Integrazione di Microsoft Project e il TFSFieldMapping comando non sono supportati per:

  • Visual Studio 2019 e Azure DevOps Office Integration 2019.
  • Azure DevOps Server 2019 e versioni successive, tra cui Azure DevOps Services.

Il supporto completo per l'integrazione di Microsoft Excel viene gestito e supporta l'importazione e l'aggiornamento bulk degli elementi di lavoro. Le alternative all'uso di Microsoft Project includono:

Abilitare il componente aggiuntivo Azure DevOps

  1. Scegliere Opzioni dal menu File di Excel.

  2. Scegliere Componenti aggiuntivi e dall'elenco a discesa Gestisci , scegliere Componenti aggiuntivi COM e quindi scegliere Vai.

    Screenshot delle opzioni di Excel, componenti aggiuntivi, Scegli componenti aggiuntivi Com.

  3. Assicurarsi che nella casella di controllo Componente aggiuntivo Team Foundation sia presente un segno di spunta.

    Screenshot della finestra di dialogo Componenti aggiuntivi COM, componente aggiuntivo Team Foundation archiviato.

  4. Riavviare Excel. Verrà visualizzata 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 completare i passaggi seguenti:

Aggiornare il Registro di sistema

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

    Screenshot del comando Esegui regedit.

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

Nota

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

Screenshot della voce LoadBehavior.

  1. Fare doppio clic per aprire LoadBehavior e impostare il campo dati valore su 3 (se il valore è 0, la barra multifunzione Team non viene caricata).

  2. Selezionare OK e riavviare Excel.

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

Verificare se il componente aggiuntivo è disabilitato

  1. Scegliere Opzioni dal menu File di Excel.

  2. Scegliere Componenti aggiuntivi e dall'elenco a discesa Gestisci , scegliere Elementi disabilitati e quindi scegliere Vai.

    Screenshot delle opzioni di Excel, componenti aggiuntivi, scegliere Elementi disabilitati.

  3. Se nell'elenco viene visualizzato "Azure DevOps Add In", selezionarlo e fare clic su Abilita.

    Screenshot della finestra di dialogo Elementi disabilitati, Aggiunta di Azure DevOps selezionata.

Il componente aggiuntivo di Office non viene caricato o aperto in Excel quando Visual Studio non riesce

Per connettersi ad 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.

TF86001 messaggio di errore, Team Foundation non è riuscito a caricare il componente aggiuntivo di Office.

Questo errore si verifica in genere quando si installa Visual Studio prima di installare Office Excel o Project. In questo caso, il Strumenti di Visual Studio per l'esecuzione di Office non è configurato correttamente. Per correggere l'errore, è necessario ripristinare Visual Studio.

Nota

Per i problemi di autenticazione, ad esempio TF31003 e TF30063, fare riferimento all'account utente che non dispone dell'autorizzazione.

Prerequisiti

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

Eseguire lo strumento Gacutil

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

    Screenshot del menu Start del prompt dei comandi per gli sviluppatori per VS2015 con 'Esegui come amministratore

  2. Per Microsoft 365, eseguire i comandi seguenti:

    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
    

    Per Office 2016 e Office 2013, eseguire i comandi seguenti:

    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
    
    GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.12.0.office\15.0.0.0__71e9bce111e9429c\Policy.12.0.Office.dll
    

    Per Office 2010, eseguire i comandi seguenti:

    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
    
    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 GACUTIL comandi, riavviare Excel e cercare il componente aggiuntivo Strumento di integrazione di Azure DevOps per Office.

Se i passaggi precedenti hanno esito negativo, provare i passaggi seguenti:

  1. Eseguire un ripristino completo di Office.

  2. Disinstallare Office e reinstallare Office.

  3. Contattare il team di supporto Microsoft.

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

Se un utente ha modificato la password di rete e inizia a ricevere errori di autenticazione con le informazioni sul nuovo account, potrebbe verificarsi un problema noto. Il token archiviato in Visual Studio non è più valido, ma il sistema non riconosce che deve essere aggiornato. L'utente non deve eseguire alcuna azione, il token scade dopo un certo periodo di tempo e l'autenticazione inizia a funzionare di nuovo, ma non è possibile stimare il ritardo. Usare la soluzione alternativa seguente per rimuovere manualmente il token.

Rimuovere il token dal Registro di sistema

  1. Chiudere tutte le istanze aperte di Excel.

  2. Salvare e quindi deselezionare il percorso del Registro di sistema. Questi comandi possono essere eseguiti dal prompt dei comandi aperti con l'opzione "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 ad Azure DevOps.

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

Problemi intermittenti durante l'aggiornamento e la pubblicazione

Se un utente presenta errori durante l'aggiornamento o la pubblicazione, potrebbe essere dovuto a un criterio di accesso condizionale in Microsoft Entra ID. Per risolvere questo problema, provare a 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 tenta di aprire un elenco di elementi di lavoro TFS in Excel, attivato da Team Explorer. Per altre informazioni, vedere How to solve "Unable to cast COM object of type Microsoft.Office.Interop.Excel.ApplicationClass" to interface type 'Microsoft.Office.Interop.Excel._Application'."