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

Documentation Index

Fetch the complete documentation index at: https://docs.get-clara.tech/llms.txt

Use this file to discover all available pages before exploring further.

​
Обзор

Нужно обновить много записей сразу? Вместо того чтобы редактировать их по одной, используйте импорт CSV для массового обновления существующих записей. Сценарии использования:
  • Обновить должности для нескольких людей
  • Массово изменить информацию о компаниях
  • Добавить данные в новые настраиваемые поля
  • Исправить ошибки данных во множестве записей

​
Как это работает

Когда вы импортируете файл, содержащий уникальный идентификатор, который совпадает с существующей записью, Twenty обновляет эту запись вместо создания дубликата.
Если уникальный идентификатор…Twenty выполнит…
Совпадает с существующей записьюОбновит существующую запись
Не совпадает ни с одной записьюСоздаст новую запись
Отсутствует в вашем файлеСоздаст новую запись (с автоматически сгенерированным ID)
Поля с множественным выбором перезаписываются, а не объединяются.Если в записи выбраны Option A и Option B, и вы импортируете ["Option C"], после импорта в записи останется только Option C. Импорт заменяет все предыдущие выбранные значения — он не добавляет к ним новые.Чтобы сохранить существующие значения, включите их все в импорт: ["Option A","Option B","Option C"]

​
Шаг 1: Экспортируйте текущие данные

Сначала экспортируйте записи, которые хотите обновить:
  1. Перейдите к объекту (Люди, Компании и т. д.)
  2. Добавьте нужные столбцы — нажмите Options → Fields, чтобы отобразить поля, которые хотите обновить
  3. При необходимости примените фильтр — сузьте выборку до тех записей, которые хотите обновить
  4. Нажмите ⋮ → Экспорт представления
  5. Сохраните файл CSV
Зачем сначала экспорт? Экспортированный файл имеет корректный формат, включает уникальные идентификаторы и автоматически сопоставляется при импорте.

​
Что экспортируется

  • Все видимые столбцы в текущем представлении
  • Уникальные идентификаторы записи (id, email, domain)
  • Текущие значения полей, которые можно изменить

​
Шаг 2: Отредактируйте файл CSV

Откройте экспортированный файл в табличном редакторе (Excel, Google Sheets и т. д.):
  1. Сохраните столбец с уникальным идентификатором — не удаляйте id, email или domain
  2. Обновите значения в столбцах, которые хотите изменить
  3. Удалите столбцы, которые не нужно обновлять (необязательно, но так будет аккуратнее)
  4. Не изменяйте значения уникальных идентификаторов — иначе Twenty создаст новые записи

​
Пример: обновление должностей

Экспортированный файл: 
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
После ваших изменений: 
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
Не изменяйте значения уникальных идентификаторов.Если вы измените john@acme.com на john.smith@acme.com, Twenty создаст новую запись вместо обновления существующей.

​
Шаг 3: Импортируйте обновлённый файл

  1. Перейдите к объекту
  2. Нажмите ⋮ → Импорт записей
  3. Загрузите отредактированный файл CSV
  4. Убедитесь, что уникальный идентификатор сопоставлен — проверьте, что email, domain или id сопоставлены корректно
  5. Проверьте сопоставление полей
  6. Проверьте наличие ошибок
  7. Нажмите Подтвердить
Twenty сопоставляет записи по уникальному идентификатору и обновляет их новыми значениями.

​
Выбор подходящего уникального идентификатора

ОбъектРекомендуетсяАльтернативаЗаметки
Людиэлектронная почтаidEmail человекочитаем
КомпаниидоменidДомен человекочитаем
Пользовательские объектыЛюбое уникальное полеidИспользуйте своё пользовательское уникальное поле
Используйте только ОДИН уникальный идентификатор. Не сопоставляйте одновременно email И id. Это может привести к путанице и ошибкам.

​
Использование пользовательских уникальных полей

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

​
Шаг 4: Проверьте обновления

После импорта:
  1. Откройте несколько обновлённых записей
  2. Убедитесь, что изменения применены
  3. Проверьте, что не были созданы дубликаты записей

​
Что с полями, которых нет в вашем файле?

Поля, не включённые в файл импорта, остаются без изменений.
Ваш файл включает…Результат
email, jobTitleОбновляется только jobTitle; остальные поля остаются прежними
email, jobTitle, phoneОбновляются jobTitle и phone
Это означает, что нужно включать только те поля, которые вы хотите изменить (плюс уникальный идентификатор).

​
Совмещение обновлений и новых записей

Вы можете обновлять существующие записи И создавать новые в одном и том же импорте: 
email,firstName,lastName,jobTitle
john@acme.com,John,Smith,Senior Manager    ← Updates existing (email matches)
newperson@acme.com,New,Person,Analyst      ← Creates new (email doesn't match)

​
Распространённые ошибки, которых следует избегать

ОшибкаПроблемаРезультатРешение
Изменение уникального идентификатораЗаменили john@acme.com на john.smith@acme.comСоздаёт новую запись вместо обновленияНе изменяйте уникальные идентификаторы
Несколько уникальных полейСопоставлены одновременно email И idВозможные конфликты сопоставленияСопоставляйте только ОДИН уникальный идентификатор
Нет уникального идентификатораВ файле только firstName, lastName, jobTitleВсе строки создают новые записиВсегда включайте email, domain или id
Несовпадение регистраВ файле John@acme.com, а в Twenty — john@acme.comСоздаёт новую записьЭкспортируйте из Twenty, чтобы получить точные значения

​
Часто задаваемые вопросы

Записи с уникальными идентификаторами, которые не совпадают с существующими, будут созданы как новые. Это позволяет обновлять и создавать в одном импорте.
Да, оставьте ячейку пустой в вашем CSV. Импорт очистит значение этого поля в существующей записи.
Поля, отсутствующие в файле импорта, остаются без изменений в существующих записях. Обновляются только включённые вами поля.
Да! Включите уникальный идентификатор связи (например, companyDomain) и сопоставьте его с полем связи. Связь будет обновлена.
На этапе проверки импорта Twenty показывает, сколько записей будет обновлено и сколько создано, исходя из совпадений уникальных идентификаторов.
Автоматической отмены нет. Рекомендуем экспортировать ваши данные в качестве резервной копии перед массовыми обновлениями.

​
Лучшие практики

  1. Сначала экспорт — всегда начинайте с экспорта, чтобы обеспечить корректный формат
  2. Создайте резервную копию перед обновлением — экспортируйте данные перед массовыми изменениями
  3. Протестируйте на нескольких записях — сначала попробуйте обновить 5–10 записей, прежде чем делать большой пакет
  4. Используйте человекочитаемые идентификаторы — email и domain легче проверить, чем id
  5. Включайте только нужные столбцы — меньше столбцов означает меньший риск ошибок

​
Устранение неполадок

Возникли проблемы? Проверьте: