Passer au contenu principal
Une spécification d’ingestion est le contrat qui indique à Solya comment interpréter un fichier entrant provenant d’une source de données. 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éeGlobal (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 :
StatutSignification
BrouillonEn cours de rédaction ; pas appliquée aux fichiers entrants.
ActiveEn service et appliquée aux fichiers correspondants.
DépréciéeRemplacée ; conservée pour référence.
ArchivéeRetiré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

1

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.
2

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.
3

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.
4

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.
Chaque application d’une spécification à un fichier est enregistrée comme une exécution d’ingestion que vous pouvez suivre.