Passer au contenu principal
Migration de données

Méthodes d’import

Twenty prend en charge deux méthodes principales d’import de données :
MéthodeIdéal pourLimite de volume
Importation CSVMigrations standard, mises à jour régulières10 000 enregistrements par fichier
Importation via APIMigrations à grande échelle, automatisationIllimité
Pour des ensembles de données très volumineux (des centaines de milliers d’enregistrements), utilisez l’API. Nos partenaires d’implémentation peuvent vous aider à exécuter ces scripts si nécessaire.

Principes de base de l’import CSV

Vous pouvez importer des données pour n’importe quel objet à l’aide de fichiers CSV, XLSX ou XLS. Chaque fichier doit contenir un seul type d’objet (par exemple, uniquement des enregistrements Personnes).
Les champs doivent exister avant l’import. Le téléversement d’un CSV crée des enregistrements, mais ne crée pas de champs. Si vous avez besoin de champs personnalisés, créez-les d’abord dans Paramètres → Modèle de données.

Étapes

  1. Accédez à l’objet dans lequel vous souhaitez importer des données
  2. Cliquez sur l’icône en haut à droite (le menu Commande), puis cliquez sur Importer des enregistrements
  3. Téléchargez le fichier modèle pour garantir que vos données sont au format attendu
  4. Téléversez votre fichier CSV formaté
  5. Faites correspondre vos colonnes aux champs Twenty
  6. Passez en revue les erreurs (surlignées en jaune) et corrigez-les en les modifiant directement dans l’interface
  7. Confirmez l’importation

Importer des relations entre objets

Vous pouvez importer des relations entre objets à l’aide de la fonction d’import CSV. Vous devez référencer l’objet lié en utilisant un champ unique de cet objet : l’id, l’email pour les Personnes et les membres de l’espace de travail, le domain pour les entreprises, tout autre champ défini comme unique dans le modèle de données pour tout autre objet.
Les enregistrements supprimés comptent pour l’unicité. Les enregistrements supprimés de façon logique (visibles dans le menu Commande → Voir les enregistrements supprimés) sont inclus dans les vérifications d’unicité. Si vous importez un enregistrement ayant la même valeur unique qu’un enregistrement supprimé, l’enregistrement supprimé sera restauré.
L’ordre d’importation est important !Lors de l’import d’objets liés, téléversez les fichiers dans cet ordre :
  1. Entreprises d’abord (le côté “un” des relations)
  2. Personnes en second (liées aux entreprises via companyId)
  3. Opportunités en troisième (liées aux entreprises/personnes)
  4. Objets personnalisés avec relations en dernier
Pourquoi ? Le côté “un” d’une relation un-à-plusieurs doit exister avant que vous puissiez y faire référence. Par exemple, l’enregistrement Entreprise doit exister avant d’importer une Personne avec l’ID de cette entreprise.
Veuillez consulter cet article pour un guide étape par étape sur la procédure à suivre.

Exporter des données

Exportez les données de votre espace de travail pour des sauvegardes, des rapports ou des migrations.

Étapes

  1. Accédez à l’objet que vous souhaitez exporter
  2. Configurez la vue avec les colonnes dont vous avez besoin
  3. Cliquez sur Exporter la vue
  4. Enregistrez le fichier CSV
Seules les colonnes visibles sont exportées. Le fichier CSV ne contiendra que les colonnes affichées dans votre vue actuelle. Ajoutez ou masquez des colonnes avant l’exportation pour contrôler les données incluses.
Limites d’exportation : jusqu’à 20 000 enregistrements par export.

Autorisations

L’import et l’export de données nécessitent des autorisations spécifiques :
  • Importation : nécessite l’autorisation “Import CSV”
  • Exportation : nécessite l’autorisation “Export CSV”
Contactez l’administrateur de votre espace de travail si vous n’avez pas ces autorisations.

Prochaines étapes