Partilhar via

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

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, execute os procedimentos neste artigo para resolver o problema.

Captura de ecrã do friso da Equipa de Integração do Excel e Azure DevOps/Office.

Nota

A integração do Azure DevOps Office é um recurso completo, sem planos para atualizações ou melhorias. Os investimentos futuros centram-se em ferramentas nativas para importação em massa ou atualização de itens de trabalho usando arquivos CSV. Se você encontrar problemas com a integração do Office, considere usar essa 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 Azure DevOps Office. Para obter os pré-requisitos, consulte a integração entre o Azure Boards e o Office.

Importante

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

  • Visual Studio 2019 e Azure DevOps Office Integration 2019.
  • Azure DevOps Server 2019 e versões posteriores, incluindo os Serviços de DevOps do Azure.

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

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.

Caso ainda não veja a barra de ferramentas Equipa, 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.

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

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

    Captura de ecrã da caixa de diálogo Suplementos COM; Suplemento Team Foundation verificado.

  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.

    Captura de ecrã do comando Executar regedit.

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

    Nota

    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

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

    Captura de ecrã de Opções do Excel, Suplementos, Escolher Itens Desativados.

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

    Captura de ecrã da caixa de diálogo de itens desabilitados, Complemento do Azure DevOps selecionado.

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.

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

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.

Nota

Para problemas de autenticação, como TF31003 e TF30063, consulte , a conta de utilizador 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 (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.

    Captura de ecrã do Prompt de Comando do Desenvolvedor do menu Iniciar para VS2015 com a opção '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 <\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 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. Oficina 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 não é mais válido, mas o sistema não reconhece a necessidade de atualizá-lo. 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.

Nota

Esta etapa publica apenas os itens de trabalho corrigidos. Se você não resolver todos os erros de validação de dados relacionados a um item de trabalho, esse item de trabalho não será publicado.

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.

    Nota

    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.

    Nota

    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.