ToolJet 如何导出和导入应用(含内置数据库表结构)到其他工作区?
【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 🚀项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet
在 ToolJet 中,应用、数据源、用户和权限都按工作区(Workspace)隔离管理,应用不能从一个工作区直接复制、共享到另一个工作区。官方文档(Workspaces FAQ)明确给出的跨工作区迁移路径是:在源工作区把应用导出为 JSON 文件,再在目标工作区导入该 JSON。如果应用使用了 ToolJet Database(内置数据库),导出时勾选Export ToolJet table schema,相关表结构会随应用一起导出;导入时目标工作区会自动创建对应的 ToolJet Database 表。整个流程通过 Web 界面完成,无需命令行。
前提:同一 ToolJet 实例内至少存在两个工作区(源工作区和目标工作区),且你能以有权限的账号访问两者。
先了解工作区切换方式
导入前需要先切换到目标工作区。按 Workspaces 文档的Switching Workspaces一节:
- 在 dashboard(应用列表页)左下角打开 workspace 下拉菜单;
- 从列表中选择目标工作区,即刻切换。
切换后 dashboard 上展示的就是该工作区的应用列表,后续导入操作会作用于当前所在的工作区。
步骤一:在源工作区导出应用
按 Import and Export Applications 文档的Exporting Applications一节:
- 进入源工作区的 dashboard;
- 点击应用右上角的设置图标(settings icon);
- 点击Export app按钮。
接下来在导出选项面板中做两个决定:
- 版本范围:选择
Export All会把该应用的所有版本导出为 JSON 文件;选择Export selected version只导出选中的那一个版本,同样是 JSON 格式。跨工作区迁移通常选其一即可,不必全选。 - 是否附带表结构:勾选
Export ToolJet table schema复选框,应用关联的 ToolJet Database 表结构(table schema)会随应用一起导出。文档说明:这种情况下,把应用导入到某个工作区时,关联的 ToolJet Database 表也会被一并创建。如果你的应用没有使用内置数据库,不勾选即可。
确认后浏览器会下载 JSON 文件,妥善保存,下一步导入时要用到。
步骤二:在目标工作区导入应用
- 按上文方法通过 dashboard 左下角的 workspace 下拉菜单切换到目标工作区;
- 在 dashboard 上,点击Create new app按钮上的省略号(ellipses),在弹出的菜单中选择
Import; - 在文件选择框中,选择刚才在源工作区下载的 JSON 文件。
结果验证
导入完成后,按文档描述检查两处:
- 应用本体:目标工作区的 dashboard 上会出现导入的应用(导入的就是 JSON 中的应用版本);
- 内置数据库表:如果导出时勾选了
Export ToolJet table schema,目标工作区会同时创建应用关联的 ToolJet Database 表。可以在目标工作区的 ToolJet Database 中确认这些表是否存在。
限制与补充
- 表数据不在迁移范围内:Table Operations 文档的Export Schema一节说明,schema 导出下载的是表结构 JSON,不包含表数据(table data)和关系(relationships),只导出结构。也就是说导入后目标工作区得到的是按 schema 创建的表,原有行数据不会随应用迁移。
- workspace 设置同样不能共享:Workspaces FAQ 明确 applications 和 workspace settings 都不能在两个工作区之间直接共享,跨工作区迁移应用只有 export/import 这一条官方路径。
- 表级 schema 单独导出(可选分支):如果只想备份某一张表的结构而不导出整个应用,可以在 ToolJet Database 界面点击表名右侧的三个竖点图标,选择Export,单独下载该表的 schema JSON(同样不含数据与关系)。该路径与本文的应用级迁移相互独立,可按需使用。
迁移完成后,建议在目标工作区实际打开导入的应用,检查页面组件与数据源配置是否按预期工作;数据源本身属于工作区资源,若目标工作区缺少对应连接,需要另行配置。
【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 🚀项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考