snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

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

@@ -0,0 +1,198 @@
+---
+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="Видеодемонстрация" />