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

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

Azure DevOps integra-se com aplicativos 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 Team aos seus aplicativos do Office.

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

• Missing Team ribbon: a faixa de opções do Azure DevOps Team não aparece no Excel ou em outros aplicativos do Office
• Complemento não carregando: o complemento Azure DevOps não carrega ou está desativado
• 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 Visual Studio em ordens diferentes

Este artigo fornece soluções passo a passo para os problemas de integração mais comuns do Office com o 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 o Azure DevOps Integration 2019

Essa ferramenta permite que você se conecte ao Azure Boards a partir 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 Excel para ver a faixa de opções Team.

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

Ativar o complemento Azure DevOps

1. Em Excel, selecione File>Options.

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 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. Inicie 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 seguintes opções)

   • 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 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 Excel File, selecione Options.

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

   

3. Se você vir Azure DevOps Adicionar na lista, escolha-a e selecione Enable.

   

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

Para se conectar ao Azure Boards, acesse a faixa de opções Team e escolha New List. Se a caixa de diálogo Nova Lista não for aberta ou você receber TF86001 ou mensagem de erro semelhante, talvez seja necessário reparar Visual Studio.

Esse erro geralmente ocorre quando Visual Studio é instalado antes do Office Excel ou Project. Nesse caso, as ferramentas de Visual Studio para Office Runtime não estão configuradas corretamente. Para corrigir esse erro, repare a instalação do Visual Studio.

Prerequisites

Instale Visual Studio para garantir que você tenha acesso ao Prompt de Comando do Visual Studio e ao Gacutil.exe (Ferramenta de Cache de Assembly Global). Se você não tiver Visual Studio, instale a edição Visual Studio Community gratuitamente.

Executar a ferramenta Gacutil

1. Abra o prompt de comando 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 pelo suplemento Azure DevOps Integration Tool 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 Microsoft por meio do Developer Community.

O usuário não pode entrar no Azure DevOps do Excel após a alteração da 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 em 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 de Excel abertas.

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á o login 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, poderá haver uma Política de Acesso Condicional no Microsoft Entra ID. Para resolver esse problema, limpe o conteúdo da pasta: %LOCALAPPDATA%\.IdentityService.

Não é possível lançar 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, disparada do Team Explorer. Para obter mais informações, consulte Como resolver "Não é possível converter o objeto COM do tipo Microsoft. Office.Interop. Excel. ApplicationClass' para o tipo de interface 'Microsoft. Office.Interop. Excel._Application''

Resolver conflitos de dados ao publicar ou atualizar dados Excel

Um conflito de dados ocorre quando você tenta publicar um item de trabalho de 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 em Excel ou 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. Excel ou Project exibe a caixa de diálogo Work Item Publishing Errors, que mostra os itens que 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 de 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 de Project 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 erro 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 erro no Excel 2007

1. Em Microsoft Excel, selecione a guia Formulas.
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 associação de assembly entre diferentes versões da biblioteca Newtonsoft.Json usadas pela integração do Office do Azure DevOps e outros aplicativos instalados.

Sintomas

Você pode encontrar esse erro ao:

• Tentar se conectar a Azure DevOps de Excel
• Abrir ou atualizar listas de itens de trabalho no Excel
• Publicar alterações de Excel para 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 sua pasta de instalação 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 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 de Excel e reinicie Excel.

6. Teste a conexão tentando se conectar a Azure DevOps de 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 de 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 Copilot Chat ajuda a solucionar problemas de Azure DevOps e integração do Office. Copie e cole este prompt no Copilot Chat, substituindo os marcadores de posição 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 da Equipe 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 mais informações, consulte as perguntas frequentes sobre o 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
• FAQs: trabalhar no Excel conectado ao Azure Boards
• Adicionar ou remover suplementos
• Todos os guias de solução de problemas e perguntas frequentes