Depois do painel pronto, você exporta os números. Este tutorial cobre as três saídas mais pedidas — CSV (por visual), XLSX (planilha completa) e PDF (retrato do painel) — e explica o que muda em cada uma, inclusive o selo de amostra e o papel da RLS.
Workspace do exemplo: Comércio Aurora Ltda (aurora).
Maturidade
CSV e XLSX (contrato de exportação, dialeto Excel pt-BR) são GA-candidato. O
PDF depende de um worker de impressão em nuvem e é Preview,
com geração/latência NÃO MEDIDO. A rasterização de imagem (PNG) também é NÃO MEDIDO. Como o PDF é Preview, esta página é Preview.
O que cada formato leva#
| Formato | Escopo | Onde roda | Observações |
|---|---|---|---|
| CSV | Um visual | No navegador (cliente) | Dialeto Excel pt-BR: separador ;, quebra CRLF, decimal com vírgula. |
| XLSX resumo | Painel (agregados) | Servidor | Uma aba por bloco. |
| XLSX detalhe | Snapshot inteiro do visual | Servidor | É o "export completo"; lê o snapshot com a visão segura. |
| Página/painel | worker de renderização na nuvem | Retrato fiel; depende de infraestrutura paga. | |
| PNG | Visual/página | No navegador | Imagem; rasterização NÃO MEDIDO. |
Tela × total × export (o contrato)#
O ingestia.bi mantém três números coerentes e avisa quando não são o universo:
- Tela: as linhas carregadas no cliente.
- Total: somado sobre o conjunto carregado (não sobre a janela virtual). Quando não é o universo, o rótulo diz "TOTAL (amostra)" ou "TOTAL (parcial)".
- Export CSV: as mesmas linhas da tela; se for parcial, o nome do arquivo
ganha o sufixo
_amostra. Para o dado inteiro, use o XLSX detalhe.
Passo a passo#
Atualize os dados
Confira Dados de … abaixo do título. Se precisar, use Atualizar agora (ver Modos de dados).
CSV de um gráfico
Botão direito no gráfico ▸ Exportar CSV deste visual. O arquivo abre no Excel pt-BR sem quebrar colunas. No mesmo menu, Salvar como imagem baixa o gráfico em PNG.
Excel do painel
Botão Excel no cabeçalho (resumo, como na tela). Para as linhas por trás de cada gráfico, Mais ações ▸ Dados subjacentes (detalhe). O arquivo traz selo de amostra se truncado e carimbo de confidencialidade.
PDF ou PowerPoint
Botão PDF (planos Business e Scale) ou PPT (uma página = um slide). Se o PDF não sair, um balão explica o motivo; use Prévia de impressão ▸ Imprimir / PDF pelo navegador.
RLS e PII na exportação#
Toda saída aplica RLS + máscara de PII + carimbo de confidencialidade:
- O XLSX/PDF leem o snapshot com a RLS do solicitante — você exporta só o que vê.
- O PDF sob demanda usa um token de embed efêmero (5 min, 1 painel) que carrega a RLS da sessão; o worker imprime exatamente o seu recorte (painel despublicado é recusado; download anti-IDOR).
- Detalhes em Tutorial: configurar RLS.
Resultado esperado#
- CSV abre no Excel pt-BR com colunas certas; nome com
_amostrase parcial. - XLSX detalhe traz o snapshot inteiro com a visão segura.
- PDF (quando habilitado) reproduz o painel com o seu recorte.
Limites e ressalvas#
- PDF exige o worker de renderização + plano com PDF; sem isso, não gera.
- Snapshot é um teto de linhas — exportações refletem esse teto (com selo de amostra).
- Geração de PDF, aparência de PPTX e rasterização de PNG são
NÃO MEDIDO.
Erros comuns#
- CSV com colunas grudadas: confirme que abriu como Excel pt-BR (separador
;). - "PDF não gera": leia o balão ao lado do botão — em geral o plano não inclui PDF. Use Prévia de impressão ▸ Imprimir / PDF.
- Faltam linhas: é amostra do snapshot — use o XLSX detalhe para o completo.
Relacionados#
- Ações do cabeçalho do painel
- Exportação e distribuição
- Modos de dados: Import, DirectQuery e cache
- Tutorial: configurar RLS
Última revisão: 2026-10-03.