Adicionar ou modificar itens de trabalho em massa usando Microsoft Excel

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.

Este artigo mostra como você pode economizar tempo usando Microsoft Excel quando precisar adicionar ou modificar muitos itens de trabalho, adicionar links e anexos a vários itens de trabalho e muito mais. Você também pode usar recursos nativos do Excel para executar ações como resumir uma coluna, copiar e colar linhas ou preencher dados em células.

Use este artigo para fluxos de trabalho herdados em que o suplemento de integração do Office ainda é necessário em seu ambiente.

Tip

Para operações em massa com suporte:

Escolha seu cenário

Para obter informações sobre como se conectar ao Excel, consulte Conectar Azure Boards a um cliente do Office. Para obter respostas a perguntas específicas sobre a integração do Excel e Azure DevOps, consulte FAQs: Trabalhar no Excel conectado ao Azure Boards.

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.

Prerequisites

Category Requirements
Acesso ao projeto - Membro do projeto.
Plataforma - O Windows é necessário. Não há suporte para macOS para Excel integração com Azure Boards.
Níveis de Acesso – Pelo menos acesso de partes interessadas.
Permissions - Membro do grupo Colaboradores.
- Exibir itens de trabalho neste nó e as permissões Editar itens de trabalho neste nó definidas como Permitir. Por padrão, o grupo Colaboradores tem essa permissão. Para obter mais informações, consulte Definir permissões e acesso para acompanhamento de trabalho.
Tools - Microsoft Excel 2010 ou posterior, incluindo Microsoft Office Excel 365.
- Azure DevOps Office Integration 2019. Para baixar, role até All Downloads, selecione Other Tools, Frameworks e Redistributables e selecione Download ao lado de Azure DevOps Office Integration 2019. Como alternativa, você pode obter o plug-in instalando uma das edições mais recentes do Visual Studio. O plug-in dá suporte à conexão com Azure Boards e Azure DevOps Server do Excel.
- Visual Studio 2015.1 ou posterior ou Team Foundation Server Office Integration 2015 Atualização 2 ou posterior.
– Para usar o recurso Select User, baixe a versão gratuita do Visual Studio Community. Esse recurso ajuda a evitar erros de validação de dados causados por nomes de usuário incorretos e é útil ao atribuir nomes de usuário de um grande grupo de contas de usuário.
Category Requirements
Acesso ao projeto - Membro do projeto.
Plataforma - O Windows é necessário. Não há suporte para macOS para Excel integração com Azure Boards.
Níveis de Acesso – Pelo menos acesso de partes interessadas.
Permissions - Membro do grupo Colaboradores.
- Exibir itens de trabalho neste nó e as permissões Editar itens de trabalho neste nó definidas como Permitir. Por padrão, o grupo Colaboradores tem essa permissão. Para obter mais informações, consulte Definir permissões e acesso para acompanhamento de trabalho.
Tools - Microsoft Excel 2010 ou posterior, incluindo Microsoft Office Excel 365.
- Azure DevOps Office Integration 2019. Para baixar, role até All Downloads, selecione Other Tools, Frameworks e Redistributables e selecione Download ao lado de Azure DevOps Office Integration 2019. Como alternativa, você pode obter o plug-in instalando uma das edições mais recentes do Visual Studio. O plug-in dá suporte à conexão com Azure Boards e Azure DevOps Server do Excel.
– Para usar o recurso Select User, instale Visual Studio 2015.1 ou posterior ou Azure DevOps Office Integration 2019 ou posterior. Você pode baixar a versão gratuita do Visual Studio Community. Esse recurso ajuda a evitar erros de validação de dados causados por nomes de usuário incorretos e é útil ao atribuir nomes de usuário de um grande grupo de contas de usuário.

Para obter mais informações, consulte Compatibilidade doClient com Azure DevOps Server.

Usar tipos de lista e consulta

Use tipos de lista e consulta para adicionar, modificar, publicar e atualizar itens de trabalho em massa.

  • Use uma lista simples para adicionar ou modificar vários tipos de itens de trabalho ao mesmo tempo, como itens de lista de pendências, tarefas, bugs ou problemas.
  • Use uma lista de árvore para adicionar ou modificar em massa itens de trabalho e seus links de topologia em árvore.

Escolha a lista e a combinação de consultas que correspondem à sua meta:

  • Lista de entrada, lista simples: importe uma lista de itens de trabalho ou crie novos itens de trabalho sem hierarquia.
  • Lista de entrada, lista de árvores: conclua o planejamento de cima para baixo e importe itens de trabalho vinculados hierarquicamente.
  • Lista de consultas, lista simples: atualize em massa uma lista de itens de trabalho ou crie novos itens de trabalho sem hierarquia.
  • Lista de consultas, lista de árvores: exiba e modifique a hierarquia de relações de vínculo de muitos itens de trabalho existentes.
  • Lista de entrada, lista simples: importe uma lista de itens de trabalho ou crie novos itens de trabalho sem hierarquia.
  • Lista de entrada, lista de árvores: conclua o planejamento descendente e publique itens de trabalho vinculados entre pai e filho.
  • Lista de consultas, lista simples: crie um relatório do Excel com base na consulta de itens de trabalho. Para criar um relatório do Excel, sua coleção de projetos deve ser configurada para dar suporte aos relatórios do Analytics. Para obter mais informações, consulte Criar um relatório.
  • Lista de consultas, lista de árvores: exibir e modificar a hierarquia e as relações de vínculo pai-filho de muitos itens de trabalho existentes.

