upstream-twenty/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/field-mapping.mdx

---
title: Сопоставление полей
description: Как работает сопоставление полей при импорте данных.
---

import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';

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

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

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

Twenty пытается сопоставлять столбцы на основе:

* Названий заголовков столбцов (точные или похожие совпадения)
* Определения типа данных (даты, числа, адреса электронной почты)
* Распространённых шаблонов полей

<Note>**Небольшой совет:** Экспортируйте несколько строк из объекта, который вы хотите импортировать. Экспортированный файл будет содержать точные названия столбцов, которые ожидает Twenty, поэтому автоматическое сопоставление при импорте пройдёт без лишних действий.</Note>

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

Для каждого столбца вы можете:

* **Сопоставить с полем**: выберите соответствующее поле Twenty из выпадающего списка
* **Не сопоставлять**: полностью пропустить столбец (данные не будут импортированы)

<Note>**Поля должны существовать до импорта.** Импорт создаёт записи, а не поля. Создайте настраиваемые поля в разделе **Настройки → Модель данных** перед импортом.</Note>

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

Все типы полей, доступные в Модели данных, поддерживаются для импорта.

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

<img src="/images/user-guide/fields/all-field-types.png" style={{width:'100%'}} />

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

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

### Поля адреса

Адрес — это вложенное поле с несколькими столбцами. Некоторые можно оставить пустыми.

* **Адрес / Адрес 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 для создаваемых записей
* **Обновить существующие записи**: сопоставьте с существующими записями, чтобы обновить их вместо создания дубликатов. В этом случае рекомендуется не сопоставлять другие уникальные поля: сопоставление только одного уникального поля обеспечивает более беспроблемный импорт.

<Note>Если вы указываете `id`, он должен быть в формате UUID (например, `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>

### Поля 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.

<Note>Новые варианты списка не будут созданы автоматически при импорте. Добавьте их в **Настройки → Модель данных** перед импортом.</Note>

<Warning>
**Импорт перезаписывает, а не добавляет.**

Если у записи уже выбраны `VALUE2` и `VALUE3`, а вы импортируете `["VALUE1"]`, после импорта у записи останется только `VALUE1`. Предыдущие выбранные значения заменяются, а не объединяются.
</Warning>

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

* Только числа
* Десятичные дроби — через точку: `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.
<Note>Новые варианты списка не будут созданы автоматически при импорте. Добавьте их в **Настройки → Модель данных** перед импортом.</Note>

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

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

## Поиск имен API

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

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

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

<VimeoEmbed videoId="1144910809" title="Видеодемонстрация" />