---
title: Mappage des champs
description: Comment fonctionne la cartographie des champs pendant l'importation des données.
---

import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';

## Comment fonctionne la cartographie des champs

Lorsque vous téléchargez un fichier, 20 analysent vos colonnes et tentent de les faire correspondre aux champs existants.

### Mappage automatique

Vingt tentatives de faire correspondre les colonnes basées sur:

* Noms d'en-tête de colonne (correspondances exactes ou similaires)
* Détection du type de données (dates, chiffres, emails)
* Modèles de champs communs

<Note>**Astuce rapide:** Exporter quelques lignes depuis l'objet que vous voulez importer. Le fichier exporté aura le nom exact des colonnes à 20 attendus, rendant le mappage automatique sans problème pendant l'importation.</Note>

### Options de mappage manuel

Pour chaque colonne, vous pouvez:

* **Mapper à un champ**: Sélectionnez le champ correspondant à 20 dans un menu déroulant
* **Ne pas mapper** : Ignorer entièrement la colonne (les données ne seront pas importées)

<Note>**Les champs doivent exister avant l'importation.** L'importation crée des enregistrements, pas des champs. Créez des champs personnalisés sous **Paramètres → Modèle de données** avant d'importer.</Note>

## Compatibilité du type de champ

Tous les types de champs disponibles dans le Modèle de Données sont pris en charge pour l'importation.

Vous pouvez également importer des valeurs `id` pour assigner un ID spécifique à de nouveaux enregistrements ou mettre à jour les valeurs existantes.

<img src="/images/user-guide/fields/all-field-types.png" style={{width:'100%'}} />

## Exigences du format de données

<Note>**Certains champs ont une syntaxe spéciale.** Nous vous recommandons de télécharger le fichier d'exemple avant de préparer votre importation afin de voir la syntaxe attendue pour chaque type de champ.</Note>

### Champs d'adresse

L'adresse est un champ imbriqué avec plusieurs colonnes. Certains peuvent être laissés vides.

* **Adresse / Adresse 1**: Rue ligne 1
* **Adresse / Adresse 2** : Rue ligne 2
* **Adresse / Ville** : Nom de la Ville
* **Adresse / État** : État ou province
* **Adresse / Pays** : Nom du pays
* **Adresse / Code postal**: Code postal

### Champs de tableau

Utilisez le format suivant :

```
["value1","value2"]
```

### Champs booléens

Utilisez `TRUE` ou `FALSE` (majuscule) - pas `true` ou `false`

### Champs de la devise

La devise est un champ imbriqué avec deux colonnes qui **doivent être remplies**:

* **Montant / Montant** : La valeur numérique (par exemple, `1234.56`)
* **Montant / Devise** : Le code de la devise (par exemple, `USD`, `EUR`)

### Champs de date

Formats pris en charge :

* `YYYY-MM-DD` (recommandé)
* `MM/DD/YYYYY`
* `JJ/MM/YYYY`
* ISO 8601 format

### Champs de domaine

* Il est recommandé d'utiliser le format `https://domain. om` pour éviter de créer des doublons, car c'est le format utilisé pour les entreprises créées par la boîte aux lettres et les synchronisations de calendrier
* Un `label de domaine` et `URL de domaine` peuvent être remplis : la meilleure pratique est de remplir `domain.com` dans l'étiquette et `https://domain.com` dans l'url
* Les domaines doivent être uniques au sein de l'objet Entreprises
* **Les domaines doivent être uniques dans le fichier à importer**

### Champs e-mail

* Doit être un format d'email valide
* Les e-mails doivent être uniques dans l'objet People
* **Les e-mails doivent être uniques dans le fichier à importer**
* Pour les e-mails supplémentaires: utilisez **Emails / Courriel Primaire** pour l'e-mail principal, et **Emails / E-mails Supplémentaires** avec ce format:

```
["jane@twenty.com","jane.doe@twenty.com"]
```

