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

Azure DevOps Serviços | 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. Esta integração baseia-se no complemento Azure DevOps Office Integration, que adiciona uma fita Team às suas aplicações do Office.

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

• Faixa da Equipa em Falta: A faixa da equipa Azure DevOps não aparece no Excel nem noutras aplicações do Office
• Add-in não está a carregar: O add-in Azure DevOps não carrega ou é 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 do Visual Studio em ordens diferentes

Este artigo apresenta soluções passo a passo para os problemas de integração mais comuns com 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

Esta ferramenta permite-lhe ligar-se ao Azure Boards a partir do Excel. Para instalar a ferramenta Azure DevOps Integration 2019, siga estes passos:

1. Descarregue a ferramenta Azure DevOps Office Integration 2019.

2. Instale a ferramenta executando o arquivo baixado.

3. Reinicie Excel para ver a fita Team.

Caso ainda não veja o separador Equipa, siga as etapas nas secções a seguir.

Ativar o complemento do Azure DevOps

1. No Excel, selecione File>Options.

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. Reiniciar 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 de Registo a partir do seu Menu Iniciar Windows introduzindo regedit na caixa Pesquisa 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 esta chave não existir, experimente 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 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 Excel File, selecione Options.

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

   

3. Se vires Azure DevOps Add In na lista, escolhe-o e seleciona Enable.

   

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

Para se ligar a Azure Boards, vá à fita Team e escolha Nova Lista. Se o diálogo de Nova Lista não abrir, ou se receber TF86001 ou mensagem de erro semelhante, poderá ser necessário reparar Visual Studio.

Este erro normalmente ocorre quando o Visual Studio é instalado antes do Office Excel ou Project. Neste caso, as ferramentas do Visual Studio para o Office Runtime não estão configuradas corretamente. Para corrigir este erro, repare a sua instalação do Visual Studio.

Prerequisites

Instale Visual Studio para garantir que tem acesso ao Visual Studio Command Prompt e à Gacutil.exe (Global Assembly Cache Tool). Se você não tiver o Visual Studio, pode instalar gratuitamente a edição Visual Studio Community.

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
   Microsoft 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 executares com sucesso os comandos GACUTIL, reinicia Excel e procura 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. Contacte-Microsoft através do Developer Community.

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. Fecha todas as instâncias Excel abertas.

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. Abre o Excel e ele pede para iniciar sessão quando se liga 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 aparecer 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 lançar objeto COM do tipo Microsoft. Office.Interop. Excel. Classe de Aplicação

Podes receber uma mensagem de erro ao abrir uma lista de itens de trabalho no Excel, ativada pelo Team Explorer. Para mais informações, veja Como resolver 'Impossível de lançar objeto COM de tipo Microsoft. Office.Interop. Excel. ApplicationClass' para o tipo de interface 'Microsoft. Office.Interop. Excel._Application.''

Resolve conflitos de dados quando publicas ou atualizas dados no Excel

Ocorre um conflito de dados quando tenta publicar um item de trabalho a partir de Excel e a versão desse item difere da versão na base de dados de itens de trabalho. O exemplo a seguir mostra como dois membros da equipe podem criar esse conflito:

1. Um membro da equipa abre uma cópia de um item de trabalho numa lista de itens de trabalho no 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 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. Excel ou Project mostra a caixa de diálogo <>Erros de Publicação de Itens de Trabalho, que mostra 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 selecionas a versão local, os dados no Office Excel ou Office Project sobrescrevem os dados no servidor. Se selecionares a versão do servidor, os dados do servidor sobrescrevem os dados no Office Excel ou Office Project.
4. Selecione Publicar.

Resolver erros de validação de dados que ocorrem ao publicar 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. Deve corrigir o erro na folha de cálculo do Office Excel ou no plano do Office Project. Para informações sobre como resolver um erro no Office Excel, consulte o procedimento seguinte 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.

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

Pode usar as ferramentas Excel do Office para encontrar e resolver um erro numa lista de trabalho. Para mais informações sobre como usar as ferramentas de verificação de erros do Office Excel, consulte a Ajuda do Office Excel.

Resolva um erro de validação de dados utilizando verificação de erros no Excel 2007

1. No Microsoft Excel, selecione o separador 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 ocorre tipicamente devido a conflitos de ligação de assembly entre diferentes versões da biblioteca Newtonsoft.Json usada pela integração do Azure DevOps Office e pelas outras aplicações instaladas.

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. Localiza a tua 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. Cria um novo ficheiro de texto na pasta de instalação Excel e nomea-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. Fecha todas as instâncias do Excel e reinicia o Excel.

6. Teste a ligação tentando ligar novamente ao Azure DevOps a partir do Excel.

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

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

Para 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 Copilot é alimentado por IA, por isso surpresas e erros são possíveis. Para 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
• FAQs: Trabalho em Excel relacionado com Azure Boards
• Adicionar ou remover suplementos
• Todos os guias de resolução de problemas e perguntas frequentes