Compartir vía


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

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

Si la cinta de opciones de Team en Microsoft Excel, como se muestra en la siguiente imagen, siga los procedimientos que se describen en este artículo para resolver el problema.

Captura de pantalla de la cinta de Team de integración de Excel y Azure DevOps/Office.

Nota:

La integración de Office de Azure DevOps es una característica completa sin planes de actualizaciones ni mejoras. Las inversiones futuras se centrarán en herramientas nativas para importar o actualizar elementos de trabajo de forma masiva mediante archivos CSV. Si tiene problemas con la integración de Office, considere la posibilidad de usar esta alternativa. Todas las tareas de integración de Office requieren una versión instalada de Visual Studio o la versión gratuita de Azure DevOps Office Integration 2019, que instala el complemento de integración de Azure DevOps Office. Para consultar los requisitos previos, consulte Integración de Azure Boards y Office.

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:

Instalación de Azure DevOps Integration 2019

Esta herramienta le permite conectarse a Azure Boards desde Excel. Para instalar la herramienta Azure DevOps Integration 2019, siga estos pasos:

  1. Descargue la herramienta Azure DevOps Office Integration 2019 .

  2. Instale la herramienta ejecutando el archivo descargado.

  3. Reinicie Excel para ver la cinta de opciones Equipo .

Si sigue sin ver la cinta de opciones Equipo , siga los pasos descritos en las secciones siguientes.

Habilitación del complemento de Azure DevOps

  1. En Excel, seleccione Archivo>Opciones.

  2. Seleccione Complementos>Complementos COM en el menú desplegable Administrar >Ir.

    Captura de pantalla de la secuencia para agregar el complemento COM.

  3. Asegúrese de que hay una marca en el cuadro Complemento de Team Foundation.

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

  4. Reinicie Excel.

Se muestra la cinta de Team.

Si la cinta de Team no aparece en el siguiente inicio, es posible que el comportamiento de carga del complemento haya cambiado, 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.

  3. Seleccione dos veces para abrir LoadBehavior y establezca el campo de datos de valor en 3. Si el valor es 0, la cinta de Team no se carga.

  4. Seleccione Aceptar y reinicie Excel.

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

Compruebe si el complemento está deshabilitado

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

  2. Elija Complementos y, en el menú desplegable Administrar, seleccione Elementos>deshabilitados Ir.

    Captura de pantalla de Opciones de Excel, Complementos, Elegir elementos deshabilitados.

  3. Si ve el complemento de Azure DevOps en la lista, selecciónelo y seleccione Habilitar.

    Captura de pantalla del cuadro de diálogo Complemento de Azure DevOps activado.

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 producirse cuando Visual Studio se instala antes de 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, repare la instalación de 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. Ejecute los siguientes comandos en función del software:

    Software Comandos
    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 y 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. 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 ayudan, pruebe los pasos siguientes:

  1. Reparar Office.

  2. Desinstale Office y vuelva a instalarlo.

  3. Póngase en contacto con Microsoft a través de la Comunidad de desarrolladores.

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

Si 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. No es necesario realizar ninguna acción; el token acaba caducando y la autenticación comienza a funcionar de nuevo, aunque el retraso es impredecible. 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, a continuación, borre la ruta del Registro ejecutando los siguientes comandos desde un símbolo del sistema con privilegios elevados (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 recibe un error durante la actualización o publicación, es posible que haya una directiva de acceso condicional en Microsoft Entra ID. Para resolver este problema, borre 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 abrir una lista de elementos de trabajo 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'".