Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Azure DevOps Serviços | Azure DevOps Server | Azure DevOps Server 2022
Important
O complemento de integração Azure DevOps Office já não é suportado e pode não funcionar com as versões atuais do Office ou dos navegadores. A Microsoft não fornece atualizações ou correções para este suplemento. Para operações de item de trabalho em massa, use a funcionalidade de importação/exportação de CSV, que é a abordagem recomendada e suportada.
Note
Este artigo aborda o antigo complemento de integração do Azure DevOps Office. Para novas operações em massa, utilize a importação/exportação de CSV ou modificar itens de trabalho em massa no portal da Web. Os passos seguintes destinam-se a equipas que ainda dependem de fluxos de trabalho baseados em Excel.
Para dar suporte a fluxos de trabalho legados de controlo do trabalho, pode utilizar o Microsoft Excel para adicionar ou atualizar itens de trabalho. Pode trabalhar em modo online (ligado ao Azure Boards ou ao Azure DevOps Server) ou em modo offline (contra uma cópia local do documento).
Tip
Pode usar IA para ajudar nesta tarefa mais adiante neste artigo, ou consultar Habilitar assistência de IA com Azure DevOps MCP Server para começar.
Clientes Office suportados e versões Azure DevOps
A tabela seguinte mostra o suporte ao cliente Office pela versão Azure DevOps/Visual Studio.
O macOS não é suportado. Mesmo que tenhas instalado o Visual Studio para Mac, a ligação ao Azure DevOps a partir do Excel ou de qualquer outro cliente Office não é suportada.
| versão do Azure DevOps/Visual Studio | Excel | Integração de projetos | Criação de storyboard no PowerPoint | Notes |
|---|---|---|---|---|
| Azure DevOps Services Azure DevOps Server 2020 Visual Studio 2022 Visual Studio 2019 Integração do Azure DevOps Office 2019 |
✅ Suportado | ❌ Não suportado | ❌ Não suportado | A integração com o Project e o TFSFieldMapping estão preteridos. O link a partir do PowerPoint está obsoleto, mas ainda podes adicionar um link de storyboard dentro de um item de trabalho. |
| Visual Studio 2017 (legado) | ✅ Suportado | ✅ Suportado | ✅ Suportado | Apenas suporte legado. |
Prerequisites
| Categoria | Requerimentos |
|---|---|
| Programa informático | - Microsoft Excel 2016 ou posteriores, incluindo versões para Microsoft 365. - Visual Studio ou a integração gratuita do Azure DevOps Office 2019. - O plug-in Azure DevOps Office Integration (instalado com Visual Studio ou com Azure DevOps Office Integration 2019). |
| Download Azure DevOps Office Integration 2019 | - Ir a Downloads do Visual Studio. - Deslocar para todos os downloads. - Expanda Outras Ferramentas, Frameworks e Pacotes Redistribuíveis. - Encontre Azure DevOps Office Integration 2019 e selecione Descarregar. - Se não conseguir localizar o download ou não tiver acesso, inicie sessão com uma conta conta Microsoft ou contacte o seu administrador. |
| Permissões | - Acesso de membro do projeto para se ligarem a um projeto do Azure Boards. |
| Projeto | - Um projeto Azure Boards. Se não tiveres um, vê Criar um projeto. |
Para informações sobre os requisitos de compatibilidade, veja Azure DevOps compatibilidade do cliente.
Limitações e problemas conhecidos
O complemento de integração Azure DevOps Office é anterior à autenticação moderna do Microsoft 365, e a Microsoft já não o mantém ativamente. Espere estas limitações:
- Autenticação moderna: O Acesso Condicional, a autenticação multifator (MFA) e as políticas de conformidade dos dispositivos podem bloquear o início de sessão. Se o login interativo falhar, inicie sessão no seu cliente Office com a mesma conta que usa para o Azure DevOps antes de abrir a folha de cálculo.
- Tokens de acesso pessoal (PATs): Alguns cenários pedem um PAT em vez de iniciar sessão interativa. Os PATs são credenciais de longa duração, por isso, evite utilizá-las sempre que possível. Use tokens Microsoft Entra sempre que suportados. Se tiver de utilizar um PAT, consulte Usar tokens de acesso pessoal.
- Microsoft 365 (web) e macOS: O complemento funciona apenas no desktop Office no Windows. Excel na Web e Office para Mac não suportam este complemento.
- Agentes alojados e automação: O complemento suporta apenas uso interativo. Não suporta cenários sem supervisão nem baseados em cadeias de processamento. Use antes a API Azure DevOps REST.
- Grandes conjuntos de dados: Publicar ou atualizar milhares de itens de trabalho numa única folha de cálculo pode exceder o tempo limite. Divida o trabalho por várias folhas de cálculo ou utilize a importação/exportação em CSV.
Para alternativas suportadas, veja Modificar em massa itens de trabalho no portal Web e Importar ou atualizar em massa itens de trabalho com ficheiros CSV.
Publicar e atualizar itens de trabalho
Quando trabalhas no Excel, editas uma cópia local dos dados dos itens de trabalho.
Use estas ações para manter a sincronização:
- Refresh descarrega os valores mais recentes do Azure Boards para a sua folha de cálculo.
- Publicar carrega as alterações das tuas folhas de cálculo para o Azure Boards.
No início, a tua folha de trabalho e o Azure Boards coincidem. Com o tempo, outros utilizadores ou processos podem alterar os mesmos itens de trabalho. Para evitar conflitos e edições aborrecidas, use este ritmo:
- Atualiza quando abrires o ficheiro.
- Faça algumas pequenas edições.
- Publicar as alterações.
- Atualiza novamente, especialmente durante sessões mais longas.
Repete este ciclo ao longo da sessão.
Azure DevOps e Excel
O diagrama seguinte mostra a sincronização bidirecional entre Excel e Azure DevOps:
- O Excel publica edições locais no Azure DevOps.
- O Excel atualiza para recolher atualizações do lado do servidor.
Para o fluxo de trabalho completo do Excel, veja Adicionar itens de trabalho em massa com Excel.
Conectar um projeto Azure DevOps ao Excel
Para adicionar ou modificar itens de trabalho no Excel, ligue primeiro a sua folha de cálculo a um projeto Azure DevOps.
Note
- Esta secção mostra os passos do Excel para Azure Boards. O PowerPoint utiliza um fluxo de ligação semelhante.
- No Azure DevOps Services, o portal seleciona automaticamente a Team Project Collection. No Azure DevOps Server, selecione a coleção antes de selecionar o projeto.
Escolha um caminho de ligação:
- Portal Web
- Cliente Excel (cloud)
- Cliente Excel (on-premises)
- Visual Studio/Team Explorer
A sua folha de cálculo liga-se como uma lista de entrada (lista manual) ou uma lista de consulta (resultados guardados de uma consulta).
- A partir do portal web
- A partir de um cliente Office (cloud)
- A partir de um cliente do Office (local)
- Do Visual Studio
Este método de ligação requer a extensão Azure DevOps Open in Excel Marketplace e o Visual Studio 2017 ou posterior.
No seu navegador, confirme que o projeto correto está selecionado e, em seguida, vá para Boards>Consultas>Todos.
Seleciona a consulta que queres abrir no Excel.
No separador Resultados, selecione o
ícone de ações e depois selecione Abrir no 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 mover o seu projeto Azure DevOps para uma coleção de projetos diferente na mesma instância do Azure DevOps Server, os seus documentos reconectam-se automaticamente. Se o projeto for transferido para uma instância diferente do Azure DevOps Server, deve reconectar manualmente os seus documentos ao novo servidor.
Trabalhar offline e voltar a ligar-se ao Azure Boards
Podes trabalhar offline no Excel para adicionar ou atualizar itens de trabalho, e depois reconectar e sincronizar mais tarde.
Note
Se o projeto for transferido para outra organização Azure DevOps ou instância do Azure DevOps Server, reconfigure a ligação ao documento. Para os passos, veja Ligar projeto Azure DevOps ao Excel.
Desconectar um arquivo de documento da rede
Antes de desligar, prepare a sua folha de exercícios:
Abre o documento que queres editar offline.
Receba as últimas atualizações. No Excel, na fita da Equipa, no grupo de Itens de Trabalho, selecione Atualizar.
Adiciona todas as colunas que planeias editar. Não podes adicionar colunas depois de desligares.
Desconecte o computador da rede ou salve o arquivo de lista de itens de trabalho e copie-o para outro computador.
O Office pode mostrar um erro de ligação depois de desligar.
Modifique ou atualize a lista de itens de trabalho conforme necessário.
Quando estiver offline, não pode criar a maioria dos tipos de ligação entre itens de trabalho. As ligações pai-filho numa lista em árvore no Excel constituem a exceção.
Reconectar um ficheiro ao Azure Boards
Quando voltares a estar online, resincroniza o teu ficheiro:
Religue o seu computador à rede, ou copie o ficheiro para um computador ligado ao Azure Boards.
Se alterou o ficheiro em modo offline, no Excel, no separador Equipa, no grupo Item de Trabalho, selecione Publicar.
Se não fizeste alterações offline, seleciona Atualizar em vez disso.
Resolver quaisquer erros ou conflitos de validação.
Extensões do Marketplace
Estas extensões do Marketplace suportam cenários de integração com Azure DevOps e Microsoft 365:
-
Abre resultados de consultas ou itens de trabalho selecionados no Excel a partir do portal web para edição e análise em massa.
- Publisher: Microsoft DevLabs
- Requisitos: Microsoft Excel e Visual Studio ou o cliente de integração Azure DevOps Office
- Compatibilidade: Azure DevOps Services e Azure DevOps Server
-
Envia notificações de service hook do Azure DevOps (por exemplo, compilação, envio de código e eventos de item de trabalho) para a caixa de entrada de um grupo do Microsoft 365.
- Editora: Microsoft
- Scope: Azure DevOps Services
Note
A página do Marketplace indica que esta extensão está pré-instalada com Visual Studio Team Services/Azure DevOps Services.
Usa IA para trabalhar com itens de trabalho sem Excel
Se configurar o Azure DevOps MCP Server, pode descrever tarefas comuns de itens de trabalho em linguagem natural, evitando o antigo Excel add-in em muitos cenários.
Substitua os valores provisórios antes de executar um prompt: <ProjectName>, <AreaPath>, <IterationPath>, e <UserName>.
| Tarefa | Exemplo de prompt |
|---|---|
| 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 dos campos | Set Iteration Path to <IterationPath> for all active Tasks assigned to <UserName> in project <ProjectName> |
| Reatribuir trabalho | 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 etiquetas 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 um instantâneo | List all resolved Bugs in project <ProjectName> from the last 30 days with Title, Assigned To, and Closed Date |
| Valores de atualização 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 estiveres a usar Visual Studio Code, o modo agente é especialmente útil para operações complexas de itens de trabalho.