Twenty prend en charge trois formats de fichiers pour l’importation :
| Format | Extension | Notes |
|---|
| CSV | .csv | Recommandé, le plus compatible |
| Excel | .xlsx | Format Excel moderne |
| Excel (hérité) | .xls | Ancien format Excel |
Exigences relatives aux fichiers
| Exigence | Valeur |
|---|
| Encodage | UTF-8 recommandé |
| Limite d’enregistrements | 10 000 enregistrements par fichier |
| Structure | La première ligne doit contenir les en-têtes de colonnes |
| Contenu | Un seul type d’objet par fichier |
Meilleures pratiques pour les fichiers CSV
- Délimiteur : Utilisez une virgule (
,) ou un point-virgule (;)
- Délimiteur de texte : Utilisez des guillemets doubles (
\") pour le texte contenant des virgules
- Fins de ligne : Windows (CRLF) ou Unix (LF) sont tous deux pris en charge
- Valeurs vides : Laissez les cellules vides, n’utilisez pas “NULL” ni “N/A”
Meilleures pratiques pour Excel
Lors de l’exportation depuis Excel :
- Supprimez les formules (exportez uniquement les valeurs)
- Supprimez les lignes vides à la fin
- Assurez-vous qu’aucune cellule n’est fusionnée
- Utilisez uniquement la première feuille
Jeux de données volumineux
Pour les jeux de données de plus de 10 000 enregistrements :
- Divisez en plusieurs fichiers
- Ou utilisez l’importation via l’API pour un nombre illimité d’enregistrements
Pour des migrations très volumineuses (plus de 100 000 enregistrements), l’API est nettement plus rapide et plus fiable que les importations CSV.