Félix Malfait
5d438bb70c
## Summary - **New Getting Started section** with quickstart guide and restructured navigation - **Halftone-style illustrations** for User Guide and Developer introduction cards using a Canvas 2D filter script - **Removed hero images** (`image:` frontmatter + `<Frame><img>` blocks) from all user-guide article pages - **Cleaned up translations** (13 languages): removed hero images and updated introduction cards to use halftone style - **Cleaned up twenty-ui pages**: removed outdated hero images from component docs - **Deleted orphaned images**: `table.png`, `kanban.png` - **Developer page**: fixed duplicate icon, switched to 3-column layout ## Test plan - [ ] Verify docs site builds without errors - [ ] Check User Guide introduction page renders halftone card images in both light and dark mode - [ ] Check Developer introduction page renders 3-column layout with distinct icons - [ ] Confirm article pages no longer show hero images at the top - [ ] Spot-check a few translated pages to ensure hero images are removed 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> Co-authored-by: github-actions <github-actions@twenty.com>
85 lines
3.7 KiB
Plaintext
85 lines
3.7 KiB
Plaintext
---
|
|
title: 数据迁移
|
|
description: 通过 CSV 文件或 API 导入和导出您的 CRM 数据。
|
|
---
|
|
|
|
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
|
|
|
|
|
## 导入方法
|
|
|
|
Twenty 支持两种主要的数据导入方法：
|
|
|
|
| 方法 | 最佳适用 | 数量上限 |
|
|
| ---------- | --------- | --------------- |
|
|
| **CSV 导入** | 标准迁移，定期更新 | 每个文件 10,000 条记录 |
|
|
| **API 导入** | 大规模迁移，自动化 | 无限制 |
|
|
|
|
<Note>对于非常大的数据集（数十万条记录），请使用 API。 我们的[实施合作伙伴](/l/zh/user-guide/getting-started/capabilities/implementation-services)如有需要，可帮助运行这些脚本。</Note>
|
|
|
|
## CSV 导入基础知识
|
|
|
|
您可以使用 CSV、XLSX 或 XLS 文件导入任何对象的数据。 每个文件应**仅包含一种对象类型**（例如，仅包含“人员”记录）。
|
|
|
|
<Note>**字段必须在导入前已存在。** 上传 CSV 会创建记录，但不会创建字段。 如果您需要自定义字段，请先在**设置 → 数据模型**中创建它们。</Note>
|
|
|
|
### 步骤
|
|
|
|
1. 导航到您要导入数据的对象
|
|
2. 点击右上角的 **⋮** 图标（命令菜单），然后点击 **导入记录**
|
|
3. 下载模板文件以确保您的数据符合预期格式
|
|
4. 上传已按格式整理的 CSV 文件
|
|
5. 将您的列映射到 Twenty 字段
|
|
6. 检查错误（以黄色高亮），并在 UI 中直接编辑进行修复
|
|
7. 确认导入
|
|
|
|
### 导入对象之间的关系
|
|
|
|
您可以使用 CSV 导入功能来导入对象之间的关系。 您需要使用此对象中的唯一字段来引用相关对象：`id`；对于人员和工作区成员，使用 `email`；对于公司，使用 `domain`；对于其他对象，则使用数据模型中设置为唯一的任何字段。
|
|
|
|
<Note>**已删除的记录也计入唯一性。** 软删除的记录（在“命令菜单 → 查看已删除记录”下可见）会包含在唯一性检查中。 如果您导入的记录与某个已删除记录具有相同的唯一值，该已删除记录将被还原。</Note>
|
|
|
|
<Warning>
|
|
**导入顺序很重要！**
|
|
|
|
在导入相关对象时，请按以下顺序上传文件：
|
|
1. 首先导入**公司**（关系中的“一”端）
|
|
2. 其次导入**人员**（通过 companyId 关联到公司）
|
|
3. 第三导入**商机**（关联到公司/人员）
|
|
4. 最后导入有关系的**自定义对象**
|
|
|
|
为什么？ 在一对多关系中，“一”端必须先存在，才能被引用。 例如，在导入带有该公司 ID 的人员之前，必须先存在该公司的记录。
|
|
</Warning>
|
|
|
|
有关操作的分步指南，请参阅[这篇文章](/l/zh/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)。
|
|
|
|
## 导出数据
|
|
|
|
导出您的工作区数据，用于备份、报告或迁移。
|
|
|
|
### 步骤
|
|
|
|
1. 导航到您要导出的对象
|
|
2. 在视图中配置所需的列
|
|
3. 点击 **⋮** → **导出视图**
|
|
4. 保存该 CSV 文件
|
|
|
|
<Note>**仅导出可见列。** CSV 文件只包含当前视图中显示的列。 导出前添加或隐藏列以控制包含的数据。</Note>
|
|
|
|
<Note>**导出限制**：每次导出最多 20,000 条记录。</Note>
|
|
|
|
## 权限
|
|
|
|
数据导入和导出需要特定权限：
|
|
|
|
* **导入**：需要“导入 CSV”权限
|
|
* **导出**：需要“导出 CSV”权限
|
|
|
|
如果您没有这些权限，请联系您的工作区管理员。
|
|
|
|
## 下一步
|
|
|
|
* [准备您的 CSV 文件](/l/zh/user-guide/data-migration/how-tos/prepare-your-csv-files)
|
|
* [通过 CSV 导入对象之间的关系](/l/zh/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
|
|
* [通过 API 导入大型数据集](/l/zh/user-guide/data-migration/how-tos/import-data-via-api)
|