Ícone do LinkedIn Ícone do RSS

17 Mai 2021 | 6 minutos • Ferramentas

Azure Boards - Queries - Parte II

Importando work items

Ingrid Machado

Ingrid Machado

Engenheira de computação, especialista em engenharia de software. Autora deste querido blog.

Image de capa do post Azure Boards - Queries - Parte II
Foto de Sergi Kabrera, via Unsplash

No post anterior, mostrei a visão de queries e como os work items são exibidos quando rodamos uma consulta. Agora falarei sobre como podemos importar work items no projeto utilizando um arquivo CSV.

Importando work items

Retornando para a visão de queries, ao clicar em “Import work items”, é exibida a tela de importação com a opção de fazer o upload de um arquivo CSV:

Tela de importação de work items

Então primeiro precisamos criar esse arquivo de importação. Aqui vou mostrar como crio o arquivo de importação a partir dos work items existentes. Se você já possui work items no projeto ou criou os work items de exemplo no post anterior, então será possível acompanhar esse post na prática.

Criando um arquivo de importação

Sempre que vou criar um arquivo de importação no Azure, eu gero uma query de teste, com as colunas que quero importar e depois preencho esse arquivo. É uma boa forma de garantir que o arquivo estará no formato correto.

Como já criamos 3 primeiros work items na mão, vou usar eles como modelo para o arquivo que vou utilizar para incluir novos work items e editar os work items existentes.

Exportando os work items de exemplo

Dentro do menu “Boards – Query”, faça uma query com a seguinte configuração:

Query para consultar todos os work items e exibí-los como árvore

Ao clicar em “Run query”, a query busca todos os work items do projeto, organizando-os em uma árvore, seguindo a hierarquia:

Tela com o resultado da query

Para gerar o arquivo de importação, basta clicar em “Export to CSV”.

Escolhendo as colunas que serão exportadas no arquivo

Caso queira incluir ou remover alguma coluna no arquivo, basta clicar em “Column options” e escolher as colunas que devem ser exibidas no resultado. O arquivo CSV sempre será criado com essas colunas, então edite isso antes de exportar o resultado. Para simplificar um pouco mais o exemplo, removi algumas colunas, deixando somente as colunas ID, Work Item Type, Title e State.

Tela para editar as colunas exibidas no resultado da query

Editando o arquivo de importação

Para ficar mais fácil de editar, abra uma nova planilha no Excel e importe o arquivo CSV seguindo o menu “Dados – De Text/CSV”. Depois de importado, o arquivo gera a seguinte tabela:

Excel com os work items exportados

Todos os work items existentes no projeto são exportados com o ID. Ao incluir uma linha na tabela sem ID, um novo work item é criado a partir dessa linha, enquanto linhas que possuem um ID podem ser interpretadas de duas formas:

Vamos fazer aqui os dois exemplos.

Editando work items

Para esse exemplo, vamos apenas alterar o nome da User Story para o título correto:

Excel com o nome da User Story corrigido

Apenas alterar o título na linha correspondente e importar o arquivo no Azure já seria o suficiente para essa correção. Mas também queremos incluir mais work items.

Incluindo work items

Sobre a estrutura da tabela: a cada linha adicionada, onde o título e o tipo seguem a lógica de hierarquia dos work items de forma correta, o Azure considera como um filho direto. Perceba que o Epic está com o título na coluna “Title 1”, a Feature com o título na coluna “Title 2” e a User Story com o título na coluna “Title 3”. Essas colunas indicam a hierarquia no arquivo. Se houvesse apenas a Feature e a User Story, a Feature estaria com o título na coluna “Title 1” e a User Story com o título na coluna “Title 2”. Se houvesse apenas work items não relacionados, haveria apenas a coluna “Title 1”.

Relembrando, defini os seguintes work items para o exemplo:

Então, precisamos adicionar duas User Stories na Feature Login:

Excel com as duas User Stories faltantes associadas à feature

Como são novas, não preenchi a coluna ID. Assim, o work item será criado e o Azure atribui o próximo ID disponível no momento da criação. Repare também que segui a hierarquia, colocando o título das User Stories dentro da coluna “Title 3”.

Para incluir a segunda Feature com as suas respectivas User Stories, basta seguir a mesma lógica:

Excel com a Feature faltante e as suas respectivas User Stories

A Feature foi adicionada com o título em “Title 2” e as User Stories filhas estão diretamente abaixo com os títulos em “Title 3”.

Resumindo:

Convertendo o arquivo de importação

Quando fazemos a edição do arquivo no Excel, é necessário converter o arquivo para o formato aceito pelo Azure. Vou mostrar como costumo fazer, mas aceito sugestões para um processo mais simples.

  1. Salvo o arquivo como “Texto em Unicode (*.txt)” no Excel:

Opção do Excel para salvar o arquivo txt

  1. Substituo os espaçamentos por vírgula no editor de texto:

Bloco de notas com o arquivo txt

Bloco de notas com o arquivo txt com as vírgulas no lugar dos espaçamentos

Dependendo do editor, recomendo que você selecione o espaçamento entre dois valores de colunas adjacentes, senão o arquivo vai ficar mal formatado.

  1. Por último, basta salvar com a extensão .csv. E esse é o arquivo que será utilizado no Azure.

Parece muito trabalho, mas assim garantimos que o arquivo será importado sem nenhum erro de formatação.

Dentro de “Boards – Queries”, ao clicar em “Import Work Items” a tela para importação será exibida. O arquivo que deve ser selecionado para upload é o com a extensão .csv:

Tela de importação de work items

Quando o arquivo é importado sem erros, o Azure exibe as alterações e inclusões:

Tela de importação de work items, com os work items importados

É possível salvar todas as alterações clicando em “Save items” ou salvar individualmente cada alteração clicando em “Save” dentro do work item.


Quis mostrar uma forma diferente de importação que, apesar de parecer um pouco extensa, facilita muito o meu trabalho. Se você ficou com alguma dúvida, fique à vontade para perguntar nos comentários.

Até a próxima!

O link do post foi copiado com sucesso!

Mais conteúdos de Ingrid Machado

Imagem de capa do post Acompanhamento financeiro para contas compartilhadas

12 Set 2022 • Ferramentas

Acompanhamento financeiro para contas compartilhadas

Em junho, participei do Coda Bootcamp. Para o curso ser concluído, deve ser feito o envio de um projeto para demonstrar o que aprendi durante o treinamento. E, como já tinha substituído o acompanha...

9 minutos

Imagem de capa do post Ferramentas que uso para produzir a newsletter

22 Jul 2022 • Ferramentas

Ferramentas que uso para produzir a newsletter

Esses dias, precisei listar as ferramentas que uso para produzir a Trilha de Valor e notei que nunca havia pensado sobre. Até por isso, acredito que devo estar usando mais do que o necessário. Nest...

2 minutos

Imagem de capa do post Coda - Publicando documentos

17 Jun 2022 • Ferramentas

Coda - Publicando documentos

Este texto faz parte da série de posts sobre o Coda. No post de formatação de páginas e texto eu incluí um documento de exemplo embedado. Diferentemente dos outros exemplos, você deve ter perc...

2 minutos

linkedin icon
LINKEDIN
Twitter icon
TWITTER
RSS icon
RSS

Ingrid Machado © 2019 - 2022

• Ingrid Machado © 2019 - 2022

• Layout por Victoria Facundes • Desenvolvido por Cristhian Rodrigues

VOLTAR AO TOPO

voltar para o topo