OARS Docs

Appearance

表单设计器 ​

表单设计器用于创建业务表单模板，配置字段与联动规则，并供流程绑定或独立填报使用。

适用场景 ​

  • 业务管理员：设计、发布和维护表单模板
  • 流程配置人员：为流程节点绑定或覆盖表单，配置字段权限

功能概述 ​

  • 可视化设计：拖拽组件到画布，支持桌面端 / 移动端布局切换
  • 全屏预览：预览弹窗可切换设备类型与桌面宽度（800 / 1000 / 1200px）
  • 字段组件：文本、数字、日期时间、选择、开关、上传、子表、组织/用户/角色选择、OCR 识别、手写签名、富文本等 30+ 类型
  • 明细子表：支持「自有」与「引用」两种模式；引用模式可复用其他表单的行表结构
  • 选项源：静态选项，或引用系统数据源（字典、部门、用户、角色、HTTP/SQL 数据源等）
  • 业务字段目录：可把组件绑定到系统「字段元数据」；目录里的必填、默认值和校验会在填报、提交和流程办理时生效
  • 字段联动：可见、只读、必填条件，支持 AND / OR 与嵌套分组
  • 字段动作：字段变化后设置固定值、复制其他字段、清空目标字段
  • 字段事件：字段变化后执行自定义脚本（适合轻量计算与联动，强校验应放在后端）
  • 功能配置：实例编号规则、打印与 PDF、列表查询/列/表头、行/列表操作按钮、保存/提交等触发器
  • 版本管理：草稿、发布、版本历史
  • 独立填报：不绑流程也可新建数据、提交、归档，并在「表单数据」中管理
  • AI 创建表单：用自然语言描述需求，生成表单草稿后进入设计器继续调整

使用步骤 ​

创建表单模板 ​

  1. 进入 表单模板 列表，点击「新建」
  2. 在设计器中从左侧组件库拖拽字段到画布
  3. 切换 桌面端 / 移动端 查看栅格布局
  4. 选中字段，在右侧配置标题、占位、校验、选项源等；也可绑定系统字段目录，沿用目录中的默认值和校验
  5. 保存草稿或发布模板

AI 创建表单 ​

在表单模板列表先选中左侧分类，再点击 AI 创建表单模版。

  1. 用业务语言描述要管什么数据、有哪些字段、哪些必填、是否需要明细行等。
  2. 有模型提供商管理权限时，可指定本次使用的提供商；否则使用系统默认提供商。
  3. 点击生成草稿。系统会保存为该分类下的表单草稿，并打开设计器。
  4. 在设计器中调整布局、组件、联动和校验后，再发布。

使用前请确认已启用默认模型提供商，见 AI 能力、系统配置。生成结果是草稿，不会直接上线。

配置选项源 ​

  • 静态选项：手动维护标签与值
  • 数据源：选择系统已配置的数据源（在 系统配置 中维护）
  • 支持将表单其他字段的值作为数据源查询参数

配置字段联动与动作 ​

  1. 选中字段，打开 行为规则
  2. 联动规则：配置可见 / 只读 / 必填条件
  3. 联动动作：配置字段变化后的赋值、复制或清空
  4. 事件脚本（可选）：编写变化后执行的脚本逻辑
  5. 使用 预览 验证效果

配置明细子表 ​

  1. 选中明细表，在 快捷设置 中选择 自有 或 引用
  2. 自有：进入子表设计编辑行内字段；若模板使用数据库存储模式，需配置子表存储名称
  3. 引用：选择被引用表单及其行表，并配置列表展示字段
  4. 明细最多嵌套 5 层；再往里拖会提示拆到其他表单。保存时也会按同一上限拦住

配置实例编号与高级能力 ​

  1. 点击工具栏 功能配置
  2. 实例编号：编辑编号模板（如按日期 + 顺序号生成）
  3. 按需配置 打印与 PDF、列表展示列与查询条件、保存/提交 触发器 等

绑定到流程 ​

  1. 在 流程设计器 中为模板或节点绑定表单
  2. 节点级可覆盖表单，并设置字段隐藏、只读

独立填报与数据管理 ​

  • 模板列表或 表单数据 页：新增数据、查看 数据详情
  • 表单数据：按模板浏览全部填写记录，支持按功能配置里的查询字段筛选（JSON 模板和物理表模板都在服务端按字段过滤），以及导出（以模板功能配置为准）。导出到 Excel/CSV 时，以 = 等开头的单元格会按文本保存，避免表格软件自动当公式执行。
  • 谁能看、谁能改：把表单数据页挂到菜单并授给角色后，这些人就能查看数据。要新增、编辑、删除、导入导出时，在角色授权里勾选同一菜单下的按钮即可，不用在设计器里再配一套互不相关的权限。超级管理员默认能操作全部表单数据。

关键说明 ​

  • 发布后的模板可用于流程绑定或独立表单菜单
  • 预览与正式填写使用同一套渲染逻辑，效果应一致；若差异多为预览宽度或移动外框所致
  • 流程绑定后，分支条件和找人规则可直接选用主表字段，无需额外标记
  • OCR 组件可将识别结果映射到目标字段
  • 字段联动、动作、事件随模板保存，在独立填报、数据管理和流程表单中生效
  • 富文本字段在只读查看时会过滤脚本类内容，保留文字、样式、表格、图片和链接

常见问题 ​

设计器和实际填写不一致？
先确认预览设备与宽度；业务页为全宽渲染。仍不一致请联系管理员检查是否使用了不同模板版本。

如何复用已有模板？
在模板列表查看版本历史，可从正式版本复制为新草稿。

如何隐藏部分字段？
流程节点可覆盖表单，按节点配置字段隐藏或只读；独立表单可在设计器中直接删除或加联动隐藏。

实例编号可以改吗？
编号在创建实例时按规则生成；调整规则后仅影响新建数据。

物理表还要同步一份 JSON 吗？
默认会。数据量大或不需要对照时，在设计器属性里关掉「同步 JSON 快照」。关掉后以物理表为准，办理页和列表仍正常显示。

选项源下拉为空？
检查数据源是否已在系统配置中启用，参数绑定是否正确。

AI 创建表单不可用或生成失败？
确认已启用默认模型提供商且密钥、地址正确；当前账号有表单模板权限。生成后请在设计器中核对字段再发布。