Aller au contenu principal

Recherche

Laissez-vous guider !

Importer un fichier .CSV

Mis à jour le

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

1. Avant de commencer

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.
Accès au menu Import depuis les options de la table

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.

Écran de chargement du fichier CSV

Détail des options de chargement

# Libellé à l'écran Rôle
1 Sélectionnez le fichier Ouvre l'explorateur pour choisir votre fichier CSV local.
2 Sélectionnez le séparateur Mode : Auto · Virgule , · Point-virgule ; · Tabulation.
3 Validation du fichier Lance la lecture du fichier avec les paramètres choisis.
4 Mode sombre Active ou désactive l'affichage en mode sombre.
5 Choix de langue Bascule 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.

Écran de préparation des imports

Détail de l'écran de préparation

# Libellé à l'écran Rôle
1 Table sélectionnée Table dans laquelle les données seront écrites.
2 Fichier sélectionné Nom du fichier CSV en cours d'import.
3 Colonne CSV Liste des colonnes détectées dans votre fichier.
4 Premières lignes du CSV Aperçu des 5 premières lignes pour vérifier le contenu.
5 Champ TimeTonic Liste 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.

Commandes d'associations : effacer, sauvegarder, charger
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…).

Case à cocher : utiliser la clé unique définie dans TimeTonic
Question Ré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.

  1. Cochez Utiliser la clé unique définie dans TimeTonic.
  2. Laissez Utiliser les données de la table cochée pour mettre à jour tous les clients.
  3. Mappage : code_client ↔ code_client, prix ↔ tarif.
  4. À 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.

Sous-option : utiliser les données de la table

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.

Comportement Dé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éfaut Automatiquement cochée.
Effet si cochée TimeTonic 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ée Le 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 ».

  1. Sur la ligne intervention_id, cochez Clé unique.
  2. Décochez ensuite Utiliser les données de la table.
  3. 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.

Mapping des colonnes CSV vers les champs TimeTonic
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.

Récapitulatif avant lancement de l'import
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.

Barre de progression pendant l'import

À 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.
Voir l'article →