JSON é o jeito como aplicativos guardam configurações e trocam dados, e muitas vezes vem compactado em uma única linha ilegível. Quando um JSON precisa ser revisado por alguém fora de um editor de código, anexado a um chamado de suporte ou guardado como registro, um PDF é mais fácil de usar. JSON para PDF formata os dados com recuo consistente e os apresenta como texto monoespaçado e paginado.
Como usar: JSON para PDF
- Adicione o arquivo .json.
- Clique em Converter para PDF.
- Baixe o PDF.
- Role pelo resultado com recuo.
Formatando os dados
Se o arquivo for um JSON válido, o VelloDoc o analisa e o reescreve com recuo de dois espaços e um valor por linha, para que objetos e arrays aninhados fiquem fáceis de acompanhar. Texto Unicode, como nomes acentuados e escritas não latinas, aparece como caracteres legíveis em vez de códigos de escape, e as chaves mantêm a ordem que têm no arquivo. O resultado é renderizado com fonte monoespaçada, e linhas longas quebram para caber na largura da página.
Quando o JSON não é válido
Um arquivo com erro de sintaxe, como uma vírgula sobrando no final ou uma aspa faltando, não pode ser analisado. Em vez de recusá-lo, o VelloDoc converte o texto exatamente como foi escrito, sem reformatar, para que você ainda tenha um registro legível. Isso também torna o PDF útil para mostrar um arquivo com defeito a um colega; a falta de recuo já indica que o JSON não foi analisado.
Escolhendo um formato para o leitor
JSON combina com dados aninhados. Se os dados são, na verdade, uma lista simples de registros, exportá-los como CSV e usar o CSV para PDF gera uma tabela que leitores não técnicos acham muito mais fácil. XML converte com o XML para PDF, e logs simples com o TXT para PDF. Exportações JSON muitas vezes contêm chaves de API ou dados pessoais, então confira antes de compartilhar; o guia de privacidade em PDF explica como compartilhar com mais segurança.
Quando usar: JSON para PDF
Respostas de API para chamados de suporte
Anexe a um chamado uma resposta de API ou mensagem de erro legível para colegas que não usam ferramentas de desenvolvimento.
Auditorias de configuração
Entregue aos auditores uma cópia paginada e imprimível das configurações de um aplicativo para revisão e aprovação.
Exportações de dados como registro
Guarde uma cópia fixa de uma estrutura de dados exportada junto com o relatório que ela embasou.
Limitações importantes
JSON para PDF gera texto monoespaçado com recuo, e não tabelas ou gráficos. JSON inválido aparece sem formatação, arquivos muito grandes geram documentos longos e a ferramenta exige o WeasyPrint no servidor. Confira se as exportações têm informações secretas antes de compartilhar.
JSON para PDF: perguntas frequentes
JSON compactado vai ser formatado?
Sim. JSON válido recebe um novo recuo de dois espaços por nível, qualquer que fosse a formatação original.
O que acontece com JSON inválido?
O arquivo é convertido exatamente como foi escrito, sem reformatar, então ainda gera um PDF legível.
Existe limite de tamanho?
Vale o limite de upload, que é de 80 MB por tarefa em um servidor VelloDoc com a configuração padrão. Arquivos muito grandes geram PDFs muito longos, então pense em converter só a parte de que as pessoas precisam.
Ele consegue mostrar JSON como tabela?
Não. O resultado é texto com recuo. Para dados em tabela, converta-os antes para CSV e use o CSV para PDF.