---
title: Сопоставление полей
description: Как работает сопоставление полей при импорте данных.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Как работает сопоставление полей
Когда вы загружаете файл, 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** в следующем формате:
```
["jane@twenty.com","jane.doe@twenty.com"]
```
### Поля идентификаторов
Указание `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"]
```
См. [здесь](#finding-api-names-for-select-fields), где найти имена 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`
### Поля связи
См. нашу отдельную статью: [Импорт связей между объектами](/l/ru/user-guide/data-migration/capabilities/import-relations)
### Выбор полей
Используйте **имя API** варианта (а не отображаемую метку):
```
VALUE1
```
См. [здесь](#finding-api-names-for-select-fields), где найти имена API.
Новые варианты списка не будут созданы автоматически при импорте. Добавьте их в **Настройки → Модель данных** перед импортом.
### Текстовые поля
* Специальное форматирование не требуется
* Начальные и конечные пробелы удаляются
## Поиск имен API
Для полей Select, Multi-Select и Array с предопределёнными вариантами необходимо использовать **имена API**, а не отображаемые метки.
### Как найти имена API
1. Перейдите в **Настройки → Модель данных**
2. Выберите объект и поле
3. Включите **Расширенный режим** (переключатель внизу справа на странице настроек)
4. Просмотрите имя API для каждого варианта