Construtor de relatórios
A maioria das exportações do Exportelier parte de algo que você já está vendo: um item, um quadro, uma sprint. Um relatório funciona ao contrário: é um objeto salvo que nomeia os próprios dados. Você o constrói uma vez, e quem tiver permissão para exportá-lo obtém os números atuais.
Um relatório é exatamente duas coisas:
- Um modelo — um modelo normal do designer. Não existe um «modelo de relatório» separado nem um segundo designer.
- Uma ou mais fontes de dados nomeadas — cada uma um filtro salvo do Jira.
Os componentes do modelo são então vinculados a uma fonte pelo nome, de modo que um único relatório pode mostrar «Backlog do suporte» ao lado de «Escalações de engenharia» no mesmo documento.
Special Reports: relatórios guardados no separador Dashboard.
Começar por um painel do Jira
Você pode construir um relatório do zero — escolher os filtros, colocar os componentes de relatório, vincular cada um — ou começar por um painel do Jira que já tenha.
Importar de um painel do Jira lê a configuração do painel e constrói um relatório comum a partir dela. Importa o que um gadget está configurado para mostrar, não uma imagem dele, e o resultado não fica sincronizado depois: os dados dos filtros continuam ao vivo, mas layout e configuração só mudam quando você reimporta explicitamente.
Onde ficam os relatórios
Os relatórios têm uma página própria no Export Center, ao lado das suas visualizações de exportação. A lista mostra nome, descrição, número de fontes de dados, modelo, escopo, última atualização e se o relatório está disponível para exportação.
Todos que podem usar o Exportelier veem a lista. O que você pode fazer ali depende do seu papel.
Quem pode fazer o quê
| Ação | Administrador do site | Qualquer usuário autenticado do Jira |
|---|---|---|
| Ver a lista de relatórios | ✅ | ✅ |
| Exportar um relatório habilitado | ✅ | ✅ |
| Criar, editar, duplicar, excluir um relatório | ✅ | — |
| Abrir o designer do relatório | ✅ | — |
| Adicionar ou alterar fontes de dados | ✅ | — |
As ações administrativas não são apenas ocultadas de quem não é administrador: o servidor as recusa, então chamar a API diretamente não adianta.
Um administrador do site pode construir um relatório a partir de qualquer filtro que ele veja. Isso não concede acesso a mais ninguém. Cada exportação relê o Jira como a pessoa que está exportando — veja resultados por usuário.
Construir um relatório
O editor de relatórios tem quatro partes, na ordem em que são usadas:
- Detalhes do relatório — nome, descrição, escopo e se o relatório está habilitado para exportação.
- Fontes de dados — adicione cada filtro salvo e dê a ele um nome que faça sentido na sua organização. Veja Fontes de dados de filtros salvos.
- Designer — o designer visual de sempre. Cada componente de dados ganha um seletor de fonte com as suas fontes nomeadas.
- Pré-visualização e exportação — confira o vínculo e exporte.
Um relatório não pode ser salvo enquanto um componente não tiver uma fonte de dados válida. O editor nomeia os componentes em questão em vez de vinculá-los em silêncio à primeira fonte disponível.
Uma fonte que nenhum componente usa é permitida — talvez você queira preparar um vínculo — mas o editor avisa, e a exportação final também.
Começar pelo modelo incluído
Novo relatório a partir do Dashboard Report Standard é o caminho mais rápido. Ele copia o modelo de sistema incluído para um modelo editável, pede pelo menos um filtro salvo e depois pergunta qual fonte de dados alimenta cada um dos três gráficos padrão.
Com um único filtro, essa resposta é preenchida para você. Com vários, nada é adivinhado: o relatório só pode ser criado quando cada gráfico estiver atribuído, porque um gráfico mal vinculado produz um relatório que parece certo e não é.
O modelo de sistema em si nunca é modificado.
Exportar um relatório
As exportações de relatórios sempre são executadas em segundo plano, porque ler vários filtros e renderizar um documento não cabe em uma requisição interativa.
Antes de o trabalho começar, uma verificação prévia confere cada fonte de dados e mostra o que encontrou — pronta, vazia ou indisponível, com uma estimativa de itens e um aviso quando uma fonte for atingir o limite por fonte. Em seguida você escolhe PDF, Word (DOCX) ou Markdown e inicia a exportação.
Durante a execução você vê fases honestas — planejamento, leitura dos filtros do Jira, renderização, preparação do download — e pode cancelar a qualquer momento. As exportações de relatórios aparecem em Exportações ativas ao lado das comuns, cada uma identificada pelo nome do relatório, e uma lista de exportações de relatórios recentes permite reabrir um trabalho depois de fechar a caixa de diálogo.
O documento final relata o que de fato continha: quantos itens cada fonte contribuiu, onde um limite o truncou e quais fontes o relatório define sem que nenhum componente as use.
Se um dos filtros salvos do relatório não estiver disponível para você, a exportação falha e nomeia essa fonte. Ela não renderiza em silêncio um relatório menor — um documento sem uma fonte de dados tem exatamente a mesma aparência de um completo.
Limites
Os relatórios têm tetos próprios: fontes por relatório, itens por fonte, linhas por tabela e assim por diante. Cada um é aplicado no servidor e nomeado na saída quando realmente trunca algo. Veja a referência de limites.