> 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 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 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 les données à extraire, la manière de formater les données, les pièges à éviter, etc.\
\
Pour ce faire, le Schéma de données est composé 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 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 l'humain
* Nom - lisible par la machine, utilisé comme clé du champ dans la réponse de l'API
* Type - type de données à extraire, détails dans : [#field-types](#field-types "mention")
* Description (facultative) - fournit un contexte supplémentaire sur l'utilisation du champ
* Consignes (facultatives) - fournit des instructions pour mieux extraire le champ

## Types de champs

Le type d'un champ détermine son format lors du retour 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>Des données numériques pouvant être une valeur entière ou une valeur décimale (à virgule flottante).</td></tr><tr><td>Date</td><td>Une année, un mois et un jour spécifiques, formatés comme une <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 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 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 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'objet</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>En outre, tentez 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 converti en tableau, une liste de valeurs.

Il suffit d'activer "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 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>Valeur de retour d'exemple</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'objet</td><td>Polygone autour du logo</td></tr><tr><td><strong>Immatriculation de l'entreprise du fournisseur</strong></td><td>Objet imbriqué</td><td><em>Voir les sous-champs ci-dessous</em></td></tr><tr><td><em>Immatriculation de l'entreprise 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 l'entreprise 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 globales

En plus des consignes propres à chaque champ, 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 les consignes globales lorsque vous souhaitez :

* Généraliser des instructions à 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 :
  * *"Veillez à la conformité ASCII en supprimant tous les diacritiques des valeurs de retour."*

{% 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 %}

## Texte du document

### Langue

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

Cela s'applique également au [#global-guidelines](#global-guidelines "mention").

Les modèles Mindee peuvent traiter des documents dans la plupart des langues.

Cela inclut, sans toutefois être **limité** à :

* Langues européennes : anglais, français, espagnol, allemand, italien, portugais, russe, 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

**Remarque :** bien que les modèles puissent comprendre ces langues, nous ne sommes pas en mesure d'offrir une assistance approfondie pour toutes les langues.

### Écriture manuscrite

Les modèles Mindee sont capables de reconnaître des textes manuscrits (ou de faire de l'OCR). 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 êtes familiarisé avec 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.