Tema
Exportar para PDF
Um dashboard exporta-se para PDF com um clique: o ícone da seta sobre um documento, na barra superior, ao lado de Recarregar. O ficheiro descarrega-se com o nome do dashboard.
O que sai no PDF
O PDF é o dashboard tal como está no ecrã: os mesmos gráficos, tabelas e indicadores, com os filtros que estavam aplicados no momento em que se pediu a exportação. Não é uma versão simplificada nem uma lista de dados — é o ecrã desenhado.
Uma página só, com a largura do dashboard em computador (1440 px) e a altura que o conteúdo precisar. Nada é cortado a meio entre páginas; um leitor de PDF mostra-a inteira e faz zoom.
Em tema claro, sempre — independentemente do tema de quem exporta. É o que se imprime e se envia.
Por cima do ecrã vai um cabeçalho discreto com o nome do dashboard e a data e hora da exportação.
O que não sai
- Ecrãs auxiliares abertos (modais e painéis de detalhe): o PDF é o ecrã principal.
- Cruzamentos activos (uma barra clicada a filtrar outro widget): a selecção é momentânea e não entra; os filtros da barra de filtros entram.
- Nas tabelas paginadas, a página visível.
No link público
O cabeçalho de um link público tem o mesmo ícone. Quem recebe o link exporta o que vê, sem conta. Com a barra superior desligada (modo televisor) não há ícone.
Como funciona
A exportação corre no servidor: um browser sem janela abre o dashboard numa vista de impressão, espera que todos os widgets tenham os dados, e fotografa a página inteira. É por isso que os gráficos saem exactamente como no ecrã, e é por isso que demora alguns segundos — o tempo de carregar o dashboard.
Na vista autenticada, o browser do servidor entra com uma sessão de curta duração em nome de quem pediu: o PDF mostra o que essa pessoa pode ver, nem mais nem menos. Cada exportação fica no registo de auditoria.
Há um limite de exportações seguidas por utilizador (e, no link público, por endereço): cada uma ocupa um browser no servidor.
Requisitos da instalação
O servidor precisa de um Chromium. Uma de duas formas, uma vez, depois de instalar a aplicação:
bash
# o Chromium do Playwright (descarrega-o para a pasta de cache do utilizador)
node node_modules/playwright-core/cli.js install --with-deps chromiumou um Chromium ou Chrome já instalado no sistema, apontado nas variáveis de ambiente:
| Variável | O que faz |
|---|---|
PDF_CHROMIUM_PATH | Caminho do executável (ex.: /usr/bin/chromium). Sem ela, usa o do Playwright. |
PDF_CHROMIUM_ARGS | Argumentos extra. --no-sandbox é preciso se a aplicação correr como root ou num contentor sem privilégios. |
PDF_RENDER_URL | Onde o browser encontra a aplicação. Por omissão, o próprio processo (http://127.0.0.1:<porta>). |
PDF_RENDER_TIMEOUT_MS | Tempo máximo por exportação. Por omissão, 60 segundos. |
PDF_TIMEZONE | Fuso da data no cabeçalho. Por omissão, Europe/Lisbon. |
Sem Chromium, o botão devolve uma mensagem a dizer o que falta; o resto da aplicação não é afectado.