Перейти к основному содержанию

​
Обзор

Импорт не работает? Это руководство поможет вам поэтапно выявлять и устранять распространённые ошибки импорта.

​
Как работает проверка импорта

После загрузки файла и сопоставления столбцов Twenty проверяет ваши данные:
  1. Запускается проверка — Twenty проверяет каждую строку на ошибки
  2. Ошибки подсвечиваются — проблемные строки отображаются жёлтым
  3. Исправляйте на месте — редактируйте ячейки прямо в интерфейсе импорта
  4. Или удалите строки — полностью пропустите проблемные записи
Исправляйте ошибки в интерфейсе. Вам не нужно возвращаться к своей таблице. Редактируйте ячейки прямо во время импорта, чтобы сэкономить время.

​
Пошаговое устранение неполадок

​
Шаг 1: Определите тип ошибки

Нажмите на подсвеченную строку, чтобы увидеть конкретное сообщение об ошибке. Распространённые типы ошибок:
Сообщение об ошибкеЧто это означает
Дублирующиеся значения, подсвеченные жёлтымЗначение уже существует в Twenty или встречается дважды в вашем файле
{field} не является допустимым {type} (наведите курсор на жёлтую ячейку)Данные не соответствуют ожидаемому формату
Подсвечено обязательное полеОбязательное поле пусто
Не удаётся подключиться к {object}. Уникальная запись не найдена... (импорт не удался)Связанная запись не существует
Слишком много записей. Разрешено не более 10000 (загрузка заблокирована)В файле более 10 000 записей

​
Шаг 2: Исправьте ошибку

Следуйте приведённым ниже инструкциям для каждого типа ошибки.

​
Ошибка: Дублирующееся значение

​
Что вы увидите

Строки с дублирующимися значениями подсвечиваются жёлтым в интерфейсе импорта до начала импорта.

​
Что это означает

Уникальное поле (email, домен) либо:
  • Уже существует в Twenty
  • Встречается дважды в вашем файле

​
Как исправить

Вариант 1: Измените дублирующееся значение
  1. Нажмите на ячейку с ошибкой
  2. Измените на уникальное значение
  3. Продолжайте импорт
Вариант 2: Удалите строку-дубликат
  1. Нажмите X рядом со строкой
  2. Эта строка будет пропущена при импорте
Вариант 3: Разрешите Twenty обновить существующую запись
  1. Убедитесь, что ваш файл содержит уникальный идентификатор (email, domain или id)
  2. Сопоставьте поле уникального идентификатора
  3. Twenty обновит существующую запись вместо создания дубликата
Можно обновлять и уникальные поля.
  • Если вы оставите id, но измените email → адрес электронной почты будет обновлён
  • Если вы оставите email, но измените id → идентификатор будет обновлён
Пока совпадает хотя бы один уникальный идентификатор, Twenty обновит запись.

​
Как предотвратить эту ошибку

Перед импортом:
  1. Отсортируйте таблицу по уникальному полю
  2. Удалите строки-дубликаты
  3. Проверьте, существуют ли записи уже в Twenty
Записи, помеченные как удалённые, учитываются при проверке уникальности.Откройте Командное меню → Просмотреть удалённые записи. Записи там по-прежнему учитываются при проверке уникальности. Удалите их окончательно или восстановите и обновите.
Подробнее: Ограничения уникальности

​
Ошибка: Неверный формат

​
Что вы увидите

Значение ячейки подсвечено жёлтым. Наведите на него курсор, чтобы увидеть сообщение об ошибке: 
{field name} — недопустимое значение для {field type}

​
Что это означает

Данные не соответствуют ожидаемому формату для этого типа поля.

​
Как исправить — по типам полей

​
Электронная почта

Проблема: Неверный формат email Решение: Используйте формат name@domain.com 
❌ john.smith@
❌ john smith@acme.com
✓ john.smith@acme.com

​
Домен