Tipos de consulta

Excel dá suporte às seguintes fontes de lista de consultas:

  • Nenhum: Usa uma lista de entrada.
  • Título da consulta: usa os itens de trabalho retornados pela consulta selecionada.

Azure Boards dá suporte a três estruturas de consulta, cada uma identificada por um ícone ao lado da consulta:

  • Lista simples de itens de trabalho: importada como uma consulta de lista simples.
  • Itens de trabalho e links diretos: importados como uma consulta de lista simples.
  • Árvore de itens de trabalho: importada como uma lista em árvore.

Captura de tela dos tipos de consulta no Azure Boards com indicadores de ícones.

Excel importa consultas de links diretos como uma lista simples porque não dá suporte à modificação de vários tipos de link.

Listas de árvores

Use as listas em árvores para adicionar em lote itens de trabalho aninhados, como uma estrutura de detalhamento do trabalho ou histórias hierárquicas de usuário. Por exemplo, você pode adicionar tarefas, subtarefas e bugs em uma hierarquia ou vincular tarefas a itens de lista de pendências do produto.

Excel dá suporte aos seguintes tipos de lista:

  • Lista simples: uma lista simples de itens de trabalho com uma única coluna Título. Ele não dá suporte ao gerenciamento de link.
  • Lista em árvore: uma lista hierárquica de itens de trabalho com duas ou mais colunas Título. Ele dá suporte à criação e atualização de links de topologia de árvore, como links pai-filho, entre itens de trabalho.

Captura de tela que mostra uma lista de árvores de itens de trabalho e a relação entre tarefas pai e subtarefas filho.

Links pai-filho ou outros tipos de link de topologia de árvore dão suporte à uma estrutura de lista de pendências hierárquica. Os tipos de item de trabalho que participam da hierarquia variam de acordo com o processo, conforme mostrado nas imagens a seguir.

Hierarquias de listas em árvore

Este diagrama mostra a hierarquia de backlog do processo Agile:

Diagrama que mostra os tipos de item de trabalho Agile.

  • Use as histórias e tarefas do usuário para acompanhar o trabalho.
  • Usar bugs para rastrear os defeitos de código.
  • Use épicos e recursos para agrupar o trabalho em cenários maiores.

Cada equipe pode configurar se deseja gerenciar bugs no mesmo nível de itens de trabalho do tipo tarefa ou história de usuário. Use a configuração Trabalhando com bugs . Para obter mais informações sobre como usar esses tipos de item de trabalho, confira Processo Agile.

Para importar uma lista hierárquica, consulte Adicionar ou importar uma lista hierárquica de itens de trabalho como uma lista de árvores mais adiante neste artigo.

Minhas consultas versus consultas compartilhadas

Você pode abrir qualquer consulta definida em Azure Boards no Excel, incluindo consultas em Minhas Consultas e Consultas Compartilhadas. No entanto, se você planeja compartilhar a pasta de trabalho com outros membros da equipe, use uma Consulta Compartilhada. Outros membros da equipe não podem acessar pastas de trabalho ou planilhas com base em consultas pessoais armazenadas na pasta Minhas Consultas.

Usar recursos do Excel

A maioria dos recursos de Excel padrão funciona com planilhas conectadas Azure Boards.

Ações de Excel úteis que ainda funcionam

  • Formatar células ou aplicar formatação condicional.
  • Recortar e colar valores entre células.
  • Recortar e colar uma única linha.
  • Somar colunas e usar fórmulas.
  • Preencher células:
  • Filtrar linhas.
  • Adicione várias planilhas em uma pasta de trabalho.

Cada planilha pode usar uma lista ou consulta de entrada diferente. Todas as planilhas na mesma pasta de trabalho devem se conectar ao mesmo projeto em uma organização ou coleção de projetos.

Comportamentos diferentes em planilhas conectadas

  • Cada célula corresponde a um campo do item de trabalho e ao seu tipo de dados, de modo que as regras do campo sejam aplicadas.
  • A inserção funciona uma linha de cada vez.
  • Copiar e colar dá suporte a várias linhas.
  • Para mover um item de trabalho em uma hierarquia, corte a linha inteira e cole-a sob o novo item pai.
  • Use Diminuir recuo e Aumentar recuo para reposicionar itens na árvore.
  • Desfazer (Ctrl + Z) pode não funcionar de forma confiável. Se necessário, atualize a planilha.

Para manter a sincronização com Azure Boards, publique e atualize com frequência. Para obter mais informações sobre Excel recursos, consulte Tarefas básicas de Excel.

