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

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Todas as tarefas de integração do Office exigem uma versão instalada do Visual Studio ou a Integração do Office para Azure DevOps 2019 gratuita. O software instala o suplemento Integração do Office para Azure DevOps ou Integração do Office para Team Foundation. Para ver a lista de pré-requisitos, confira Azure Boards e integração do Office.

Se a faixa de opções Equipe não for exibida no Microsoft Excel, conforme mostrado na imagem a seguir, tente resolver o problema com os procedimentos fornecidos neste artigo.

Screenshot of Excel TFS-Office integration Team ribbon.

Importante

Não há suporte para a Integração do Microsoft Project e o comando TFSFieldMapping para:

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

No entanto, o suporte completo para a integração do Microsoft Excel é mantido e dá suporte à importação e atualização em massa de itens de trabalho. As alternativas para o Microsoft Project incluem o seguinte:

Habilitar o suplemento do Azure DevOps

  1. No menu Arquivo do Excel, escolhaOpções.

  2. Escolha Suplementos e, na lista de seleção Gerenciar, escolha Suplementos COM e escolha Ir.

    Screenshot of Excel Options, Add-ins, Choose Com Add-ins.

  3. Verifique se há uma marca na caixa de seleção Suplemento do Team Foundation.

    Screenshot of COM Add-ins dialog, Team Foundation Add-in checked.

  4. Reinicie o Excel. Agora você deve ver a faixa de opções Equipe.

Se a faixa de opções Equipe não for exibida na próxima inicialização, o comportamento de carregamento do suplemento poderá ter sido alterado e você precisará concluir as seguintes etapas:

Atualizar o Registro

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

    Screenshot of Run regedit command.

  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

Screenshot of LoadBehavior entry.

  1. Clique duas vezes para abrir LoadBehavior e defina o campo de dados de valor como 3 (se o valor for 0, a faixa de opções Equipe não será carregada).

  2. Selecione OK e reinicie o Excel.

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

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.

TF86001 error message, Team Foundation was unable to load the Office Add-in.

Esse erro normalmente é causado quando você instala o Visual Studio antes de instalar o Office Excel ou o Project. Nesse caso, o Visual Studio Tools for Office Run Time não está configurado corretamente. Para corrigir esse erro, você deve reparar o Visual Studio.

Observação

Para problemas de autenticação, como TF31003 e TF30063, confira 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.

    Screenshot of Developer Command Prompt for VS2015 start menu with 'Run as administrator

  2. Para o Microsoft 365, execute os seguintes comandos:

    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

    Para o Office 2016 e o Office 2013, execute os seguintes comandos:

    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

    Para o Office 2010, execute os seguintes comandos:

    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

  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 acima não forem bem-sucedidas, tente as seguintes etapas:

  1. Execute um reparo completo do Office.

  2. Desinstale o Office e reinstale-o.

  3. Contate a equipe de suporte da Microsoft.

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

Se um usuário 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 que ele precisa ser atualizado. O usuário não precisa executar nenhuma ação, o token expira após algum tempo e a autenticação começa a funcionar novamente, mas não há como estimar o atraso. 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. Esses comandos podem ser executados no prompt de comando aberto com a opção “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 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 um usuário obtém erros ao fazer uma atualização ou uma publicação, o motivo pode ser uma política de acesso condicional no Microsoft Entra ID. Para resolver esse problema, experimente limpar o conteúdo da pasta %LOCALAPPDATA%\.IdentityService.

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

Você poderá receber uma mensagem de erro ao tentar abrir uma lista de itens de trabalho do TFS no Excel, disparada do 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’”.