Importar de um painel do Jira
O Exportelier pode ler um painel do Jira e construir um relatório a partir do que encontrar. Você escolhe um painel, o Exportelier informa gadget por gadget o que entendeu, você completa o que o Jira não entregou e obtém um relatório editável comum.
Vale conhecer duas coisas antes de começar, porque elas determinam todo o resto desta página.
O Exportelier importa a configuração do painel — qual filtro, qual campo, qual tipo de gráfico — e a reconstrói com os próprios componentes. O resultado não é uma captura de tela, nem uma cópia fiel ao pixel, nem uma página do Jira incorporada. Larguras de coluna, molduras de gadgets e espaçamento exato não são reproduzidos, porque a API pública do Jira não os expõe.
A Atlassian não garante que as configurações de um gadget nativo sejam legíveis por uma API pública. Quando uma configuração não é legível, o Exportelier pede que você a escolha. Ele nunca adivinha qual filtro ou qual campo você quis dizer.
O que pode ser importado
| Gadget do Jira | Vira | Observações |
|---|---|---|
| Filter Results | Tabela de itens | Mantém as colunas escolhidas e sua ordem |
| Pie Chart | Gráfico de categorias (pizza) | Usa o tipo de estatística do gadget |
| Work Item Statistics | Gráfico de categorias (barras) | Usa o tipo de estatística do gadget |
| Two Dimensional Filter Statistics | Matriz | Usa os campos de ambos os eixos |
| Created vs. Resolved Chart | Gráfico de séries temporais | Mantém o período e o histórico do gadget — veja os limites abaixo |
| Sprint Burndown | — | Exige dados históricos de sprint que o Exportelier ainda não oferece |
| Qualquer outro | — | É nomeado e excluído, nunca descartado em silêncio |
Cada gadget do painel recebe exatamente um status:
- Pronto — reconhecido, e tudo o que era necessário estava legível.
- Precisa de reparo — reconhecido, mas você precisa informar uma configuração que falta.
- Disponível mais adiante — reconhecido, mas o componente correspondente do Exportelier ainda não existe. O Sprint Burndown está aqui.
- Sem suporte — um gadget de terceiros ou desconhecido. Ele é nomeado, não escondido.
- Erro — o Jira não deixou o Exportelier lê-lo, ou o que foi lido era contraditório. Esse status bloqueia a importação até você resolver no Jira.
O reconhecimento usa a identidade técnica do gadget, nunca o título. Renomear um gadget no Jira, ou usar o Jira em outro idioma, não muda o que o Exportelier faz com ele — e chamar um gadget próprio de «Pie Chart» não o transforma em um.
O que um gráfico de criados x resolvidos mostra
Um gráfico de criados x resolvidos importado conta as datas de criação e de resolução dos itens que o seu filtro salvo retorna hoje. Ele não reconstrói quais itens o filtro retornava no passado.
Isso importa quando o conteúdo do filtro mudou. Se um item saiu do projeto que o filtro cobre, ele desaparece de todos os períodos do gráfico — inclusive dos anteriores à mudança. O próprio gadget do Jira se comporta da mesma forma e pelo mesmo motivo, mas vale saber antes de comparar duas exportações separadas por meses.
Há outras três diferenças possíveis, e cada uma é citada no aviso de completude do relatório quando se aplica:
- Período do relatório. Diário, semanal e mensal são reproduzidos com exatidão. Por hora vira diário, e trimestral e anual viram mensal — os totais não mudam, apenas a largura de cada período.
- A linha de tendência de não resolvidos. O Jira pode sobrepor uma terceira linha com os itens em aberto ao longo do tempo. O gráfico do Exportelier mostra apenas as séries de criados e resolvidos.
- Histórico. Um período maior que 366 dias é reduzido a 366 dias.
Todo o resto — o filtro, o modo acumulado, os próprios números — é mantido sem alteração, e você pode editar cada uma dessas configurações no designer depois.
A importação
- Abra Relatórios e escolha Importar de um painel do Jira.
- Escolha um painel. Aqui aparecem apenas os painéis que o Jira já mostra a você: ser administrador do site no Exportelier não amplia a lista.
- Leia a análise. Cada gadget aparece com seu status.
- Repare o que precisar. O filtro salvo e os campos são escolhidos nos seletores habituais; não há campo de JQL bruto, por decisão de projeto.
- Revise a completude. Tudo o que ficará de fora é listado pelo nome, e você precisa confirmar as exclusões explicitamente antes de poder criar o relatório.
- Crie o relatório. Ele abre no editor normal, totalmente editável.
Qualquer coisa ainda marcada como Precisa de reparo ou Erro bloqueia a criação. O Exportelier prefere recusar a produzir um relatório que omita metade de um painel em silêncio.
O aviso de completude
Todo relatório importado começa com um aviso de completude: um componente real do documento, não uma dica na interface. Ele nomeia o painel de origem, quando foi importado, quantos gadgets do painel estão incluídos e todos os que não estão, por título.
É uma nota informativa quando tudo foi importado e um alerta quando algo ficou de fora. Aparece igualmente em PDF, Word e Markdown.
Enquanto o relatório continuar vinculado à sua importação, o Exportelier gerencia o aviso: você pode reorganizar livremente o restante do layout, mas não pode excluí-lo nem reescrevê-lo. Se ainda assim ele for removido ou alterado, o relatório não será exportado — um documento que afirma representar um painel enquanto omite parte dele em silêncio é pior do que nenhum documento.
Se quiser um relatório sem o aviso, duplique-o. Uma duplicata é um relatório comum, sem importação por trás e sem aviso gerenciado.
Acompanhar o painel
A importação é um instantâneo da configuração do painel. Os dados continuam ao vivo: um relatório lê seus filtros salvos no momento da exportação, então os números estão atualizados mesmo meses depois.
O que não se atualiza sozinho são layout e configuração. Se alguém adicionar um gadget no Jira, ou apontar um para outro filtro, seu relatório continua exatamente como antes até você decidir o contrário.
Abra o relatório e use Verificar alterações. O Exportelier lê o painel de novo e classifica cada gadget como adicionado, removido, movido, configuração alterada ou sem alterações. Importar novamente então aplica isso:
- gadgets sem alterações e movidos mantêm o que têm;
- o que você acrescentou ao relatório manualmente fica intacto;
- gadgets alterados e adicionados recebem conteúdo novo;
- um gadget cuja nova configuração não pode ser resolvida automaticamente interrompe a reimportação e vai para reparo, em vez de sobrescrever seu trabalho com um palpite;
- um gadget excluído como "disponível mais adiante" que uma versão mais recente do Exportelier já consegue importar aparece como alterado, e a reimportação o adiciona ao fim do relatório. Relatórios existentes nunca ganham um componente só porque uma versão foi lançada — você precisa pedir.
Antes de cada reimportação uma versão do modelo é salva automaticamente, então Restaurar versão a desfaz.
Não há agendador nem sincronização em segundo plano. A reimportação acontece quando você pede.
Permissões
Importar, reimportar e excluir uma importação são ações de administrador do site.
Cada leitura de painel, gadget e filtro durante uma importação é executada como a pessoa que a realiza: um administrador não consegue importar um painel que o Jira não lhe mostra. As exportações posteriores releem os filtros do relatório como quem exporta, então a importação não amplia o acesso de ninguém aos dados do Jira. Veja Permissões e papéis.
Limites
| Limite | Valor |
|---|---|
| Gadgets analisados por importação | 12 |
| Gadgets oferecidos para seleção acima desse teto | 60 |
Um painel com mais de doze gadgets não é truncado. Você é solicitado a escolher quais gadgets importar, e os que ficarem de fora são nomeados no aviso de completude como qualquer outra exclusão.
Um relatório importado é um relatório comum e herda todos os limites de relatório — fontes de dados, componentes, itens por fonte. Veja a referência de limites.
Sobre a API do Jira utilizada
O Exportelier lê painéis apenas pela API REST de painéis do Jira Cloud documentada pela Atlassian. Ele não analisa páginas web do Jira, não lê iframes de gadgets, não captura telas e não usa endpoints não documentados.
Uma dessas operações — Get gadgets, que lista os gadgets de um painel — é marcada como Experimental pela Atlassian. Isso significa que a Atlassian pode alterá-la sem as garantias de estabilidade do restante da API. Se ela mudar de um jeito que o Exportelier não reconheça, a importação de painéis se desativa sozinha e avisa, em vez de importar algo que leu errado. Seus relatórios, modelos e exportações existentes não são afetados.