操作指南稳定能力
表单设计(页面设计器):功能分节
了解 表单设计(页面设计器) 中“功能分节”的使用方法、操作要求和完成标准。
了解 表单设计(页面设计器) 中“功能分节”的使用方法、操作要求和完成标准。 完成本页后,你应能够理解功能边界,并按步骤完成配置和验证。
开始前检查
- 已登录 DSP 平台并进入正确组织
- 已选择目标应用和当前开发版本
- 账号拥有当前功能的查看或编辑权限

功能分节
页面列表(PageList)
功能说明:按应用浏览、搜索、进入设计器。

操作步骤:
- 访问
/dsp/pageList,点击目标应用卡片。 - 进入
/dsp/page/{appCode}设计器首页。
顶栏工具条

| 图标/入口 | 说明 |
|---|---|
| 保存 | 持久化当前页面 JSON 配置 |
| 撤销 / 重做 | 设计器历史栈 |
| 预览 | 打开预览路由查看效果 |
| 模型管理 | 内嵌面板 formManage,维护绑定模型 |
| 展示配置 | ShowDesign,列表/表单展示规则 |
| 权限配置 | FormDataAuth,数据/字段/按钮权限 |
| 流程 | 打开流程选择/绑定对话框 |
| AI | 打开 AI 辅助(脚本/H5 等) |
预期结果:保存成功无报错;预览在新窗口或路由中展示最新配置。
左侧 — 文件(页面树)

操作步骤:
- 点击左侧 文件夹图标(Tooltip:文件)。
- 使用搜索框:占位符「表单编号、名称」。
- 新建目录:顶部
+图标pageAddDir。 - 目录节点操作:编辑、新建表单、新建子文件夹、复制、删除(删除有「确认删除?」)。
- 点击叶子页面节点,在画布中打开该页。
左侧 — 组件
功能说明:PC 端组件库(H5 页面类型下该 Tab 隐藏)。

操作步骤:
- 点击 列表图标(Tooltip:组件)。
- 搜索「请输入编号、名称搜索」。
- 拖拽组件到画布;在组件树中复制、删除(「确认删除该组件?」)。
左侧 — 数据(数据集)
操作步骤:
- 点击 数据图标(Tooltip:数据)。
- 点击 新建数据(红色按钮,需已打开页面
hasOpenPage)。 - 列表项支持:复制、编辑、删除数据集。
- 点击条目在抽屉中配置
publicData绑定。
左侧 — 方法(页面逻辑)
操作步骤:
- 点击 方法图标(Tooltip:方法)。
- 新建方法 → 在抽屉编辑
publicLogic。 - 支持复制、编辑、删除逻辑方法。
左侧 — 接口 / 业务模型 / 表单元素
| Tab | Tooltip | 作用 |
|---|---|---|
| 接口 | 接口 | 维护页面关联 API、字段映射关系 |
| 业务模型 | 业务模型 | 查看/引用模型对象与关系 |
| 表单元素 | 表单元素 | 表单字段元素树(非 H5) |
左侧 — 应用参数、应用字典 / 公共方法
- 应用参数、应用字典(Tab 8):维护页面级参数与字典引用。
- 公共方法(Tab 9):跨页面复用逻辑。
画布与右侧配置
操作步骤:
- 在画布选中组件。
- 在右侧配置 属性、样式、静态/动态数据、事件。
- 顶栏可切换 终端(
clientFlag)预览 PC/移动表现。 - 门户项标记「P」表示门户相关配置。
运行态路由
| 路由 | 用途 |
|---|---|
| /page/auto/:appCode/:id | 自动表单(新增/列表提交) |
| /page/edit/... | 编辑已有数据 |
| /page/detail/... | 只读详情 |
| /page/print/... | 打印布局 |
| /page/import/... | 批量导入 |
注意:设计态 /page/design 与运行态 /page/auto 不是同一页面,联调时务必访问运行态验证权限与数据。
字段与控件说明
字段名称以当前页面显示为准。不同版本或权限下,可选项可能有所差异。
| 字段名称 | 位置 | 用途 | 填写规则 | 可选值 | 影响结果 | 常见错误 |
|---|---|---|---|---|---|---|
| 保存 | 顶栏 | 持久化页面 JSON | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 持久化页面 JSON | 若无法保存,优先检查必填项、格式校验、权限和网络请求返回信息。 |
| 撤销 | 顶栏 | 回退上一步编辑 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 回退上一步编辑 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 重做 | 顶栏 | 恢复撤销 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 恢复撤销 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 预览 | 顶栏 | 打开预览路由 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 打开预览路由 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 模型管理 | 顶栏 | 跳转/弹窗管理 biz 模型 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 跳转/弹窗管理 biz 模型 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 展示配置 | 顶栏 | 配置展示相关项 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 配置展示相关项 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 权限配置 | 顶栏 | 打开数据/按钮权限 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 会影响用户可访问的菜单、按钮、数据范围或审批操作。 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 流程 | 顶栏 | 关联流程配置 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 会影响流程流转、审批节点和待办生成。 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| AI | 顶栏 | 打开 AI 辅助面板 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 打开 AI 辅助面板 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 文件 | 左栏 | 页面树、新建/复制页面 | 选择符合页面要求的文件格式和大小,上传后确认预览或附件列表。 | 无固定枚举;按业务规则或页面格式要求填写。 | 页面树、新建/复制页面 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 组件 | 左栏 | 组件库,拖入画布 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 组件库,拖入画布 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 数据 | 左栏 | 数据集、绑定 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 数据集、绑定 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 方法 | 左栏 | 页面级方法脚本 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 页面级方法脚本 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 接口 | 左栏 | 接口引用配置 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 会影响外部系统调用、数据同步或联调排查。 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 业务模型 | 左栏 | 模型字段树 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 模型字段树 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 表单元素 | 左栏 | 表单专用组件 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 表单专用组件 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 公共方法 | 左栏 | 跨页公共方法 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 跨页公共方法 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 选中组件 | 画布 | 右侧显示 uiconfig | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 右侧显示 uiconfig | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 拖入组件 | 画布 | 新增组件节点 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 新增组件节点 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 属性 | 右侧 | 编辑组件属性 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 编辑组件属性 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 样式 | 右侧 | 编辑样式 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 编辑样式 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 数据 | 右侧 | 绑定字段/数据集 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 绑定字段/数据集 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 事件 | 右侧 | 配置点击/加载等事件 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 配置点击/加载等事件 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
完成标准
不要只以“按钮点击成功”作为完成依据,请至少核对以下结果。
- 持久化页面 JSON
- 回退上一步编辑
- 恢复撤销
- 基于数据模型快速搭建「列表 + 表单 + 详情」业务页;
- 配置数据权限、按钮事件、公共数据集与方法;
