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

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

Azure DevOps se integra con las aplicaciones de Microsoft Office, principalmente Excel y Project, para habilitar la edición y administración masivas de elementos de trabajo. Esta integración se basa en el complemento de integración de Office de Azure DevOps, que agrega una cinta de opciones Team a las aplicaciones de Office.

Entre los escenarios comunes en los que se pueden encontrar problemas de integración se incluyen los siguientes:

• Cinta de opciones Team que falta: la cinta de opciones de Azure DevOps Team no aparece en Excel ni en otras aplicaciones de Office.
• Complemento que no se carga: el complemento de Azure DevOps no se puede cargar o está deshabilitado
• Problemas de autenticación: problemas de inicio de sesión después de cambios de contraseña o actualizaciones de la organización
• Errores de publicación: conflictos de datos o errores de validación al actualizar elementos de trabajo desde Office
• Conflictos de instalación: problemas derivados de la instalación de Office y Visual Studio en distintos pedidos

En este artículo se proporcionan soluciones paso a paso para los problemas de integración de Office de Azure DevOps más comunes. Antes de solucionar problemas, asegúrese de que tiene los requisitos previos necesarios y comprenda el estado actual de la compatibilidad con la integración de Office.

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 estos pasos 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.

   

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

   

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.

   

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

   Note

   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

   

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 Equipo 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 y haga clic en >.

   

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

   

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.

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.

Prerequisites

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.

   

2. Ejecute los siguientes comandos en función del 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 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 <\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. 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. Oficina de Reparación.
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 la necesidad de actualizarlo. 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.

Eliminar el token del registro

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'".

Resolución de conflictos de datos al publicar o actualizar datos de Excel

Se produce un conflicto de datos al intentar publicar un elemento de trabajo de excel y la versión de ese elemento de trabajo difiere de la versión de la base de datos de elementos de trabajo. En el ejemplo siguiente se muestra cómo dos miembros del equipo pueden crear este conflicto:

1. Un miembro del equipo abre una copia de un elemento de trabajo en una lista de elementos de trabajo en Excel o Project.
2. Miembro del equipo A edita el elemento de trabajo y realiza un conjunto de cambios.
3. El miembro del equipo B edita ese mismo elemento de trabajo y realiza un conjunto diferente de cambios y publica esos cambios.
4. El miembro del equipo A termina de editar el elemento de trabajo e intenta publicar los cambios en el elemento de trabajo.
5. Excel o Project muestra el cuadro de diálogo Errores de publicación de elementos de trabajo, donde se indican los elementos que no se pudieron publicar.

Resolución de un conflicto de datos

1. En el cuadro de diálogo Errores de publicación de elementos de trabajo, siga estos pasos con cada elemento de trabajo del cuadro Elementos de trabajo no publicados que tenga Conflicto en la columna Problema.
2. En el cuadro Elementos de trabajo no publicados, seleccione el elemento de trabajo.
   El área Detalles muestra una lista de los conflictos para el elemento de trabajo seleccionado. La columna Campo en conflicto muestra el nombre del campo en el que se produce el conflicto. Las columnas versión local y versión del servidor muestran los datos locales y del servidor, respectivamente, y aparece una casilla junto a los datos de cada una de estas columnas.
3. Para cada fila del cuadro Detalles, active la casilla situada junto al valor correcto.
   Al seleccionar la versión local, los datos de Office Excel u Office Project sobrescriben los datos en el servidor. Si selecciona la versión del servidor, los datos del servidor sobrescriben los datos en Office Excel u Office Project.
4. Seleccione Publicar.

Resolución de errores de validación de datos que se producen al publicar desde Excel

Se produce un error de validación de datos cuando un cambio en la lista de elementos de trabajo o el plan del proyecto infringe la regla de un tipo de elemento de trabajo. En los ejemplos siguientes se muestran errores comunes de validación de datos:

• Alguien asigna un elemento de trabajo a un miembro del equipo cuyo nombre no se incluye en la lista de valores permitidos.
• Alguien crea un elemento de trabajo, pero olvida completar un campo obligatorio, como el tipo de elemento de trabajo.

Si se produce un error de validación de datos al intentar publicar cambios, aparece el cuadro de diálogo Errores de publicación de elementos de trabajo y, en la lista de elementos de trabajo no publicados, la columna Problema muestra error de validación u otra frase que contiene No válido.

Resolución de un error de validación de datos

Puede usar el cuadro de diálogo Errores de publicación de elementos de trabajo para resolver un error de validación de datos.

1. En el cuadro de diálogo Errores de publicación de elementos de trabajo, para cada elemento de trabajo que aparece con un error de validación de datos, siga estos pasos.

   Note

   Si el error de validación de datos es un tipo de elemento de trabajo no válido, el botón Editar elemento de trabajo no está visible y no aparece un formulario de elemento de trabajo. Debe corregir el error en la hoja de cálculo de Office Excel o en el plan de Office Project. Para obtener información sobre cómo resolver un error en Office Excel, consulte el siguiente procedimiento de este artículo.