Classificar itens de trabalho

Use as seguintes diretrizes ao classificar itens de trabalho no Excel:

  • Classifique listas simples usando o recurso de classificação de Excel.
  • Não ordene listas em árvore. A classificação de uma lista de árvores altera a hierarquia e pode interromper os vínculos entre itens de trabalho.

Escolha a opção que corresponde à sua meta:

  • Reordenar itens em um backlog da equipe: Use o campo Stack Rank ou Backlog Priority (processo Agile ou Scrum). Defina valores, publique a planilha e atualize a lista de pendências. Os itens aparecem do menor para o número mais alto. Se alguém reordenar a lista de pendências mais tarde, esses valores poderão ser alterados.
  • Mantenha uma ordem personalizada apenas em Excel: adicione um campo de classificação personalizado e classifique sua lista simples por esse campo. Essa abordagem não altera a ordem mostrada no backlog da equipe.

Concluir tarefas em uma planilha do Excel

Use planilhas conectadas Excel para executar estas tarefas comuns:

Tarefas sem suporte

Quando você trabalha em uma planilha Excel, não há suporte para as seguintes tarefas:

  • Excluir itens de trabalho
  • Alterar o tipo de item de trabalho de um item de trabalho existente
  • Mover itens de trabalho para outro projeto
  • Importar ou atualizar etapas de caso de teste ou outros artefatos de teste
  • Adicionar itens de trabalho em qualquer outro estado que não seja o novo estado
  • Adicionar a um thread de discussão de item de trabalho
  • Link para um item de trabalho remoto

Importar itens de trabalho como uma lista simples

Use o procedimento a seguir para importar itens de trabalho como uma lista simples:

Note

A integração do Excel com o Azure Boards é compatível apenas com o Windows. Não há suporte para o macOS, incluindo Visual Studio para cenários do Mac.

  1. Abra o Excel e conecte-se ao seu projeto de Azure Boards. Use um dos quatro métodos fornecidos no projeto Connect Azure DevOps para Excel.

    Note

    Quando você se conecta a Azure Boards na nuvem, o Team Project Collection é automaticamente selecionado, pois há apenas uma coleção associada à sua organização de serviços Azure DevOps. Quando você se conectar a Azure Boards em um servidor local, escolha o Team Project Collection antes de escolher o projeto.

  2. No Excel, comece com uma planilha em branco. Se a faixa de opções Team não estiver disponível, verifique se você instalou a ferramenta Azure DevOps Office Integration 2019. Para obter mais informações, consulte problemas de integração do Office no Azure DevOps.

  3. Coloque o cursor na primeira célula da tabela. Na faixa de opções Equipe, selecione Nova Lista:

    Captura de tela que mostra como selecionar a opção Nova Lista na faixa de opções Equipe.

  4. Na caixa de diálogo Nova Lista , selecione Lista de Entradas e selecione OK:

    Captura de tela da caixa de diálogo Nova Lista com a opção Lista de entrada realçada.

    Sua planilha agora está associada ao seu projeto como uma lista de entrada (Query[None]), lista simples:

    Captura de tela da planilha de lista plana vazia conectada a um projeto no Excel.

  5. Insira valores de título para os itens de trabalho que você deseja adicionar e selecione os valores de tipo de item de trabalho:

    Captura de tela da lista simples atualizada no Excel com o título do item de trabalho e os tipos de item de trabalho.

    Os campos Estado e Motivo são preenchidos automaticamente com valores padrão depois que você seleciona o tipo de item de trabalho.

  6. Coloque o cursor em qualquer célula de tabela que tenha dados. Na faixa de opções Equipe, selecione Publicar:

    Captura de tela que mostra como publicar sua planilha.

    Depois que a planilha for publicada com êxito, os itens de trabalho na tabela receberão números de ID :

    Captura de tela da planilha publicada com IDs de item de trabalho no Excel.

  7. Para atribuir valores a outros campos, selecione Escolher Colunas na faixa de opções da Equipe . Adicione os campos, faça as atribuições e publique suas alterações.

    Tip

    Ao adicionar itens de trabalho a uma lista de pendências da equipe, certifique-se de especificar o Caminho da Área e o Caminho da Iteração da equipe. Se você precisar adicionar Caminhos de Área ou Caminhos de Iteração, selecione Editar Áreas e Iterações. Esse link abre a página Configurações do projeto em um navegador da Web. Para obter mais informações, consulte Definir caminhos de área e atribuir a uma equipe e definir caminhos de iteração e configurar iterações de equipe.

  8. Você pode adicionar mais informações a um item de trabalho na lista abrindo o item no portal da Web do Excel.

    Primeiro, publique as alterações não salvas na lista. Selecione o item de trabalho e, em seguida, selecione Abrir no Acesso à Web na faixa de opções da Equipe :

    Captura de tela que mostra como abrir um item de trabalho no portal da Web do Excel.

    Um navegador da Web abre e exibe o item de trabalho.

    Se você fizer alterações no item de trabalho, atualize sua planilha imediatamente para capturar as alterações.

