Поддерживаемые форматы
Twenty поддерживает три формата файлов для импорта:
| Формат | Расширение | Заметки |
|---|
| CSV | .csv | Рекомендуется, наибольшая совместимость |
| Excel | .xlsx | Современный формат Excel |
| Excel (устаревший) | .xls | Старый формат Excel |
Требования к файлам
| Требование | Значение |
|---|
| Кодировка | Рекомендуется UTF-8 |
| Лимит записей | 10 000 записей на файл |
| Структура | Первая строка должна содержать заголовки столбцов |
| Содержимое | Один тип объекта в файле |
Лучшие практики CSV
- Разделитель: используйте запятую (
,) или точку с запятой (;)
- Квалификатор текста: используйте двойные кавычки (
\") для текста, содержащего запятые
- Окончания строк: поддерживаются оба варианта — Windows (CRLF) и Unix (LF)
- Пустые значения: оставляйте ячейки пустыми, не используйте “NULL” или “N/A”
Лучшие практики Excel
При экспорте из Excel:
- Удалите формулы (экспортируйте только значения)
- Удалите пустые строки в конце
- Убедитесь, что нет объединённых ячеек
- Используйте только первый лист
Большие наборы данных
Для наборов данных более 10 000 записей:
- Разбейте на несколько файлов
- Или используйте импорт через API для неограниченного количества записей
Для очень больших миграций (100 000+ записей) API значительно быстрее и надёжнее, чем импорт CSV.
