> For the complete documentation index, see [llms.txt](https://docs.mindee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mindee.com/v2/fr/modeles-extraction/data-schema.md).

# Aperçu du Schéma de données

Description générale du Schéma de données d’un modèle d’extraction.

Un **Schéma de données d’Extraction** définit quelles données doivent être extraites et de quelle manière, à partir des documents envoyés au modèle.

Le Schéma de données est la base de votre modèle. Toutes les autres fonctionnalités utiliseront et dépendront du Schéma de données.

Vous pouvez considérer le Schéma de données comme une carte des documents que vous envoyez au modèle pour extraction.

Cette carte indique quelles données extraire, comment les formater, quels pièges éviter, etc.\
\
Pour cela, le Schéma de données est composé de Fields (ou points de données), chaque champ ayant sa propre configuration.

{% hint style="info" icon="lightbulb" %}
Utilisez le [Live test](/v2/fr/models/live-test.md) lorsque vous travaillez sur votre Schéma de données afin de valider rapidement les modifications.
{% endhint %}

## Aperçu des champs

Un Schéma de données est principalement composé de champs.

Un champ décrit un point de données unique à extraire dans le document.

Chaque champ possède les propriétés suivantes :

* Titre - lisible par un humain
* Nom - lisible par machine, utilisé comme clé du champ dans la réponse de l'API
* Type - le type de données à extraire, détails dans : [#field-types](#field-types "mention")
* Description (facultatif) - fournit un contexte supplémentaire sur la façon dont le champ est utilisé
* Consignes (facultatif) - fournit des instructions pour mieux extraire le champ

Vous pouvez spécifier le *Titre*, *Nom*, *Description*, et *Consignes* [dans n'importe quelle langue](/v2/fr/models/models-overview.md#supported-document-texts).

## Types de champs

Le type d'un champ détermine le format sous lequel il sera renvoyé par l'API.

Le type donne également une indication sur ce qu'il faut rechercher dans le fichier d'entrée.

### Types de base

<table><thead><tr><th width="191.2000732421875">Type de champ</th><th>Description</th></tr></thead><tbody><tr><td>Texte</td><td>Une séquence de caractères représentant des données textuelles, une valeur de chaîne de caractères.</td></tr><tr><td>Nombre</td><td>Données numériques pouvant être une valeur entière (integer) ou une valeur décimale (floating point).</td></tr><tr><td>Date</td><td>Une année, un mois et un jour spécifiques, formatés comme un <code>YYYY-MM-DD</code> date ou <code>YYYY-MM-DD HH:mm:ss</code> pour la date et l'heure.</td></tr><tr><td>Classification</td><td>Une liste définie de catégories ou de types à faire correspondre. Les noms des catégories sont des chaînes de caractères.</td></tr><tr><td>Booléen</td><td><p>Représente deux valeurs possibles : <code>true</code> ou <code>false</code> </p><p>Doit être utilisé pour les cases à cocher.</p><p>Astuce : les noms des champs booléens devraient commencer par « is » ou « has ».</p></td></tr><tr><td>Objet imbriqué</td><td><p>Un type de données complexe contenant plusieurs sous-champs ou propriétés.</p><p>Utilisé pour regrouper des éléments liés, comme les composantes d'une adresse.</p><p>Les sous-champs peuvent contenir une valeur unique ou une liste de valeurs.</p><p>Un seul niveau d'imbrication : les sous-champs ne peuvent pas être des objets imbriqués.</p></td></tr><tr><td>Détection d'objets</td><td>Détectez l'emplacement d'un élément du document, comme un logo, une signature, une photo, etc.</td></tr><tr><td>Code-barres</td><td><p>Détectez l'emplacement d'un code-barres 1D (c.-à-d. UPC, EAN) ou d'un code-barres 2D (c.-à-d. QR Code, Data Matrix, 2D-DOC, PDF417).</p><p>Essayez également de décoder le contenu du code-barres sous forme de chaîne de caractères.</p></td></tr></tbody></table>

{% hint style="info" %}
Tous les champs peuvent avoir une valeur vide (null).
{% endhint %}

### **Types de tableaux**

N'importe quel type de champ peut être transformé en tableau, une liste de valeurs.

Activez simplement « Plusieurs éléments peuvent être extraits » lors de la création ou de la modification du champ.

Le type de retour sera un tableau du type de base, par exemple une liste de valeurs textuelles ou une liste de nombres.

Il est possible d'avoir une liste d'objets imbriqués, mais pas une liste de listes.

{% hint style="info" icon="lightbulb" %}
Dans certains cas, il peut y avoir des éléments en double, par exemple lorsque la même valeur apparaît sur plusieurs pages.

Activez « Filtrer les doublons de la liste d'éléments » pour corriger cela.
{% endhint %}

## **Exemples de champs**

Quelques exemples des meilleurs types de champs à utiliser pour un Schéma de données d'extraction de factures de base.

<table><thead><tr><th>Nom du champ</th><th width="203.5">Type de champ</th><th>Exemple de valeur renvoyée</th></tr></thead><tbody><tr><td><strong>Nom du fournisseur</strong></td><td>Chaîne de caractères</td><td><code>Acme Supplies Ltd.</code></td></tr><tr><td><strong>Logo du fournisseur</strong></td><td>Détection d'objets</td><td>Polygone autour du logo</td></tr><tr><td><strong>Immatriculation de la société du fournisseur</strong></td><td>Objet imbriqué</td><td><em>Voir les sous-champs ci-dessous</em></td></tr><tr><td><em>Immatriculation de la société du fournisseur.</em><strong>Nombre</strong></td><td>Chaîne de caractères</td><td><code>CRN-20250123</code></td></tr><tr><td><em>Immatriculation de la société du fournisseur.</em><strong>Type</strong></td><td>Classification</td><td><code>NUMÉRO DE TVA</code></td></tr><tr><td><strong>Date de facture</strong></td><td>Date</td><td><code>2025-06-10</code></td></tr><tr><td><strong>En retard</strong></td><td>Booléen</td><td><code>false</code></td></tr><tr><td><strong>Montant total</strong></td><td>Nombre</td><td><code>1540.75</code></td></tr><tr><td><strong>Taxes</strong></td><td>Tableau d'objets imbriqués</td><td><em>Voir les sous-champs ci-dessous</em></td></tr><tr><td><em>Taxes[0].</em><strong>Taux</strong></td><td>nombre</td><td><code>0.185</code></td></tr><tr><td><em>Taxes[0].</em><strong>Base</strong></td><td>nombre</td><td><code>1300.00</code></td></tr><tr><td><em>Taxes[0].</em><strong>Montant</strong></td><td>nombre</td><td><code>240.75</code></td></tr></tbody></table>

## Consignes générales

En plus des consignes individuelles des champs, une consigne globale peut être utilisée dans votre Schéma de données.

Le texte de la consigne globale s'appliquera à tous les champs ou à certains d'entre eux, selon vos instructions.

Utilisez des consignes globales lorsque vous souhaitez :

* Généraliser des instructions à plusieurs champs spécifiques. Par exemple :
  * *« Les champs numériques liés aux montants doivent toujours avoir 3 décimales. »*
  * *« Les champs de pays doivent renvoyer le code ISO alpha-3 du pays. »*
* Fournir des instructions générales ou un contexte pour tous les champs. Par exemple :
  * *« Assurez la conformité ASCII en supprimant tous les diacritiques des valeurs renvoyées. »*

{% hint style="info" %}
Vous pouvez mettre n'importe quel nombre de consignes sans lien entre elles dans le texte, par exemple tous les exemples ci-dessus.

Pour de meilleurs résultats, séparez chaque consigne différente par une nouvelle ligne.
{% endhint %}

Vous pouvez spécifier les Consignes générales  [dans n'importe quelle langue](/v2/fr/models/models-overview.md#supported-document-texts).

## Limitations techniques

### Nombre de champs dans le Schéma de données

Le nombre maximal recommandé de champs est de 25 pour un Schéma de données.

Bien qu'il n'y ait aucune erreur, au-delà de ce nombre, les temps de réponse augmenteront.

### Noms des champs

Le champ *nom* ne doit contenir que :

* des lettres latines minuscules sans accents (a-z)
* des chiffres (0-9)
* des tirets bas (`_`), mais ni le premier ni le dernier caractère ne peuvent être un tiret bas.
* les noms suivants ne peuvent pas être utilisés : `valeur`, `champs`, `éléments`.

## Étapes suivantes

Maintenant que vous connaissez les différents composants du Schéma de données, vous voudrez consulter des conseils pour [construire un Schéma de données précis](/v2/fr/modeles-extraction/data-schema-best-practices.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mindee.com/v2/fr/modeles-extraction/data-schema.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.