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

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

O Azure DevOps integra-se com aplicações do Microsoft Office, principalmente Excel e Project, para permitir a edição em massa e a gestão de itens de trabalho. Essa integração depende do suplemento Integração do Office do Azure DevOps, que adiciona uma faixa de opções de equipe aos seus aplicativos do Office.

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

• Friso Equipa em falta: O friso Equipa de DevOps do Azure não aparece no Excel ou noutras aplicações do Office
• Suplemento não carregando: o suplemento 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 ordens diferentes

Este artigo fornece soluções passo a passo para os problemas mais comuns de integração do Azure DevOps Office. Antes de solucionar problemas, verifique se você tem os pré-requisitos necessários e entende 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 o Excel para ver a faixa de opções Equipa.

Se você ainda não vir a faixa de opções Equipe , siga as etapas nas seções a seguir.

Habilitar o complemento Azure DevOps

1. No Excel, selecione Opções de arquivo>.

2. Selecione Add-ins>Add-ins COM no menu Gerir dropdown >Ir.

   

3. Certifique-se de que há uma seleção na caixa Suplemento Team Foundation.

   

4. Reinicie o Excel.

A Faixa de opções da Equipe é exibida.

Se a faixa de opções Equipe não aparecer na próxima inicialização, o comportamento de carregamento do suplemento poderá ser alterado, então siga os próximos passos.

Atualizar o registo

1. Inicie o Editor do Registro no Menu Iniciar do Windows digitando regedit a caixa Pesquisar ou Executar.

   

2. Vá para um dos seguintes caminhos que contêm o TFCOfficeShim.Connect.[ versão] pasta:

   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 da Equipe não será carregada.

4. Selecione OK e reinicie o Excel.

   Para obter mais informações sobre a entrada LoadBehavior, consulte Entradas do Registro para suplementos VSTO, valores de LoadBehavior.

Verificar se o suplemento está desativado

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

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

   

3. Se você vir Adicionar do Azure DevOps na lista, escolha-o e selecione Ativar.

   

O suplemento do Office não carrega nem abre no Excel quando o Visual Studio falha

Para se conectar aos Quadros do Azure, vá para a Faixa de Opções Equipe e escolha Nova Lista. Se a caixa de diálogo Nova lista falhar ao abrir ou se você receber TF86001 mensagem de erro ou semelhante, talvez seja necessário reparar o Visual Studio.

Este erro geralmente ocorre quando o Visual Studio é instalado antes do Office Excel ou 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 (Global Assembly Cache Tool). Se você não tiver o Visual Studio, poderá instalar o Visual Studio Community Edition gratuitamente.

Execute 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
   Escritório 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 os GACUTIL comandos com êxito, reinicie o Excel e procure o complemento Azure DevOps Integration Tool for Office.

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

1. Escritório de Reparação.
2. Desinstale o Office e, em seguida, reinstale o Office.
3. Entre em contato com a Microsoft por meio da Comunidade de desenvolvedores.

O utilizador não consegue iniciar sessão no Azure DevOps a partir do Excel após a alteração da palavra-passe

Se alterou a palavra-passe da rede e começou a receber erros de autenticação com as novas informações da conta, poderá estar a ter um problema conhecido. O token armazenado no Visual Studio já não é válido, mas o sistema não reconhece a necessidade de o atualizar. Você não precisa tomar nenhuma medida; O token expira eventualmente, e a autenticação começa a funcionar novamente, embora o atraso seja imprevisível. Use a seguinte solução alternativa para remover manualmente o token.

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 de um prompt de comando elevado (executar 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 solicita entrada quando se conecta ao Azure DevOps.

Aguarde até que o token expire ou exclua essa chave reg sempre que uma senha for alterada, se 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 no Microsoft Entra ID. Para resolver esse problema, limpe o conteúdo da pasta: %LOCALAPPDATA%\.IdentityService.

Não é possível converter 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 a partir do Team Explorer. Para obter mais informações, consulte Como resolver 'Não é possível converter 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 do Excel

Um conflito de dados ocorre quando você tenta publicar um item de trabalho de do Excel e a versão desse item de trabalho difere da versão no banco de dados de 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 esse mesmo item de trabalho e faz um conjunto diferente de alterações, além de publicá-las.
4. O membro da equipe A conclui a edição do item de trabalho e tenta publicar as alterações no item de trabalho.
5. O Excel ou Project exibe a caixa de diálogo Erros de Publicação de Item de Trabalho, que mostra os itens que não foi possível 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 tenha 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 Conflito mostra o nome do campo no qual o conflito ocorre. As colunas Versão Local e Versão do Servidor 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 de detalhes , marque a caixa de verificação ao lado do valor correto.
   Quando você seleciona a versão local, os dados no Office Excel ou no Office Project sobrescrevem 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 publica a partir 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 preencher um campo obrigatório, como o tipo de item de trabalho.

Se ocorrer um erro de validação de dados quando tenta publicar alterações, a caixa de diálogo Erros de Publicação de Item de Trabalho será exibida e, na lista Itens de Trabalho Não Publicados, a coluna Problema mostrará Erro de Validação ou outra frase que contenha 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 Office Project. 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, em seguida, selecione Editar item de trabalho.

   Um formulário de item de trabalho é exibido.

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

4. Selecione Fechar para salvar as alterações e fechar o formulário de 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 corrigidos. 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 Item 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 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 Erros. Para obter mais informações sobre o erro, selecione Ajuda sobre este 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 Erros mostrar outro erro, repita as duas etapas anteriores para resolver o erro.
   • Se aparecer uma mensagem indicando que a verificação de erros foi concluída, selecione OK para fechar essa mensagem e a caixa de diálogo Verificação de Erros.

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 do Azure DevOps Office e outros aplicativos instalados.

Sintomas

Poderá encontrar este erro quando:

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

Resolução

Resolva esse problema criando um arquivo de configuração que redireciona ligaçõ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. Guarde o ficheiro e certifique-se de que 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 de solução de problemas anteriores, considere reparar o perfil do usuário e verificar se há arquivos de 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
   

Use IA para resolver problemas de integração com o Office

O seguinte exemplo de prompt para o Copilot Chat ajuda-o a resolver problemas de integração com Azure DevOps e Office. Copie e cole este prompt no Copilot Chat, substituindo os espaços reservados pela sua informação específica.

Para obter a melhor assistência em IA, inclua detalhes específicos como a mensagem de erro exata, a versão do Office, o estado do add-in do Azure DevOps e se a fita Team é visível nas suas aplicações 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.

O copiloto é alimentado por IA, por isso surpresas e erros são possíveis. Para obter mais informações, consulte Perguntas frequentes sobre o uso geral do Copilot.

Conteúdo relacionado

• Modificar em massa itens de trabalho (portal online)
• Importar ou atualizar itens de trabalho em massa com os ficheiros CSV
• Perguntas frequentes: Trabalhar no Excel conectado aos Painéis do Azure
• Adicionar ou remover suplementos