Skip to main content

控件事件

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

应用场景​

  • 获取外部数据。创建记录时，输入快递单号，直接调用API获取物流信息写入到字段中。
  • 数据验证提醒。当APP扫码入库出现异常时，直接播放提示音提醒用户查看。
  • 修改字段值。当客户登记选择为VIP1时，折扣率修改为95折，选择为VIP2是，折扣率修改为85折,不选择会员时折扣率为100。

场景示例​

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

配置入口​

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

1.配置事件类型​

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

2.配置事件条件与执行动作​

事件条件​

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

执行动作​


动作分为全局动作和选择字段动作两种类型：

  • 全局动作：主要用于执行全局性操作，如打开视图、打开自定义页面、打开大屏、打开链接、打开应用、打开记录、新增数据、调用服务以及发起流程等。这些操作通常不针对特定字段，而是影响整个表单或应用的上下文。
  • 选择字段动作：针对特定字段进行操作，如显示、隐藏、启用、禁用以及设置字段值等。这些操作允许用户根据业务需求动态调整字段的状态或内容。例如，可以根据条件控制“折扣率”字段的显示或隐藏，或者为其设置特定的值。
通过这两种动作类型，用户可以灵活地控制表单和应用的行为，满足不同的业务场景需求。

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

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

与属性、业务规则的优先级​

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

👇文档问题反馈​