> 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

Un **Schéma de données 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 le Schéma de données et en dépendront.

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

Cette carte inclut quelles données extraire, comment formater les données, les pièges à éviter, etc.\
\
Pour ce faire, le Schéma de données se compose de Champs (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 pour 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 l'humain
* Nom - lisible par la 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 manière dont le champ est utilisé
* Consignes (facultatif) - fournit des instructions pour mieux extraire le champ

## Types de champs

Le type d'un champ détermine la manière dont il sera formaté lorsqu'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 suite de caractères représentant des données textuelles, une valeur de chaîne.</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 de catégories sont des chaînes de texte.</td></tr><tr><td>Booléen</td><td><p>Représente deux valeurs possibles : <code>vrai</code> ou <code>faux</code> </p><p>Doit être utilisé pour les cases à cocher.</p><p>Astuce : les noms des champs booléens doivent 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, tels que les composants d'une adresse.</p><p>Les sous-champs peuvent contenir une seule valeur 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'une fonctionnalité 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>En outre, essayez de décoder le contenu du code-barres sous forme de valeur de chaîne.</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, c'est-à-dire 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 dupliqués, par exemple lorsque la même valeur apparaît sur plusieurs pages.

Activez "Filtrer les doublons de la liste des é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 facture 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</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</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>Est en retard</strong></td><td>Booléen</td><td><code>faux</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 propres à chaque champ, une consigne générale peut être utilisée dans votre Schéma de données.

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

Utilisez des consignes générales lorsque vous voulez :

* Généraliser des consignes à plusieurs champs spécifiques. Par exemple :
  * *"Les champs numériques liés à des montants doivent toujours comporter 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 placer n'importe quel nombre de consignes sans rapport 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 %}

## Texte du document

### Langue

Vous pouvez spécifier le *Titre*, *Nom*, *Description*et *Consignes* dans la plupart des langues.

Cela s'applique également au Schéma de données [#global-guidelines](#global-guidelines "mention").

Les modèles Mindee peuvent traiter des documents dans presque n'importe quelle langue.

Cela inclut, sans toutefois s'y **limiter** à :

* Langues européennes : anglais, français, espagnol, allemand, néerlandais, italien, polonais, portugais, grec, etc.
* Langues asiatiques : hindi, bengali, turc, ourdou, farsi, arménien, etc.
* Langues d'Asie de l'Est : japonais, mandarin, coréen, vietnamien, etc.
* Langues sémitiques : arabe, hébreu, amharique, etc.
* Langues africaines : swahili, yoruba, zoulou, etc.

### Écriture manuscrite

Les modèles Mindee sont capables de reconnaître (ou OCR) des textes manuscrits. La précision pour l'écriture manuscrite est en moyenne légèrement inférieure à celle du texte imprimé.

## 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* doit contenir uniquement :

* des lettres latines minuscules sans accents (a-z)
* des chiffres (0-9)
* des caractères de soulignement (`_`), mais ni le premier ni le dernier caractère ne peuvent être un caractère de soulignement.

## É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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.