Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Serviços Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Important
O suplemento de integração do Azure DevOps Office não tem mais suporte e pode não funcionar com versões atuais do Office ou navegadores. A Microsoft não fornece atualizações nem correções para este suplemento. Para operações de item de trabalho em massa, use a funcionalidade de importação/exportação do CSV, que é a abordagem recomendada e suportada.
Note
Este artigo aborda o suplemento de integração legado do Azure DevOps para o Office. Para novos fluxos de trabalho em massa, use importação/exportação de CSV ou modificação em massa de itens de trabalho no portal da Web. As etapas a seguir são para equipes que ainda dependem de fluxos de trabalho baseados em Excel.
Para dar suporte a fluxos de trabalho de acompanhamento de trabalho herdados, você pode usar Microsoft Excel para adicionar ou atualizar itens de trabalho. Você pode trabalhar no modo online (conectado a Azure Boards ou Azure DevOps Server) ou no modo offline (em uma cópia local do documento).
Tip
Você pode usar a IA para ajudar nessa tarefa mais adiante neste artigo ou consulte Ativar a assistência de IA com o Azure DevOps Server MCP para começar.
Clientes do Office com suporte e versões de Azure DevOps
A tabela a seguir mostra o suporte do cliente do Office por versão do Azure DevOps/Visual Studio.
Não há suporte para macOS. Mesmo que você tenha instalado Visual Studio para Mac, não há suporte para a conexão com Azure DevOps do Excel ou de qualquer outro cliente do Office.
| versão Azure DevOps/Visual Studio | Excel | Integração de projeto | Criação de storyboard no PowerPoint | Observações |
|---|---|---|---|---|
| Azure DevOps Services Azure DevOps Server 2020 Visual Studio 2022 Visual Studio 2019 Azure DevOps Office Integration 2019 |
✅ Suportado | ❌ Sem suporte | ❌ Sem suporte | A integração de projeto e TFSFieldMapping estão obsoletos. A vinculação de dentro de PowerPoint foi preterida, mas você ainda pode adicionar um link do Storyboard de dentro de um item de trabalho. |
| Visual Studio 2017 (herdado) | ✅ Suportado | ✅ Suportado | ✅ Suportado | Suporte apenas para sistemas legados. |
Prerequisites
| Categoria | Requisitos |
|---|---|
| Programas de computador | - Microsoft Excel 2016 ou posterior, incluindo versões Microsoft 365. - Visual Studio ou o Azure DevOps Office Integration 2019 gratuito. - O plug-in de Integração do Office do Azure DevOps (instalado com o Visual Studio ou com o Azure DevOps Office Integration 2019). |
| Baixar Azure DevOps Office Integration 2019 | - Vá para Visual Studio Downloads. - Role para Todos os Downloads. - Expanda Outras Ferramentas, Frameworks e Redistribuíveis. - Localize Azure DevOps Office Integration 2019 e selecione Baixar. - Se você não conseguir localizar o download ou não tiver acesso, entre com um conta Microsoft ou entre em contato com o administrador. |
| Permissões | - Acesso de membro do projeto para se conectar a um projeto do Azure Boards. |
| Projeto | - Um projeto Azure Boards. Se você não tiver um, consulte Criar um projeto. |
Para obter informações sobre requisitos de compatibilidade, consulte Azure DevOps compatibilidade do cliente.
Limitações e problemas conhecidos
O suplemento de integração do Office para o Azure DevOps é anterior à autenticação moderna do Microsoft 365, e a Microsoft não o mantém mais ativamente. Espere estas limitações:
- Autenticação moderna: O Acesso Condicional, a MFA (autenticação multifator) e as políticas de conformidade do dispositivo podem bloquear a entrada. Se a entrada interativa falhar, entre no cliente do Office com a mesma conta usada para Azure DevOps antes de abrir a planilha.
- PATs (tokens de acesso pessoal): Alguns cenários solicitam um PAT em vez de uma entrada interativa. PATs são credenciais de longa duração, portanto evite-as quando possível. Use tokens do Microsoft Entra quando houver suporte. Se você precisar usar um PAT, consulte Usar tokens de acesso pessoal.
- Microsoft 365 (web) e macOS: O complemento funciona somente no Office para desktop no Windows. Excel para a Web e Office para Mac não dão suporte a esse suplemento.
- Agentes hospedados e automação: O suplemento dá suporte apenas ao uso interativo. Ele não oferece suporte a cenários não assistidos ou baseados em pipeline. Em vez disso, use a API REST Azure DevOps.
- Conjuntos de dados grandes: Publicar ou atualizar milhares de itens de trabalho em uma única planilha pode expirar. Divida o trabalho entre planilhas ou use a importação/exportação de arquivos CSV.
Para alternativas com suporte, consulte Modificar em massa itens de trabalho no portal da Web e Importar ou atualizar em massa itens de trabalho usando arquivos CSV.
Publicar e atualizar itens de trabalho
Quando você trabalha em Excel, edita uma cópia local dos dados do item de trabalho.
Use estas ações para permanecer sincronizado:
- A atualização baixa os valores mais recentes de Azure Boards em sua planilha.
- Publicar envia as alterações da planilha para o Azure Boards.
A princípio, sua planilha e o Azure Boards correspondem. Com o tempo, outros usuários ou processos podem alterar os mesmos itens de trabalho. Para evitar conflitos e edições obsoletas, use este ritmo:
- Atualize quando abrir o arquivo.
- Faça algumas pequenas edições.
- Publicar as alterações.
- Atualize novamente, especialmente durante sessões mais longas.
Repita esse ciclo durante toda a sessão.
Azure DevOps e Excel
O diagrama a seguir mostra a sincronização bidirecional entre Excel e Azure DevOps:
- Excel publica edições locais para Azure DevOps.
- O Excel é atualizado para obter atualizações no servidor.
Para obter o fluxo de trabalho de Excel completo, consulte Adicionar itens de trabalho em massa com Excel.
Conectar um projeto Azure DevOps ao Excel
Para adicionar ou modificar itens de trabalho em Excel, primeiro conecte sua planilha a um projeto de Azure DevOps.
Note
- Esta seção mostra Excel etapas para Azure Boards. PowerPoint usa um fluxo de conexão semelhante.
- No Azure DevOps Services, o portal seleciona automaticamente a Coleção de Projetos de Equipe. Em Azure DevOps Server, selecione a coleção antes de selecionar o projeto.
Escolha um caminho de conexão:
- Portal da Web
- Excel cliente (nuvem)
- cliente do Excel (local)
- Visual Studio/Team Explorer
Sua planilha se conecta como uma lista de entradas (lista manual) ou uma lista de consultas (resultados salvos da consulta).
Esse método de conexão requer a extensão do Marketplace Azure DevOps Open in Excel e o Visual Studio 2017 ou posterior.
No navegador, confirme se o projeto correto está selecionado e, em seguida, acesse Quadros>Consultas>Todos.
Selecione a consulta que você deseja abrir no Excel.
Na guia Resultados, selecione o
ícone de ações e, em seguida, selecione Abrir em Excel.
Tip
Você pode usar várias planilhas em uma pasta de trabalho do Excel para trabalhar com diferentes listas de entrada ou consulta. Você só pode se conectar a um projeto por pasta de trabalho.
Se você mover seu projeto Azure DevOps para uma coleção de projetos diferente na mesma instância Azure DevOps Server, seus documentos se reconectarão automaticamente. Se o projeto passar para uma instância de Azure DevOps Server diferente, você deverá reconectar manualmente seus documentos ao novo servidor.
Trabalhe offline e reconecte-se ao Azure Boards
Você pode trabalhar offline em Excel para adicionar ou atualizar itens de trabalho e, em seguida, reconectar e sincronizar mais tarde.
Note
Se o projeto for transferido para uma organização diferente do Azure DevOps ou para uma instância do Azure DevOps Server, reconfigure a conexão com o documento. Para ver as etapas, consulte Conectar o projeto do Azure DevOps ao Excel.
Desconectar um arquivo de documento da rede
Antes de se desconectar, prepare sua planilha:
Abra o documento que você deseja editar offline.
Obtenha as atualizações mais recentes. Em Excel, na faixa de opções equipe, no grupo Itens de Trabalho, selecione Atualizar.
Adicione todas as colunas que você planeja editar. Você não pode adicionar colunas depois de desconectar.
Desconecte o computador da rede ou salve o arquivo da lista de itens de trabalho e copie-o para outro computador.
O Office pode mostrar um erro de conexão depois que você se desconectar.
Modifique ou atualize a lista de itens de trabalho conforme necessário.
Embora esteja offline, você não pode criar a maioria dos tipos de vínculo entre itens de trabalho. As relações pai-filho em uma lista em árvore do Excel são a exceção.
Reconectar um arquivo ao Azure Boards
Quando você estiver online novamente, ressincronizará seu arquivo:
Reconecte seu computador à rede ou copie o arquivo para um computador conectado ao Azure Boards.
Se você alterou o arquivo offline, em Excel, na faixa de opçõesequipe, no grupo Itens de Trabalho, selecione Publicar.
Se você não fez alterações offline, selecione Atualizar .
Resolva quaisquer erros ou conflitos de validação.
Extensões do Marketplace
Essas extensões do Marketplace dão suporte a cenários de integração Azure DevOps e Microsoft 365:
-
Abre os resultados da consulta ou os itens de trabalho selecionados em Excel no portal da Web para edição e análise em massa.
- Publisher: Microsoft DevLabs
- Requisitos: Microsoft Excel e o Visual Studio ou o cliente de Integração do Office do Azure DevOps
- Compatibilidade: serviços Azure DevOps e Azure DevOps Server
-
Envia notificações de ganchos de serviço do Azure DevOps (por exemplo, compilação, envio de código e eventos de itens de trabalho) para a caixa de entrada de um grupo do Microsoft 365.
- Publicador: Microsoft
- Escopo: serviços de Azure DevOps
Note
A página do Marketplace afirma que essa extensão é pré-instalada com Visual Studio Team Services/Azure DevOps Services.
Usar a IA para trabalhar com itens de trabalho sem Excel
Se você configurar o Azure DevOps MCP Server, poderá descrever tarefas comuns de itens de trabalho em linguagem natural, evitando o suplemento herdado do Excel em muitos cenários.
Substitua os valores de espaço reservado antes de executar um prompt: <ProjectName>, <AreaPath>, <IterationPath> e <UserName>.
| Tarefa | Prompt de exemplo |
|---|---|
| Adicionar itens de trabalho em lote | Create 10 User Stories in project <ProjectName> under area path <AreaPath> in iteration <IterationPath> |
| Importar uma hierarquia | Create an Epic "Checkout revamp" in project <ProjectName> with 3 Features and 2 User Stories under each Feature |
| Atualizar valores de campo | Set Iteration Path to <IterationPath> for all active Tasks assigned to <UserName> in project <ProjectName> |
| Reatribuir tarefa | Reassign all active User Stories in area path <AreaPath> from <UserName> to <UserName> |
| Mover itens para um sprint | Move all uncommitted User Stories in project <ProjectName> from iteration <IterationPath> to iteration <IterationPath> |
| Adicionar tags em massa | Add tag "release-2026" to all User Stories in iteration <IterationPath> in project <ProjectName> |
| Consultar itens de trabalho | Show all active unassigned Bugs in project <ProjectName> |
| Exportar uma captura | List all resolved Bugs in project <ProjectName> from the last 30 days with Title, Assigned To, and Closed Date |
| Atualizar valores em massa | Set Priority to 2 for all active Bugs in area path <AreaPath> in project <ProjectName> |
| Alterar o tipo de item de trabalho | Change all Issues tagged "convert-to-bug" to Bug in project <ProjectName> |
Note
Se você estiver usando Visual Studio Code, o modo de agente será especialmente útil para operações complexas de item de trabalho.