Importar itens de trabalho como uma lista de árvores

Você pode adicionar uma hierarquia de itens de trabalho vinculados usando links pai-filho ou outros tipos de link de topologia de árvore.

Important

Evite classificar uma lista de árvores, pois isso pode alterar as relações hierárquicas de link.

  1. Comece da etapa do procedimento anterior em que você vinculou sua planilha ao seu projeto.

  2. Converta a planilha de lista de entrada em formato plano em uma lista em árvore. Selecione uma célula da lista e depois selecione Adicionar Nível de Árvore na guia Equipe:

    Captura de tela de uma lista plana vazia conectada a um projeto e a opção Adicionar Nível de Árvore realçada.

    Se a opção Adicionar Nível de Árvore não estiver disponível, sua lista será uma lista de consultas. Para converter sua lista em uma lista de árvores, primeiro você deve reconfigurar sua lista para uma lista de entrada.

  3. Na caixa de diálogo Converter em Lista de Árvores , selecione o tipo de link a ser usado ao adicionar itens de trabalho a uma hierarquia e selecione Converter. A opção mais comum é Pai-Filho. Você só pode selecionar entre tipos de link de topologia de árvore. Para obter mais informações, consulte Topologias e restrições de tipo de link.

    Captura de tela da caixa de diálogo Converter em Lista de Árvores.

    O tipo de lista é alterado para Árvore e outra coluna Título é exibida. A coluna Título inicial é rotulada como Título 1 e a nova coluna Título é rotulada como Título 2:

    Captura de tela que mostra a lista convertida com o tipo Lista alterado para Árvore e uma segunda coluna Título.

  4. Para adicionar mais níveis à hierarquia, selecione Adicionar Nível de Árvore novamente. Por exemplo, se você planeja adicionar uma hierarquia de Épicos, Funcionalidades e Histórias de Usuário, precisará de três colunas Título.

    Se você quiser adicionar tarefas, adicione outro nível de árvore para ter quatro colunas de título . Para remover uma coluna, confira Remover um nível de árvore.

  5. Salve seu arquivo do Excel.

  6. Insira o Tipo de Item de Trabalho e os Títulos para a hierarquia que deseja importar. Os campos Estado preenchem automaticamente com valores padrão depois que você seleciona o tipo de item de trabalho.

    Captura de tela de uma planilha do Excel mostrando uma lista hierárquica de itens de trabalho.

  7. Coloque o cursor em qualquer célula de tabela que tenha dados. Na faixa de opções Equipe, selecione Publicar.

    Depois que a planilha for publicada com êxito, os itens de trabalho na tabela receberão números de ID .

    Em segundo plano, o tipo de link selecionado é usado para vincular cada item de trabalho na hierarquia. Os épicos estão vinculados a recursos. Os recursos estão vinculados a histórias de usuários.

  8. Para verificar os links, selecione um item de trabalho e selecione Links e Anexos na faixa de opções equipe . O exemplo a seguir mostra os links filho e pai criados para um recurso importado:

    Captura de tela da caixa de diálogo Link e Anexos mostrando links filho e pai criados para um recurso importado.

  9. Para adicionar um filho a um item de trabalho em uma nova linha de tabela, selecione o item de trabalho e, em seguida, selecione Adicionar Filho na faixa de opções da Equipe :

    Captura de tela que mostra como adicionar um filho a um item de trabalho.

  10. Para atribuir valores a outros campos, selecione Escolher Colunas na faixa de opções da Equipe . Adicione os campos, faça as atribuições e publique suas alterações.

  11. Para modificar a hierarquia de árvore, corte a linha inteira para um item de trabalho e cole a linha sob o novo pai na árvore. Quando você publica a alteração, links hierárquicos antigos são excluídos e novos links hierárquicos são criados.

    Você pode usar as ações Recuar item na árvore e Avançar item na árvore para rebaixar ou promover um item de trabalho dentro da hierarquia de árvore. Essas ações estão disponíveis para conteúdo em qualquer coluna rotulada como Título<Número>. Se você quiser trabalhar com dados em uma coluna que não tenha o rótulo Título< Número>, adicione um nível hierárquico para a coluna.

Remover um nível de árvore

Para remover um nível de árvore com segurança:

Important

Remova um nível de árvore somente depois de publicar alterações. A atualização substitui a planilha e os dados não publicados são perdidos.

  1. Publicar todas as alterações pendentes.

  2. Limpe todos os valores sob a coluna Título <Número> que deseja remover.

    A coluna deve ser a coluna Título com maior numeração na árvore.

  3. Atualize a planilha.

    Excel remove a coluna Título, que agora está vazia. Se você tentar excluir a coluna manualmente, Excel retornará um erro.

Dicas para trabalhar com uma lista de árvore

