Componentes de relatório
Quatro componentes leem um conjunto inteiro de itens em vez de um único item. São componentes normais do designer — você os arrasta para a tela como qualquer outro — mas cada um carrega uma configuração de fonte de dados.
Vincular um componente aos dados
Todos esses componentes fazem a mesma pergunta: quais itens?
| Onde você está | O que o seletor de fonte oferece |
|---|---|
| Um modelo de exportação normal (item, quadro, sprint, versão, backlog, JQL) | Conjunto exportado atual — os itens sendo exportados. Sem busca adicional no Jira. |
| Um relatório | As fontes de dados nomeadas do relatório. |
Os dois não são intercambiáveis. Uma fonte nomeada só é resolvida dentro de um relatório; um componente vinculado a uma que não existe mais exibe um diagnóstico visível nomeando a fonte ausente, em todos os formatos. Ele nunca renderiza vazio em silêncio.
Quando um relatório tem mais de uma fonte, nada é adivinhado. Um gráfico vinculado ao filtro errado produz um documento que parece correto e não é — pior do que um que falha abertamente.
Gráfico de categorias
Agrupa o conjunto de itens por um campo agrupável e desenha a distribuição como gráfico de pizza, rosca ou barras horizontais.
- No máximo 20 categorias; acima disso, as categorias excedentes são agrupadas em Outros ou truncadas, conforme a configuração do componente.
- Valores vazios aparecem como Nenhum.
- Em campos multivalorados como rótulos, as porcentagens contam atribuições de categoria, não itens: um item com três rótulos contribui com três.
- Truncamento e valores não suportados sempre geram uma nota visível.
Cartão de KPI
Um único número em destaque com seu rótulo. Escolha uma métrica:
| Métrica | O que conta |
|---|---|
| Contagem de itens | Itens na fonte. |
| Itens concluídos | Itens cuja categoria de status é Concluído. |
| Percentual de conclusão | Itens concluídos como porcentagem da fonte. |
| Campo numérico | A soma ou a média de um campo numérico. |
A agregação numérica aceita apenas números finitos. Valores vazios ou não numéricos são ignorados e contados de forma visível, de modo que um cartão construído sobre um campo meio preenchido nunca engana em silêncio sobre a própria base.
Opcionalmente, o cartão mostra o nome da fonte de dados lida — útil quando vários cartões ficam lado a lado.
Tabela de itens
Uma linha por item, com as colunas que você escolher.
- Qualquer campo padrão ou personalizado por coluna, com cabeçalho e largura próprios opcionais.
- Ordenação opcional por um campo, crescente ou decrescente.
- Até 200 linhas. Se a fonte tiver mais, a tabela mostra as primeiras linhas e informa quantas foram omitidas.
- Linha de contagem opcional («12 de 47 linhas») e linha de cabeçalho opcional.
Os valores dos campos são renderizados e convertidos exatamente como nas demais tabelas do Exportelier, de modo que um campo personalizado tem a mesma aparência em qualquer lugar.
Matriz bidimensional
Uma tabela cruzada: um campo nas linhas, outro nas colunas, contando itens em cada célula.
- Ambos os eixos são limitados a 12 grupos. Acima disso, os valores restantes caem em um grupo Outros determinístico — a mesma entrada sempre produz a mesma tabela.
- Totais de linha, de coluna e total geral opcionais.
- Renderizada como tabela real e acessível em todos os formatos, nunca como imagem.
Como cada formato os representa
O Exportelier compila um modelo para quatro formatos. A tabela reflete o que os renderizadores realmente produzem — um formato só é marcado como completo quando carrega todos os valores, não quando apenas se parece.
| Componente | Word (DOCX) | Markdown | Excel (XLSX) | |
|---|---|---|---|---|
| Gráfico de categorias | Gráfico vetorial com rótulos e valores | SVG incorporado com alternativa em PNG, seguido de uma tabela de categorias | Tabela de categorias; as barras horizontais ganham também barras de texto. Pizza e rosca não são simuladas por imagem. | Planilha de dados com as colunas Category, Count e Percent |
| Cartão de KPI | Completo | Completo | Completo | Uma linha na planilha Summary compartilhada, não uma planilha própria |
| Tabela de itens | Completo | Completo | Completo | Completo — uma linha por issue, uma coluna por coluna configurada |
| Matriz | Completo | Completo | Completo | Completo — grupos de linhas × grupos de colunas, com totais quando configurados |
Nomes de categoria e números permanecem sempre disponíveis como texto, de modo que a cor nunca é o único portador de informação.
A saída Markdown escapa tudo o que, nos seus dados do Jira, quebraria a estrutura da tabela: o texto do item continua sendo texto.
Limites
Um relatório pode conter no máximo 30 componentes orientados a dados. Junto com os tetos por fonte e por tabela, isso limita o custo de uma exportação — veja a referência de limites.