> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Spécifications d'ingestion

> Définissez comment Solya détecte, analyse et transforme chaque fichier entrant vers son modèle de données standard.

Une **spécification d'ingestion** est le contrat qui indique à Solya comment
interpréter un fichier entrant provenant d'une
[source de données](/fr/data-layer/data-source). Elle décrit comment reconnaître le
fichier, comment lire ses colonnes et comment transformer les données brutes vers le
modèle standard de Solya, afin d'alimenter analytics, prévisions et plans.

## Ce que contient une spécification

* **Nom et description** — l'objet de la spécification.
* **Système de caisse / source** — le système ciblé (par ex. Polaris, Kezia).
* **Règles de détection** — comment Solya identifie le fichier correspondant
  (motifs de nom de fichier, noms d'onglets, en-têtes de colonnes attendus).
* **Configuration d'analyse** — comment extraire et analyser chaque colonne (types de
  champs, séparateurs, formats de dates et de nombres).
* **Étapes de promotion** — les transformations qui enrichissent les données (jointures,
  conversions de types, filtrage, renommage, mapping de taxonomie).
* **Portée** — `Global` (partagée) ou `Org` (propre à votre organisation).
* **Priorité** — quelle spécification l'emporte lorsque plusieurs pourraient correspondre.
* **Version** — les spécifications sont versionnées pour tracer les changements.

## Cycle de vie

Une spécification passe par ces statuts :

| Statut        | Signification                                                |
| ------------- | ------------------------------------------------------------ |
| **Brouillon** | En cours de rédaction ; pas appliquée aux fichiers entrants. |
| **Active**    | En service et appliquée aux fichiers correspondants.         |
| **Dépréciée** | Remplacée ; conservée pour référence.                        |
| **Archivée**  | Retirée et masquée de l'usage courant.                       |

Une spécification possède aussi un indicateur **déployée** — seules les spécifications
déployées sont appliquées aux fichiers réels.

## Travailler avec les spécifications d'ingestion

<Steps>
  <Step title="Ouvrir la page de configuration">
    Allez dans **Data platform → Configuration → Spécifications d'ingestion** pour
    parcourir les spécifications. Filtrez par système de caisse, format, portée et
    statut de déploiement.
  </Step>

  <Step title="Créer une spécification">
    Créez une spécification en définissant ses règles de détection, sa configuration
    d'analyse et ses étapes de promotion. Solya peut aussi **recommander** une
    spécification à partir d'un fichier exemple pour gagner du temps.
  </Step>

  <Step title="La déployer">
    Déployez la spécification pour commencer à l'appliquer aux fichiers entrants. Le
    déploiement est enregistré pour savoir quand elle est entrée en service.
  </Step>

  <Step title="Itérer en toute sécurité">
    Les spécifications étant versionnées, vous pouvez affiner la détection et l'analyse
    au fil du temps tout en conservant un historique clair.
  </Step>
</Steps>

<Note>
  Chaque application d'une spécification à un fichier est enregistrée comme une
  [exécution d'ingestion](/fr/data-layer/ingestion-runs) que vous pouvez suivre.
</Note>