Fontes de dados de filtros salvos
Os dados de um relatório vêm dos filtros salvos do Jira. Você adiciona cada filtro uma vez, dá um nome a ele e vincula componentes a esse nome.
Os filtros salvos são a única fonte de dados nesta versão. Não há JQL de texto livre, nem fontes REST, SQL ou CSV, nem conectores de terceiros.
Adicionar uma fonte
No editor de relatórios, Adicionar fonte de dados lista os filtros salvos que o Jira mostra a você. Escolha um e dê a ele um nome de exibição local — «Backlog do suporte», «Escalações de engenharia» — que é o que você verá no seletor de fonte do designer.
Você também pode digitar diretamente um ID numérico de filtro salvo. Se o Jira não puder ser alcançado, o seletor informa isso em vez de bloquear o editor.
Um relatório comporta até 8 fontes de dados. Os nomes devem ser únicos.
O Exportelier guarda um ID de filtro, não uma consulta
Esta é a coisa mais importante a entender sobre relatórios.
Ao adicionar um filtro salvo, o Exportelier guarda o ID numérico dele e o seu nome de exibição. Nada mais. Ele não guarda:
- o JQL do filtro — nunca é lido, copiado, registrado nem concatenado;
- os resultados do filtro — nenhum instantâneo dos itens é mantido.
No momento da exportação, o Exportelier monta um único predicado estritamente
numérico, filter = 12345, e pede ao Jira a resposta de agora.
Daí decorrem três consequências, todas deliberadas:
- O relatório acompanha o filtro. Edite o filtro salvo no Jira e a próxima exportação refletirá isso. Não há nada para ressincronizar no Exportelier.
- As regras de compartilhamento do Jira valem automaticamente. O Exportelier nunca vira um canal paralelo para contorná-las.
- Não há cópia desatualizada que possa vazar. Um relatório guarda uma referência, não dados.
Como a referência é ao vivo, editar um filtro salvo amplamente compartilhado muda todos os relatórios vinculados a ele — inclusive os de outros administradores.
Toda exportação é executada como você
O Exportelier lê o Jira como a pessoa que iniciou a exportação, nunca como o aplicativo e nunca como quem construiu o relatório.
Assim, duas pessoas podem exportar o mesmo relatório no mesmo dia e receber legitimamente documentos diferentes. Cada uma vê exatamente os itens que as próprias permissões do Jira permitem — nem mais, nem menos. Esse é o comportamento correto, não um defeito: a alternativa seria um aplicativo que mostra às pessoas dados que o Jira lhes nega.
O administrador que constrói o relatório vê os filtros que ele pode ver. Isso nunca amplia o que outra pessoa recebe.
Duas fontes, um filtro, uma busca
Se duas fontes de dados apontarem para o mesmo filtro salvo, o Jira é consultado uma única vez e o resultado é entregue às duas. Os campos de que os componentes realmente precisam são reunidos em todo o relatório e pedidos juntos, em vez de buscar «tudo» ou consultar por componente.
Você pode, portanto, adicionar o mesmo filtro duas vezes com nomes diferentes — para componentes diferentes — sem pagar em dobro por isso.
Verificação prévia: o que a exportação vai encontrar
Antes de iniciar uma exportação, o Exportelier confere cada fonte e informa um destes estados:
| Estado | O que significa | Bloqueia a exportação? |
|---|---|---|
| Pronta | O filtro foi lido e encontrou itens. | Não |
| Vazia | O filtro não corresponde a nenhum item no momento. | Não — um relatório vazio é uma resposta verdadeira. |
| Indisponível | O filtro não está disponível para você. | Sim |
| Limitada por taxa | O Jira está limitando as requisições; tente em breve. | Temporariamente |
| Erro | Não foi possível verificar o filtro. | Temporariamente |
A verificação prévia também mostra uma contagem aproximada por fonte e avisa quando uma fonte será cortada no limite por fonte.
Por que «indisponível» não diz «excluído»
O Jira responde 404 tanto para um filtro que não existe mais quanto para um
que existe mas não está compartilhado com você. Os dois casos não podem ser
distinguidos pela API, então o Exportelier não adivinha. Afirmar uma exclusão que
não pode comprovar mandaria as pessoas procurarem o problema errado; a mensagem
nomeia as duas possibilidades e sugere pedir a um administrador que compartilhe o
filtro.
Uma fonte indisponível interrompe a exportação
Um relatório com uma fonte ausente não é exportado. O trabalho falha e nomeia a fonte. É uma escolha deliberada: um relatório a que falta em silêncio uma de suas fontes de dados é materialmente falso e indistinguível de um completo.
Limites aplicáveis às fontes
- 8 fontes de dados por relatório e no máximo 8 buscas de filtro distintas.
- 500 itens por fonte e 2.000 itens únicos em todo o relatório.
- 2 buscas do Jira em paralelo — relatórios são trabalhos em segundo plano, não leituras interativas, e compartilham o orçamento de taxa do Jira do site.
Quando um limite trunca dados, o documento final diz isso, por fonte. Veja a referência de limites.