Resolver problemas de integração do Office com o Azure DevOps

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

O Azure DevOps integra-se aos aplicativos do Microsoft Office, principalmente Excel e Project, para habilitar a edição em massa e o gerenciamento de itens de trabalho. Essa integração depende do suplemento Azure DevOps Office Integration, que adiciona uma barra de ferramentas de equipe aos seus aplicativos do Office.

Cenários comuns em que você pode encontrar problemas de integração incluem:

• Faixa de opções da equipe ausente: a faixa de opções da Equipe do Azure DevOps não aparece no Excel ou em outros aplicativos do Office
• Suplemento não carregado: o suplemento do Azure DevOps falha ao carregar ou está desabilitado
• Problemas de autenticação: problemas de entrada após alterações de senha ou atualizações organizacionais
• Erros de publicação: conflitos de dados ou erros de validação ao atualizar itens de trabalho do Office
• Conflitos de instalação: problemas decorrentes da instalação do Office e do Visual Studio em pedidos diferentes

Este artigo fornece soluções passo a passo para os problemas mais comuns de integração do Office do Azure DevOps. Antes de solucionar problemas, verifique se você tem os pré-requisitos necessários e entenda o estado atual do suporte à integração do Office.

Instalar a integração do Azure DevOps 2019

Essa ferramenta permite que você se conecte ao Azure Boards do Excel. Para instalar a ferramenta Azure DevOps Integration 2019, siga estas etapas:

1. Baixe a ferramenta Azure DevOps Office Integration 2019 .

2. Instale a ferramenta executando o arquivo baixado.

3. Reinicie o Excel para ver a faixa de opções Equipe.

Se você ainda não vê o menu de faixa Equipe, execute as etapas nas seções a seguir.

Habilitar o suplemento do Azure DevOps

1. No Excel, selecione Arquivo>Opções.

2. Selecione Add-ins>Suplementos COM no Gerenciar menu suspenso >Ir.

   

3. Verifique se há uma marca na caixa Suplemento do Team Foundation.

   

4. Reinicie o Excel.

A faixa de opções Equipe é exibida.

Se a faixa de opções Equipe não aparecer na próxima inicialização, o comportamento de carregamento do complemento pode ser alterado, então siga estas próximas etapas.

Atualizar o Registro

1. Inicialize o Editor do registro no Menu Iniciar do Windows inserindo regedit na caixa Pesquisar ou Executar.

   

2. Navegue até um dos seguintes caminhos que contêm a pasta TFCOfficeShim.Connect.[version]:

   Note

   Se houver várias pastas com o mesmo nome, selecione aquela com o número de versão mais alto.

   • HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Excel\Addins (se essa chave não existir, tente uma das opções a seguir)

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

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

   

3. Selecione duas vezes para abrir LoadBehavior e defina o campo de dados do valor como 3. Se o valor for 0 a faixa de opções Equipe não será carregada.

4. Selecione OK e reinicie o Excel.

   Para saber mais sobre a entrada LoadBehavior, confira Entradas do Registro para Suplementos VSTO, valores LoadBehavior.

Verificar se o suplemento está desabilitado

1. No menu Arquivo do Excel, escolha Opções.

2. Escolha Suplementos e, no menu suspenso Gerenciar selecione Itens desativados>Ir.

   

3. Se você vir Azure DevOps Add In na lista, escolha-o e selecione Habilitar.

   

O suplemento do Office não é carregado ou aberto no Excel quando o Visual Studio falha

Para se conectar ao Azure Boards, acesse a faixa de opções Equipe e escolha Nova Lista. Caso a caixa de diálogo Nova Lista não seja aberta ou caso você receba a mensagem de erro TF86001 ou semelhante, talvez seja preciso reparar o Visual Studio.

Esse erro geralmente ocorre quando o Visual Studio é instalado antes do Office Excel ou do Project. Nesse caso, o Visual Studio Tools for Office Runtime não está configurado corretamente. Para corrigir esse erro, repare a instalação do Visual Studio.

Prerequisites

Instale o Visual Studio para garantir que você tenha acesso ao Prompt de Comando do Visual Studio e ao Gacutil.exe (Ferramenta de Cache de Assemblies Globais). Se você não tem o Visual Studio, pode instalar a Edição Visual Studio Community gratuitamente.

Executar a ferramenta Gacutil

1. Abra o Prompt de Comando do Visual Studio e escolha executá-lo como administrador.

   

2. Execute os seguintes comandos com base no seu 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 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 <\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. Depois de executar com êxito os comandos GACUTIL, reinicie o Excel e procure o suplemento Ferramenta de Integração do Azure DevOps para Office.

Se as etapas anteriores não ajudarem, tente as próximas etapas:

1. Oficina de Reparos
2. Desinstale o Office e reinstale-o.
3. Entre em contato com a Microsoft por meio da Comunidade de Desenvolvedores.

