Procure tarefas no JIRA (linguagem simples). Parte 1: Pesquisa rápida e básica

Recentemente, o JIRA é usado ativamente por organizações que não têm uma conexão direta com a TI. É difícil para especialistas que não estão familiarizados com o JIRA antes entender a estrutura das consultas JQL se você não der exemplos.

Para simplificar a percepção, decidimos coletar toda a documentação, localizar e colocar em um só lugar. E começaremos com as pesquisas "básicas" e "rápidas" .



Muitos enfrentaram a necessidade de encontrar uma tarefa adequada na variedade de tarefas já criadas ou selecionar um grupo de tarefas que atendam a certos critérios. Para isso, o JIRA fornece funcionalidade flexível projetada para um especialista técnico e um usuário comum, além de permitir salvar pesquisas para uso posterior. Uma solicitação salva é chamada de filtro.

Existem três maneiras de procurar tarefas no JIRA:

  1. Rápido.
  2. Basic.
  3. Avançado (JQL).

Neste artigo, falaremos sobre a pesquisa "básica" e "rápida" . Como usar a pesquisa JQL "avançada" - contaremos na próxima publicação.

Vale ressaltar que, independentemente do método de pesquisa selecionado, apenas as tarefas disponíveis para sua visualização serão retornadas como resposta. A acessibilidade é determinada por direitos de acesso e esquemas de segurança em projetos que possuem essas tarefas.

Pesquisa rápida


A maneira menos precisa e rápida de encontrar tarefas no JIRA. O campo de entrada está localizado no canto superior direito da tela. Para usá-lo, basta começar a digitar o que você está procurando.



1. Salto rápido para a tarefa

Se a chave da tarefa em que você está trabalhando for conhecida, para uma transição rápida, você precisará inseri-la e pressionar Enter.

Suponha que você esteja trabalhando em uma tarefa com a chave "YAT-106"; nesse caso, você pode inserir o valor "YAT-106" ou "yat-106" no campo "Pesquisar".

Muitas vezes, você nem precisa digitar a chave completa, basta digitar a parte digital. Se você estiver trabalhando no projeto "YAT", quando entrar no campo "106", o sistema o redirecionará automaticamente para "YAT-106".

2. Pesquisa rápida inteligente

O JIRA permite que você use uma pesquisa rápida "inteligente" com digitação mínima. Por exemplo, para pesquisar todas as tarefas do tipo "Tarefa" no projeto "YAT" com o status "Concluído", é necessário pesquisar a sequência "Tarefa concluída YAT". E o JIRA o redireciona para a janela do navegador com tarefas selecionadas pelos critérios especificados.

A tabela abaixo lista os termos específicos para a pesquisa rápida inteligente:
Parâmetro de pesquisaDescrição do produtoExemplo de string de pesquisa
meuProcure tarefas atribuídas a você.minha tarefa aberta
r:Procure tarefas de autoria de
você ou outro usuário ou autor
não definido.

Cuidado
Entre "r:" e definição do autor
Não deve haver espaços.
r: me - procure tarefas,
qual você é o autor.

r: demo_3 - procure tarefas criadas por
é um usuário com o nome de usuário demo_3.

r: nenhum - pesquisa tarefas,
cujo autor não está definido.
<nome do projeto>
ou
<chave de projeção>
Pesquise todas as tarefas
projeto específico
pelo seu nome ou chave.
Projeto Yat
Yat
yat
vencidoProcure tarefas cujo prazo final
expira hoje ou já terminou.
vencido
criado:
atualizado:
vencimento:
Procure tarefas cujos parâmetros de data
"Criado" (Criado),
"Atualizado",
Data de vencimento
atenderia aos critérios fornecidos.

Nesse sentido,
o parâmetro Criado
corresponderá a "criado",
"Atualizado" - "atualizado",
"Data de Vencimento" - vencimento.

Ao definir condições, você pode usar os termos
"Hoje", "ontem", "amanhã".

Um registro no formato "-1w", "1w" que denota,
que a data de interesse para nós está no intervalo
de (-1 semana) a (+1 semana) do atual
hora do sistema.

Um registro do formulário "1w" significa que estamos interessados ​​em
data está no intervalo de (+1 semana)
a partir da hora atual do sistema.

Abreviações válidas para data e hora:
'w' (semana), 'd' (dia), 'h' (hora), 'm' (minuto).
criado: hoje - seleção de tarefas,
criado para o dia atual.

criado: ontem -
tarefas criadas ontem.

atualizado: -1w - tarefas,
atualizado na última semana.

vencimento: 1w - a data de vencimento começa em
uma semana a partir da data atual.

vencimento: -1d, 1w - data de vencimento
encontra-se na faixa
de (<data atual> - 1 dia)
até (<data atual> + 1 semana)

