La fonction Importer un fichier CSV de TimeTonic permet d'intégrer des ensembles de données externes directement dans vos tables, en préservant l'intégrité de votre base. Cette fonctionnalité offre un mappage précis des colonnes, une gestion avancée des doublons via une clé unique, et un contrôle de la portée de l'import (table entière ou vue active).
L'import CSV intègre désormais deux options de gestion des doublons :
Utiliser la clé unique définie dans TimeTonic (si votre
table en possède une)
Déclarer une clé unique ponctuelle directement dans
la fenêtre d'import
Avant de lancer un import, vérifiez que votre fichier respecte les trois prérequis suivants. Ils évitent les erreurs d'encodage, facilitent le mapping et permettent d'activer la gestion des doublons.
Format du fichier
Fichier .csv encodé en UTF-8. Cela évite les caractères « � » et les accents mal interprétés.
Colonnes bien nommées
Une ligne d'en-tête claire en première ligne. Elle facilite le mapping vers les champs TimeTonic.
Clé unique (facultatif mais vivement conseillé)
Un champ qui identifie chaque ligne de façon sûre (N° client, code article, identifiant métier…). Elle permet de mettre à jour vos enregistrements au lieu de tout recréer.
💡 Astuce : faites toujours un premier essai sur une copie de la table ou sur une vue filtrée avant un import massif.
2. Lancer l'import depuis votre table
L'import se déclenche depuis le menu options de la table cible, en trois clics.
1
Ouvrez la table cible
Rendez-vous dans le livre puis sur la table où vous souhaitez importer vos données.
2
Ouvrez les options de la table
Cliquez sur l'icône ⋮ Options de la table dans la barre supérieure, puis sur Import.
3
Choisissez "Importer depuis CSV"
Dans le menu qui apparaît, sélectionnez l'option d'import CSV pour ouvrir la fenêtre de chargement.
3. Sélectionner et paramétrer votre fichier CSV
La fenêtre de chargement vous permet de choisir votre fichier et de configurer sa lecture avant l'association des champs.
Détail des options de chargement
#Libellé à l'écranRôle
1Sélectionnez le fichierOuvre l'explorateur pour choisir votre fichier CSV local.
2Sélectionnez le séparateurMode : Auto · Virgule , · Point-virgule ; · Tabulation.
3Validation du fichierLance la lecture du fichier avec les paramètres choisis.
4Mode sombreActive ou désactive l'affichage en mode sombre.
5Choix de langueBascule l'interface entre français et anglais.
4. Association des champs (mapping CSV → TimeTonic)
Cet écran associe chaque colonne de votre fichier CSV à un champ de la table TimeTonic. C'est l'étape qui garantit que vos données arriveront dans les bonnes colonnes.
Détail de l'écran de préparation
#Libellé à l'écranRôle
1Table sélectionnéeTable dans laquelle les données seront écrites.
2Fichier sélectionnéNom du fichier CSV en cours d'import.
3Colonne CSVListe des colonnes détectées dans votre fichier.
4Premières lignes du CSVAperçu des 5 premières lignes pour vérifier le contenu.
5Champ TimeTonicListe déroulante : le champ cible dans la table TimeTonic.
Les commandes d'associations
Trois commandes permettent de gérer rapidement vos mappings, notamment pour les imports récurrents.
1. Effacer les associations
Réinitialise tous les mappings déjà effectués entre les colonnes du CSV et les champs de la table. Utile si vous voulez repartir de zéro.
2. Sauvegarder les associations
Enregistre localement le mapping courant afin de le ré-appliquer lors d'un prochain import.
3. Charger les associations
Récupère un mapping précédemment sauvegardé pour gagner du temps sur les imports récurrents.
5. Gérer les doublons : deux options à distinguer
TimeTonic propose deux façons d'identifier les lignes existantes pour les mettre à jour au lieu de les recréer. Le choix dépend de la structure de votre table et de la portée souhaitée pour l'import.
Option 1 : Utiliser la clé unique définie dans TimeTonic
C'est l'option recommandée lorsque votre table possède déjà un champ déclaré comme clé unique (code client, identifiant article, référence métier…).
QuestionRéponse
Quand l'option apparaît-elle ?Uniquement si la table possède déjà au moins un champ déclaré clé unique.
Que fait-elle ?
TimeTonic cherche la valeur de clé unique dans toute la table :
· si elle existe → la ligne est mise à jour
· sinon → une nouvelle ligne est créée
Quand s'en servir ?
· Pour synchroniser régulièrement un fichier de référence (ERP, CRM, etc.)
· Lorsque la table contient déjà son identifiant métier (N° client, code article…)
Exemple concret
Table « Clients » : le champ code_client est déclaré comme clé unique. Le fichier CSV contient la colonne code_client et de nouveaux prix.
Cochez Utiliser la clé unique définie dans TimeTonic.
Laissez Utiliser les données de la table cochée pour mettre à jour tous les clients.
Mappage : code_client ↔ code_client, prix ↔ tarif.
À l'import : les clients existants sont mis à jour, les codes inconnus sont ajoutés.
Option 2 : Déclarer une clé unique manuelle à l'import
Lorsque votre table ne possède pas de clé unique permanente, vous pouvez en déclarer une ponctuellement directement dans la fenêtre de mapping, en cochant la case Clé unique en face d'une colonne CSV.
La sous-option "Utiliser les données de la table"
Lorsque vous cochez une clé unique manuelle, une sous-option apparaît pour contrôler la portée de la recherche de doublons : sur toute la table, ou uniquement sur la vue active.
ComportementDétail
Quand apparaît-elle ?Uniquement si vous avez coché Clé unique sur au moins une colonne de la table. Elle n'existe donc que dans le scénario "clé unique manuelle".
Valeur par défautAutomatiquement cochée.
Effet si cochéeTimeTonic ignore la vue active et recherche la valeur de la clé unique dans toute la table. Comportement identique à l'option 1.
Effet si décochéeLe contrôle des doublons se limite à la vue active. Les lignes masquées par un filtre sont considérées comme absentes : si le CSV les contient, elles seront recréées en doublon.
Exemple concret
Import quotidien avec la colonne intervention_id · vous voulez affecter uniquement les interventions visibles dans la vue « En cours ».
Sur la ligne intervention_id, cochez Clé unique.
Décochez ensuite Utiliser les données de la table.
Résultat :
Les intervention_id présents dans la vue sont mis à jour.
Les mêmes identifiants masqués par le filtre, s'ils figurent dans le CSV, seront créés comme nouvelles lignes (puisqu'ils sont invisibles au contrôle).
⚠️ Attention : si vous laissez la case cochée, le contrôle portera sur l'ensemble de la table. Aucune recréation inattendue ne se produira, mais le traitement sera global, sans tenir compte de la vue active.
6. Faire le mapping
Une fois vos options de doublons définies, associez chaque colonne CSV au champ TimeTonic correspondant.
1
Pour chaque colonne CSV, sélectionnez le champ TimeTonic correspondant
Utilisez la liste déroulante pour associer la colonne à son champ cible.
2
Cochez la case Clé unique au besoin
Sur la colonne qui sert d'identifiant pour la gestion des doublons.
3
Cliquez sur OK
Pour valider l'ensemble du mapping et passer à l'étape de confirmation.
7. Valider et lancer l'import
Un récapitulatif s'affiche pour vérifier les correspondances avant de lancer l'import définitif.
Démarrer l'import
Cliquez sur Démarrer l'import pour lancer le traitement.
Mettre en pause / reprendre
Vous pouvez à tout moment interrompre l'import via Mettre en pause l'import, puis le relancer via Reprendre l'import.
Suivre la progression en temps réel
Une barre de progression affiche l'état du traitement pendant tout le cycle de chargement.
À la fin de l'import
État détaillé de l'import
TimeTonic affiche un récapitulatif : nombre de lignes créées, mises à jour et éventuelles erreurs rencontrées.
Rapport de logs téléchargeable
Un fichier de logs complet est disponible en téléchargement pour analyser le détail de l'import, notamment en cas d'erreur.
Recommandations avant un import volumineux
Sauvegardez la table
Conservez une copie de la table avant tout import massif pour pouvoir revenir en arrière.
Vérifiez la clé unique
Qu'elle soit permanente ou ponctuelle, elle ne doit contenir ni doublons ni cellules vides.
Testez sur une vue filtrée
Préférez une vue réduite pour vos tests afin d'éviter les surprises à grande échelle.
Surveillez les colonnes obligatoires
Vérifiez que toutes les colonnes requises par votre table sont bien renseignées dans le CSV.
Consultez le rapport d'import
Il recense les lignes créées, mises à jour et les éventuelles erreurs à corriger.
Tutoriel vidéo
Retrouvez les explications de cet article en vidéo.
Aller plus loin
Définir un champ comme clé unique
Configurez un champ pour identifier chaque ligne de façon sûre dans votre table.