Перейти к основному содержанию
Миграция данных

Способы импорта

Twenty поддерживает два основных способа импорта данных:
МетодЛучше всего подходитОграничение объема
Импорт CSVСтандартные миграции, регулярные обновления10 000 записей на файл
Импорт APIКрупномасштабные миграции, автоматизацияБез ограничений
Для очень больших наборов данных (сотни тысяч записей) используйте API. Наши партнеры по внедрению при необходимости помогут запустить эти скрипты.

Основы импорта CSV

Вы можете импортировать данные для любого объекта, используя файлы CSV, XLSX или XLS. Каждый файл должен содержать только один тип объекта (например, только записи «Люди»).
Поля должны существовать до импорта. Загрузка CSV создает записи, но не создает поля. Если вам нужны настраиваемые поля, сначала создайте их в разделе Settings → Data Model.

Шаги

  1. Перейдите к объекту, в который вы хотите импортировать данные
  2. Нажмите значок в правом верхнем углу (это Командное меню) и выберите Импорт записей
  3. Скачайте шаблон файла, чтобы убедиться, что ваши данные в ожидаемом формате
  4. Загрузите подготовленный файл CSV
  5. Сопоставьте ваши столбцы с полями Twenty
  6. Просмотрите ошибки (выделены желтым) и исправьте их, редактируя прямо в интерфейсе
  7. Подтвердите импорт

Импорт связей между объектами

Вы можете импортировать связи между объектами с помощью функции импорта CSV. Вам нужно ссылаться на связанный объект, используя уникальное поле этого объекта: id, email для «Люди» и участников рабочего пространства, domain для компаний, либо любое другое поле, помеченное как уникальное в модели данных для любого другого объекта.
Удаленные записи учитываются при проверке уникальности. Мягко удаленные записи (видны в Командном меню → See deleted records) включаются в проверки уникальности. Если вы импортируете запись с тем же уникальным значением, что и у удаленной записи, удаленная запись будет восстановлена.
Порядок импорта имеет значение!При импорте связанных объектов загружайте файлы в следующем порядке:
  1. Сначала Компании (сторона «один» в отношениях)
  2. Люди во вторую очередь (связаны с компаниями через companyId)
  3. Возможности в третью очередь (связаны с компаниями/людьми)
  4. Пользовательские объекты со связями — в последнюю очередь
Почему? Сторона «один» в связи типа «один-ко-многим» должна существовать, прежде чем вы сможете на нее ссылаться. Например, запись компании должна существовать до импорта человека с идентификатором этой компании.
Обратитесь к этой статье за пошаговым руководством.

Экспорт данных

Экспортируйте данные вашего рабочего пространства для резервного копирования, отчетности или миграции.

Шаги

  1. Перейдите к объекту, который вы хотите экспортировать
  2. Настройте представление с нужными столбцами
  3. Нажмите Экспортировать представление
  4. Сохраните файл CSV
Экспортируются только видимые столбцы. Файл CSV будет содержать только столбцы, отображаемые в вашем текущем представлении. Добавьте или скройте столбцы перед экспортом, чтобы управлять тем, какие данные будут включены.
Ограничения экспорта: до 20 000 записей за один экспорт.

Разрешения

Импорт и экспорт данных требуют определенных разрешений:
  • Импорт: требуется разрешение “Import CSV”
  • Экспорт: требуется разрешение “Export CSV”
Свяжитесь с администратором вашего рабочего пространства, если у вас нет этих разрешений.

Следующие шаги