Excel usa as colunas Título para criar links de árvore. Antes de publicar, verifique estes problemas comuns:

  • Linhas em branco na hierarquia: uma linha em branco entre itens pode quebrar ou desaplicar links incorretamente.
  • Título na coluna errada: insira o título de cada item de trabalho filho na coluna correta Título <Número>.
  • Várias colunas Título preenchidas em uma linha: insira texto em apenas uma coluna Título <Número> por linha.
  • Lista de árvores classificadas: não classifique uma lista de árvores. A classificação pode alterar as relações de hierarquia. Se você classificar por engano, atualize imediatamente para recuperar a estrutura original.

Para solucionar problemas de links inválidos, consulte perguntas frequentes.

Um item de trabalho vinculado pai-filho pode ter apenas um pai. Se uma tarefa precisar aparecer em vários itens de pendência, crie tarefas separadas.

Atualizar itens de trabalho em massa com uma lista de consultas

Use uma lista de consultas quando quiser atualizar muitos itens de trabalho existentes ao mesmo tempo.

Tip

Mantenha sua planilha sincronizada:

  • Comece por Atualizar para obter os dados mais recentes.
  • Use Escolher Colunas para adicionar campos que você precisa editar.
  • Publique com frequência para reduzir conflitos de dados.
  • Salve a pasta de trabalho regularmente para evitar a perda de alterações não publicadas.
  1. Crie uma consulta que retorne os itens de trabalho que você deseja atualizar. Para obter mais informações, confira Criar e salvar consultas gerenciadas com o editor de consultas.

  2. Abra o Excel e conecte-se ao seu projeto de Azure Boards. Use um dos quatro métodos fornecidos no projeto Connect Azure DevOps para Excel.

  3. Continue com o caminho que corresponde ao local em que você começou:

    • Caminho A: Você abriu a consulta no portal da Web ou Visual Studio

      1. Selecione Escolher Colunas na faixa de opções da Equipe para adicionar todos os campos que você deseja editar.

      2. Atualize os valores e, em seguida, publique suas alterações.

    • Caminho B: você começou no Excel

      1. Abra uma planilha em branco. Você também pode adicionar uma planilha a uma pasta de trabalho existente se usar uma consulta do mesmo projeto associado.

      2. Coloque o cursor na primeira célula da tabela. Na faixa de opções Equipe, selecione Nova Lista:

        Captura de tela que mostra como selecionar a opção Nova Lista na faixa de opções Equipe.

      3. Na caixa de diálogo Nova Lista , selecione a lista de consultas e, em seguida, selecione a consulta:

        Captura de tela da caixa de diálogo Nova Lista com a opção de lista de consultas realçada.

        O ícone ao lado de cada consulta mostra o tipo de consulta. Para obter detalhes, consulte tipos de consulta.

        Selecione OK.

        A planilha agora está associada ao seu projeto e preenchida a partir da consulta:

        Captura de tela da planilha associada a um projeto no Excel e preenchida com resultados de uma consulta.

      4. Faça suas atualizações e, em seguida, publique as alterações.

        Se você estiver trabalhando com uma lista de árvores, examine as diretrizes em Importar uma lista hierárquica de itens de trabalho, anteriormente neste artigo.

Habilitar comandos de árvore

Se os comandos Árvore, como Adicionar filho e Aumentar recuo não estiverem disponíveis na faixa de opções Equipe, sua planilha está configurada atualmente como uma lista simples ou de consulta:

Captura de tela que mostra os comandos do grupo Árvore indisponíveis (cinza) na faixa de opções da equipe no Excel.

Para habilitar comandos de árvore , reconfigure a planilha para um destes tipos de lista:

  • Lista de entrada
  • Lista de consultas com base em uma consulta de árvore

Para obter instruções passo a passo, consulte Alterar seu tipo de lista ou consulta.

Alterar o tipo de lista ou a consulta

Use este procedimento quando precisar alterar a forma como sua planilha é preenchida.

É possível:

  • Alterar uma lista simples para uma lista de árvores
  • Alterar de uma lista de consultas para uma lista de entrada
  • Alterar de uma lista de entrada para uma lista de consultas
  • Alterar a consulta à qual sua planilha faz referência

Se você precisar de uma lista de árvores e os comandos tree não estiverem disponíveis, primeiro converta a planilha em uma lista de entrada.

Converter uma lista de consultas em uma lista de entrada

  1. Selecione Publicar para garantir que todas as alterações na planilha sejam salvas.

  2. Na faixa de opções da Equipe, selecione Configurar>Lista:

    Captura de tela da faixa de opções Equipe com a opção Configurar, Lista realçada.

  3. Na caixa de diálogo Configurar Propriedades da Lista, selecioneSomente Atualizar itens de trabalho e selecione Aplicar:

    Captura de tela da caixa de diálogo Configurar propriedades de lista mostrando a opção Atualizar somente itens de trabalho realçada.

    A planilha agora é uma lista de entrada.

Converter uma lista de entrada em uma lista de consultas

  1. Na caixa de diálogo Configurar Propriedades da Lista, selecioneAtualizar na consulta.

  2. Selecione a consulta para preencher a planilha e selecione Aplicar:

    Captura de tela das propriedades da caixa de diálogo Configurar lista mostrando a opção Atualizar da consulta realçada e a lista de seleção de consulta aberta.

