概览
本指南将引导您把数据从 Twenty 自托管实例迁移到 Twenty Cloud。 该过程包括设置您的云端工作区、导出数据并重新导入。视图、工作流和角色必须在迁移后手动重新创建。 为这些配置工作预留时间。
步骤 1：创建您的云端工作区
- 访问 app.twenty.com 并创建一个新的工作区
- 完成初始设置向导
- 记录您的新工作区 URL
步骤 2：重新创建您的数据模型
在导入数据之前，重新创建您的自定义对象和字段：- 在您的云端实例中进入 设置 → 数据模型
- 创建与自托管设置相匹配的自定义对象
- 向标准对象和自定义对象添加自定义字段
- 配置字段设置（唯一、必填等）
为便于参考，请截取自托管数据模型的屏幕截图，或并排打开两个实例。
步骤 3：邀请所有用户
- 在您的云端实例中进入 设置 → 成员
- 邀请所有在自托管环境中拥有账户的团队成员
- 等待所有人接受 邀请
- 核实所有用户都出现在您的“成员”列表中
步骤 4：从自托管导出数据
从您的自托管实例中导出每个对象：- 导航到每个对象（公司、人员、商机等）
- 将视图配置为显示您希望迁移的所有列
- 点击 ⋮ → 导出视图
- 将每个 CSV 文件保存为清晰的名称（例如，
companies-export.csv）
- 公司
- 人员
- 机会
- 自定义对象（按其依赖关系顺序）
- 任务、笔记
步骤 5：更新工作区成员引用
导出的 CSV 包含来自您自托管实例的用户 ID。 这些 ID 与您的云端实例不匹配，因此需要将其替换为邮箱地址。 对于每个包含用户引用（所有者、被指派人等）的 CSV 文件：- 在电子表格应用中打开该 CSV
- 在每个用户 ID 列旁边添加一个新列（例如，在
accountOwnerId旁添加accountOwnerEmail） - 填写每位用户的邮箱地址
- 您可以删除旧的 ID 列或保留它（导入时会被跳过）
请使用用户接受云端工作区邀请时所使用的相同邮箱地址。
步骤 6：规划您的导入顺序
按正确顺序导入文件以保持关系：- 公司 优先（无依赖关系）
- 人员 其次（关联到公司）
- 商机 第三（关联到公司和人员）
- 自定义对象（按其依赖关系）
- 任务和笔记 最后（关联到其他记录）
步骤 7：导入到云端
针对每个 CSV 文件，按顺序进行：- 在云端实例中导航到该对象
- 点击 ⋮ → 导入记录
- 上传 CSV 文件
- 将列映射到字段：
- 将用户邮箱列映射到相应的关系字段
- 按常规方式映射其他列
- 检查并修复任何错误
- 确认导入
- 在继续下一个文件之前，先核对几条记录
步骤 8：重新创建配置
导入数据后，请手动重新创建：视图
- 根据筛选、排序和列配置重新创建已保存的视图
- 设置任何看板或日历视图
工作流
- 在 设置 → 工作流 中重新创建自动化
- 在依赖之前先测试每个工作流
角色和权限
- 在 设置 → 角色 中配置角色
- 将用户分配到合适的角色
集成
- 为每位用户重新连接邮件和日历同步
- 使用新的 API 密钥重新配置任何 API 集成
迁移后检查表
所有数据均已成功导入
对象之间的关系运行正常
用户分配（所有者、被指派人）映射正确
视图已重新创建
工作流已重新创建并通过测试
角色和权限已配置
邮件/日历同步已重新连接
API 集成已使用新密钥更新
常见问题
我可以自动迁移工作流吗？
我可以自动迁移工作流吗？
目前不可以。 必须在您的云端实例中手动重新创建工作流。
文件附件和图片怎么办？
文件附件和图片怎么办？
CSV 导出不包含文件附件。 您需要手动重新上传任何附件、通过 API 迁移它们，或联系我方团队获取大规模迁移的协助。
迁移期间我可以同时运行两个实例吗？
迁移期间我可以同时运行两个实例吗？
可以。我们建议在您确认云端迁移完成之前，保持自托管实例运行。 只要注意不要在两个环境中同时创建新数据即可。
如果某个用户尚未接受邀请怎么办？
如果某个用户尚未接受邀请怎么办？
引用该用户的记录将导入失败，或其关系字段为空。 在导入数据之前，确保所有用户都已接受邀请。