TeeckIn/Docs

Importer des données

Importez dans TeeckIn vos données de suivi du temps provenant d'autres outils.

Présentation

Vous changez d'outil de suivi du temps ? TeeckIn peut importer vos données existantes afin de ne pas perdre votre historique de suivi. Nous prenons en charge les imports directs depuis des outils populaires, un format CSV générique et la restauration complète à partir d'exports TeeckIn.

Formats pris en charge

Toggl Track

Import direct depuis les exports Toggl. Les catégories correspondent aux projets et les pointages conservent toutes leurs métadonnées.

Export CSV depuis Toggl

Clockify

Importez les rapports détaillés de Clockify. Les projets deviennent des Topics et les tags sont conservés.

Export CSV depuis Clockify

Harvest

Importez les pointages de Harvest. Les clients, projets et tâches sont mis en correspondance automatiquement.

Export CSV depuis Harvest

CSV générique

Importez depuis n'importe quel outil grâce à notre format CSV standard. Associez les colonnes lors de l'import.

Fichier CSV personnalisé

Export TeeckIn (v3)

Restaurez à partir d'un export TeeckIn précédent. Parfait pour les sauvegardes ou pour migrer entre comptes.

Export JSON TeeckIn

Importer depuis Toggl

  1. 1
    Dans Toggl : allez dans Reports puis Detailed
  2. 2
    Sélectionnez la plage de dates que vous souhaitez exporter
  3. 3
    Cliquez sur Export et choisissez CSV
  4. 4
    Dans TeeckIn : allez dans Paramètres du compte puis Données
  5. 5
    Cliquez sur Importer des données
  6. 6
    Sélectionnez Toggl Track comme source
  7. 7
    Téléversez le fichier CSV
  8. 8
    Vérifiez l'aperçu et la correspondance
  9. 9
    Cliquez sur Importer

Remarque

Les projets Toggl deviennent des Topics TeeckIn. Si vous avez des clients dans Toggl, ils deviennent des catégories contenant ces projets.

Importer depuis Clockify

  1. 1
    Dans Clockify : allez dans Reports puis Detailed
  2. 2
    Définissez votre plage de dates et les filtres souhaités
  3. 3
    Cliquez sur Export et choisissez CSV
  4. 4
    Dans TeeckIn : allez dans Paramètres du compte puis Données
  5. 5
    Cliquez sur Importer des données
  6. 6
    Sélectionnez Clockify comme source
  7. 7
    Téléversez le fichier CSV
  8. 8
    Vérifiez la correspondance et ajustez-la si nécessaire
  9. 9
    Cliquez sur Importer

Import CSV générique

Pour les outils sans prise en charge directe, utilisez un CSV comportant ces colonnes :

ColonneObligatoireFormat
dateOuiYYYY-MM-DD
start_timeOui*HH:MM or HH:MM:SS
end_timeOui*HH:MM or HH:MM:SS
durationOui*HH:MM:SS ou minutes
projectNonTexte (devient un Topic)
categoryNonTexte
descriptionNonTexte (devient des notes)
tagsNonSéparées par des virgules
hourly_rateNonNombre
billableNontrue/false or yes/no

* Fournissez soit start_time + end_time, soit duration

Astuce

Lors de l'import, vous pouvez associer les colonnes de votre CSV aux champs de TeeckIn si les noms ne correspondent pas exactement.

Restaurer à partir d'un export TeeckIn

Vous pouvez restaurer vos données à partir d'un export TeeckIn v3. C'est utile pour :

  • Restaurer à partir d'une sauvegarde après une perte de données
  • Migrer des données vers un nouveau compte TeeckIn
  • Passer de la version auto-hébergée à la version cloud, et inversement
  1. 1
    Allez dans Paramètres du compte puis Données
  2. 2
    Cliquez sur Importer des données
  3. 3
    Sélectionnez Export TeeckIn comme source
  4. 4
    Téléversez votre fichier d'export JSON
  5. 5
    Confirmez en saisissant votre mot de passe
  6. 6
    Patientez pendant la fin de l'import

Avertissement

L'import remplacera TOUTES vos données existantes. Veillez à exporter d'abord vos données actuelles si vous souhaitez en conserver une partie.