O usuário não pode entrar no Azure DevOps por meio do Excel após a alteração de senha

Se você alterou a senha de rede e começa a receber erros de autenticação com as novas informações de conta, esse pode ser um problema conhecido. O token armazenado no Visual Studio não é mais válido, mas o sistema não reconhece a necessidade de atualizá-lo. Você não precisa tomar nenhuma ação; O token expira eventualmente e a autenticação começa a funcionar novamente, embora o atraso seja imprevisível. Use a solução alternativa a seguir para remover o token manualmente.

Remover o token do Registro

1. Feche todas as instâncias abertas do Excel.

2. Salve e limpe o caminho do Registro executando os seguintes comandos em um Prompt de Comando com privilégios elevados (executado 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 o Excel e ele solicitará a entrada ao se conectar ao Azure DevOps.

Aguarde até que o token expire ou exclua essa chave do Registro sempre que uma senha for alterada, caso ela esteja configurada de uma forma que cause esse problema.

Problemas intermitentes ao atualizar e publicar

Se você receber um erro durante a atualização ou publicação, pode haver uma Política de Acesso Condicional na ID do Microsoft Entra. Para resolver esse problema, limpe o conteúdo da pasta: %LOCALAPPDATA%\.IdentityService.

Não é possível converter o objeto COM do tipo Microsoft.Office.Interop.Excel.ApplicationClass

Você pode receber uma mensagem de erro ao abrir uma lista de itens de trabalho no Excel, acionada pelo Team Explorer. Para obter mais informações, confira Como resolver “Não é possível converter o objeto COM do tipo Microsoft.Office.Interop.Excel.ApplicationClass” no tipo de interface ‘Microsoft.Office.Interop.Excel._Application’”.

Resolver conflitos de dados ao publicar ou atualizar dados do Excel

Um conflito de dados ocorre quando você tenta publicar um item de trabalho do excel e a versão desse item de trabalho difere da versão no banco de dados do item de trabalho. O exemplo a seguir mostra como dois membros da equipe podem criar esse conflito:

1. Um membro da equipe abre uma cópia de um item de trabalho em uma lista de itens de trabalho no Excel ou no Project.
2. O membro da equipe A edita o item de trabalho e faz um conjunto de alterações.
3. O membro da equipe B edita o mesmo item de trabalho e faz um conjunto diferente de alterações e publica essas alterações.
4. O membro da equipe A termina de editar o item de trabalho e tenta publicar as alterações no item de trabalho.
5. O Excel ou o Project exibe a caixa de diálogo Erros de Publicação de Item de Trabalho, que mostra os itens que ele não pôde publicar.

Resolver um conflito de dados

1. Na caixa de diálogo Erros de Publicação de Item de Trabalho, para cada item de trabalho na caixa Itens de trabalho não publicados que tem Conflito na coluna Problema, siga estas etapas.
2. Na caixa itens de trabalho não publicados, selecione o item de trabalho.
   A área Detalhes mostra uma lista de conflitos para o item de trabalho selecionado. A coluna Campo conflitante mostra o nome do campo no qual o conflito ocorre. As colunas de versão local e Server mostram os dados locais e do servidor, respectivamente, e uma caixa de seleção aparece ao lado dos dados em cada uma dessas colunas.
3. Para cada linha na caixa Detalhes, selecione a caixa de seleção ao lado do valor correto.
   Quando você seleciona a versão local, os dados no Office Excel ou no Office Project substituem os dados no servidor. Se você selecionar a versão do servidor, os dados do servidor substituirão os dados no Office Excel ou no Office Project.
4. Selecione Publicar.

Resolver erros de validação de dados que ocorrem quando você publica do Excel

Um erro de validação de dados ocorre quando uma alteração na lista de itens de trabalho ou no plano de projeto viola a regra de um tipo de item de trabalho. Os exemplos a seguir mostram erros comuns de validação de dados:

• Alguém atribui um item de trabalho a um membro da equipe cujo nome não está incluído na lista de valores permitidos
• Alguém cria um item de trabalho, mas esquece de concluir um campo necessário, como o tipo de item de trabalho.

Se ocorrer um erro de validação de dados ao tentar publicar alterações, a caixa de diálogo Erros de Publicação de Item de Trabalho será exibida e, na lista de itens de trabalho não publicados, a coluna Problema mostra Erro de validação ou outra frase que contém Inválido.

Resolver um erro de validação de dados

Você pode usar a caixa de diálogo Erros de Publicação de Item de Trabalho para resolver um erro de validação de dados.

1. Na caixa de diálogo Erros de Publicação de Item de Trabalho, para cada item de trabalho que aparece com um erro de validação de dados, siga estas etapas.

   Note

   Se o erro de validação de dados for um tipo de item de trabalho inválido, o botão Editar Item de Trabalho não estará visível e um formulário de item de trabalho não será exibido. Você deve corrigir o erro na planilha do Office Excel ou no plano do Projeto do Office. Para obter informações sobre como resolver um erro no Office Excel, consulte o próximo procedimento neste artigo.

2. Na caixa Itens de trabalho não publicados, selecione o item de trabalho e clique em Editar Item de Trabalho.

   Um formulário de item de trabalho será exibido.

3. No formulário do item de trabalho, examine as informações e corrija o valor.

4. Selecione Fechar para salvar as alterações e fechar o formulário do item de trabalho.

5. Depois de corrigir os erros de validação de dados, selecione Publicar para publicar os itens de trabalho corrigidos.

   Note

   Esta etapa publica apenas os itens de trabalho que você corrigiu. Se você não resolver um erro de validação de dados, esse item de trabalho não será publicado.

6. Selecione Fechar para fechar a caixa de diálogo Erros de Publicação de Itens de Trabalho.

Resolver um erro de validação de dados usando a verificação de erros no Excel

Você pode usar as ferramentas do Office Excel para localizar e resolver um erro em uma lista de itens de trabalho. Para obter mais informações sobre como usar as ferramentas de verificação de erros do Office Excel, consulte a Ajuda do Office Excel.

Resolver um erro de validação de dados usando a verificação de erros no Excel 2007

1. No Microsoft Excel, selecione a guia Fórmulas.
2. No grupo Auditoria de Fórmulas, selecione Verificação de Erros.
   Se a ferramenta de verificação de erros encontrar um erro, a caixa de diálogo de Verificação de Erros será exibida.
3. Para obter informações básicas sobre o erro, consulte o texto que descreve o erro na caixa de diálogo Verificação de Erro. Para obter mais informações sobre o erro, selecione Ajuda neste erro.
4. Na lista de itens de trabalho, selecione a célula que contém o erro e corrija o valor.
5. Na caixa de diálogo Verificação de Erros, selecione Retomar para localizar o próximo erro de validação de dados.
   • Se a caixa de diálogo Verificação de Erro mostrar outro erro, repita as duas etapas anteriores para resolver o erro.
   • Se aparecer uma mensagem que indique a verificação de erros concluída, selecione OK para fechar essa mensagem e a caixa de diálogo de Verificação de Erros do.

Resolver TF80070: ocorreu um erro ao executar a operação

O erro TF80070 normalmente ocorre devido a conflitos de vinculação de assembly entre diferentes versões da biblioteca Newtonsoft.Json usada pela integração com Azure DevOps Office e outros aplicativos que estão instalados.

Sintomas

Você pode encontrar esse erro ao:

• Tentar se conectar ao Azure DevOps do Excel
• Abrir ou atualizar listas de itens de trabalho no Excel
• Publicar alterações do Excel no Azure DevOps

Resolução

Resolva esse problema criando um arquivo de configuração que redireciona associações de assembly para a versão correta da biblioteca Newtonsoft.Json.

1. Localize a pasta de instalação do Excel. Os caminhos típicos são:

   • 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. Crie um novo arquivo de texto na pasta de instalação do Excel e nomeie-o excel.exe.config.

   Important

   Você precisa de privilégios de administrador para criar arquivos no diretório de instalação do Office. Clique com o botão direito do mouse no Bloco de Notas e selecione Executar como administrador antes de criar o arquivo.

3. Adicione o seguinte conteúdo XML ao excel.exe.config arquivo:

   <?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. Salve o arquivo e verifique se o nome é exatamente excel.exe.config (não excel.exe.config.txt).

5. Feche todas as instâncias do Excel e reinicie o Excel.

6. Teste a conexão tentando se conectar ao Azure DevOps do Excel novamente.

Se o problema persistir depois de concluir as etapas anteriores de solução de problemas, considere reparar o perfil do usuário e verificar se há arquivos do sistema corrompidos.

1. Abra o Prompt de Comando ou o PowerShell como Administrador.

2. Execute a ferramenta DISM para reparar a imagem do Windows:

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   

3. Após a conclusão do DISM, execute o Verificador de Arquivos do Sistema:

   sfc /scannow
   

Usar IA para solucionar problemas de integração do Office

O prompt de exemplo a seguir para o Copilot Chat ajuda você a solucionar problemas de integração do Azure DevOps e do Office. Copie e cole esse prompt no Copilot Chat, substituindo os espaços reservados por suas informações específicas.

Para obter a melhor assistência de IA, inclua detalhes específicos, como a mensagem de erro exata, a versão do Office, o status do suplemento do Azure DevOps e se a faixa de opções do Team está visível em seus aplicativos do 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 é alimentado pela IA, portanto, surpresas e erros são possíveis. Para obter mais informações, consulte perguntas frequentessobre uso geral do Copilot.

Conteúdo relacionado

• Modificar itens de trabalho em massa (portal da Web)
• Importar ou atualizar itens de trabalho em massa usando arquivos CSV
• Perguntas Frequentes: trabalho no Excel conectado ao Azure Boards
• Adicionar ou remover suplementos