Проблема: Несогласованный формат может вызывать дубликаты Решение: Используйте формат https://domain.com (рекомендуется) 
⚠️ acme.com         (valid, but not recommended)
⚠️ www.acme.com     (valid, but not recommended)
✅ https://acme.com  (recommended)
Все форматы допустимы, но https://domain.com рекомендуется, потому что он соответствует формату, используемому при синхронизации почты/календаря. Использование других форматов может привести к созданию дублирующихся компаний.

​
Дата

Проблема: Нераспознанный формат даты Решение: Используйте единый формат по всему файлу 
✓ 2024-03-15        (YYYY-MM-DD - recommended)
✓ 03/15/2024        (MM/DD/YYYY)
✓ 15/03/2024        (DD/MM/YYYY)

​
Телефон

Проблема: Отсутствуют обязательные столбцы Решение: Добавьте все столбцы для телефонов
СтолбецПример
Телефоны / Основной номер телефона4159095555
Телефоны / Код страны основного номераUS
Телефоны / Телефонный код основного номера+1

​
Логический тип

Проблема: Неверное логическое значение Решение: Используйте прописные TRUE или FALSE 
❌ true
❌ yes
❌ 1
✓ TRUE
✓ FALSE

​
Выбор / Множественный выбор

Проблема: Значение не совпадает с существующими опциями Решение: Используйте имена API, а не отображаемые метки Как найти имена API:
  1. Перейдите в Настройки → Модель данных
  2. Выберите объект и поле
  3. Включите Расширенный режим (переключатель внизу справа)
  4. Используйте имя API (например, OPTION_1, а не “Option 1”)
❌ High Priority
✓ HIGH_PRIORITY

​
Валюта

Проблема: Отсутствует сумма или код валюты Решение: Заполните оба столбца
СтолбецПример
Сумма / Сумма1234.56
Сумма / ВалютаUSD

​
Число

Проблема: Нечисловые символы Решение: Только цифры, точка для десятичных дробей 
❌ $1,234.56
❌ 1,234.56
✓ 1234.56
Полная справка по форматам: Справочник по сопоставлению полей

​
Ошибка: Отсутствует обязательное поле

​
Что вы увидите

Строка подсвечена жёлтым, а ячейка обязательного поля отмечена.

​
Что это означает

В этой строке не заполнено обязательное поле.

​
Как исправить

Вариант 1: Введите значение
  1. Нажмите на пустую ячейку
  2. Введите значение
  3. Продолжайте импорт
Вариант 2: Удалите строку
  1. Если данных нет, нажмите X, чтобы пропустить строку

​
Как предотвратить эту ошибку

Перед импортом определите обязательные поля:
  1. Перейдите в Настройки → Модель данных
  2. Выберите ваш объект
  3. Проверьте, какие поля помечены как обязательные

​
Ошибка: Связь не найдена

​
Что вы увидите

Эта ошибка возникает после начала импорта — импорт завершается с сообщением вроде: 
Can't connect to company. No unique record found with condition: id = 7776ee49-f608-4a77-8cc8-6fe96ae1e43f
Это означает, что в Twenty нет компании с таким идентификатором.
В отличие от других ошибок, эта не обнаруживается на этапе проверки данных. Импорт начнётся, а затем завершится с ошибкой, когда встретит отсутствующую связь.

​
Что это означает

Вы пытаетесь сослаться на запись, которой не существует в Twenty.

​
Как исправить

Вариант 1: Сначала импортируйте родительские записи
  1. Отмените текущий импорт
  2. Импортируйте родительские записи (например, Компании)
  3. Затем импортируйте дочерние записи (например, Контакты)
Вариант 2: Исправьте ссылочное значение
  1. Проверьте ссылочное значение в вашем файле
  2. Убедитесь, что оно в точности совпадает с существующей записью
  3. Проверьте формат: домены должны быть в виде https://domain.com
Вариант 3: Удалите связь
  1. Очистите ячейку, чтобы импортировать без связи
  2. Добавьте связь вручную позже