Ce qui est restauré

  • Les paramètres et préférences de votre compte
  • Toutes les données de l'espace de travail personnel (catégories, Topics, pointages)
  • Les clients, factures et transactions
  • Les tags et libellés comptables
  • Les pointages récurrents et les objectifs de temps
  • La progression de la gamification (séries, XP, accomplissements)
  • Les organisations que vous possédez (avec toutes leurs données)

Ce qui doit être reconfiguré

Avertissement

Pour des raisons de sécurité, certaines données ne peuvent pas être restaurées à partir des exports :
  • Paramètres e-mail SMTP — Votre configuration e-mail doit être ressaisie après l'import
  • Identifiants d'agent — Les secrets OAuth doivent être régénérés ; seules les métadonnées de l'agent (noms, types) sont conservées
  • Fichiers joints — Seules les métadonnées sont restaurées ; les fichiers eux-mêmes ne peuvent pas être récupérés
  • Authentification à deux facteurs — Doit être reconfigurée de zéro par sécurité

Remarque

Les imports ne fonctionnent qu'avec les exports au format v3.0.0. Les formats d'export plus anciens ne sont pas pris en charge et devront d'abord être migrés.

Correspondance des colonnes

Lors de l'import, l'assistant affiche un écran de correspondance :

Votre colonne : « Project Name »correspond àTopic
Votre colonne : « Start »correspond àHeure de début
Votre colonne : « Stop »correspond àHeure de fin

Vous pouvez modifier les correspondances, ignorer des colonnes ou définir des valeurs par défaut pour les données manquantes.

Aperçu de l'import

Avant d'importer, un aperçu vous montrera :

  • Le nombre de pointages à importer
  • La plage de dates des données
  • Les catégories et Topics qui seront créés
  • Les éventuels avertissements concernant les pointages en double ou invalides

Avertissement

Examinez l'aperçu attentivement. Les imports ne peuvent pas être annulés : il faudrait supprimer manuellement les pointages importés.

Gestion des doublons

TeeckIn vérifie la présence de doublons potentiels lors de l'import :

Ignorer les doublons

Les pointages ayant la même date, la même heure de début et le même Topic sont ignorés.

Importer quand même

Importez tous les pointages, même s'ils peuvent être des doublons.

Examiner chacune

Affiche les doublons potentiels et vous laisse décider pour chacun.

Après l'import

Une fois l'import terminé :

  1. 1
    Vérifiez le récapitulatif de l'import pour repérer les pointages ignorés
  2. 2
    Allez dans le Calendrier pour vérifier que les pointages apparaissent correctement
  3. 3
    Vérifiez les nouvelles catégories et Topics dans les Paramètres
  4. 4
    Définissez des tarifs horaires sur les Topics s'ils n'ont pas été importés
  5. 5
    Supprimez les pointages importés indésirables si nécessaire

Remarque

Les pointages importés sont marqués en interne afin que vous puissiez les filtrer ou les identifier plus tard si besoin.

Dépannage

L'import échoue avec « Format de date invalide »

Assurez-vous que les dates utilisent le format AAAA-MM-JJ. Convertissez-les dans Excel/Sheets avant l'import.

Les heures sont décalées de plusieurs heures

Vérifiez les paramètres de fuseau horaire. TeeckIn utilise le fuseau horaire de votre compte pour les imports.

Certains pointages sont manquants

Vérifiez le récapitulatif de l'import pour repérer les pointages ignorés. Causes courantes : détection de doublons, champs obligatoires manquants.

Les catégories ou Topics ne sont pas créés correctement

Vérifiez la correspondance des colonnes. Assurez-vous que les colonnes de projet/catégorie sont correctement associées.

L'import TeeckIn échoue avec « Format invalide »

Assurez-vous d'utiliser un export v3.0.0. Les exports plus anciens utilisent un format différent et ne peuvent pas être importés directement.

Le SMTP/e-mail ne fonctionne pas après la restauration

Les identifiants SMTP ne sont pas inclus dans les exports par sécurité. Ressaisissez vos paramètres e-mail dans les Paramètres du compte.

À voir aussi

Exportez vos données

Sauvegardez ou migrez vos données

Catégories

Organisez les Topics importés

Topics

Définissez des tarifs sur les Topics importés