Ícone do LinkedIn Ícone do RSS

24 Mai 2021 | 4 minutos • Ferramentas

Azure Boards - Queries - Parte III

Fazendo consultas

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 III

Queries - Parte III

Nos posts anteriores, vimos uma introdução a respeito das queries. Espero que até o momento você já tenha entendido como que a visão de queries exibe as consultas e como podemos usar essa mesma tela para fazer a importação de work items.

Agora que temos uma estrutura de exemplo, com todos os tipos de work items que vamos usar no processo Agile, vou mostrar alguns exemplos de queries que podemos rodar no Azure.

Editor de queries

Ao acessar “Boards – Queries – New Query”, é possível visualizar o editor de queries:

Editor de queries

Antes de mostrar os exemplos de consultas que podemos fazer, vou explicar o que é cada parte do editor.

As três primeiras opções permitem selecionar entre a visão de resultados, do editor e dos gráficos. Dentro do editor, temos as seguintes opções:

Type of query

Existem três tipos de query:

Para os exemplos deste post, vou usar a opção “Flat list of work items”.

Filters for top level work items

Seção onde ficam os filtros que vamos aplicar nas queries, onde cada um desses filtros se chama cláusula. Na primeira coluna temos a opção de adicionar ou remover uma cláusula. Na segunda coluna, podemos selecionar as cláusulas que gostaríamos de agrupar. A coluna “And/Or” permite alternar as condições E e OU da query.

Além dessas, também existem as colunas:

Exemplos de queries

Primeiramente vamos relembrar todos os work items que criamos no post anterior. Para isto, basta clicar em “Run query”:

Tela com o resultado da query para consultar todos os work items

A query retorna todos os work items porque ela faz a seguinte consulta:

Work Item Type = [Any] And State = [Any]

Isso significa que a query deve retornar work items de qualquer tipo e em qualquer status. Sendo assim, o resultado retorna todos os work items existentes no projeto.

Consultando somente as User Stories

Seguindo a mesma lógica, para consultar somente as User Stories, podemos alterar somente o campo “Value”, na primeira cláusula da query anterior:

Work Item Type = User Story And State = [Any]

Ao clicar em “Run query”, não serão mais retornados o Epic e as duas Features.

Consultando as User Stories com a palavra “senha” no nome

Nesta consulta, basta substituir a segunda cláusula por uma cláusula que utiliza o campo “Title” e a operação “Contains Words”:

Work Item Type = User Story And Title Contains Words senha

Consultando as User Stories que estão no meu nome

Para esta consulta, substituímos a segunda cláusula por uma cláusula que utiliza o campo “Assigned To”:

Work Item Type = User Story And Assigned To = @Me

Como nenhuma User Story foi colocada no meu nome, o retorno é vazio. O valor @Me indica uma macro de consulta.

Como existem diversas opções possíveis para o “Field” e para o “Value”, sugiro que você faça diversos exemplos de queries, com diferentes combinações. Mas a ideia principal é bem simples e acredito que esses exemplos demonstram o uso básico.

Macros de consulta

As macros são variáveis que podemos utilizar dentro das queries. No exemplo, a macro @Me indica que o usuário na consulta é o meu. Por baixo dos panos, a cláusula consultará da seguinte forma:

Work Item Type = User Story And Assigned To = Ingrid Machado

Se eu salvar essa query publicamente e outro usuário clicar em “Run Query”, o resultado exibido será com os work items que estão no nome desse outro usuário.

O uso de macro é bem interessante para queries compartilhadas e queries que serão utilizadas em dashboards. Essas são as que mais costumo usar:

Salvando queries

Ao clicar em “Save query”, é exibida a opção de salvar a query. E existem duas pastas:

Tela com as opções para salvar a query

Também é possível criar novas pastas dentro dessas duas pastas default.


Com este post, está encerrada a parte de queries. Apesar de ter muito mais para mostrar, acredito que posts muito extensos e que esgotem toda a documentação tirariam um pouco do foco.

Mas fique à vontade para tirar qualquer eventual dúvida. Como sempre, a caixa de comentários e o meu email estão disponíveis.

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