Převod souboru JSON do PDF

Klient, tiskárna, systém záznamů nebo e-mailový pracovní postup může vyžadovat dokument s pevným rozvržením namísto datového souboru. Převodem souboru vznikne čitelný snímek pro sdílení, tisk nebo archivaci, ale vnořená data se tím automaticky nezmění na dobře navržený report.

Co je formát JSON

JSON (JavaScript Object Notation) je prostý textový, na jazyce nezávislý formát pro objekty, pole, řetězce, čísla, logické hodnoty a null. Webová API, nastavení aplikací, browserový software, databáze, exportní nástroje, logy, katalogy produktů a skripty pro vývojáře běžně vytvářejí soubory .json.

JSON zachovává datové hodnoty a vnořené vztahy, ale nedefinuje fonty, velikosti stránek, záhlaví, tabulky, zalomení stránek ani další pravidla rozvržení pro tisk. Převodník proto musí zvolit, jak strukturu zobrazí.

Co je formát PDF

PDF je dokumentový formát orientovaný na stránky, navržený tak, aby zachoval text, grafiku, fonty a rozvržení napříč operačními systémy a tiskárnami. Hodí se pro reporty, faktury, formuláře, kopie pro klienty a záznamy, které by příjemci měli zobrazit nebo vytisknout bez změny podkladových dat.

PDF je méně vhodné pro řazení, filtrování nebo opětovné použití hodnot. Ponechte si původní soubor .json nebo spolu s PDF poskytněte export CSV, pokud příjemci potřebují strojově čitelná data.

Vytvoření formátovaného PDF pomocí Pythonu a browseru

Tento lokální pracovní postup se vyhýbá nahrávání zdrojových dat a poskytuje kontrolu nad nadpisy, tabulkami, mezerami a escapováním. Hodí se pro malé a středně velké dokumenty JSON.

1. Nainstalujte Python 3 a uložte zdroj jako data.json.
2. Uložte tento skript jako json_to_pdf.py do stejného adresáře:

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. Spusťte python json_to_pdf.py. V některých instalacích Windows použijte py json_to_pdf.py.
4. Otevřete json_report.html v prohlížeči Chrome, Edge, Firefox nebo Safari a zvolte Print → Save as PDF nebo možnost výstupu PDF v browseru.
5. Zkontrolujte náhled kvůli oříznutým sloupcům, rozděleným tabulkám, nadměrnému prázdnému prostoru a chybějícím znakům. Pokud se mají zobrazit šedá záhlaví tabulek, povolte grafiku na pozadí.

Skript escapuje znaky citlivé na HTML, takže hodnoty obsahující značky se zobrazí jako text, nikoli jako interpretované HTML. Objekty vykresluje jako vnořené dvousloupcové tabulky a pole jako číslované seznamy; velká nebo hluboce vnořená datová sada může vyžadovat vlastní šablonu, která vybere pole nebo zploští záznamy.

Použití online převodníku pro necitlivá data

Služby jako CloudConvert a Convertio mohou přijmout soubor JSON a vrátit PDF, pokud je tento převod v jejich aktuálním rozhraní dostupný. Nahrajte soubor, zvolte PDF jako cílový formát, spusťte převod a zkontrolujte stažený výsledek. Tyto služby mohou vytvářet nezpracovaný výpis kódu nebo minimálně formátované stránky namísto reportu, proto zkontrolujte náhled a výběr textu.

Nenahrávejte přihlašovací údaje, osobní informace, proprietární exporty ani regulované záznamy, pokud podmínky poskytovatele týkající se zabezpečení, uchovávání a zpracování nesplňují vaše požadavky. Pro důvěrná data je bezpečnější lokální pracovní postup.

Tisk formátovaného JSON z desktopového editoru

Pro kopii určenou vývojářům otevřete soubor ve Visual Studio Code, spusťte Format Document, poté zvolte File → Print a vyberte PDF tiskárnu nebo systémový výstup PDF. Editor podporující JSON, například Notepad++ s pluginem pro formátování JSON, umožňuje stejný postup. Zachová odsazení a syntaxi, ale obvykle vytvoří výpis kódu, nikoli report založený na tabulkách.

Omezení kvality a kompatibility

• Před převodem zdroj ověřte. Spusťte python -m json.tool data.json; neplatný JSON způsobí ukončení Pythonu i většiny převodníků.
• Pořadí členů objektu JSON nemá obecně žádný prezentační význam a duplicitní názvy členů nejsou přenositelné. Pokud záleží na opakovatelném výstupu, seřaďte klíče nebo záznamy ve skriptu.
• Dlouhé řetězce a široké objekty mohou přesahovat stránky. Vyberte relevantní pole, zalamujte text, zmenšete velikost fontu nebo pro hlavní kolekce vytvořte samostatné tabulky.
• Znaky Unicode vyžadují vhodné fonty. Pokud browser nahradí font nebo PDF neobsahuje potřebný glyf, mohou se znaky zobrazit jako čtverečky; použijte font s požadovaným skriptem a exportované PDF ověřte.
• Data Base64, Markdown, URL a vložené značky jsou hodnoty, nikoli automaticky obrázky nebo formátovaný obsah. Pokud tyto hodnoty vyžadují speciální vykreslení, přidejte explicitní zpracování.
• PDF vytvořená browserem obvykle obsahují text, který lze vybrat a prohledávat. Snímek obrazovky nebo naskenovaný výtisk vytváří stránky obsahující pouze obrázky a může vyžadovat OCR.