模块指南稳定能力
模型设计（数据模型）完整指南
模型设计器在 X6 画布上维护业务对象、字段与关联关系，是表单、流程、规则的数据基础。 典型场景： 从应用到模型
模型设计器在 X6 画布上维护业务对象、字段与关联关系，是表单、流程、规则的数据基础。 典型场景： 从应用到模型 完成本页后，你应能够理解功能边界，并按步骤完成配置和验证。
开始前检查
- 已登录 DSP 平台并进入正确组织
- 已选择目标应用和当前开发版本
- 账号拥有当前功能的查看或编辑权限
概述
模型设计器在 X6 画布上维护业务对象、字段与关联关系，是表单、流程、规则的数据基础。
典型场景：
- 从应用到模型
入口与使用前准备
访问入口
| 入口 | 路径 |
|---|---|
| 模型列表 | /dsp/bizList |
| 设计器 | /dsp/biz/:appCode/:bizCode |
使用前准备
已创建应用；bizCode 常与 appCode 相同。
界面总览
| 区域 | 说明 |
|---|---|
| 画布 | 对象节点与连线 |
| 抽屉 | 字段属性编辑 |
| 工具栏 | 保存、布局、删除 |
| 说明 |
功能分节
模型列表 BizList
功能说明：按应用进入设计器。
操作步骤：
- /dsp/bizList
- 选择应用
画布与对象
功能说明：新建实体、编辑字段。
操作步骤：
- 新建对象
- 抽屉维护字段
- 保存
注意事项：错误：未关联画布对象。
关联关系
功能说明：连线表示主子/关联。
操作步骤：
- 拖拽连线
- 配置基数
端到端场景
场景 A：从应用到模型
应用详情→数据模型→保存→表单绑定
权限与可见性
设计权限按应用控制。
字段与控件说明
字段名称以当前页面显示为准。不同版本或权限下，可选项可能有所差异。
| 字段名称 | 位置 | 用途 | 填写规则 | 可选值 | 影响结果 | 常见错误 |
|---|---|---|---|---|---|---|
| 模型列表 | 入口 | 打开 /dsp/bizList | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 打开 /dsp/bizList | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 设计器 | 入口 | 打开 /dsp/biz/:appCode/:bizCode | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 打开 /dsp/biz/:appCode/:bizCode | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 对象节点与连线 | 画布 | 对象节点与连线 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 对象节点与连线 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 字段属性编辑 | 抽屉 | 字段属性编辑 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 字段属性编辑 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 保存 | 工具栏 | 保存、布局、删除 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 会移除当前配置或数据，执行前确认没有被其他模块依赖。 | 若无法保存，优先检查必填项、格式校验、权限和网络请求返回信息。 |
| 布局 | 工具栏 | 保存、布局、删除 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 会移除当前配置或数据，执行前确认没有被其他模块依赖。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 删除 | 工具栏 | 保存、布局、删除 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 会移除当前配置或数据，执行前确认没有被其他模块依赖。 | 若无法删除，通常是存在引用关系、权限不足或当前状态不允许删除。 |
| 模型列表 BizList | 模型列表 BizList | 按应用进入设计器。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 按应用进入设计器。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 新增 | 画布与对象 | 打开新建弹窗或向导 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 打开新建弹窗或向导 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 保存 | 画布与对象 | 持久化配置 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 持久化配置 | 若无法保存，优先检查必填项、格式校验、权限和网络请求返回信息。 |
| 画布与对象 | 画布与对象 | 新建实体、编辑字段。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 新建实体、编辑字段。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 关联关系 | 关联关系 | 连线表示主子/关联。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 连线表示主子/关联。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
完成标准
不要只以“按钮点击成功”作为完成依据，请至少核对以下结果。
- 打开 /dsp/bizList
- 打开 /dsp/biz/:appCode/:bizCode
- 对象节点与连线
- 从应用到模型
- 保存或提交后页面没有错误提示，刷新后配置仍可正确回显。
常见问题
Q1：字段编码不合法
现象字段编码不合法。
原因见处理步骤。
处理遵循 bizValidation 规则
Q2：无法保存未关联对象
现象无法保存未关联对象。
原因见处理步骤。
处理先选中画布节点
Q3：404
现象404。
原因见处理步骤。
处理检查 appCode/bizCode
Q4：页面白屏或路由 404
现象页面白屏或路由 404。
原因见处理步骤。
处理检查 /dsp 前缀与路径参数；重新登录。
Q5：无权限 403
现象无权限 403。
原因见处理步骤。
处理权限管理分配角色资源后重新登录。
Q6：保存或提交失败
现象保存或提交失败。
原因见处理步骤。
处理F12 查看接口 message；补全必填项。
Q7：列表无数据
现象列表无数据。
原因见处理步骤。
处理确认后端服务与租户；点击刷新。
Q8：菜单无入口
现象菜单无入口。
原因见处理步骤。
处理getMyMenuTree 资源配置。
截图与文档不一致
处理检查前置条件、权限与当前配置，修正后重新执行。