criado: -1w, -30m - data de criação
encontra-se na faixa de
(<data e hora da data atual> - 1 semana)
até (<data e hora atuais>
- 30 minutos)

criado: -1d atualizado: -4h - tarefas criadas
para o ultimo dia
e atualizado durante
quatro anteriores
horas.

<prioridade>Procure tarefas com uma determinada prioridade.crítico
alto
médio
baixo
<tipo de emissão>Procure tarefas de um tipo específico.

Cuidado
Você pode usar valores plurais.
inseto
tarefa
insetos
tarefas
<resolução>Pesquise tarefas pelo valor do campo "Resolução".fixo
duplicar
c:Procure tarefas com um específico
o valor do campo "Componente / s".

Cuidado
Entre "c:" e definição de componente
Não deve haver espaços.
c: segurança - tarefas
em nome dos componentes dos quais
contém a palavra "segurança".
v:Procure tarefas por valor
Afeta os campos da versão / s
(Aparece em versões)

Cuidado
Não deve haver espaços entre "v:" e a definição da versão.
v: 3.0 - tarefas são selecionadas,
com valores para o campo
"Afeta as versões"
(Aparece em versões):

3.0
3.0 eap
3.0 beta

Mas não inclui tarefas
com os seguintes valores
para o campo "Afeta versões / s"
(Aparece em versões):

3.0.1
3.0.0.4

Para selecionar tarefas que contenham
também versões secundárias e versões de montagem,
um registro do formulário é usado:

v: 3.0 *

Como resultado do lançamento, as tarefas serão selecionadas
com valores para o campo
"Afeta as versões"
("Aparece em versões"):

3.0
3.0 eap
3.0 beta
3.0.1
3.0.0.4

ff:Procure tarefas por valor
Campos "Fix Version / s"
(Corrigido nas versões).

A pesquisa pelo parâmetro "ff:" é realizada
semelhante à pesquisa pelo parâmetro "v:".
ff: 3.0
ff: 3.0 *

3. Pesquisa rápida de texto

Você também pode selecionar tarefas que contenham texto específico - basta inseri-lo no campo "Pesquisar". O JIRA procura tarefas no texto em apenas três campos específicos:

  • "Resumo" ("Tema");
  • "Descrição";
  • "Comentários" ("Comentários").

Pesquisa básica


Essa é uma interface de usuário conveniente para selecionar tarefas. Para usá-lo, você não precisa conhecer o JIRA Query Language (JQL).

Vá para o item de menu Pesquisar → Pesquisar consultas ;



e selecione seu critério de pesquisa:



Por padrão, a pesquisa "base" contém:

  1. O critério "Projeto" na lista suspensa para selecionar projetos que contenham tarefas de seu interesse.
  2. Critério "Tarefa / Tipo" na lista suspensa para selecionar o tipo de tarefas.
  3. O critério "Status" na lista suspensa para selecionar tarefas pelo status do fluxo de trabalho.
  4. O critério "contratante" para a seleção de tarefas atribuídas a artistas específicos. Como artistas, você pode selecionar usuários específicos do JIRA ou um grupo JIRA (as tarefas atribuídas a esse grupo serão exibidas).
  5. O critério "Contém texto" para selecionar tarefas que podem conter texto específico nos campos "Resumo", "Descrição" ou "Comentários".

Se você precisar adicionar outro campo aos critérios de pesquisa, então:

  1. Para começar, recomendamos que você defina os projetos a serem pesquisados ​​no campo "Projeto";
  2. Defina o tipo de tarefas no campo "Tipo";
  3. Na lista suspensa "Mais", comece a inserir o nome do campo que será usado como critério de seleção.



4. Marque a caixa ao lado do campo obrigatório;
5. Defina os critérios de seleção para este campo.


Para remover os critérios de seleção adicionados, basta usar o botão
para este critério.

Uma consulta de uma pesquisa "base" pode ser traduzida em uma pesquisa JQL "avançada" e vice-versa. No entanto, uma consulta de uma pesquisa JQL "avançada" não pode ser convertida em uma "base" se:

  1. a solicitação contém uma instrução OR ;
  2. a solicitação contém um operador NOT ;
  3. a solicitação contém uma declaração VAZIA ;
  4. contém qualquer um dos operadores de comparação ! =, IS, IS NOT,>,> =, <, <= .
  5. a solicitação indica os campos que na pesquisa "básica" ficam disponíveis somente após a seleção dos critérios do projeto e do tipo de tarefas.

Cuidado

Regra geral: se a consulta não puder ser criada na forma de uma pesquisa "básica", não poderá ser convertida de JQL "avançado" para "básico".

Falaremos sobre os recursos da pesquisa JQL "avançada" no próximo artigo ;)

Source: https://habr.com/ru/post/pt448034/


All Articles