更新日期

1. 字段简介

1.1 功能概述

按钮字段常配合插件使用,在点击该按钮时,用户可以手动激活相应的执行操作。

1.2 应用场景

  • 即时查询:在订单详情页点击按钮,点击按钮触发「物流查询插件」获取包裹轨迹
  • 获取信息:在填写公司名称后,点击按钮触发「企业信息查询插件」,自动调取并填充企业统一社会信用代码、法人等工商数据
  • 请求校验:在输入发票信息后,点击按钮触发「发票验真插件」,实时验证发票真实性并返回校验结果

2. 设置入口

表单设计页面,从左侧字段区拖拽点击即可添加按钮字段,在右侧属性区进行配置。

3. 字段属性

本文主要介绍按钮字段的特有属性,通用属性设置可查看:字段属性

3.1 按钮文字

「按钮文字」默认是“按钮”,支持自定义按钮显示的名称(如“查询企业”、“立即验证”)。

3.2 按钮样式

在「按钮样式」处,支持自定义按钮的风格与颜色,以匹配不同的业务重要程度。

3.3 执行动作

执行动作定义了点击按钮后触发的具体操作。以“企业信息查询”为例:
1)添加动作:在属性区点击「设置」进入管理页,点击右上角「 + 添加执行动作」;
2)事件定义:输入事件名称及说明,设置配置条件,系统默认触发字段为“按钮”,无需更改;
3)插件配置:在「触发插件」下拉框中选择目标插件,并完成发送参数/数据填充字段的映射;
4)保存管理:「保存」后动作默认开启。您可以在管理列表中对已有的动作进行编辑、调试、停用删除

4. 交互说明

  • 手动触发:不同于前端事件可设置提交表单后自动触发,按钮字段由用户在填写过程中主动点击触发
  • 实时回填:执行成功后,系统会根据插件配置实时填充表单字段

5. 注意事项

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

6. 效果演示