Skip to main content

控件事件

在详情页创建记录或编辑记录时,支持自定义控件事件。在控件上有交互事件发生时,如果表单内的数据满足条件,则可以根据配置执行不同动作,如提醒、调用集成API等。

详情页始是指点击创建按钮显示的创建页面,或点击已有记录打开的记录页面。在视图下编辑或批量编辑时控件事件不可用;导入、工作流新增时事件不生效。

常用场景:

  • 获取外部数据。创建记录时,输入快递单号,直接调用API获取物流信息写入到字段中。

  • 数据验证提醒。当APP扫码入库出现异常时,直接播放提示音提醒用户查看。

  • 修改字段值。当客户登记选择为VIP1时,折扣率修改为95折,选择为VIP2是,折扣率修改为85折,不选择会员时折扣率为100。

场景示例

当客户的会员等级选择为VIP1时,折扣率自动选择95折,选择为VIP2是,折扣率自动选择85折,不是会员或清空时时折扣率选择无折扣。

配置入口

在表单设计区点击字段,在右侧点选"事件"按钮,然后点击"+事件开始配置"

1.选择事件类型

选择“值改变时”的类型,选择了等级项或清除了选项,都属于值被改变。

2.配置事件的条件和动作

配置条件1和相应动作:等级选择了VIP1时,折扣率选择为95折。

条件配置:

执行动作:

3.继续添加其他场景的条件和相应动作

点击事件类型右侧的添加条件按钮,新建一个条件动作组。

效果演示:

字段支持事件类型

目前支持的事件有“显示/隐藏时”、“值改变时”、“获取/失去焦点时”。不同的控件类型,支持的事件类型不同,下表列出了不同类型控件支持的事件类型:

控件交互类型显示时隐藏时获取焦点时失去焦点时值改变时值改变并失去焦点时
输入型🚫
动作型🚫🚫🚫
只读型🚫🚫🚫🚫
选项型🚫🚫🚫
关联型🚫🚫🚫

输入型:文本、数值(直接输入)、金额、邮箱、电话、富文本、证件

动作型:数值(进度、计步器)、日期、时间、附件、检查项、等级、定位、签名

只读型:公式、自动编号、文本识别、API查询(按钮)、条码、大写金额、嵌入、查询记录、他表字段、汇总、自由连接、分段、标签页、备注

选项型:地区、单选、多选、成员、部门、组织角色、API查询(下拉框)

关联型:关联记录、子表、级联选择

执行动作类型

目前在事件发生时支持的执行动作有以下几种:

执行动作说明
显示/隐藏指定在事件发生时要显示或隐藏的字段(与业务规则不同,仅在事件发生时生效)
设置只读/可编辑指定在事件发生时要设置只读或可编辑的字段(与业务规则不同,仅在事件发生时生效)
设置字段值在事件发生时更新某个字段的值为指定值
刷新字段值在事件发生时,主动刷新公式、汇总、文本组合等计算字段的值
调用已集成 API在事件发生时,调用指定的已集成 API,并可以将返回的值映射写回到当前表单记录
显示消息在事件发生时显示一个自定义的全局提示消息
播放声音在事件发生时播放指定的音效或声音文件

事件执行条件

在字段控件事件发生时,用户可以设置还需要同时满足指定条件才会执行动作。支持在同一个事件下设置多组不同的条件,当一组条件不满足时,将继续匹配其余条件,直至匹配成功后则执行满足该条件下的动作。目前支持设置的条件类型包括:

条件类型说明
按字段值在事件发生时,如果当前表单的字段值满足设置的筛选条件,则执行动作
按查询工作表在事件发生时,如果按指定的筛选条件满足查询工作表后的期望结果,则执行动作
按自定义函数在事件发生时,如果运行自定义编写的 javascript 代码(可引用当前表单字段)返回 true,则执行动作

和属性、业务规则的优先级

  1. 所有控件事件的执行动作均按配置的顺序从上往下执行。
  2. 在加载表单时,会在加载完成后将所有可见字段的“显示时”事件动作执行一遍,此时按表单布局的顺序依次执行每个字段的“显示时”事件,事件中的执行动作从上往下顺序执行。
  3. 字段配置中勾选的属性(不是通过业务规则设置),比如 隐藏、只读,可以通过事件来修改属性为显示和可编辑。
  4. 业务规则中设置了“隐藏”、“显示”动作的字段,执行业务规则时如显示状态发生变化,会触发该字段的“隐藏时”、“显示时”事件。
  5. 控件事件与业务规则的显示、隐藏、只读、可编辑动作在同一个字段生效时,先把事件动作按先后顺序执行完毕,再按 隐藏 > 显示、显示时 只读 > 必填 > 可编辑 与业务规则合并进行处理。