更新日期
1. 简介
1.1 功能概述
按钮 字段是一种手动触发型字段,常配合插件使用。用户在填写表单时点击按钮,即可主动激活预设的执行动作,实现数据查询、信息填充或校验等操作。
1.2 应用场景
- 即时物流查询 :销售人员在订单详情页点击“查询物流”按钮,触发物流查询插件,系统自动获取包裹最新轨迹并回填至表单。
- 企业信息自动填充 :财务人员在录入供应商信息时,输入公司名称后点击“查询企业”按钮,系统自动调取统一社会信用代码、法人等工商数据并填充到对应字段。
- 发票真伪校验 :财务人员在录入发票信息后,点击“验真”按钮,系统调用发票验真插件,实时验证发票真实性并返回校验结果。
1.3 版本说明
按钮字段在所有版本中均可用。
2. 设置入口
操作路径 :进入表单设计页面 >> 从左侧字段区拖拽或点击 「按钮」 字段 >> 在右侧属性区进行配置。

3. 操作指南
本文主要介绍 按钮 字段的特有属性设置的操作,通用属性设置可查看 字段属性 文档。
3.1 设置按钮文字
选中已添加的按钮字段,在右侧属性区找到「按钮文字」设置项。默认显示为“按钮”,用户可自定义修改为业务所需的名称,如“查询企业”、“立即验证”等。

3.2 设置按钮样式
在右侧属性区找到「按钮样式」设置项,支持自定义按钮的风格与颜色,以匹配不同的业务重要程度。

3.3 配置执行动作
执行动作定义了点击按钮后触发的具体操作。按钮必须绑定有效的执行动作方可生效。
3.3.1 添加执行动作
1)在属性区点击「执行动作」下方的「设置」按钮。
2)点击右上角「+ 添加执行动作」按钮。
2)点击右上角「+ 添加执行动作」按钮。

3.3.2 配置触发与执行
1)输入事件名称及说明(如“查询企业信息”)。
2)设置触发条件。系统默认触发字段为“按钮”。
3)在「触发插件」下拉框中选择目标插件。
4)完成发送参数与数据填充字段的填充配置。
2)设置触发条件。系统默认触发字段为“按钮”。
3)在「触发插件」下拉框中选择目标插件。
4)完成发送参数与数据填充字段的填充配置。


3.3.3 管理执行动作
配置完成后点击「保存」,动作默认开启。用户可在管理列表中对已有的执行动作进行编辑、调试、开关或删除。

3.4 子表单中的按钮
按钮字段支持添加在子表单中,其配置规则与主表保持一致。


4. 交互说明
- 手动触发 :按钮由用户在填写表单过程中主动点击触发,不同于前端事件可设置为提交表单后自动触发。
- 实时回填 :执行成功后,系统会根据插件配置实时填充表单字段。
5. 效果演示
以“企业信息查询”场景为例:
点击前 :表单中的“公司类型”、“法人”、“注册地址”、“企业标签”等字段均为空白,待用户手动录入。
点击后 :用户在“企业名称”字段中输入企业名称(如“深圳市轻松信息科技有限公司”),点击「按钮」。系统自动调用企业信息查询插件,将查询到的结果实时回填到表单对应字段中:
- “公司类型”填充为“有限责任公司(港澳台投资、非独资)”。
- “法人”填充为“郭仁和”。
- “注册地址”填充为“深圳市龙华区龙华街道松和社区东环一路108号油松科技”。
- “企业标签”填充为“有限责任公司港、澳、台商投资企业”。

6. 注意事项
- 绑定动作 :按钮必须绑定有效的“执行动作”方可生效;若未配置或执行动作处于“关闭”状态,点击按钮将无任何响应。
- 计算与校验 :按钮字段不支持参与「公式编辑」及「表单提交校验」。
- 显隐规则 :在设置显隐逻辑时,按钮 不支持 作为触发条件(条件字段),仅支持作为被控制的显示字段。
- 状态限制 :按钮仅在数据填报或编辑状态下可见且可用,在数据查看详情页不可用。
- 权限约束 :按钮的可见性受表单字段权限控制,无该字段“查看权限”的成员无法看到并触发按钮。
- 使用限制 :数据标题、提交提示页面、打印模板、仪表盘、工作流、聚合表、数据仓库中均不支持展示和使用按钮字段。