
导入方法
Twenty 支持两种主要的数据导入方法:| 方法 | 最佳适用 | 数量上限 |
|---|---|---|
| CSV 导入 | 标准迁移,定期更新 | 每个文件 10,000 条记录 |
| API 导入 | 大规模迁移,自动化 | 无限制 |
对于非常大的数据集(数十万条记录),请使用 API。 我们的实施合作伙伴如有需要,可帮助运行这些脚本。
CSV 导入基础知识
您可以使用 CSV、XLSX 或 XLS 文件导入任何对象的数据。 每个文件应仅包含一种对象类型(例如,仅包含“人员”记录)。字段必须在导入前已存在。 上传 CSV 会创建记录,但不会创建字段。 如果您需要自定义字段,请先在设置 → 数据模型中创建它们。
步骤
- 导航到您要导入数据的对象
- 点击右上角的 ⋮ 图标(命令菜单),然后点击 导入记录
- 下载模板文件以确保您的数据符合预期格式
- 上传已按格式整理的 CSV 文件
- 将您的列映射到 Twenty 字段
- 检查错误(以黄色高亮),并在 UI 中直接编辑进行修复
- 确认导入
导入对象之间的关系
您可以使用 CSV 导入功能来导入对象之间的关系。 您需要使用此对象中的唯一字段来引用相关对象:id;对于人员和工作区成员,使用 email;对于公司,使用 domain;对于其他对象,则使用数据模型中设置为唯一的任何字段。
已删除的记录也计入唯一性。 软删除的记录(在“命令菜单 → 查看已删除记录”下可见)会包含在唯一性检查中。 如果您导入的记录与某个已删除记录具有相同的唯一值,该已删除记录将被还原。
导出数据
导出您的工作区数据,用于备份、报告或迁移。步骤
- 导航到您要导出的对象
- 在视图中配置所需的列
- 点击 ⋮ → 导出视图
- 保存该 CSV 文件
仅导出可见列。 CSV 文件只包含当前视图中显示的列。 导出前添加或隐藏列以控制包含的数据。
导出限制:每次导出最多 20,000 条记录。
权限
数据导入和导出需要特定权限:- 导入:需要“导入 CSV”权限
- 导出:需要“导出 CSV”权限