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

​
Как работает сопоставление полей

Когда вы загружаете файл, Twenty анализирует ваши столбцы и пытается сопоставить их с существующими полями.

​
Автоматическое сопоставление

Twenty пытается сопоставлять столбцы на основе:
  • Названий заголовков столбцов (точные или похожие совпадения)
  • Определения типа данных (даты, числа, адреса электронной почты)
  • Распространённых шаблонов полей
Небольшой совет: Экспортируйте несколько строк из объекта, который вы хотите импортировать. Экспортированный файл будет содержать точные названия столбцов, которые ожидает Twenty, поэтому автоматическое сопоставление при импорте пройдёт без лишних действий.

​
Варианты ручного сопоставления

Для каждого столбца вы можете:
  • Сопоставить с полем: выберите соответствующее поле Twenty из выпадающего списка
  • Не сопоставлять: полностью пропустить столбец (данные не будут импортированы)
Поля должны существовать до импорта. Импорт создаёт записи, а не поля. Создайте настраиваемые поля в разделе Настройки → Модель данных перед импортом.

​
Совместимость типов полей

Все типы полей, доступные в Модели данных, поддерживаются для импорта. Вы также можете импортировать значения id, чтобы назначать конкретный идентификатор новым записям или обновлять существующие.

​
Требования к формату данных

У некоторых полей есть особый синтаксис. Рекомендуем перед подготовкой импорта скачать образец файла, чтобы увидеть ожидаемый синтаксис для каждого типа поля.

​
Поля адреса

Адрес — это вложенное поле с несколькими столбцами. Некоторые можно оставить пустыми.
  • Адрес / Адрес 1: Первая строка адреса
  • Адрес / Адрес 2: Вторая строка адреса
  • Адрес / Город: Название города
  • Адрес / Штат: Штат или провинция
  • Адрес / Страна: Название страны
  • Адрес / Почтовый индекс: Почтовый индекс/ZIP-код

​
Поля массива

Используйте следующий формат: 
["value1","value2"]

​
Булевы поля

Используйте TRUE или FALSE (заглавными) — не true и не false

​
Валютные поля

Валюта — это вложенное поле с двумя столбцами, которые оба должны быть заполнены:
  • Сумма / Сумма: Числовое значение (например, 1234.56)
  • Сумма / Валюта: Код валюты (например, USD, EUR)

​
Поля даты

Поддерживаемые форматы:
  • YYYY-MM-DD (рекомендуется)
  • MM/DD/YYYY
  • DD/MM/YYYY
  • Формат ISO 8601

​
Поля доменов

  • Рекомендуется использовать формат https://domain.com, чтобы избежать создания дубликатов, так как именно этот формат используется для Companies, создаваемых синхронизациями почты и календаря
  • Можно заполнить Domain Label и Domain URL: лучшая практика — указать domain.com в метке и https://domain.com в URL
  • Домены должны быть уникальными в объекте Companies
  • Домены должны быть уникальными внутри импортируемого файла

​
Поля электронной почты

  • Должен быть корректный формат электронной почты
  • Адреса электронной почты должны быть уникальными в объекте People
  • Адреса электронной почты должны быть уникальными внутри импортируемого файла
  • Для дополнительных адресов: используйте Emails / Primary Email для основного адреса и Emails / Additional Emails в следующем формате:
["[email protected]","[email protected]"]

​
Поля идентификаторов

Указание id при импорте необязательно. Twenty автоматически сгенерирует его, если он не указан. Варианты использования сопоставления столбца id:
  • Задать конкретный ID: выберите UUID для создаваемых записей
  • Обновить существующие записи: сопоставьте с существующими записями, чтобы обновить их вместо создания дубликатов. В этом случае рекомендуется не сопоставлять другие уникальные поля: сопоставление только одного уникального поля обеспечивает более беспроблемный импорт.
Если вы указываете id, он должен быть в формате UUID (например, c776ee49-f608-4a77-8cc8-6fe96ae1e43f).

​
Поля JSON

Используйте допустимый формат JSON: 
{"key":"value","key2":"value2"}

​
Поля ссылок

Аналогично полям доменов:
  • Заполните оба столбца — метку и URL: Links / Link URL и Links / Link Label
  • Используйте полный формат URL: https://example.com
  • Для дополнительных ссылок используйте столбец Links / Secondary Links со следующим форматом:
[{"url":"https://twenty.com","label":"Twenty"}]

​
Поля множественного выбора

Используйте имена API (а не отображаемые метки) в следующем формате: 
["VALUE1","VALUE2"]
См. здесь, где найти имена API.
Новые варианты списка не будут созданы автоматически при импорте. Добавьте их в Настройки → Модель данных перед импортом.
Импорт перезаписывает, а не добавляет.Если у записи уже выбраны VALUE2 и VALUE3, а вы импортируете [\"VALUE1\"], после импорта у записи останется только VALUE1. Предыдущие выбранные значения заменяются, а не объединяются.

​
Числовые поля

  • Только числа
  • Десятичные дроби — через точку: 1234.56
  • Без разделителей тысяч

​
Поля телефона

Телефон — это вложенное поле с несколькими столбцами, которые должны быть заполнены
  • Phones / Primary Phone Number: Номер телефона (например, 4159095555)
  • Phones / Primary Phone Country Code: Код страны (например, US)
  • Phones / Primary Phone Calling Code: Телефонный код (например, +1)

​
Поля рейтинга

Используйте формат имени API: RATING_1, RATING_2, RATING_3, RATING_4, RATING_5

​
Поля связи

См. нашу отдельную статью: Импорт связей между объектами

​
Выбор полей

Используйте имя API варианта (а не отображаемую метку): 
VALUE1
См. здесь, где найти имена API.
Новые варианты списка не будут созданы автоматически при импорте. Добавьте их в Настройки → Модель данных перед импортом.

​
Текстовые поля

  • Специальное форматирование не требуется
  • Начальные и конечные пробелы удаляются

​
Поиск имен API

Для полей Select, Multi-Select и Array с предопределёнными вариантами необходимо использовать имена API, а не отображаемые метки.

​
Как найти имена API

  1. Перейдите в Настройки → Модель данных
  2. Выберите объект и поле
  3. Включите Расширенный режим (переключатель внизу справа на странице настроек)
  4. Просмотрите имя API для каждого варианта