snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -0,0 +1,209 @@
---
title: Экспортируйте ваши данные
description: Полное пошаговое руководство по экспорту данных из Twenty.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Обзор
Экспортируйте данные своего рабочего пространства в CSV для резервного копирования, отчетности или миграции.
**Сценарии использования:**
* **Регулярные резервные копии** — храните копии ваших данных
* **Внешняя отчетность** — анализируйте данные в Excel, Google Sheets или инструментах BI
* **Миграция** — перенесите данные в другую систему
* **Массовые обновления** — экспортируйте, редактируйте и повторно импортируйте для обновления записей
## Что нужно знать
### Ограничения экспорта
* **Максимум 20 000 записей** на один экспорт
* Экспортируются только **видимые столбцы**
* Экспортируются только **отфильтрованные записи** (на основе вашего текущего представления)
<Note>Для больших объемов экспорта (20 000+ записей) используйте фильтры для пакетного экспорта или [API](/l/ru/developers/extend/api).</Note>
### Разрешения
Для экспорта данных вам требуется разрешение **"Export CSV"**. Свяжитесь с администратором рабочего пространства, если у вас нет этой опции.
## Шаг 1: Перейдите к объекту
Перейдите к объекту, который хотите экспортировать:
* **People** — для контактов
* **Companies** — для организаций
* **Opportunities** — для сделок
* **Пользовательские объекты** — любой объект, который вы создали
## Шаг 2: Настройте ваше представление
**Важно:** Экспорт включает только то, что видно в вашем текущем представлении.
### Добавление/удаление столбцов
1. Нажмите **Параметры → Поля** (или **+** в конце столбцов)
2. Отметьте поля, которые хотите экспортировать
3. Снимите отметку с полей, которые вам не нужны
### Фильтрация записей (необязательно)
Если вам нужен только поднабор данных:
1. Нажмите **Фильтр**
2. Добавьте условия фильтра (например, "Created date > January 1, 2024")
3. Будут экспортированы только соответствующие записи
### Сортировка записей (необязательно)
1. Нажмите заголовок столбца, чтобы отсортировать
2. Экспорт сохранит ваш порядок сортировки
<Note>**Создайте отдельное представление для экспорта.** Сохраните представление, специально настроенное для экспорта, чтобы вам не приходилось перенастраивать его каждый раз.</Note>
## Шаг 3: Экспорт данных
1. Нажмите значок **⋮** в правом верхнем углу таблицы
2. Выберите **Экспорт представления**
3. Выберите, куда сохранить файл CSV
4. Дождитесь завершения загрузки
## Что экспортируется
| Включено | Не включено |
| ---------------------------------------- | ----------------------------------- |
| Все видимые столбцы | Скрытые столбцы |
| Записи, соответствующие текущим фильтрам | Записи, исключенные фильтрами |
| Значения пользовательских полей | Поля, отсутствующие в представлении |
| ID записей | Файловые вложения |
| ID связей | Изображения |
### Поля связи
Идентификаторы связей экспортируются только на стороне **"many"** связи:
* **Экспорт People** включает столбец `companyId` (связь People → Company)
* **Экспорт Companies** НЕ включает `peopleIds` (Companies — это сторона "one")
Это означает, что вы можете использовать экспорт People для повторного импорта и сохранения связи с Company, но вам нужно будет повторно импортировать People после Companies, чтобы восстановить связи.
## Экспорт для конкретных целей
### Для резервного копирования
1. Создайте представление, в котором видны **все поля**
2. Удалите все фильтры, чтобы включить все записи
3. Экспортируйте каждый тип объекта отдельно
4. Храните экспортированные файлы в защищенном месте
5. Настройте регулярное напоминание (еженедельно/ежемесячно)
### Для внешней отчетности
1. Включайте только те поля, которые нужны для анализа
2. Примените фильтры, чтобы сосредоточиться на релевантных данных
3. Рассмотрите сортировку по полю, которое вы будете анализировать
### Для массовых обновлений
1. Экспортируйте записи, которые хотите обновить
2. Включайте уникальный идентификатор (`email`, `domain` или `id`)
3. Отредактируйте экспортированный файл
4. Импортируйте повторно, чтобы обновить записи
См.: [Как обновить существующие записи](/l/ru/user-guide/data-migration/how-tos/update-existing-records-via-import)
### Для миграции
Если вы экспортируете для миграции в другую систему:
1. **Экспортируйте каждый объект отдельно** — People, Companies, Opportunities и т. д.
2. **Включайте поля с ID** — они помогают сохранять связи
3. **Задокументируйте сопоставления полей** — отметьте, как поля Twenty соответствуют вашей целевой системе
## Обработка больших наборов данных (20 000+ записей)
Лимит экспорта — 20 000 записей. Для больших наборов данных:
### Вариант 1: Экспорт партиями
1. Добавьте фильтр (например, диапазоны "Created date")
2. Экспортируйте первую партию
3. Измените фильтр
4. Экспортируйте следующую партию
5. Объедините файлы в вашей таблице
**Примеры фильтров для разбиения на партии:**
* По диапазону дат (январь, февраль, март...)
* По владельцу (участник команды A, участник команды B...)
* По статусу (Активен, Неактивен...)
### Вариант 2: Используйте API
В API нет ограничения по числу записей:
1. Получите ключ API в **Настройки → Разработчики**
2. Используйте GraphQL API для выборки записей
3. Обрабатывайте результаты в вашем приложении
См.: [Документация по API](/l/ru/developers/extend/api)
## Советы и лучшие практики
### Создавайте представления для экспорта
Сохраняйте представления, специально настроенные для экспорта:
1. Настройте столбцы и фильтры
2. Нажмите **Параметры представления** → **Сохранить как новое представление**
3. Назовите его "Export - [Purpose]"
### Защитите экспортируемые данные
Экспортированные файлы могут содержать конфиденциальные данные:
* Храните в защищенных местах
* Удаляйте старые экспортированные файлы, когда они больше не нужны
* Будьте осторожны при обмене экспортированными файлами
### Проверьте перед экспортом
<Check>Отображаются нужные столбцы</Check>
<Check>Фильтры настроены корректно (или отключены для полного экспорта)</Check>
<Check>У вас есть разрешение на экспорт</Check>
## Часто задаваемые вопросы
<AccordionGroup>
<Accordion title="Почему в моем экспорте отсутствуют некоторые столбцы?">
Экспортируются только видимые столбцы. Перед экспортом добавьте нужные столбцы через **Параметры → Поля**.
</Accordion>
<Accordion title="Почему мой экспорт содержит не все записи?">
Проверьте ваши фильтры. Экспорт включает только записи, соответствующие фильтрам вашего текущего представления. Удалите фильтры, чтобы экспортировать все записи.
</Accordion>
<Accordion title="Могу ли я экспортировать более 20 000 записей?">
Не одним экспортом. Используйте фильтры для экспорта партиями или используйте API для больших наборов данных.
</Accordion>
<Accordion title="В каком формате файл экспорта?">
CSV (значения, разделенные запятыми). Открывается в Excel, Google Sheets или любом табличном приложении.
</Accordion>
<Accordion title="Включаются ли идентификаторы связей?">
Да, но только на стороне "many" в связях. Например, экспорт People включает `companyId`, а экспорт Companies не включает ID людей.
</Accordion>
<Accordion title="Могу ли я автоматизировать экспорт?">
Не напрямую через интерфейс. Используйте API, чтобы создать автоматизированные рабочие процессы экспорта.
</Accordion>
</AccordionGroup>
## Следующие шаги
* [Как обновить существующие записи](/l/ru/user-guide/data-migration/how-tos/update-existing-records-via-import) — отредактируйте и импортируйте ваш экспорт повторно
* [Как импортировать данные через API](/l/ru/user-guide/data-migration/how-tos/import-data-via-api) — для больших наборов данных
* [Документация по API](/l/ru/developers/extend/api) — создавайте собственные рабочие процессы экспорта