Konwertuj JSON na PDF

Klient, drukarka, system ewidencji lub obieg wiadomości e-mail może wymagać dokumentu o stałym układzie zamiast pliku danych. Konwersja pliku tworzy czytelny obraz do udostępniania, drukowania lub archiwizowania, ale nie przekształca automatycznie danych zagnieżdżonych w dobrze zaprojektowany raport.

Czym jest format JSON

JSON (JavaScript Object Notation) to format zwykłego tekstu, niezależny od języka, przeznaczony dla obiektów, tablic, ciągów znaków, liczb, wartości logicznych i null. Internetowe interfejsy API, ustawienia aplikacji, oprogramowanie przeglądarek, bazy danych, narzędzia eksportu, dzienniki, katalogi produktów i skrypty programistyczne często tworzą pliki .json.

JSON zachowuje wartości danych i relacje zagnieżdżone, ale nie definiuje czcionek, rozmiarów stron, nagłówków, tabel, podziałów stron ani innych reguł układu wydruku. Konwerter musi więc zdecydować, jak przedstawić strukturę.

Czym jest format PDF

PDF to zorientowany na strony format dokumentu zaprojektowany tak, aby zachowywać tekst, grafikę, czcionki i układ na różnych systemach operacyjnych i drukarkach. Nadaje się do raportów, faktur, formularzy, kopii dla klientów i dokumentacji, którą odbiorcy powinni przeglądać lub drukować bez zmieniania podstawowych danych.

PDF jest mniej odpowiedni do sortowania, filtrowania lub ponownego wykorzystywania wartości. Zachowaj oryginalny plik .json lub udostępnij eksport CSV razem z plikiem PDF, gdy odbiorcy potrzebują danych w formacie czytelnym maszynowo.

Generowanie sformatowanego pliku PDF za pomocą Python i przeglądarki

Ten lokalny sposób pracy pozwala uniknąć przesyłania źródła oraz zapewnia kontrolę nad nagłówkami, tabelami, odstępami i znakami specjalnymi. Nadaje się do małych i średnich dokumentów JSON.

1. Zainstaluj Python 3 i zapisz źródło jako data.json.
2. Zapisz ten skrypt jako json_to_pdf.py w tym samym katalogu:

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. Uruchom python json_to_pdf.py. W przypadku niektórych instalacji systemu Windows użyj py json_to_pdf.py.
4. Otwórz plik json_report.html w przeglądarce Chrome, Edge, Firefox lub Safari i wybierz opcję Print → Save as PDF albo opcję eksportu PDF przeglądarki.
5. Sprawdź podgląd pod kątem obciętych kolumn, podzielonych tabel, nadmiernych pustych przestrzeni i brakujących znaków. Włącz grafikę tła, jeśli szare nagłówki tabel powinny być widoczne.

Skrypt zamienia znaki specjalne HTML, dzięki czemu wartości zawierające znaczniki są wyświetlane jako tekst, a nie interpretowane jako HTML. Renderuje obiekty jako zagnieżdżone tabele z dwiema kolumnami, a tablice jako listy numerowane; duży lub głęboko zagnieżdżony zbiór danych może wymagać niestandardowego szablonu wybierającego pola lub spłaszczającego rekordy.

Używanie konwertera online dla danych niewrażliwych

Usługi takie jak CloudConvert i Convertio mogą przyjmować plik JSON i zwracać plik PDF, jeśli taka konwersja jest dostępna w ich bieżącym interfejsie. Prześlij plik, wybierz PDF jako format docelowy, rozpocznij konwersję i sprawdź pobrany wynik. Usługi te mogą generować surową listę kodu lub minimalnie sformatowane strony zamiast raportu, dlatego sprawdź podgląd i możliwość zaznaczania tekstu.

Nie przesyłaj danych uwierzytelniających, danych osobowych, zastrzeżonych eksportów ani dokumentacji objętej regulacjami, chyba że warunki bezpieczeństwa, przechowywania i przetwarzania dostawcy spełniają Twoje wymagania. Lokalny sposób pracy jest bezpieczniejszy w przypadku danych poufnych.

Drukowanie sformatowanego JSON z edytora desktopowego

W przypadku kopii przeznaczonej dla programisty otwórz plik w Visual Studio Code, uruchom polecenie Format Document, a następnie wybierz File → Print i wybierz drukarkę PDF lub systemową opcję eksportu PDF. Edytor obsługujący JSON, taki jak Notepad++ z wtyczką do formatowania JSON, umożliwia zastosowanie tego samego podejścia. Zachowuje ono wcięcia i składnię, ale zwykle tworzy listę kodu, a nie raport oparty na tabelach.

Ograniczenia jakości i zgodności

• Zweryfikuj źródło przed konwersją. Uruchom python -m json.tool data.json; niepoprawny JSON powoduje zatrzymanie działania Python i większości usług konwersji.
• Kolejność elementów obiektu JSON nie ma ogólnego znaczenia prezentacyjnego, a zduplikowane nazwy elementów nie są przenośne. Sortuj klucze lub rekordy w skrypcie, gdy istotny jest powtarzalny wynik.
• Długie ciągi znaków i szerokie obiekty mogą wykraczać poza strony. Wybierz odpowiednie pola, włącz zawijanie tekstu, zmniejsz rozmiar czcionki lub utwórz osobne tabele dla głównych kolekcji.
• Znaki Unicode wymagają odpowiednich czcionek. Jeśli przeglądarka zastąpi czcionkę lub w pliku PDF zabraknie potrzebnego glifu, znaki mogą być wyświetlane jako kwadraty; użyj czcionki obsługującej wymagany system pisma i sprawdź wyeksportowany plik PDF.
• Dane Base64, Markdown, adresy URL i osadzone znaczniki są wartościami, a nie automatycznie obrazami lub sformatowaną treścią. Dodaj jawną obsługę, jeśli te wartości wymagają specjalnego renderowania.
• Pliki PDF generowane przez przeglądarkę zwykle zawierają tekst, który można zaznaczać i przeszukiwać. Zrzut ekranu lub zeskanowany wydruk tworzy strony zawierające wyłącznie obrazy i może wymagać OCR.