​
Как предотвратить эту ошибку

  1. Импортируйте в правильном порядке:
    • Сначала — Компании
    • Затем — Контакты (со ссылками на компании)
    • Третьими — Возможности
  2. Проверьте ссылочные значения:
    • Экспортируйте родительские записи, чтобы получить точные идентификаторы
    • Используйте формат домена https://domain.com
    • Проверьте опечатки и учтите регистр
Импорт завершится с ошибкой, если ссылка указывает на несуществующую запись.Всегда импортируйте родительские объекты перед дочерними объектами.
Подробнее: Импорт связей

​
Ошибка: Слишком большой файл

​
Что вы увидите

Эта ошибка появляется при загрузке файла — загрузка полностью блокируется: 
Слишком много записей. Разрешено не более 10000
Вы не сможете перейти к этапу проверки данных, пока не уменьшите размер файла.

​
Что это означает

В вашем файле более 10 000 записей.

​
Как исправить

Вариант 1: Разделите на несколько файлов
  1. Разделите данные на файлы по 10 000 записей или меньше
  2. Импортируйте каждый файл отдельно
  3. Соблюдайте порядок импорта (Компании перед Контактами)
Вариант 2: Используйте импорт через API Для очень больших наборов данных используйте API, у которого нет ограничения по количеству записей. См.: Как импортировать данные через API

​
Ошибка: Поле не распознано

​
Что это означает

Столбец в вашем файле нельзя сопоставить, потому что такого поля нет в Twenty.

​
Как исправить

  1. Перейдите в Настройки → Модель данных
  2. Выберите объект, который вы импортируете
  3. Нажмите + Добавить поле
  4. Создайте настраиваемое поле с соответствующим типом
  5. Загрузите файл повторно
Импорт CSV создаёт записи, а не поля. Все поля должны существовать до начала импорта.

​
Ошибка: Пустая связь с пользователем

​
Что это означает

Вы пытаетесь назначить запись пользователю (Owner, Assignee), но связь не сопоставляется.

​
Распространённые причины

  1. Пользователь не принял приглашение — пользователь ещё не существует в Twenty
  2. Используется ID пользователя из старой системы — Twenty не может сопоставить идентификаторы из другой системы
  3. Неверный формат email — адрес электронной почты не совпадает с аккаунтом пользователя в Twenty

​
Как исправить

  1. Убедитесь, что все пользователи приняли приглашение в ваше рабочее пространство Twenty
  2. Используйте адрес электронной почты пользователя (не его имя и не ID из старой системы)
  3. Используйте тот же адрес электронной почты, который использовался для присоединения к Twenty
Пользователи должны принять приглашения до начала импорта.Если пользователь не принял приглашение, у записей, ссылающихся на него, будет пустая пользовательская связь.

​
Контрольный список перед импортом

Избегайте ошибок, проверив следующее перед импортом:

​
Требования к файлу

Файл в формате CSV, XLSX или XLS
В файле менее 10 000 записей
Файл использует кодировку UTF-8

​
Качество данных

Нет дублирующихся адресов электронной почты (для Контактов)
Нет дублирующихся доменов (для Компаний)
Все даты используют единый формат
Все домены в формате https://domain.com

​
Форматы полей

Логические поля используют TRUE или FALSE (прописные)
Поля типа Select используют имена API, а не отображаемые метки
Телефонные поля содержат все обязательные столбцы
Поля валюты содержат и сумму, и код валюты

​
Связи

Родительские записи импортированы до дочерних записей
Столбцы со связями ссылаются на существующие записи
Формат домена точно соответствует формату Twenty

​
Модель данных

Все настраиваемые поля существуют в Настройки → Модель данных
Опции для Select созданы до импорта

​
Всё ещё возникают проблемы?

Если вы попробовали решения выше:
  1. Скачайте пример файла — посмотрите точный формат, который ожидает Twenty
  2. Экспортируйте существующие записи — сравните свой файл с рабочими данными
  3. Протестируйте на небольшой выборке — сначала попробуйте 5–10 строк
  4. Ознакомьтесь со справочными статьями: