github-actions[bot]
58dd5d3561
Created by Github action Co-authored-by: github-actions <github-actions@twenty.com>
172 lines
5.7 KiB
Plaintext
172 lines
5.7 KiB
Plaintext
---
|
||
title: 从自托管迁移到云
|
||
description: 分步指南：将您的 Twenty 自托管实例迁移到 Twenty Cloud。
|
||
---
|
||
|
||
## 概览
|
||
|
||
本指南将引导您把数据从 Twenty 自托管实例迁移到 Twenty Cloud。 该过程包括设置您的云端工作区、导出数据并重新导入。
|
||
|
||
<Note>视图、工作流和角色必须在迁移后手动重新创建。 为这些配置工作预留时间。</Note>
|
||
|
||
## 步骤 1：创建您的云端工作区
|
||
|
||
1. 访问 [app.twenty.com](https://app.twenty.com) 并创建一个新的工作区
|
||
2. 完成初始设置向导
|
||
3. 记录您的新工作区 URL
|
||
|
||
## 步骤 2：重新创建您的数据模型
|
||
|
||
在导入数据之前，重新创建您的自定义对象和字段：
|
||
|
||
1. 在您的云端实例中进入 **设置 → 数据模型**
|
||
2. 创建与自托管设置相匹配的自定义对象
|
||
3. 向标准对象和自定义对象添加自定义字段
|
||
4. 配置字段设置（唯一、必填等）
|
||
|
||
<Note>为便于参考，请截取自托管数据模型的屏幕截图，或并排打开两个实例。</Note>
|
||
|
||
## 步骤 3：邀请所有用户
|
||
|
||
<Warning>
|
||
**至关重要：在导入数据之前邀请用户。**
|
||
|
||
在您导入任何引用到他们的记录（例如“账户所有者”字段）之前，用户必须先接受邀请。 如果用户尚不存在，则无法映射这些关系。
|
||
</Warning>
|
||
|
||
1. 在您的云端实例中进入 **设置 → 成员**
|
||
2. 邀请所有在自托管环境中拥有账户的团队成员
|
||
3. **等待所有人接受** 邀请
|
||
4. 核实所有用户都出现在您的“成员”列表中
|
||
|
||
## 步骤 4：从自托管导出数据
|
||
|
||
从您的自托管实例中导出每个对象：
|
||
|
||
1. 导航到每个对象（公司、人员、商机等）
|
||
2. 将视图配置为显示您希望迁移的**所有列**
|
||
3. 点击 **⋮** → **导出视图**
|
||
4. 将每个 CSV 文件保存为清晰的名称（例如，`companies-export.csv`）
|
||
|
||
**按以下顺序导出**（供导入时参考）：
|
||
|
||
1. 公司
|
||
2. 人员
|
||
3. 机会
|
||
4. 自定义对象（按其依赖关系顺序）
|
||
5. 任务、笔记
|
||
|
||
## 步骤 5：更新工作区成员引用
|
||
|
||
导出的 CSV 包含来自您自托管实例的用户 ID。 这些 ID 与您的云端实例不匹配，因此需要将其替换为邮箱地址。
|
||
|
||
**对于每个包含用户引用（所有者、被指派人等）的 CSV 文件：**
|
||
|
||
1. 在电子表格应用中打开该 CSV
|
||
2. 在每个用户 ID 列旁边添加一个新列（例如，在 `accountOwnerId` 旁添加 `accountOwnerEmail`）
|
||
3. 填写每位用户的邮箱地址
|
||
4. 您可以删除旧的 ID 列或保留它（导入时会被跳过）
|
||
|
||
**示例:**
|
||
|
||
之前:
|
||
|
||
```csv
|
||
name,domain,accountOwnerId
|
||
Acme Corp,https://acme.com,old-uuid-123
|
||
```
|
||
|
||
之后:
|
||
|
||
```csv
|
||
name,domain,accountOwnerEmail
|
||
Acme Corp,https://acme.com,john@yourcompany.com
|
||
```
|
||
|
||
<Note>请使用用户接受云端工作区邀请时所使用的相同邮箱地址。</Note>
|
||
|
||
## 步骤 6：规划您的导入顺序
|
||
|
||
按正确顺序导入文件以保持关系：
|
||
|
||
1. **公司** 优先（无依赖关系）
|
||
2. **人员** 其次（关联到公司）
|
||
3. **商机** 第三（关联到公司和人员）
|
||
4. **自定义对象**（按其依赖关系）
|
||
5. **任务和笔记** 最后（关联到其他记录）
|
||
|
||
有关维护关系的详细信息，请参见[如何导入关系](/l/zh/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)。
|
||
|
||
## 步骤 7：导入到云端
|
||
|
||
针对每个 CSV 文件，按顺序进行：
|
||
|
||
1. 在云端实例中导航到该对象
|
||
2. 点击 **⋮** → **导入记录**
|
||
3. 上传 CSV 文件
|
||
4. 将列映射到字段：
|
||
* 将用户邮箱列映射到相应的关系字段
|
||
* 按常规方式映射其他列
|
||
5. 检查并修复任何错误
|
||
6. 确认导入
|
||
7. 在继续下一个文件之前，先核对几条记录
|
||
|
||
## 步骤 8：重新创建配置
|
||
|
||
导入数据后，请手动重新创建：
|
||
|
||
### 视图
|
||
|
||
* 根据筛选、排序和列配置重新创建已保存的视图
|
||
* 设置任何看板或日历视图
|
||
|
||
### 工作流
|
||
|
||
* 在 **设置 → 工作流** 中重新创建自动化
|
||
* 在依赖之前先测试每个工作流
|
||
|
||
### 角色和权限
|
||
|
||
* 在 **设置 → 成员 → 角色** 中设置角色
|
||
* 将用户分配到合适的角色
|
||
|
||
### 集成
|
||
|
||
* 为每位用户重新连接邮件和日历同步
|
||
* 使用新的 API 密钥重新配置任何 API 集成
|
||
|
||
## 迁移后检查表
|
||
|
||
<Check>所有数据均已成功导入</Check>
|
||
<Check>对象之间的关系运行正常</Check>
|
||
<Check>用户分配（所有者、被指派人）映射正确</Check>
|
||
<Check>视图已重新创建</Check>
|
||
<Check>工作流已重新创建并通过测试</Check>
|
||
<Check>角色和权限已配置</Check>
|
||
<Check>邮件/日历同步已重新连接</Check>
|
||
<Check>API 集成已使用新密钥更新</Check>
|
||
|
||
## 常见问题
|
||
|
||
<AccordionGroup>
|
||
<Accordion title="我可以自动迁移工作流吗？">
|
||
目前不可以。 必须在您的云端实例中手动重新创建工作流。
|
||
</Accordion>
|
||
|
||
<Accordion title="文件附件和图片怎么办？">
|
||
CSV 导出不包含文件附件。 您需要手动重新上传任何附件、通过 API 迁移它们，或联系我方团队获取大规模迁移的协助。
|
||
</Accordion>
|
||
|
||
<Accordion title="迁移期间我可以同时运行两个实例吗？">
|
||
可以。我们建议在您确认云端迁移完成之前，保持自托管实例运行。 只要注意不要在两个环境中同时创建新数据即可。
|
||
</Accordion>
|
||
|
||
<Accordion title="如果某个用户尚未接受邀请怎么办？">
|
||
引用该用户的记录将导入失败，或其关系字段为空。 在导入数据之前，确保所有用户都已接受邀请。
|
||
</Accordion>
|
||
</AccordionGroup>
|
||
|
||
## 需要帮助？
|
||
|
||
对于复杂的迁移或大型数据集，请通过 [contact@twenty.com](mailto:contact@twenty.com) 与我们联系，或查看我们的[实施服务](/l/zh/user-guide/getting-started/capabilities/implementation-services)。
|