### Champs ID

Spécifier un `id` pendant l'importation est optionnel. Vingt auto-génère une si elle n'est pas fournie.

Utiliser des cas pour mapper une colonne `id`:

* **Définit un ID spécifique** : Choisissez l'UUID pour les enregistrements nouvellement créés
* **Mettre à jour les enregistrements existants**: Faites correspondre avec les enregistrements existants pour les mettre à jour au lieu de créer des doublons. Dans ce cas, il est recommandé de ne pas cartographier les autres champs uniques: la cartographie d'un seul champ unique garantit une importation plus fluide.

<Note>Si vous fournissez un `id`, il doit être au format UUID (par exemple, `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>

### Champs JSON

Utiliser un format JSON valide :

```
{"key":"value","key2":"value2"}
```

### Champs de liens

Semblable aux champs de domaine:

* Remplissez à la fois le libellé et les colonnes d'URL : **Liens / URL de liaison** et **Liens / Étiquette de lien**
* Utiliser le format complet de l'URL : `https://example.com`
* Pour les liens secondaires, utilisez la colonne **Liens / Liens secondaires** avec ce format :

```
[{"url":"https://twenty.com","label":"Twenty"}]
```

### Champs à sélection multiple

Utilisez les **noms de l'API** (pas les libellés d'affichage) dans le format suivant :

```
["VALUE1","VALUE2"]
```

Voir [here](#finding-api-names-for-select-fields) où trouver les noms de l'API.

<Note>Les nouvelles options de sélection ne seront pas créées automatiquement par l'importation. Ils doivent être ajoutés dans **Paramètres → Modèle de données** avant d'importer.</Note>

<Warning>
**Écraser l'import ; il ne l'ajoute pas.**

Si un enregistrement a déjà `VALUE2` et `VALUE3` sélectionnés, et que vous importez `["VALUE1"]`, l'enregistrement n'aura `VALUE1` qu'après l'importation. Les sélections précédentes sont remplacées, non fusionnées.
</Warning>

### Nombre de champs

* Numéros uniquement
* Les décimales utilisent la période: `1234.56`
* Pas de milliers de séparateurs

### Champs du téléphone

Le téléphone est un champ imbriqué avec plusieurs colonnes qui **doivent être remplies**

* **Téléphones / Numéro de téléphone principal**: le numéro de téléphone (par exemple, `4159095555`)
* **Téléphones / Code de pays de téléphone principal**: Code pays (par exemple, `US`)
* **Téléphones / Code d'appel téléphonique principal**: Code d'appel (par exemple, `+1`)

### Champs d'évaluation

Utilisez le format du nom de l'API: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4`, `RATING_5`

### Champs de relation

Veuillez consulter notre article dédié : [Importer des relations entre les objets](/l/fr/user-guide/data-migration/capabilities/import-relations)

### Champs de sélection

Utilisez le **nom de l'API** de l'option (pas l'étiquette d'affichage) :

```
VALUE1
```

Voir [ici](#finding-api-names-for-select-fields) où trouver les noms d'API.
<Note>Les nouvelles options de sélection ne seront pas créées automatiquement par l'importation. Elles doivent être ajoutées sous **Paramètres → Modèle de données** avant l'importation.</Note>

### Champs de texte

* Aucun formatage particulier requis
* Les espaces au début et à la fin sont supprimés

## Recherche des noms d'API

Pour les champs Select, Multi-Select et Array avec des options prédéfinies, vous devez utiliser les **noms d'API**, et non les libellés affichés.

### Comment trouver les noms d'API

1. Allez dans **Paramètres → Modèle de données**
2. Sélectionnez l'objet et le champ
3. Activez le **mode avancé** (bouton à bascule en bas à droite de la page des paramètres)
4. Affichez le nom d'API pour chaque option

<VimeoEmbed videoId="1144910809" title="Démonstration vidéo" />