Adicionar itens de trabalho existentes à planilha

Use o caminho que corresponde ao tipo de planilha.

Se sua planilha usa uma lista de consultas

Modifique sua consulta para incluir os itens de trabalho desejados e atualize a planilha.

Se sua planilha usar uma lista de entrada

Concluir as seguintes etapas:

  1. Na guia Equipe, selecione Obter Itens de Trabalho:

    Captura de tela da Faixa de Opções da Equipe mostrando a opção Obter Itens de Trabalho realçada.

Caixa de diálogo Obter Itens de Trabalho

Na caixa de diálogo Obter Itens de Trabalho , escolha como você deseja encontrar itens de trabalho:

Captura de tela da caixa de diálogo Obter itens de trabalho, com a opção Consulta salva selecionada, mostrando os resultados da ação Localizar.

Se os itens de trabalho estiverem em outro projeto, primeiro selecione o projeto. Em seguida, escolha uma destas opções:

  • Consulta salva: use uma consulta salva que retorna os itens de trabalho desejados.

  • IDs: use essa opção quando você já souber as IDs do item de trabalho.

    • Na caixa IDs, insira IDs separadas por vírgulas ou espaços.
  • O título contém: localizar itens de trabalho por uma palavra ou frase no campo Título . Na lista e tipo, selecione o tipo de item de trabalho a ser retornado.

Tip

Para minimizar o tempo necessário para executar a consulta, reduza os critérios de filtro da pesquisa.

  1. Selecione Localizar.

    • Os resultados incluem apenas itens de trabalho do projeto selecionado e do tipo de item de trabalho.
    • A marca de verificação indica um item de trabalho que já está na planilha.
    • Para classificar os resultados, selecione um cabeçalho de coluna. Você também pode redimensionar colunas para ver mais detalhes.
  2. Na lista de resultados, marque a caixa de seleção para cada item de trabalho que você deseja adicionar.

    • Inclua também quaisquer nós filhos relacionados que você deseja incluir na planilha.
    • Use Shift + Select para selecionar um intervalo e Ctrl + Select para adicionar ou remover itens individuais.
    • Use Selecionar Tudo para selecionar todos os itens de trabalho retornados.
  3. Selecione OK. A lista de planilhas é atualizada para mostrar suas alterações.

Adicionar ou remover campos de coluna

Quando você cria uma planilha usando a ação Nova Lista na faixa de opções da Equipe , o processo gera um conjunto de colunas de campo padrão, como Tipo de Item de Trabalho, ID e Estado. Se você criar sua planilha a partir de uma consulta existente, os campos de coluna na planilha corresponderão aos campos definidos na consulta.

Em ambos os cenários, use a ação Escolher Colunas na faixa de opções da Equipe para adicionar e modificar colunas. Lembre-se de que, se você criar sua planilha a partir de uma consulta, as alterações de coluna não afetarão a consulta subjacente.

  1. Selecione Opções de Coluna para adicionar campos e atribuir valores a outros campos:

    Captura de tela que mostra como abrir e trabalhar com a caixa de diálogo Escolher Colunas.

    • Para filtrar os campos com base no tipo de item de trabalho, selecione o Tipo de item de trabalho.

    • Para adicionar um campo ao conjunto de colunas da planilha, selecione o campo na lista de colunas disponíveis e, em seguida, selecione a seta para a direita.

    • Para remover um campo do conjunto de campos da planilha, selecione o campo na lista de colunas selecionadas e, em seguida, selecione a seta para a esquerda .

    • Para alterar a posição de um campo na sequência de colunas, selecione o campo e reposicione-o usando a seta para cima e a seta para baixo. A seta para cima move a coluna selecionada em direção à esquerda no conjunto de cabeçalhos de coluna de tabela. A seta para baixo move a coluna para a direita no conjunto de cabeçalhos de coluna da tabela.

    • Você pode adicionar campos de rich-text, como Descrição. Tenha em mente que alguma formatação avançada pode ser perdida na planilha publicada.

    Selecione OK para aplicar as alterações de coluna.

  2. Depois que os campos aparecerem na planilha, atribua valores e publique suas atualizações. Quando você trabalha com campos de identidade que aceitam contas de usuário, siga as diretrizes na próxima seção, selecione contas de usuário.

  3. Salve sua planilha.

Selecione contas de usuário

Use Selecionar Usuário para localizar contas e atribuir valores a campos nomeados por pessoa. Esse recurso é especialmente útil para equipes maiores e também mostra os valores usados mais recentemente (MRU).

Note

