应用迁移

1. 导出元素

1. 进入源应用，切换至“设置 → 元素管理”，勾选需要迁移的文件夹和元素，单击“导出”。菜单、UX 及其引用的业务元素也应纳入检查范围。

2. 在“选择导出元素”中核对关联资源，避免遗漏必要依赖。

3. 设置“数据导出方式”和“权限导出方式”。需要迁移业务数据或保留授权时，选择包含对应内容。

4. 确认导出，完成后前往下载中心下载导出包。

元素导出包中的业务数据范围取决于对应组件的导出能力，不替代 DeepModel 对象及数据迁移，也不代表包含全部流程历史实例。

2. 导出 DeepModel 对象与数据

1. 进入源应用的 DeepModel 控制台，确认需要迁移的对象结构、配置及数据范围。

2. 全库迁移用于整体迁移应用的 DeepModel 对象结构、配置及数据，通常迁入空白应用，适用于测试环境迁移至正式环境、复用已有应用等场景。进入“全局配置 → 迁移管理”，单击“全库导出”下载迁移文件。

3. 若仅迁移部分对象，按 DeepModel 迁移中的方式批量导出对象结构和数据，并记录需在目标应用手动维护的配置。

导入前应确认目标应用的 DeepModel 是否为空；若已有对象或数据，应先核对导入的影响范围。如需清空，请向产品研发团队提交工单，并提前备份需要保留的数据。

3. 导入元素

1. 进入目标应用，切换至“设置 → 元素管理”，选择存放目录，单击“导入”，上传源应用导出的 ZIP 文件。

2. 选择需要导入的内容，检查同名元素的比较结果，按需选择替换或跳过。替换前应确认目标已有内容是否需要保留。

3. 设置是否导入业务数据，以及权限处理方式“覆盖”“增量”或“忽略”，具体含义参见元素管理与权限。导出时未包含的数据或权限，不能通过导入选项补回。

4. 确认导入，完成后检查元素及关联配置。

进入“配置管理 → 目标空间 → 作业管理”，查看对应导入作业的执行结果和日志。存在失败项时，先根据日志补齐依赖或修正配置，再处理失败内容，不应仅凭元素已出现在列表中判断全部导入成功。

4. 导入 DeepModel 对象与数据

1. 进入目标应用的 DeepModel 控制台，确认当前空间和应用正确。

2. 进入“全局配置 → 迁移管理”，上传源应用导出的迁移文件，核对导入范围后执行“全库导入”。仅迁移部分对象时，参见 DeepModel 迁移。

3. 导入完成后，检查对象结构、配置及数据是否完整，并核对对象链接和资源引用，必要时调整为目标空间或目标应用中的对应资源。

导入失败时，可在“迁移管理”中查看对应迁移日志，根据失败原因处理后重试。

5. 发布工作流和数据流

发布前先核对目标环境中的数据源、用户或用户组、通知模板、外部接口及定时触发配置，避免误向正式用户发送通知或操作源环境数据。

工作流：

1. 打开目标工作流，检查导入后的节点配置及引用资源，修复校验错误。

2. 工作流需逐个发布。确认各工作流需要运行的主版本内容后，分别执行发布，并检查是否存在启用版本。

工作流的版本规则参见流程发布与流程管理。

数据流：

1. 进入目标应用的数据流监控页面，在“数据流管理”中定位本次迁移的元素。

2. 核对本次迁移的数据流及其设计内容，选择需要发布的数据流执行“批量发布”。

批量发布会将选定数据流的主版本发布为正式版本。操作说明参见数据流监控。

组件不可用

导入元素失败，“作业管理”的日志明细显示：

元素名称[xxx]元素类型[xxx]路径[xxx]导入失败：通用异常:组件不可用

进入“配置管理 → 目标空间 → 组件管理”，注册对应组件后重新导入。

导入工作流元素失败

导入工作流元素失败，“作业管理”的日志明细显示：

元素名称[xxx]元素类型[WKFL]路径[xxx]导入失败：调用[deepflow-server3-0]元素导入业务数据接口异常：42=工作流组件的数据源部署在DeepModel数据库，请先到DeepModel控制台中进行数据库初始化并重新注册工作流组件

按以下顺序处理后重新导入：

1. 进入“配置管理 → 目标空间 → 组件管理”，注册 DeepModel 组件。

2. 进入 DeepModel 控制台，完成数据库初始化。

3. 返回“组件管理”，重新注册工作流组件。

导入工作流对象组失败

在 DeepModel 控制台中导入或手动新建工作流对象组失败，日志中出现以下错误；导入失败时，可在“迁移管理”中查看日志明细：

创建工作流视图失败，原因：StatementCallback; bad SQL grammar [create or replace view deepflow."comment" as select hi_comment.id_ as comment_id, hi_comment.time_ as created_time, ...

工作流对象组要求工作流的数据源部署在 DeepModel 中。确认 DeepModel 已完成数据库初始化后，进入“配置管理 → 目标空间 → 组件管理”，重新注册工作流组件，再重试导入或新建工作流对象组。

用户或用户组不存在

打开权限方案、菜单或流程配置时，提示用户或用户组不存在。

在“配置管理 → 目标空间 → 空间成员”中补齐所引用的用户和用户组。按 ID 引用时，需要与源配置中的用户 ID、用户组 ID 对应；仅创建同名对象不能修复引用。若目标对象的 ID 已不同，应重新选择授权或指派对象，并检查相关数据链接。导入方式参见成员与用户组。

消息模板不存在

打开工作流或数据流时，提示消息模板不存在。

进入“配置管理 → 目标空间 → 消息管理 → 模板管理”，按源配置补齐模板，并核对编码、类型和参数；返回工作流或数据流检查模板引用，必要时重新选择并保存。配置方式参见空间级配置。

unknown component

打开 UX 时，提示 Error: [importComponent] unknown component {...}。

若报错涉及自定义控件，进入“配置管理 → 目标空间 → NPM 管理”，上传并启用源空间对应的 NPM 包，核对包名和版本后重新打开 UX。使用方式参见UX 自定义控件。

SystemUser 缺少 order 属性

部分存量环境中，打开 UX 或 DeepModel 的 SystemUser 数据管理时，可能提示 object type 'spacexxx:SystemUser' has no link or property 'order'。

进入 DeepModel 控制台的地图模式，对 SystemUser 执行“更新结构”。更新成功后，若 UX 仍提示该字段不存在，先刷新相关领域模型的列表（如有），再刷新 UX 中相关数据源的结构并保存。不要为消除报错自行添加同名字段。

维度同步 DeepModel 数据异常

迁移后，维度同步 DeepModel 数据时，不同 UI 版本可能出现以下报错：

先确认目标应用中的对应对象已完成迁移，再在维度的数据同步配置中重新选择目标同步对象并保存，然后重试同步。