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

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Se a faixa de opções Equipe estiver faltando no Microsoft Excel, conforme mostrado na imagem a seguir, siga os procedimentos deste artigo para resolver o problema.

Captura de tela da faixa de opções da equipe de integração do Excel e do Azure DevOps/Office.

Observação

A integração do Azure DevOps Office é completa, sem planos para atualizações ou melhorias. Os investimentos futuros se concentrarão em ferramentas nativas para importação ou atualização em massa de itens de trabalho usando arquivos CSV. Se você encontrar problemas com a integração do Office, considere usar esta alternativa. Todas as tarefas de integração do Office exigem uma versão instalada do Visual Studio ou o Azure DevOps Office Integration 2019 gratuito, que instala o Suplemento de Integração do Office do Azure DevOps. Para ver os pré-requisitos, confira integração do Office e Azure Boards.

Importante

A integração do Microsoft Project e o comando TFSFieldMapping não são suportados para:

  • Visual Studio 2019 e Azure DevOps Office Integration 2019.
  • Azure DevOps Server 2019 e versões posteriores, incluindo Azure DevOps Services.

O suporte completo para a integração do Microsoft Excel é mantido, permitindo a importação e atualização em massa de itens de trabalho. As alternativas para o Microsoft Project incluem:

Habilitar o suplemento do Azure DevOps

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

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

    Captura de tela da sequência para adicionar o suplemento COM.

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

    Captura de tela da caixa de diálogo Suplementos COM, Suplemento do Team Foundation com marca de seleção.

  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.

    Captura de tela do comando Executar regedit.

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

    Observação

    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

    Captura de tela da entrada LoadBehavior.

  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.

    Captura de tela de opções do Excel, suplementos, escolha itens desativados.

  3. Se você vir "Suplemento do Azure DevOps" na lista, escolha-o e selecione Habilitar.

    Captura de tela da caixa de diálogo de itens desabilitados, suplemento do Azure DevOps marcado.

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.

Mensagem de erro TF86001, o Team Foundation não pôde carregar o Suplemento do Office.

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.

Observação

Para problemas de autenticação, como TF31003 e TF30063consulte A conta de usuário não tem permissão.

Pré-requisitos

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 Assembly Global). 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.

    Captura de tela do Prompt de Comando do Desenvolvedor para o menu Iniciar do VS2015 com 'Executar como administrador

  2. Execute os seguintes comandos com base no seu software:

Software Comandos
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
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
GACUTIL /I C:\Windows\assembly\GAC_MSIL\Policy.12.0.office\14.0.0.0__71e9bce111e9429c\Policy.12.0.Office.dll
  1. 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. Reparar o Office.

  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’”.