Converti JSON in PDF

Un client, una stampante, un sistema di gestione dei record o un flusso di lavoro email può richiedere un documento a layout fisso invece di un file di dati. La conversione del file produce un'istantanea leggibile per la condivisione, la stampa o l'archiviazione, ma non trasforma automaticamente i dati annidati in un report ben progettato.

Che cos'è il formato JSON

JSON (JavaScript Object Notation) è un formato di testo semplice e indipendente dal linguaggio per oggetti, array, stringhe, numeri, valori booleani e null. Le API Web, le impostazioni delle applicazioni, i software browser, i database, gli strumenti di esportazione, i log, i cataloghi di prodotti e gli script per sviluppatori creano comunemente file .json.

JSON conserva i valori dei dati e le relazioni annidate, ma non definisce caratteri, dimensioni delle pagine, intestazioni, tabelle, interruzioni di pagina o altre regole di layout per la stampa. Un convertitore deve quindi scegliere come presentare la struttura.

Che cos'è il formato PDF

PDF è un formato di documento orientato alle pagine, progettato per preservare testo, grafica, caratteri e layout tra sistemi operativi e stampanti. È adatto a report, fatture, moduli, copie per i clienti e documenti che i destinatari devono visualizzare o stampare senza modificare i dati sottostanti.

PDF è meno adatto per ordinare, filtrare o riutilizzare i valori. Conservare il file .json originale o fornire un'esportazione CSV insieme al PDF quando i destinatari hanno bisogno di dati leggibili dalle macchine.

Generare un PDF formattato con Python e un browser

Questo flusso di lavoro locale evita di caricare la fonte e offre il controllo su intestazioni, tabelle, spaziatura ed escaping. È adatto a documenti JSON di dimensioni piccole e moderate.

1. Installare Python 3 e salvare la fonte come data.json.
2. Salvare questo script come json_to_pdf.py nella stessa directory:

import html
import json
from pathlib import Path

source = json.loads(Path("data.json").read_text(encoding="utf-8"))

def render(value):
    if isinstance(value, dict):
        rows = []
        for key, item in value.items():
            rows.append(
                f"<tr><th>{html.escape(str(key))}</th>"
                f"<td>{render(item)}</td></tr>"
            )
        return "<table>" + "".join(rows) + "</table>"
    if isinstance(value, list):
        return "<ol>" + "".join(
            f"<li>{render(item)}</li>" for item in value
        ) + "</ol>"
    if value is None:
        return "<em>null</em>"
    return html.escape(str(value))

page = f"""<!doctype html>
<html><head><meta charset='utf-8'>
<title>JSON report</title>
<style>
body {{ font: 11pt Arial, sans-serif; margin: 15mm; color: #222; }}
table {{ border-collapse: collapse; width: 100%; margin: 0 0 14px; }}
th, td {{ border: 1px solid #999; padding: 6px; vertical-align: top; text-align: left; }}
th {{ width: 25%; background: #eee; }}
li {{ margin: 4px 0; }}
</style></head><body>
<h1>JSON report</h1>{render(source)}
</body></html>"""

Path("json_report.html").write_text(page, encoding="utf-8")

3. Eseguire python json_to_pdf.py. In alcune installazioni Windows, usare py json_to_pdf.py.
4. Aprire json_report.html in Chrome, Edge, Firefox o Safari e scegliere Print → Save as PDF oppure l'opzione di output PDF del browser.
5. Controllare l'anteprima per individuare colonne tagliate, tabelle divise, spazi vuoti eccessivi e caratteri mancanti. Abilitare la grafica di sfondo se le intestazioni grigie delle tabelle devono essere visualizzate.

Lo script esegue l'escaping dei caratteri sensibili per HTML, quindi i valori che contengono markup vengono visualizzati come testo invece di essere interpretati come HTML. Esegue il rendering degli oggetti come tabelle annidate a due colonne e degli array come elenchi numerati; un dataset grande o profondamente annidato potrebbe richiedere un template personalizzato che selezioni i campi o appiattisca i record.

Usare un convertitore online per dati non sensibili

Servizi come CloudConvert e Convertio possono accettare un file JSON e restituire un PDF quando tale conversione è disponibile nella loro interfaccia attuale. Caricare il file, scegliere PDF come destinazione, avviare la conversione e controllare il risultato scaricato. Questi servizi potrebbero produrre un elenco di codice grezzo o pagine con una formattazione minima invece di un report, quindi controllare l'anteprima e la selezione del testo.

Non caricare credenziali, informazioni personali, esportazioni proprietarie o record soggetti a normative, a meno che i termini del provider relativi a sicurezza, conservazione e trattamento non soddisfino i propri requisiti. Un flusso di lavoro locale è più sicuro per i dati riservati.

Stampare JSON formattato da un editor desktop

Per una copia orientata agli sviluppatori, aprire il file in Visual Studio Code, eseguire Format Document, quindi scegliere File → Print e selezionare una stampante PDF o l'output PDF del sistema. Un editor consapevole di JSON come Notepad++ con un plugin per la formattazione JSON supporta lo stesso approccio. Questo preserva l'indentazione e la sintassi, ma di solito crea un elenco di codice, non un report basato su tabelle.

Limiti di qualità e compatibilità

• Convalidare la fonte prima della conversione. Eseguire python -m json.tool data.json; un JSON non valido fa sì che Python e la maggior parte dei servizi di conversione si interrompano.
• L'ordine dei membri di un oggetto JSON non ha un significato generale per la presentazione e i nomi dei membri duplicati non sono portabili. Ordinare le chiavi o i record nello script quando è importante ottenere un output ripetibile.
• Le stringhe lunghe e gli oggetti larghi possono fuoriuscire dalle pagine. Selezionare i campi pertinenti, andare a capo nel testo, ridurre la dimensione del carattere o creare tabelle separate per le raccolte principali.
• I caratteri Unicode richiedono caratteri appropriati. Se un browser sostituisce un carattere o il PDF non contiene un glifo necessario, i caratteri potrebbero apparire come riquadri; usare un carattere con lo script richiesto e verificare il PDF esportato.
• I dati Base64, Markdown, gli URL e il markup incorporato sono valori, non immagini o contenuti formattati automaticamente. Aggiungere una gestione esplicita se tali valori richiedono un rendering speciale.
• I PDF generati dai browser normalmente contengono testo selezionabile e ricercabile. Una schermata o una stampa digitalizzata crea pagine composte solo da immagini e potrebbe richiedere l'OCR.