Passer au contenu principal

​
Vue d’ensemble

Ce guide vous accompagne dans l’importation des relations entre objets — par exemple, lier des Personnes à des Entreprises, ou des Opportunités à des Personnes.
Ce qui peut être importé : Uniquement des relations un-à-plusieurs pointant vers un seul type d’objet. Les relations pointant vers plusieurs types d’objet (comme des Notes liées à des Personnes ET à des Entreprises) ne sont pas encore prises en charge pour l’importation.

​
Comprendre les relations

​
Qu’est-ce qu’une relation “un-à-plusieurs” ?

Dans une relation un-à-plusieurs :
  • Une Entreprise a de nombreuses Personnes (employés)
  • Une Entreprise a de nombreuses Opportunités
  • Une Personne a de nombreuses Tâches
Le côté “un” est le parent. Le côté “plusieurs” est l’enfant.

​
Relations courantes dans Twenty

RelationCôté “un” (Parent)Côté “plusieurs” (Enfant)
Entreprises → PersonnesEntreprisePersonnes
Entreprises → OpportunitésEntrepriseOpportunités
Personnes → TâchesPersonneTâches
Personnes → NotesPersonneNotes

​
Étape 1 : Identifier les côtés “un” et “plusieurs”

Avant l’importation, déterminez quel objet est le parent et lequel est l’enfant. Posez-vous la question : “Est-ce qu’UN [Objet A] a PLUSIEURS [Objet B] ?”
  • Une Entreprise → Plusieurs Personnes ✓ (l’Entreprise est le parent)
  • Une Personne → Plusieurs Entreprises ✗ (C’est faux — une personne appartient à une seule entreprise)

​
Étape 2 : Importer d’abord les enregistrements parents

Le parent (côté “un”) doit exister dans Twenty avant que vous ne puissiez y faire référence. Ordre d’import :
  1. Entreprises d’abord (aucune dépendance)
  2. Personnes ensuite (liées aux Entreprises)
  3. Opportunités en troisième (liées aux Entreprises et/ou aux Personnes)
  4. Tâches/Notes (liées à l’un des éléments ci-dessus)
Si l’enregistrement parent n’existe pas, l’import échouera.Vérifiez toujours que les Entreprises sont importées avant d’importer des Personnes avec des références à l’Entreprise.

​
Étape 3 : Noter l’identifiant unique du parent

Vous devez référencer l’enregistrement parent à l’aide d’un identifiant unique. Options disponibles :
Objet parentIdentifiants uniques disponibles
Entreprisesid (UUID), domain (recommandé), ou tout champ unique personnalisé
Personnesid (UUID), email, ou tout champ unique personnalisé
Membres de l’espace de travailid (UUID), email (pas le nom)
Objets personnalisésid (UUID), ou tout champ marqué comme unique
Recommandé : Utilisez domain pour les Entreprises et email pour les Personnes. Ils sont lisibles par l’humain et faciles à vérifier dans votre feuille de calcul.

​
Trouver l’identifiant

Si vous avez besoin de l’id :
  1. Exportez les enregistrements parents depuis Twenty
  2. L’export comprend la colonne id
  3. Utilisez ces identifiants dans votre fichier d’enregistrements enfants

​
Étape 4 : Vérifier que le champ de relation existe

Avant l’importation, assurez-vous que le champ de relation existe entre vos objets. Pour vérifier ou créer :
  1. Allez dans Paramètres → Modèle de données
  2. Sélectionnez votre objet enfant (par ex., Personnes)
  3. Recherchez un champ de relation pointant vers le parent (par ex., Entreprise)
  4. S’il n’existe pas, créez-le :
    • Cliquez sur + Add field
    • Sélectionnez le type Relation
    • Choisissez l’objet parent

​
Étape 5 : Préparer votre fichier CSV

Ajoutez une colonne à votre CSV enfant qui référence le parent en utilisant son identifiant unique.

​
Exemple : Personnes liées aux Entreprises

Votre CSV Personnes : 
firstName,lastName,email,jobTitle,companyDomain
John,Smith,john@acme.com,CEO,https://acme.com
Jane,Doe,jane@widgets.co,CTO,https://widgets.co
Bob,Johnson,bob@techstart.io,Developer,https://techstart.io
La colonne companyDomain référence le domaine de l’Entreprise.

​
Exigences de format

