Convertir JSON en PDF

Un client, une imprimante, un système d’archivage ou un flux de travail de messagerie peut nécessiter un document à mise en page fixe plutôt qu’un fichier de données. La conversion du fichier produit un instantané lisible à partager, à imprimer ou à archiver, mais elle ne transforme pas automatiquement les données imbriquées en rapport bien conçu.

Qu’est-ce que le format JSON ?

JSON (JavaScript Object Notation) est un format en texte brut et indépendant du langage pour les objets, les tableaux, les chaînes, les nombres, les valeurs booléennes et null. Les API Web, les paramètres d’application, les logiciels de navigation, les bases de données, les outils d’exportation, les journaux, les catalogues de produits et les scripts de développeur créent couramment des fichiers .json.

JSON conserve les valeurs des données et les relations imbriquées, mais ne définit pas les polices, les tailles de page, les en-têtes, les tableaux, les sauts de page ni les autres règles de mise en page pour l’impression. Un convertisseur doit donc choisir comment présenter la structure.

Qu’est-ce que le format PDF ?

PDF est un format de document orienté page, conçu pour préserver le texte, les graphiques, les polices et la mise en page entre les systèmes d’exploitation et les imprimantes. Il convient aux rapports, aux factures, aux formulaires, aux copies destinées aux clients et aux documents que les destinataires doivent consulter ou imprimer sans modifier les données sous-jacentes.

PDF convient moins au tri, au filtrage ou à la réutilisation des valeurs. Conservez le fichier .json d’origine ou fournissez un export CSV avec le PDF lorsque les destinataires ont besoin de données lisibles par une machine.

Générer un PDF mis en forme avec Python et un navigateur

Ce flux de travail local évite de téléverser la source et permet de contrôler les titres, les tableaux, l’espacement et l’échappement. Il convient aux documents JSON de petite et moyenne taille.

1. Installez Python 3 et enregistrez la source sous le nom data.json.
2. Enregistrez ce script sous le nom json_to_pdf.py dans le même répertoire :

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. Exécutez python json_to_pdf.py. Sur certaines installations Windows, utilisez py json_to_pdf.py.
4. Ouvrez json_report.html dans Chrome, Edge, Firefox ou Safari, puis choisissez Print → Save as PDF ou l’option de sortie PDF du navigateur.
5. Examinez l’aperçu pour détecter les colonnes tronquées, les tableaux coupés, les espaces vides excessifs et les caractères manquants. Activez les graphiques d’arrière-plan si les en-têtes de tableau gris doivent apparaître.

Le script échappe les caractères sensibles au HTML, afin que les valeurs contenant du balisage soient affichées comme du texte plutôt qu’interprétées comme du HTML. Il affiche les objets sous forme de tableaux imbriqués à deux colonnes et les tableaux sous forme de listes numérotées ; un jeu de données volumineux ou profondément imbriqué peut nécessiter un modèle personnalisé qui sélectionne certains champs ou aplatit les enregistrements.

Utiliser un convertisseur en ligne pour les données non sensibles

Des services tels que CloudConvert et Convertio peuvent accepter un fichier JSON et renvoyer un PDF lorsque cette conversion est disponible dans leur interface actuelle. Téléversez le fichier, choisissez PDF comme format cible, démarrez la conversion, puis examinez le résultat téléchargé. Ces services peuvent produire une liste de code brute ou des pages peu mises en forme plutôt qu’un rapport. Vérifiez donc l’aperçu et la sélection du texte.

Ne téléversez pas d’identifiants, d’informations personnelles, d’exports propriétaires ou de documents réglementés, sauf si les conditions de sécurité, de conservation et de traitement du fournisseur répondent à vos exigences. Un flux de travail local est plus sûr pour les données confidentielles.

Imprimer du JSON mis en forme depuis un éditeur de bureau

Pour obtenir une copie destinée aux développeurs, ouvrez le fichier dans Visual Studio Code, exécutez Format Document, puis choisissez File → Print et sélectionnez une imprimante PDF ou la sortie PDF du système. Un éditeur compatible avec JSON, tel que Notepad++ avec un plugin de mise en forme JSON, prend en charge la même approche. Cela préserve l’indentation et la syntaxe, mais produit généralement une liste de code, et non un rapport sous forme de tableaux.

Limites de qualité et de compatibilité

• Validez la source avant la conversion. Exécutez python -m json.tool data.json ; un JSON mal formé provoque l’arrêt de Python et de la plupart des services de conversion.
• L’ordre des membres d’un objet JSON n’a pas de signification générale pour la présentation, et les noms de membres en double ne sont pas portables. Triez les clés ou les enregistrements dans le script lorsqu’un résultat reproductible est important.
• Les chaînes longues et les objets larges peuvent déborder des pages. Sélectionnez les champs pertinents, activez le retour à la ligne, réduisez la taille de la police ou créez des tableaux distincts pour les collections principales.
• Les caractères Unicode nécessitent des polices adaptées. Si un navigateur remplace une police ou si le PDF ne contient pas le glyphe requis, les caractères peuvent apparaître sous forme de carrés ; utilisez une police prenant en charge l’écriture requise et vérifiez le PDF exporté.
• Les données Base64, le Markdown, les URL et le balisage intégré sont des valeurs, et non automatiquement des images ou du contenu mis en forme. Ajoutez une gestion explicite si ces valeurs doivent être rendues d’une manière particulière.
• Les PDF générés par un navigateur contiennent normalement du texte sélectionnable et interrogeable. Une capture d’écran ou une impression numérisée crée des pages composées uniquement d’images et peut nécessiter un OCR.