84 lines
6.9 KiB
Plaintext
84 lines
6.9 KiB
Plaintext
---
|
|
title: Data Migration
|
|
description: Импортируйте и экспортируйте данные вашей CRM через файлы CSV или API.
|
|
---
|
|
|
|
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
|
|
|
## Способы импорта
|
|
|
|
Twenty поддерживает два основных способа импорта данных:
|
|
|
|
| Метод | Лучше всего подходит | Ограничение объема |
|
|
| -------------- | ------------------------------------------- | ---------------------- |
|
|
| **Импорт CSV** | Стандартные миграции, регулярные обновления | 10 000 записей на файл |
|
|
| **Импорт API** | Крупномасштабные миграции, автоматизация | Без ограничений |
|
|
|
|
<Note>Для очень больших наборов данных (сотни тысяч записей) используйте API. Наши [партнеры по внедрению](/l/ru/user-guide/getting-started/capabilities/implementation-services) при необходимости помогут запустить эти скрипты.</Note>
|
|
|
|
## Основы импорта CSV
|
|
|
|
Вы можете импортировать данные для любого объекта, используя файлы CSV, XLSX или XLS. Каждый файл должен содержать **только один тип объекта** (например, только записи «Люди»).
|
|
|
|
<Note>**Поля должны существовать до импорта.** Загрузка CSV создает записи, но не создает поля. Если вам нужны настраиваемые поля, сначала создайте их в разделе **Settings → Data Model**.</Note>
|
|
|
|
### Шаги
|
|
|
|
1. Перейдите к объекту, в который вы хотите импортировать данные
|
|
2. Нажмите значок **⋮** в правом верхнем углу (это Командное меню) и выберите **Импорт записей**
|
|
3. Скачайте шаблон файла, чтобы убедиться, что ваши данные в ожидаемом формате
|
|
4. Загрузите подготовленный файл CSV
|
|
5. Сопоставьте ваши столбцы с полями Twenty
|
|
6. Просмотрите ошибки (выделены желтым) и исправьте их, редактируя прямо в интерфейсе
|
|
7. Подтвердите импорт
|
|
|
|
### Импорт связей между объектами
|
|
|
|
Вы можете импортировать связи между объектами с помощью функции импорта CSV. Вам нужно ссылаться на связанный объект, используя уникальное поле этого объекта: `id`, `email` для «Люди» и участников рабочего пространства, `domain` для компаний, либо любое другое поле, помеченное как уникальное в модели данных для любого другого объекта.
|
|
|
|
<Note>**Удаленные записи учитываются при проверке уникальности.** Мягко удаленные записи (видны в Командном меню → See deleted records) включаются в проверки уникальности. Если вы импортируете запись с тем же уникальным значением, что и у удаленной записи, удаленная запись будет восстановлена.</Note>
|
|
|
|
<Warning>
|
|
**Порядок импорта имеет значение!**
|
|
|
|
При импорте связанных объектов загружайте файлы в следующем порядке:
|
|
1. Сначала **Компании** (сторона «один» в отношениях)
|
|
2. **Люди** во вторую очередь (связаны с компаниями через companyId)
|
|
3. **Возможности** в третью очередь (связаны с компаниями/людьми)
|
|
4. **Пользовательские объекты** со связями — в последнюю очередь
|
|
|
|
Почему? Сторона «один» в связи типа «один-ко-многим» должна существовать, прежде чем вы сможете на нее ссылаться. Например, запись компании должна существовать до импорта человека с идентификатором этой компании.
|
|
</Warning>
|
|
|
|
Обратитесь к [этой статье](/l/ru/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) за пошаговым руководством.
|
|
|
|
## Экспорт данных
|
|
|
|
Экспортируйте данные вашего рабочего пространства для резервного копирования, отчетности или миграции.
|
|
|
|
### Шаги
|
|
|
|
1. Перейдите к объекту, который вы хотите экспортировать
|
|
2. Настройте представление с нужными столбцами
|
|
3. Нажмите **⋮** → **Экспортировать представление**
|
|
4. Сохраните файл CSV
|
|
|
|
<Note>**Экспортируются только видимые столбцы.** Файл CSV будет содержать только столбцы, отображаемые в вашем текущем представлении. Добавьте или скройте столбцы перед экспортом, чтобы управлять тем, какие данные будут включены.</Note>
|
|
|
|
<Note>**Ограничения экспорта**: до 20 000 записей за один экспорт.</Note>
|
|
|
|
## Разрешения
|
|
|
|
Импорт и экспорт данных требуют определенных разрешений:
|
|
|
|
* **Импорт**: требуется разрешение "Import CSV"
|
|
* **Экспорт**: требуется разрешение "Export CSV"
|
|
|
|
Свяжитесь с администратором вашего рабочего пространства, если у вас нет этих разрешений.
|
|
|
|
## Следующие шаги
|
|
|
|
* [Подготовьте файлы CSV](/l/ru/user-guide/data-migration/how-tos/prepare-your-csv-files)
|
|
* [Импорт связей между объектами](/l/ru/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
|
|
* [Импорт через API для больших наборов данных](/l/ru/user-guide/data-migration/how-tos/import-data-via-api)
|