IdentifiantFormatExemple
DomaineFormat d’URLhttps://acme.com
E-mailAdresse e-mail standardjohn@acme.com
IDUUIDc776ee49-f608-4a77-8cc8-6fe96ae1e43f
Le format du domaine est important !Utilisez https://domain.com (et non simplement domain.com). Cela correspond à la manière dont Twenty stocke les domaines des Entreprises et évite les erreurs d’association.

​
Règles importantes

  1. Correspondance exacte requise — la valeur doit correspondre exactement à l’enregistrement parent
  2. N’associez qu’UN SEUL identifiant unique — n’incluez pas à la fois companyId ET companyDomain
  3. Sensible à la casse — Acme.com ≠ acme.com

​
Étape 6 : Téléverser et associer la relation

  1. Accédez à l’objet enfant (par ex., Personnes)
  2. Cliquez sur ⋮ → Importer des enregistrements
  3. Téléversez votre fichier CSV
  4. Lors de l’étape de correspondance des champs :
    • Trouvez votre colonne de relation (par ex., companyDomain)
    • Associez-la au champ de relation Entreprise
  5. Complétez les correspondances restantes
  6. Passez en revue les erreurs et confirmez
Twenty liera automatiquement chaque enregistrement enfant au parent correspondant.

​
Étape 7 : Vérifier l’importation

Après l’importation :
  1. Ouvrez quelques enregistrements enfants (par ex., Personnes)
  2. Vérifiez que le champ de relation affiche le parent correct (par ex., Entreprise)
  3. Ouvrez un enregistrement parent et vérifiez la section des enregistrements liés

​
Erreurs courantes à éviter

ErreurProblèmeSolution
Mauvais ordre d’importImporter des Personnes avant des EntreprisesImportez toujours les parents d’abord, puis les enfants
Mauvais format de domaineUtiliser acme.com au lieu de https://acme.comUtilisez le format d’URL complet avec https://
Plusieurs champs uniquesAssocier à la fois companyId ET companyDomainN’associez qu’UN SEUL identifiant unique
Champ de relation manquantLe champ de relation n’existe pas dans le modèle de donnéesCréez-le dans Paramètres → Modèle de données avant l’importation
Enregistrements inexistantsL’enregistrement parent n’existe pas dans TwentyImportez d’abord les enregistrements parents, ou vérifiez les fautes de frappe
Incohérence de casseAcme.com dans le fichier mais acme.com dans TwentyAssurez une correspondance exacte de la casse

​
Liaison aux membres de l’espace de travail

Lors de la liaison à des membres de l’espace de travail (votre équipe) :
  • Utilisez leur adresse e-mail, pas leur nom
  • Exemple : owner@yourcompany.com, pas “John Smith”
taskName,assignedTo
Follow up with client,john@yourcompany.com
Review proposal,jane@yourcompany.com

​
FAQ

Vous avez deux options :
  1. Utilisez l’id Twenty (exportez les enregistrements parents pour obtenir leurs identifiants)
  2. Créez un champ unique personnalisé dans votre modèle de données pour stocker un identifiant externe provenant de votre système précédent
Oui! Incluez l’identifiant unique de l’enregistrement enfant (par ex., email pour les Personnes) ainsi que la nouvelle valeur de relation. L’import mettra à jour la relation.
Les relations plusieurs-à-plusieurs ne sont pas encore prises en charge pour l’importation. C’est prévu pour S1 2026.
Les relations pointant vers plusieurs types d’objet ne sont pas encore prises en charge pour l’import/export. C’est sur notre feuille de route.
L’import affichera une erreur pour cette ligne. Vous pouvez :
  • Importez d’abord l’enregistrement parent, puis réimportez
  • Corrigez la valeur de référence
  • Supprimez la ligne de l’import
Causes courantes :
  • Mauvais format (utilisez https://domain.com pour les domaines)
  • Incohérence de casse (vérifiez l’orthographe exacte)
  • Le parent n’existe pas (importez d’abord les parents)
  • Association de plusieurs identifiants (n’en utilisez qu’un seul)
Rappel : Les enregistrements supprimés de façon logique comptent pour l’unicité.Si vous obtenez des erreurs “introuvable” mais que l’enregistrement semble exister, vérifiez le menu de commande → Voir les enregistrements supprimés. Le parent a peut-être été supprimé de façon logique.

​
Résolution des problèmes

Vous rencontrez des problèmes ? Consultez :