操作指南稳定能力

表单设计(页面设计器):功能分节

了解 表单设计(页面设计器) 中“功能分节”的使用方法、操作要求和完成标准。

阅读本页后,你可以

了解 表单设计(页面设计器) 中“功能分节”的使用方法、操作要求和完成标准。 完成本页后,你应能够理解功能边界,并按步骤完成配置和验证。

开始前检查

  • 已登录 DSP 平台并进入正确组织
  • 已选择目标应用和当前开发版本
  • 账号拥有当前功能的查看或编辑权限
功能分节界面示例
功能分节界面示例,点击可查看原图。

功能分节

页面列表(PageList)

功能说明:按应用浏览、搜索、进入设计器。

图4-1 页面列表
图4-1 页面列表

操作步骤:

  1. 访问 /dsp/pageList,点击目标应用卡片。
  2. 进入 /dsp/page/{appCode} 设计器首页。

顶栏工具条

图4-2 顶栏工具
图4-2 顶栏工具
图标/入口说明
保存持久化当前页面 JSON 配置
撤销 / 重做设计器历史栈
预览打开预览路由查看效果
模型管理内嵌面板 formManage,维护绑定模型
展示配置ShowDesign,列表/表单展示规则
权限配置FormDataAuth,数据/字段/按钮权限
流程打开流程选择/绑定对话框
AI打开 AI 辅助(脚本/H5 等)

预期结果:保存成功无报错;预览在新窗口或路由中展示最新配置。

左侧 — 文件(页面树)

图4-3 文件树
图4-3 文件树

操作步骤:

  1. 点击左侧 文件夹图标(Tooltip:文件)。
  2. 使用搜索框:占位符「表单编号、名称」。
  3. 新建目录:顶部 + 图标 pageAddDir
  4. 目录节点操作:编辑、新建表单、新建子文件夹、复制、删除(删除有「确认删除?」)。
  5. 点击叶子页面节点,在画布中打开该页。

左侧 — 组件

功能说明:PC 端组件库(H5 页面类型下该 Tab 隐藏)。

图4-4 组件库
图4-4 组件库

操作步骤:

  1. 点击 列表图标(Tooltip:组件)。
  2. 搜索「请输入编号、名称搜索」。
  3. 拖拽组件到画布;在组件树中复制、删除(「确认删除该组件?」)。

左侧 — 数据(数据集)

操作步骤:

  1. 点击 数据图标(Tooltip:数据)。
  2. 点击 新建数据(红色按钮,需已打开页面 hasOpenPage)。
  3. 列表项支持:复制、编辑、删除数据集。
  4. 点击条目在抽屉中配置 publicData 绑定。

左侧 — 方法(页面逻辑)

操作步骤:

  1. 点击 方法图标(Tooltip:方法)。
  2. 新建方法 → 在抽屉编辑 publicLogic
  3. 支持复制、编辑、删除逻辑方法。

左侧 — 接口 / 业务模型 / 表单元素

TabTooltip作用
接口接口维护页面关联 API、字段映射关系
业务模型业务模型查看/引用模型对象与关系
表单元素表单元素表单字段元素树(非 H5)

左侧 — 应用参数、应用字典 / 公共方法

  • 应用参数、应用字典(Tab 8):维护页面级参数与字典引用。
  • 公共方法(Tab 9):跨页面复用逻辑。

画布与右侧配置

操作步骤:

  1. 在画布选中组件。
  2. 在右侧配置 属性、样式、静态/动态数据、事件。
  3. 顶栏可切换 终端(clientFlag)预览 PC/移动表现。
  4. 门户项标记「P」表示门户相关配置。

运行态路由

路由用途
/page/auto/:appCode/:id自动表单(新增/列表提交)
/page/edit/...编辑已有数据
/page/detail/...只读详情
/page/print/...打印布局
/page/import/...批量导入

注意:设计态 /page/design 与运行态 /page/auto 不是同一页面,联调时务必访问运行态验证权限与数据。

字段与控件说明

字段名称以当前页面显示为准。不同版本或权限下,可选项可能有所差异。

23 项
字段名称位置用途填写规则可选值影响结果常见错误
保存顶栏持久化页面 JSON按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。持久化页面 JSON若无法保存,优先检查必填项、格式校验、权限和网络请求返回信息。
撤销顶栏回退上一步编辑按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。回退上一步编辑若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
重做顶栏恢复撤销按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。恢复撤销若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
预览顶栏打开预览路由按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。打开预览路由若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
模型管理顶栏跳转/弹窗管理 biz 模型按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。跳转/弹窗管理 biz 模型若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
展示配置顶栏配置展示相关项按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。配置展示相关项若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
权限配置顶栏打开数据/按钮权限按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。会影响用户可访问的菜单、按钮、数据范围或审批操作。若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
流程顶栏关联流程配置按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。会影响流程流转、审批节点和待办生成。若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
AI顶栏打开 AI 辅助面板按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。打开 AI 辅助面板若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
文件左栏页面树、新建/复制页面选择符合页面要求的文件格式和大小,上传后确认预览或附件列表。无固定枚举;按业务规则或页面格式要求填写。页面树、新建/复制页面若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
组件左栏组件库,拖入画布按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。组件库,拖入画布若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
数据左栏数据集、绑定按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。数据集、绑定若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
方法左栏页面级方法脚本按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。页面级方法脚本若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
接口左栏接口引用配置按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。会影响外部系统调用、数据同步或联调排查。若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
业务模型左栏模型字段树按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。模型字段树若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
表单元素左栏表单专用组件按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。表单专用组件若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
公共方法左栏跨页公共方法按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。跨页公共方法若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
选中组件画布右侧显示 uiconfig按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。右侧显示 uiconfig若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
拖入组件画布新增组件节点按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。新增组件节点若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
属性右侧编辑组件属性按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。编辑组件属性若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
样式右侧编辑样式按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。编辑样式若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
数据右侧绑定字段/数据集按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。绑定字段/数据集若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。
事件右侧配置点击/加载等事件按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。无固定枚举;按业务规则或页面格式要求填写。配置点击/加载等事件若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。

完成标准

不要只以“按钮点击成功”作为完成依据,请至少核对以下结果。

  • 持久化页面 JSON
  • 回退上一步编辑
  • 恢复撤销
  • 基于数据模型快速搭建「列表 + 表单 + 详情」业务页;
  • 配置数据权限、按钮事件、公共数据集与方法;

继续阅读