Sem o recurso Selecionar Usuário , você precisa inserir nomes de usuário exatamente como eles aparecem no banco de dados; caso contrário, você receberá erros de validação de dados ao tentar publicar.

  1. Confirme se Visual Studio 2015.1 ou posterior está instalado. Se necessário, baixe e instale uma versão mais recente.

  2. Em sua planilha, selecione um campo de identidade ou um campo de nome de pessoa. Essa seleção ativa Selecionar Usuário na faixa de opções Equipe:

    Captura de tela da opção Selecionar Usuário disponível na guia Equipe para uma identidade selecionada ou um campo com nome de pessoa.

    Os campos de identidade e nome de pessoa são mapeados para contas de usuário, normalmente de Microsoft Entra ID, Windows Server Active Directory ou um grupo de trabalho.

  3. Na caixa de diálogo Atribuir Usuário , comece a digitar um nome de usuário e selecione a conta correspondente nos resultados filtrados.

    Captura de tela da caixa de diálogo Atribuir Usuário.

    • Digite uma letra para pular para os nomes que começam com essa letra. Somente nomes de usuário são reconhecidos, não aliases.

    • Excel armazena seleções recentes para que você possa escolher contas de usuário diretamente do campo da próxima vez.

    Captura de tela que mostra a lista suspensa do campo Atribuído a com valores usados recentemente.

Use a guia Links na caixa de diálogo Links e Anexos para:

  • Examinar links existentes para um item de trabalho selecionado
  • Adicionar links a um ou mais itens de trabalho
  • Excluir links.
  • Abrir um item de trabalho vinculado no portal da Web
  • Editar o tipo de link para um link existente
  • Adicionar colunas e classificar a lista na guia Links

Para obter mais informações sobre como vincular itens de trabalho, consulte Histórias de usuário do Link, problemas, bugs e outros itens de trabalho.

A caixa de diálogo Links e Anexos não dá suporte a atualizações em massa para links de item de trabalho. Para atualizar em massa os tipos de link de topologia de árvore, use uma lista de árvores.

  1. Selecione o item de trabalho a ser atualizado na planilha e selecione Links e Anexos na faixa de opções equipe .

  2. Na caixa de diálogo Links e Anexos, selecione a guia Links e depois selecione Link para.

  3. Na caixa de diálogo Adicionar link para o <item de trabalho>, identifique os itens para os quais você deseja criar um link:

    1. Selecione o tipo de link. O mesmo tipo de link é aplicado a todos os itens de trabalho selecionados.

    2. Selecione os identificadores (IDs dos itens de trabalho) de todos os itens de trabalho a serem vinculados. Para obter mais informações, consulte Localizar itens de trabalho para vincular.

    3. Selecione OK.

    Captura de tela da caixa de diálogo Adicionar link à caixa de diálogo mostrando como especificar o tipo de link e os identificadores para os itens de trabalho aos quais vincular.

  4. Selecione Publicar na faixa de opções da Equipe e feche a caixa de diálogo.

  1. Selecione um intervalo de itens de trabalho na planilha usando o atalho de teclado Shift + Select . Use Ctrl + Select para adicionar ou remover itens de trabalho do grupo selecionado.

  2. Siga o procedimento para as caixas de diálogo Links e anexos e Adicionar link ao <item de trabalho> para identificar os itens de trabalho para vincular.

  3. Publique suas alterações. Os itens de trabalho identificados estão vinculados a todos os itens de trabalho selecionados na planilha.

Na caixa de diálogo Adicionar vínculo a <Item de Trabalho>, abra Escolher itens de trabalho vinculados para selecionar um ou mais itens de trabalho de destino. Se você quiser usar uma consulta salva, primeiro defina a consulta.

  1. Na caixa de diálogo Adicionar link ao <Work Item>, selecione Browse (Visual Studio):

    Captura de tela da caixa de diálogo Escolher Itens de Trabalho Vinculados.

  2. Na caixa de diálogo Escolher Itens de Trabalho Vinculados , selecione o método para que os itens de trabalho vinculem:

    Captura de tela da caixa de diálogo Escolher itens de trabalho vinculados, mostrando a opção Consulta salva selecionada.

    Configure essa caixa de diálogo da mesma maneira que Obter Itens de Trabalho. Para obter mais informações, consulte Adicionar itens de trabalho existentes à sua planilha.

Você pode alterar as colunas mostradas na lista Links :

  1. Selecione um item de trabalho na planilha e, em seguida, selecione Links e Anexos na faixa de opções da Equipe.

  2. Na caixa de diálogo Links e Anexos , selecione a guia Links e, em seguida, selecione Opções de Coluna.

  3. Na caixa de diálogo Opções de Coluna , selecione os campos que você deseja exibir:

    • Para adicionar campos, selecione um ou mais campos em colunas disponíveis e, em seguida, selecione a seta Adicionar coluna selecionada.

    • Para remover campos, selecione um ou mais campos em colunas selecionadas e selecione a seta Remover colunas selecionadas.

    Configure essa caixa de diálogo da mesma maneira que Obter Itens de Trabalho. Para obter mais informações, consulte Adicionar itens de trabalho existentes à sua planilha.

  4. Para reordenar a lista de links na caixa de diálogo Links e Anexos , selecione uma coluna para classificar a lista nesse campo:

    Captura de tela que mostra como selecionar uma coluna na lista de links para classificar a lista nesse campo.

