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

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.

Observação

A integração do Azure DevOps Office é completa, sem planos para atualizações ou melhorias. Os investimentos futuros se concentram 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 pré-requisitos, consulte Azure Boards e integração com o Office.

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:

• Planos de Entrega
• Extensões do Marketplace, como o Project Connect ou o gráfico GANTT.

Instalar a integração do Azure DevOps 2019

Essa ferramenta permite que você se conecte ao Azure Boards 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 Equipe.

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

Habilitar o suplemento do Azure DevOps

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

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

   

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

   

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.

   

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

   

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.

   

3. Se você vir Azure DevOps Add In na lista, escolha-o e selecione Habilitar.

   

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.

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 TF30063, consulte 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 Assemblies Globais). 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.

   

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 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. Oficina de Reparos
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’”.

Resolver conflitos de dados ao publicar ou atualizar dados do Excel

Um conflito de dados ocorre quando você tenta publicar um item de trabalho do excel e a versão desse item de trabalho difere da versão no banco de dados do 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 o mesmo item de trabalho e faz um conjunto diferente de alterações e publica essas alterações.
4. O membro da equipe A termina de editar o item de trabalho e tenta publicar as alterações no item de trabalho.
5. O Excel ou o Project exibe a caixa de diálogo Erros de Publicação de Item de Trabalho, que mostra os itens que ele não pôde 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 tem 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 Campo conflitante mostra o nome do campo no qual o conflito ocorre. As colunas de versão local e Server 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 Detalhes, selecione a caixa de seleção ao lado do valor correto.
   Quando você seleciona a versão local, os dados no Office Excel ou no Office Project substituem 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.

Observação

Esta etapa publica apenas os itens de trabalho que você corrigiu. 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 você publica 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 concluir um campo necessário, como o tipo de item de trabalho.

Se ocorrer um erro de validação de dados ao tentar publicar alterações, a caixa de diálogo Erros de Publicação de Item de Trabalho será exibida e, na lista de itens de trabalho não publicados, a coluna Problema mostra Erro de validação ou outra frase que contém 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.

   Observação

   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 Projeto do Office. 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 clique em Editar Item de Trabalho.

   Um formulário de item de trabalho será exibido.

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

4. Selecione Fechar para salvar as alterações e fechar o formulário do item de trabalho.

5. Depois de corrigir os erros de validação de dados, selecione Publicar para publicar os itens de trabalho corrigidos.

   Observação

   Esta etapa publica apenas os itens de trabalho que você corrigiu. 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 Itens 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 de 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 Erro. Para obter mais informações sobre o erro, selecione Ajuda neste 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 Erro mostrar outro erro, repita as duas etapas anteriores para resolver o erro.
   • Se aparecer uma mensagem que indique a verificação de erros concluída, selecione OK para fechar essa mensagem e a caixa de diálogo de Verificação de Erros do.

Artigos relacionados

• Modificar itens de trabalho em massa (portal da Web)
• Importar ou atualizar itens de trabalho em massa usando arquivos CSV
• Perguntas Frequentes: trabalho no Excel conectado ao Azure Boards
• Adicionar ou remover suplementos