Condividi tramite

Risolvere i problemi di integrazione di Azure DevOps e Office

  • Articolo

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

Se la barra multifunzione Team non è presente in Microsoft Excel, come illustrato nell'immagine seguente, eseguire le procedure descritte in questo articolo per risolvere il problema.

Screenshot della barra multifunzione del team di integrazione di Excel e Azure DevOps/Office.

Nota

L'integrazione di Office di Azure DevOps è completa senza piani per aggiornamenti o miglioramenti. Gli investimenti futuri saranno incentrati sugli strumenti nativi per l'importazione bulk o l'aggiornamento di elementi di lavoro tramite file CSV. Se si verificano problemi con l'integrazione di Office, è consigliabile usare questa alternativa. Tutte le attività di integrazione di Office richiedono una versione installata di Visual Studio o l'integrazione gratuita di Azure DevOps Office 2019, che installa il componente aggiuntivo Integrazione di Office di Azure DevOps. Per i prerequisiti, vedere Azure Boards e integrazione di 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.

Viene mantenuto il supporto completo per l'integrazione di Microsoft Excel, consentendo l'importazione in blocco e l'aggiornamento degli elementi di lavoro. Le alternative all'uso di Microsoft Project includono:

Installare Azure DevOps Integration 2019

Questo strumento consente di connettersi ad 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 la procedura descritta nelle sezioni seguenti.

Abilitare il componente aggiuntivo Azure DevOps

  1. In Excel selezionare Opzioni file>.

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

    Screenshot della sequenza per aggiungere il componente aggiuntivo COM.

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

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

  4. Riavviare Excel.

Viene 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 eseguire questi passaggi successivi.

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.

  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 caricato.

  4. 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 dal menu a discesa Gestisci e selezionare Elementi>disabilitati Vai.

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

  3. Se nell'elenco viene visualizzato l'opzione Aggiungi Azure DevOps, selezionarla e selezionare 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 Visual Studio viene installato prima di Office Excel o Project. In questo caso, il Strumenti di Visual Studio per Office Runtime non è configurato correttamente. Per correggere questo errore, ripristinare l'installazione di Visual Studio.

Nota

Per i problemi di autenticazione, ad esempio TF31003 e , vedere L'account utente non dispone dell'autorizzazioneTF30063.

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. Eseguire i comandi seguenti in base al software:

    Software Comandi
    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
    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
    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 non sono utili, provare i passaggi successivi:

  1. Ripristinare Office.

  2. Disinstallare Office e quindi reinstallare Office.

  3. Contattare Microsoft tramite la community per sviluppatori.

L'utente non può accedere ad 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 di 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 ad 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 viene visualizzato un errore durante l'aggiornamento o la pubblicazione, potrebbe essere presente un criterio 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 How to solve 'Unable to cast COM object of type Microsoft.Office.Interop.Excel.ApplicationClass' to interface type 'Microsoft.Office.Interop.Excel._Application'.