A exportação de dados no sistema não é uma função isolada em uma única tela: é um recurso genérico, disponível em praticamente toda listagem (grid) do sistema — clientes, contratos, financeiro, relatórios, etc. Este artigo explica onde encontrar o botão, quais formatos existem, como escolher colunas e quais são as limitações reais desse recurso.
Onde encontrar o botão de exportar
Em qualquer tela de listagem (grid) do sistema, na barra de paginação (rodapé da tabela), existe um ícone de download — com a dica/tooltip "Exportar registros em forma de arquivos". Em algumas telas de relatório específicas (ex.: Faturamento por grupo, Extrato de carteira), esse mesmo recurso aparece como um botão de texto "Exportar tabela" em vez do ícone — mas é exatamente a mesma funcionalidade por trás.
Ao clicar, abre-se o pop-up "Criação de relatórios / exportação de dados", com duas partes:
-
Colunas: uma lista de checkboxes com todas as colunas exportáveis daquela listagem. Por padrão vêm marcadas as colunas que já estão visíveis na grid (ou a última seleção salva por você para aquela tela, já que a escolha de colunas fica salva por usuário/tela entre uma exportação e outra).
-
Formato: campo de seleção com as opções disponíveis (ver abaixo). Se escolher PDF, aparece um campo adicional "Página", com as opções A4 (Retrato) e A4 (Paisagem).
Depois de ajustar colunas e formato, o botão "Gerar arquivo" processa e baixa o arquivo.
-
CSV (Excel) — arquivo texto separado por ponto-e-vírgula, com valores entre aspas; abre diretamente no Excel/planilhas. É o formato mais indicado para tratar os dados depois (filtros, fórmulas, tabelas dinâmicas).
-
HTML (Tela) — gera uma versão em página HTML dos dados, como se fosse a própria tela impressa.
-
PDF (Impressão) — mesma base do HTML, convertida para PDF, já pensada para impressão (com escolha de página retrato/paisagem).
-
JSON (Exportação) — formato estruturado, voltado para uso técnico/integração (importar em outro sistema, script, etc.), não para leitura direta pelo usuário final.
Pré-requisitos
- Permissão de acesso à tela/listagem que se deseja exportar (a exportação usa os mesmos dados e permissões da grid).
- Ter aplicado, antes de exportar, os filtros/busca desejados na tela — a exportação usa exatamente o filtro atual da grid (ver limitação abaixo).
Passo a passo
- Abra a listagem desejada (ex.: Clientes, Contratos, Financeiro) e aplique os filtros/busca necessários.
- Clique no ícone de download na barra de paginação (rodapé da grid) — ou no botão "Exportar tabela", em telas de relatório específicas.
- No pop-up, marque/desmarque as colunas que deseja incluir no arquivo.
- Escolha o Formato (CSV, HTML, PDF ou JSON). Se escolher PDF, selecione também o tamanho de Página (Retrato/Paisagem).
- Clique em "Gerar arquivo". O download começa automaticamente ao terminar o processamento.
Limitações conhecidas
-
Não exporta só a página atual — exporta tudo o que bate com o filtro aplicado. Esse é um ponto que gera confusão: mesmo que a grid esteja mostrando, por exemplo, 50 registros por página, a exportação ignora a paginação da tela e traz todos os registros que atendem à busca/filtro atual (até um limite prático de ~999.999 linhas por exportação). Ou seja, exportar sem aplicar nenhum filtro pode gerar um arquivo com toda a base daquela listagem.
-
Arquivos muito grandes podem demorar: exportações sem filtro em tabelas com muitos registros (ex.: toda a base de clientes ou de débitos) podem levar bastante tempo para processar, especialmente em PDF (que primeiro monta o conteúdo em HTML e depois converte para PDF) — CSV costuma ser o formato mais rápido e mais leve para volumes grandes.
-
Só saem colunas marcadas como exportáveis: a maioria das colunas de uma grid é exportável por padrão, mas algumas colunas específicas (normalmente ações, ícones ou campos calculados apenas visuais) podem não aparecer na lista de seleção do pop-up, mesmo estando visíveis na tela.
-
Formatação é sempre texto simples no CSV: valores de moeda, data, HTML embutido em campos, etc. são convertidos para texto puro (tags HTML são removidas) — não há fórmulas nem formatação de célula.
-
Seleção de colunas fica salva por tela e por usuário: se um mesmo usuário exportar a mesma tela depois de um tempo, o pop-up já vem com a última seleção de colunas usada — o que é útil, mas pode confundir quem espera ver todas as colunas marcadas por padrão sempre.
Erros comuns
-
Esperar que a exportação traga só o que está visível na página atual e se surpreender com um arquivo muito maior (ou muito menor, se havia filtro aplicado sem perceber) do que o esperado.
-
Escolher PDF para grandes volumes de dados — o resultado costuma ser um arquivo pesado e demorado de gerar; para análise de dados em volume, CSV é sempre a melhor escolha.
-
Não perceber que a seleção de colunas do pop-up já vem pré-marcada de uma exportação anterior, gerando um arquivo sem alguma coluna que o usuário esperava que viesse por padrão.
-
Procurar um botão de "exportar" fixo em algum menu geral do sistema: não existe uma tela central de exportação — o recurso é sempre por listagem, acessado dentro da própria tela de onde os dados vêm.