Exporter vos données

Trois formats

Ztract exporte les données extraites dans trois formats. Choisissez celui que votre outil en aval lit nativement.

JSON

La forme structurée. JSON conserve la forme complète de votre schéma — objets imbriqués, tableaux d’objets, tableaux de chaînes — exactement tels que le moteur les a renvoyés. Utilisez JSON quand :

• Vous transmettez les données à un autre système via un script ou un workflow.
• Votre outil en aval lit JSON nativement (la plupart des applications modernes le font).
• L’imbrication compte (parties à un contrat, conditions de paiement d’un accord fournisseur, lignes de poste avec taxe par ligne).

CSV

La forme plate. CSV produit une ligne par document pour les champs scalaires, avec les lignes de poste émises dans un CSV distinct lorsqu’elles existent. Utilisez CSV quand :

• Vous chargez les données dans une base de données, un outil BI ou tout ce qui attend des tables plates.
• Vous travaillez en ligne de commande (awk / cut / csvkit).
• Vous voulez un format qui s’ouvre correctement dans n’importe quel tableur sans bricoler les séparateurs.

Les champs imbriqués sont aplatis avec des chemins en notation pointée (par exemple, parties_involved.party_1_name).

Excel

La forme tableur. Les exports Excel utilisent plusieurs feuilles quand votre schéma comporte des tableaux — une feuille pour les champs scalaires au niveau du document, une feuille par tableau (lignes de poste, transactions, etc.). Les en-têtes sont lisibles par un humain. Utilisez Excel quand :

• Le destinataire est un utilisateur non technique qui ouvrira le fichier directement.
• Vous avez besoin de combiner les données extraites avec des formules avant de les transmettre à quelqu’un d’autre.

D’où exporter

Ouvrez un projet, basculez vers l’onglet Données extraites et cliquez sur Exporter. Choisissez le format, restreignez éventuellement par plage de dates d’extraction, puis confirmez. Les exports sont à la portée du projet — le fichier contient tous les documents extraits du projet qui correspondent à votre filtre de date.

Comment les exports sont produits

Les exports s’exécutent en tâches d’arrière-plan, pas en téléchargements directs. Après avoir cliqué sur Exporter, la tâche apparaît dans l’onglet Exports du projet avec l’un des trois statuts suivants :

• En file d’attente — en attente qu’un worker la prenne en charge.
• En cours — le fichier est en cours de construction.
• Prêt — terminé ; cliquez pour télécharger.

Le tableau de bord interroge la file automatiquement, vous n’avez donc pas à actualiser. Pour les petits projets, le fichier est généralement prêt en quelques secondes ; pour les projets comportant des milliers de documents, cela peut prendre quelques minutes. Vous pouvez fermer le tableau de bord et revenir plus tard — le fichier reste disponible jusqu’à ce que vous supprimiez le projet.

Ce que contient chaque format

• JSON : un tableau d’objets-documents, chacun correspondant au schéma — les objets imbriqués, tableaux d’objets et tableaux de chaînes sont conservés tels quels.
• CSV : une mise en page plate avec une ligne par document extrait (ou par page extraite en mode page par page). Les champs imbriqués sont des chemins pointés.
• Excel : un classeur unique avec la même forme plate que le CSV, formaté pour une ouverture directe.

Chaque export reflète vos dernières modifications — si vous avez corrigé une valeur dans le visualiseur côte à côte, l’export utilise automatiquement votre valeur corrigée (les corrections sont stockées comme surcouches sur l’extraction d’origine ; rien ne relance le moteur).

Itérer entre vérification et export

Une boucle courante :

1. Première passe d’extraction (le moteur).
2. Vérifiez ponctuellement les champs signalés par un score de confiance, corrigez si nécessaire.
3. Lancez un export, utilisez le fichier.
4. Vous repérez une valeur que vous aviez manquée ? Corrigez-la. Réexportez. Gratuit — les relances du moteur consomment des pages, mais pas les nouvelles tâches d’export.

Export par API

L’export programmatique via HTTP API est inscrit à la feuille de route. Aujourd’hui, tous les exports passent par le tableau de bord. Écrivez à [support@ztract.com](mailto:support@ztract.com?subject=API early access) si l’accès à l’API est un point bloquant et que vous souhaitez être prévenu dès qu’il sera disponible.