Aller au contenu

ETL & Imports avancés

Admin

Le module ETL (Extract, Transform, Load) permet d'alimenter CASH à partir de vos systèmes sources (logiciel comptable, ERP, fichiers plats) de façon automatisée et répétable. Accès : Administration → ETL (/admin/etl).

Vue d'ensemble

Là où l'import manuel (voir Extraction & Imports) traite un fichier ponctuel, l'ETL industrialise le flux de données :

  • Extract — récupération des données depuis la source (fichier déposé, dossier surveillé, connecteur)
  • Transform — mapping des colonnes sources vers les champs CASH et règles de nettoyage
  • Load — création ou mise à jour des clients, engagements et montants

Toutes les données chargées restent strictement cloisonnées à votre société : l'ETL utilise le company_id issu de votre session et n'écrit jamais dans le périmètre d'une autre entreprise.

Étapes pas à pas

Configurer un flux ETL

  1. Accédez à Administration → ETL.
  2. Cliquez sur "Nouveau flux".
  3. Renseignez :
  4. Le nom du flux
  5. La source (dépôt de fichier, format CSV/Excel, encodage)
  6. La fréquence (à la demande, quotidienne, hebdomadaire)
  7. Enregistrez.

Mapper les champs

  1. Ouvrez le flux, puis l'onglet "Mapping".
  2. Pour chaque colonne du fichier source, sélectionnez le champ CASH cible (client, référence engagement, montant dû, date d'échéance, etc.).
  3. Définissez les règles de transformation si nécessaire : format de date, séparateur décimal, valeurs par défaut.
  4. Marquez les colonnes obligatoires. Une ligne dont un champ obligatoire est manquant sera rejetée.

Réutiliser un mapping

Enregistrez le mapping comme modèle pour le réappliquer aux exécutions suivantes sans tout reconfigurer.

Planifier les imports

  1. Dans l'onglet "Planification", choisissez la fréquence d'exécution.
  2. Définissez l'heure de déclenchement et le fuseau horaire.
  3. Activez le flux. Il s'exécutera automatiquement selon la planification.

Gérer les erreurs ETL

  1. Ouvrez l'onglet "Exécutions" pour consulter l'historique.
  2. Chaque exécution affiche un statut : Succès, Partiel, Échec.
  3. Pour une exécution partielle ou en échec, cliquez sur "Voir le rapport" :
  4. Lignes traitées, créées, mises à jour
  5. Lignes rejetées avec le motif (champ manquant, format invalide, doublon)
  6. Corrigez le fichier source ou le mapping, puis relancez le flux.

Doublons et mises à jour

L'ETL identifie les enregistrements existants par leur référence unique. Vérifiez votre clé de rapprochement dans le mapping pour éviter les doublons ou les écrasements involontaires.

Permissions

Action Agent Manager Admin Super Admin
Lancer un import manuel ✓ ✓ ✓
Configurer un flux ETL ✓ ✓
Planifier un flux ETL ✓ ✓
Consulter les rapports d'exécution ✓ ✓

Le module ETL n'est accessible qu'aux rôles admin et super admin.

FAQ

Q : Quelle différence avec l'import Manager ? L'import Manager est ponctuel et manuel ; l'ETL est configurable, mappé et planifiable pour des flux récurrents.

Q : Mon flux est en échec total, que vérifier d'abord ? Vérifiez l'encodage et le séparateur du fichier, puis la présence des colonnes obligatoires définies dans le mapping.

Q : Les données ETL peuvent-elles écraser des engagements existants ? Oui, si la clé de rapprochement correspond à un engagement existant. Configurez soigneusement la clé pour maîtriser les mises à jour.

Modules liés