2. En el cuadro Elementos de trabajo no publicados, seleccione el elemento de trabajo y, a continuación, seleccione Editar elemento de trabajo.

   Aparece un formulario de elemento de trabajo.

3. En el formulario del elemento de trabajo, revise la información y corrija el valor.

4. Seleccione Cerrar para guardar los cambios y cerrar el formulario del elemento de trabajo.

5. Después de corregir los errores de validación de datos, seleccione Publicar para publicar los elementos de trabajo corregidos.

   Note

   Este paso publica solo los elementos de trabajo que corrigió. Si no resuelve un error de validación de datos, ese elemento de trabajo no se publica.

6. Seleccione Cerrar para cerrar el cuadro de diálogo Errores de publicación de elementos de trabajo.

Resolución de un error de validación de datos mediante la comprobación de errores en Excel

Puede usar las herramientas de Office Excel para buscar y resolver un error en una lista de elementos de trabajo. Para obtener más información sobre cómo usar las herramientas de comprobación de errores de Office Excel, vea la Ayuda de Office Excel.

Resolución de un error de validación de datos mediante la comprobación de errores en Excel 2007

1. En Microsoft Excel, seleccione la pestaña Fórmulas.
2. En el grupo Auditoría de fórmulas, seleccione Comprobación de errores.
   Si la herramienta de comprobación de errores encuentra un error, aparece el cuadro de diálogo Comprobación de errores.
3. Para obtener información básica sobre el error, vea el texto que describe el error en el cuadro de diálogo Comprobación de errores. Para obtener más información sobre el error, seleccione Ayuda sobre este error.
4. En la lista de elementos de trabajo, seleccione la celda que contiene el error y, a continuación, corrija el valor.
5. En el cuadro de diálogo Comprobación de errores, seleccione Reanudar para detectar el siguiente error de validación de datos.
   • Si el cuadro de diálogo comprobación de errores muestra otro error, repita los dos pasos anteriores para resolver el error.
   • Si aparece un mensaje que indica que se ha completado la comprobación de errores, seleccione Aceptar para cerrar este mensaje y el cuadro de diálogo Comprobación de errores.

Resolver TF80070: Ha ocurrido un error al realizar la operación

El error TF80070 suele producirse debido a conflictos de enlace de ensamblados entre diferentes versiones de la biblioteca Newtonsoft.Json que utiliza la integración de Azure DevOps Office y otras aplicaciones instaladas.

Síntomas

Es posible que encuentre este error al:

• Intento de conectarse a Azure DevOps desde Excel
• Abrir o actualizar listas de elementos de trabajo en Excel
• Publicación de cambios de Excel en Azure DevOps

Resolución

Resuelva este problema mediante la creación de un archivo de configuración que redirija los enlaces de ensamblado a la versión correcta de la biblioteca Newtonsoft.Json.

1. Busque la carpeta de instalación de Excel. Las rutas de acceso típicas son:

   • 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. Cree un nuevo archivo de texto en la carpeta de instalación de Excel y asígnele el nombre excel.exe.config.

   Important

   Necesita privilegios de administrador para crear archivos en el directorio de instalación de Office. Haga clic con el botón derecho en el Bloc de notas y seleccione Ejecutar como administrador antes de crear el archivo.

3. Agregue el siguiente contenido XML al excel.exe.config archivo:

   <?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. Guarde el archivo y asegúrese de que se denomina exactamente excel.exe.config (no excel.exe.config.txt).

5. Cierre todas las instancias de Excel y reinicie Excel.

6. Pruebe la conexión intentando conectarse a Azure DevOps de nuevo desde Excel.

Si el problema persiste después de completar los pasos de solución de problemas anteriores, considere la posibilidad de reparar el perfil del usuario y comprobar si hay archivos del sistema dañados.

1. Abra el Símbolo del sistema o PowerShell como Administrador.

2. Ejecute la herramienta DISM para reparar la imagen de Windows:

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   

3. Una vez completado DISM, ejecute el Comprobador de archivos del sistema:

   sfc /scannow
   

Utilizar IA para solucionar problemas de integración de Office

El siguiente mensaje de ejemplo para El chat de Copilot le ayuda a solucionar problemas de integración de Azure DevOps y Office. Copie y pegue este mensaje en Copilot Chat, reemplazando los marcadores por la información específica suya.

Para obtener la mejor asistencia de IA, incluya detalles específicos, como el mensaje de error exacto, la versión de Office, el estado del complemento de Azure DevOps y si la cinta de opciones team está visible en las aplicaciones de 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 funciona con IA, por lo que es posible que se produzcan sorpresas y errores. Para obtener más información, consulte Preguntas más frecuentes sobre el uso general de Copilot.

Contenido relacionado

• Modificación en bloque de elementos de trabajo (portal web)
• Importación o actualización en bloque de elementos de trabajo mediante archivos CSV
• Preguntas frecuentes sobre el uso de Excel en conexión con Azure Boards
• Adición o eliminación de complementos