Resolución de problemas de integración de Office para Azure DevOps

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

Todas las tareas de integración de Office requieren una versión de Visual Studio o la integración gratuita de Office para Azure DevOps 2019. El software instala el complemento de integración de Office de Azure DevOps o el complemento de integración de Office de Team Foundation. Para obtener una lista de los requisitos previos, consulte Integración de Azure Boards y Office.

Si no ve la barra de herramientas de Equipo en Microsoft Excel, como se muestra en la siguiente imagen, puede que desee resolver el problema con los procedimientos que se indican en este artículo.

Captura de pantalla de la barra de herramientas del equipo de integración de TFS-Office de Excel.

Importante

La integración de Microsoft Project y el comando TFSFieldMapping no son compatibles con:

  • Visual Studio 2019 y Azure DevOps Office Integration 2019.
  • Azure DevOps Server 2019 y versiones posteriores, incluido Azure DevOps Services.

Hay total compatibilidad con la integración de Microsoft Excel y se admite la importación y actualización masiva de elementos de trabajo. Entre las alternativas a usar Microsoft Project, están las siguientes:

Habilitación del complemento de Azure DevOps

  1. En el menú Archivo de Excel, elija Opciones.

  2. Elija Complementos y, en la lista desplegable Administrar, elija Complementos COM y, a continuación, elija Ir.

    Captura de pantalla de opciones de Excel, complementos, selección de Complementos COM.

  3. Asegúrese de que se coloca una marca en la casilla Complemento de Team Foundation.

    Captura de pantalla del cuadro de diálogo Complementos COM, Complemento de Team Foundation seleccionado.

  4. Reinicie Excel. Ahora debería aparecer la cinta Equipo.

Si la cinta de Equipo no aparece en el siguiente inicio, es posible que se cambie el comportamiento de carga del complemento, por lo que debe completar los siguientes pasos:

Actualizar el registro

  1. Iniciar el editor del registro desde el menú Inicio de Windows al escribir regedit en el cuadro Buscar o Ejecutar.

    Captura de pantalla de Ejecutar comando regedit.

  2. Vaya a una de las siguientes rutas de acceso que contienen la carpeta TFCOfficeShim.Connect.[versión]:

Nota:

Si hay varias carpetas con el mismo nombre, seleccione la que tenga el número de versión más alto.

  • HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Excel\Addins (si esta clave no existe, pruebe una de las siguientes opciones )

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

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

Captura de pantalla de la entrada LoadBehavior.

  1. Haga doble clic para abrir LoadBehavior y establezca el campo de datos de valor en 3 (si el valor fuera 0, la cinta de opciones Equipo no se carga).

  2. Seleccione Aceptar y reinicie Excel.

    Para más información sobre la entrada LoadBehavior, consulte Entradas del registro para complementos de VSTO, Valores de LoadBehavior.

El complemento de Office no se carga ni se abre en Excel cuando se produce un error en Visual Studio

Para conectarse a Azure Boards, vaya a la barra de herramientas Equipo y elija Nueva lista. Si el cuadro de diálogo Nueva lista no se abre o recibe un mensaje de error TF86001 o similar, es posible que tenga que reparar Visual Studio.

Mensaje de error TF86001, Team Foundation no pudo cargar el complemento de Office.

Este error suele deberse a que se instala Visual Studio antes de instalar Office Excel o Project. En este caso, el tiempo de ejecución de Visual Studio Tools para Office no está configurado correctamente. Para corregir este error, debe reparar Visual Studio.

Nota:

Para problemas de autenticación, como TF31003 y TF30063, consulte La cuenta de usuario no tiene permiso.

Requisitos previos

Instale Visual Studio para asegurarse de que tiene acceso al símbolo del sistema de Visual Studio y a la herramienta de caché global de ensamblados (Gacutil.exe). Si aún no tiene Visual Studio, puede descargar e instalar la edición de Visual Studio Community gratis.

Ejecución de la herramienta Gacutil

  1. Abra el símbolo del sistema de Visual Studio y elija ejecutarlo como administrador.

    Captura de pantalla del símbolo del sistema para desarrolladores del menú de inicio de VS2015 con

  2. Para Microsoft 365, ejecute los siguientes comandos:

    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
    

    Para Office 2016 y Office 2013, ejecute los siguientes comandos:

    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
    

    Para Office 2010, ejecute los siguientes comandos:

    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. Una vez que haya ejecutado correctamente los comandos GACUTIL, reinicie Excel y busque el complemento Herramienta de integración de Azure DevOps para Office.

Si los pasos anteriores no funcionan, pruebe los pasos siguientes:

  1. Ejecute una reparación completa de Office.

  2. Desinstale Office y vuelva a instalarlo.

  3. Póngase en contacto con el servicio de soporte técnico de Microsoft.

El usuario no puede iniciar sesión en Azure DevOps desde Excel después de cambiar la contraseña

Si un usuario cambió su contraseña de red y comienza a recibir errores de autenticación con la nueva información de cuenta, es posible que experimente un problema conocido. El token almacenado en Visual Studio ya no es válido, pero el sistema no reconoce que debe actualizarse. El usuario no tiene que realizar ninguna acción, el token expira después de un tiempo y la autenticación comienza a funcionar de nuevo, pero no hay forma de calcular el retraso. Use la siguiente solución alternativa para quitar manualmente el token.

Eliminación de un token de TokenStore

  1. Cierre todas las instancias abiertas de Excel.

  2. Guarde y desactive la ruta de acceso del registro; estos comandos se pueden ejecutar desde el símbolo del sistema abierto con la opción "ejecutar como administrador":

    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. Abra Excel y se le pedirá que inicie sesión cuando se conecte a Azure DevOps.

Espere hasta que el token expire o elimine esta clave regular cada vez que cambie una contraseña, si está configurada de una manera que causa este problema.

Problemas intermitentes al actualizar y publicar

Si un usuario tiene errores al realizar una actualización o publicar, puede deberse a una directiva de acceso condicional en Microsoft Entra ID. Para resolver este problema, intente borrar el contenido de la carpeta %LOCALAPPDATA%\.IdentityService.

No se puede convertir el objeto COM de tipo Microsoft.Office.Interop.Excel.ApplicationClass...

Es posible que reciba un mensaje de error al intentar abrir una lista de elementos de trabajo de TFS en Excel, desencadenada desde Team Explorer. Para obtener más información, consulte Cómo solucionar el problema "No se ha podido convertir un objeto COM de tipo Microsoft.Office.Interop.Excel.ApplicationClass" al tipo de interfaz 'Microsoft.Office.Interop.Excel._Application'".