Abrir um item de trabalho vinculado

Você pode abrir um item de trabalho vinculado de Links e Anexos.

  • Na guia Links , clique com o botão direito do mouse em um item de trabalho vinculado e selecione Abrir Item Vinculado:

    Captura de tela da caixa de diálogo Links e Anexos, guia Links, mostrando como abrir um item de trabalho vinculado.

O item de trabalho vinculado é aberto no portal da Web.

Você pode editar qualquer link listado, incluindo o tipo de link e o item de trabalho de destino.

  1. Na caixa de diálogo Links e Anexos , na guia Links , selecione o link a ser atualizado e, em seguida, selecione Editar Link.

  2. Na caixa de diálogo Editar Link , altere o tipo de link conforme necessário:

    Captura de tela da caixa de diálogo Editar link para um link selecionado.

  3. Para alterar o item de trabalho vinculado, insira a ID do item de trabalho ou selecione Procurar para localizá-lo.

    Configure campos nessa caixa de diálogo da mesma maneira que Obter Itens de Trabalho. Para obter mais informações, consulte Adicionar itens de trabalho existentes à sua planilha.

Adicionar anexos

Siga estas etapas para adicionar anexos aos seus itens de trabalho:

  1. Selecione o item de trabalho e selecione Links e Anexos.

  2. Na caixa de diálogo Links e Anexos para <Item de Trabalho>, selecione a guia Anexos.

  3. Selecione Adicionar e selecione o arquivo que você deseja anexar:

    Captura de tela da caixa de diálogo Links e Anexos mostrando como adicionar arquivos como anexos.

    Selecione OK.

  4. Selecione Publicar e feche a caixa de diálogo.

Use esse mesmo processo para adicionar os mesmos anexos a vários itens de trabalho ao mesmo tempo. Na planilha, use o atalho de teclado Shift + Select para selecionar um intervalo de itens de trabalho e Ctrl + Select para adicionar ou remover itens de trabalho do grupo selecionado. Depois de selecionar os anexos, o processo publicar aplicará os arquivos a todos os itens de trabalho selecionados.

Criar um relatório

Para consultas de lista simples, você pode criar gráficos e relatórios diretamente no portal da Web. Para obter mais informações, consulte Acompanhar o progresso criando gráficos baseados em consulta de tendência e status.

Important

Você pode criar um relatório do Excel usando a opção New Report somente de um Azure DevOps Server local. Esses relatórios exigem que a coleção do projeto seja configurada para dar suporte ao SQL Server Analytics Server.

Para criar um relatório Excel (Azure DevOps Server local), selecione Novo Relatório:

Captura de tela que mostra como criar um relatório selecionando a ação Novo Relatório na faixa de opções Equipe.

Para obter detalhes adicionais, consulte Criar um relatório.

Resolver erros de publicação

Use as seguintes referências quando as operações de publicação ou atualização falharem no Excel:

Solucionar problemas comuns

Use esta seção como um guia de recuperação rápida enquanto trabalha no Excel.

Use a IA para adicionar ou modificar itens de trabalho sem Excel

Se você configurar o servidor MCP Azure DevOps, poderá descrever tarefas de adição e modificação em massa em linguagem natural em vez de publicar e atualizar uma planilha Excel.

Use os exemplos a seguir como modelos. Substitua nomes de projeto, IDs, usuários, sprints e caminhos de área por seus valores.

Tarefa Prompt de exemplo
Adicionar uma lista simples de itens de trabalho Create 15 tasks under user story 4321 in project Fabrikam Fiber with the titles I provide.
Adicionar uma hierarquia Create an epic "Payments" in project Fabrikam Fiber with 4 features and 3 user stories per feature under area path Fabrikam Fiber\Billing.
Atualizar vários campos For all active tasks in Sprint 12, set Remaining Work to 4 and Activity to Development in project Fabrikam Fiber.
Adicionar etiquetas em lote Add tags "excel-migrated" and "cleanup" to every user story in area path Fabrikam Fiber\Web in project Fabrikam Fiber.
Transferir em massa Reassign all tasks under user story 4321 from Jamal Hartnett to Raisa Garrison in project Fabrikam Fiber.
Mover para um sprint Move all uncommitted tasks from Sprint 5 to Sprint 6 in project Fabrikam Fiber.
Definir links pai-filho Parent tasks 5001 through 5010 under user story 4321 in project Fabrikam Fiber.
Localizar itens de trabalho sem anexos List all active work items in project Fabrikam Fiber that don't have attachments.
Prioridade de atualização em massa Set Priority to 1 for all bugs tagged "regression" in project Fabrikam Fiber.
Migrar um arquivo CSV Import the CSV rows I provide as new user stories under area path Fabrikam Fiber\Web in project Fabrikam Fiber.

Note

Se você estiver usando Visual Studio Code, o modo de agente será especialmente útil para operações complexas de item de trabalho em massa.