前端事件

1. 简介

1.1 功能简介

前端事件是一种全新的数据获取的方式，可以在数据填报时，主动调用外部接口，实现接口取数、数据验证、数据分析、触发事件等一系列的操作。

前端事件功能所有版本皆可免费使用，无需开通简道云 API 接口，且无需编程即可完成前端事件的配置。如果企业具有开发能力，也可以自己封装接口，来实现想要的数据交互效果！

1.2 应用场景

前端事件可以应用于数据处理、数据验证、数据获取，以及其他自定义的场景等。如：

1.3 预期效果

以查询物流信息为例，效果如下所示：

2. 设置步骤

2.1 设置入口

1）在「表单设计 >> 表单属性 >> 前端事件」处点击「设置」，进入前段事件的设置页面：

2）进入前端事件设置页面，点击左上角的「添加前端事件」即可添加一个新的前端事件。

2.2 设置名称信息

添加好前端事件后，首先设置前端事件的名称和说明，以便于区分不同的前端事件。设置完成后，点击「下一步」。

2.3 设置触发动作

触发动作即触发前端事件的条件。选择触发字段后，当触发字段的值被手动修改时，会触发执行动作：

2.4 执行动作

执行动作是指当发生触发动作时，前端事件将调用接口，完成相应的执行操作。执行动作支持设置为 自定义请求 或 调用插件。

3. 保存与调试

1）配置好前端事件的参数后，点击「保存并调试」进入调试页面。

2）进入调试页面后，在触发字段中输入内容，点击「发送请求」，右侧调试信息中将显示请求内容和返回内容，并将返回内容按照返回值设置填写进表单字段中：

4. 注意事项

4.1 请求超时

在执行前端事件的自定义请求时，如发生请求超时，系统将自动进行重试。每次请求时长 15 秒，最多重试三次。若第三次仍超时，则不再继续请求。

而在前端事件执行插件时，插件执行超时时间为 60 秒，且不会自动重试。

4.2 重复赋值

在多个前端事件回填同一字段时，注意排查触发逻辑，避免同时触发多个前端事件导致最终回填的字段值无法控制。