github-actions[bot]
e7fe435f60
Created by Github action Co-authored-by: github-actions <github-actions@twenty.com>
210 lines
6.4 KiB
Plaintext
210 lines
6.4 KiB
Plaintext
---
|
||
title: 导出您的数据
|
||
description: 从 Twenty 导出数据的完整分步指南。
|
||
---
|
||
|
||
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
||
|
||
## 概览
|
||
|
||
将您的工作区数据导出为 CSV，用于备份、报表或迁移。
|
||
|
||
**使用场景：**
|
||
|
||
* **定期备份** — 保留您的数据副本
|
||
* **外部报表** — 在 Excel、Google 表格或 BI 工具中分析数据
|
||
* **迁移** — 将数据迁移到其他系统
|
||
* **批量更新** — 通过导出、编辑并重新导入来更新记录
|
||
|
||
## 您需要了解的内容
|
||
|
||
### 导出限制
|
||
|
||
* **每次导出最多 20,000 条记录**
|
||
* 仅导出**可见列**
|
||
* 仅导出**筛选后的记录**（基于您当前视图）
|
||
|
||
<Note>对于更大的导出（20,000+ 条记录），请使用筛选器分批导出，或使用 [API](/l/zh/developers/extend/api)。</Note>
|
||
|
||
### 权限
|
||
|
||
导出数据需要拥有 **"Export CSV"** 权限。 如果您没有此选项，请联系您的工作区管理员。
|
||
|
||
## 步骤 1：导航到对象
|
||
|
||
前往您要导出的对象：
|
||
|
||
* **People** — 用于联系人
|
||
* **Companies** — 用于组织
|
||
* **Opportunities** — 用于商机
|
||
* **自定义对象** — 您创建的任意对象
|
||
|
||
## 步骤 2：配置您的视图
|
||
|
||
\*\*重要：\*\*导出仅包含您当前视图中可见的内容。
|
||
|
||
### 添加/移除列
|
||
|
||
1. 单击 **Options → Fields**（或单击列末尾的 **+**）
|
||
2. 勾选您要导出的字段
|
||
3. 取消勾选不需要的字段
|
||
|
||
### 筛选记录（可选）
|
||
|
||
如果您只需要数据的一个子集：
|
||
|
||
1. 单击 **Filter**
|
||
2. 添加筛选条件（例如："Created date > January 1, 2024"）
|
||
3. 仅会导出匹配的记录
|
||
|
||
### 排序记录（可选）
|
||
|
||
1. 单击列标题进行排序
|
||
2. 导出将遵循您的排序顺序
|
||
|
||
<Note>**创建专用的导出视图。** 保存一个专为导出配置的视图，这样每次就无需重新配置。</Note>
|
||
|
||
## 步骤 3：导出数据
|
||
|
||
1. 单击表格右上角的 **⋮** 图标
|
||
2. 选择 **Export view**
|
||
3. 选择 CSV 文件的保存位置
|
||
4. 等待下载完成
|
||
|
||
## 导出内容
|
||
|
||
| 包含 | 不包含 |
|
||
| ------------ | -------- |
|
||
| 所有可见列 | 隐藏列 |
|
||
| 与当前筛选条件匹配的记录 | 被过滤掉的记录 |
|
||
| 自定义字段值 | 不在视图中的字段 |
|
||
| 记录 ID | 文件附件 |
|
||
| 关系 ID | 图片 |
|
||
|
||
### 关系字段
|
||
|
||
关系 ID 仅在关系的\*\*“多”端\*\*导出：
|
||
|
||
* **People 导出** 包含一个 `companyId` 列（People → Company 关系）
|
||
* **Companies 导出** 不包含 `peopleIds`（Companies 是“一”端）
|
||
|
||
这意味着您可以使用 People 的导出来重新导入并保持与 Company 的链接，但您需要在导入 Companies 之后再次导入 People 以重新创建这些关系。
|
||
|
||
## 针对特定目的的导出
|
||
|
||
### 用于备份
|
||
|
||
1. 创建一个显示**所有字段**的视图
|
||
2. 移除所有筛选器以包含所有记录
|
||
3. 分别导出每种对象类型
|
||
4. 将导出文件存储在安全位置
|
||
5. 设置重复提醒（每周/每月）
|
||
|
||
### 用于外部报表
|
||
|
||
1. 只包含您进行分析所需的字段
|
||
2. 应用筛选器以聚焦相关数据
|
||
3. 考虑按您将要分析的字段进行排序
|
||
|
||
### 用于批量更新
|
||
|
||
1. 导出您要更新的记录
|
||
2. 包含唯一标识符（`email`、`domain` 或 `id`）
|
||
3. 编辑导出的文件
|
||
4. 重新导入以更新记录
|
||
参见：[如何更新现有记录](/l/zh/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. 在电子表格中合并文件
|
||
|
||
**用于分批的示例筛选器：**
|
||
|
||
* 按日期范围（1 月、2 月、3 月……）
|
||
* 按所有者（团队成员 A、团队成员 B……）
|
||
* 按状态（活跃、非活跃……）
|
||
|
||
### 选项 2：使用 API
|
||
|
||
API 没有记录数量限制：
|
||
|
||
1. 在 **Settings → Developers** 中获取您的 API 密钥
|
||
2. 使用 GraphQL API 查询记录
|
||
3. 在您的应用程序中处理结果
|
||
|
||
参见：[API 文档](/l/zh/developers/extend/api)
|
||
|
||
## 技巧与最佳实践
|
||
|
||
### 创建导出视图
|
||
|
||
保存专为导出配置的视图：
|
||
|
||
1. 配置列和筛选器
|
||
2. 单击 **View options** → **Save as new view**
|
||
3. 将其命名为 "Export - [Purpose]"
|
||
|
||
### 保护您的导出文件安全
|
||
|
||
导出的文件可能包含敏感数据：
|
||
|
||
* 存放在安全位置
|
||
* 不再需要时删除旧的导出文件
|
||
* 共享导出文件时请谨慎
|
||
|
||
### 导出前检查
|
||
|
||
<Check>显示了正确的列</Check>
|
||
<Check>筛选器设置正确（或为完整导出已移除）</Check>
|
||
<Check>您具有导出权限</Check>
|
||
|
||
## 常见问题
|
||
|
||
<AccordionGroup>
|
||
<Accordion title="为什么我的导出缺少某些列？">
|
||
仅导出可见列。 在导出之前通过 **Options → Fields** 添加所需的列。
|
||
</Accordion>
|
||
|
||
<Accordion title="为什么我的导出没有包含所有记录？">
|
||
检查您的筛选器。 导出仅包含与您当前视图筛选条件匹配的记录。 移除筛选器以导出所有记录。
|
||
</Accordion>
|
||
|
||
<Accordion title="我可以导出超过 20,000 条记录吗？">
|
||
单次导出不可以。 使用筛选器分批导出，或使用 API 处理更大的数据集。
|
||
</Accordion>
|
||
|
||
<Accordion title="导出文件是什么格式？">
|
||
CSV（逗号分隔值）。 可在 Excel、Google 表格或任何电子表格应用中打开。
|
||
</Accordion>
|
||
|
||
<Accordion title="是否包含关系 ID？">
|
||
包含，但仅限于关系的“多”端。 例如，People 的导出包含 `companyId`，但 Companies 的导出不包含人员 ID。
|
||
</Accordion>
|
||
|
||
<Accordion title="我可以自动化导出吗？">
|
||
无法直接通过 UI 实现。 使用 API 构建自动化的导出工作流。
|
||
</Accordion>
|
||
</AccordionGroup>
|
||
|
||
## 下一步
|
||
|
||
* [如何更新现有记录](/l/zh/user-guide/data-migration/how-tos/update-existing-records-via-import) — 编辑并重新导入您的导出文件
|
||
* [如何通过 API 导入数据](/l/zh/user-guide/data-migration/how-tos/import-data-via-api) — 适用于大型数据集
|
||
* [API 文档](/l/zh/developers/extend/api) — 构建自定义导出工作流
|