前端事件

1. 简介

1.1 功能简介

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

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

1.2 应用场景

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

1.3 预期效果

配置好前端事件后，在表单中上传发票图片，即可完成增值税发票识别。点击体验效果

2. 设置入口

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

2）如果未添加过前端事件，点击「添加前端事件」进行添加：

3）如果已经添加过前端事件，可以对之前添加的前端事件进行编辑、调试、删除、开启和停用操作，或点击左上角的「添加前端事件」进行添加：

4）当一个表单中添加了多个前端事件时，支持对列表中的前端事件进行拖拽排序，便于查看。

3. 设置内容

前端事件的设置内容主要包括：事件名称、事件说明、触发动作和执行动作。

3.1 事件名称

事件名称即前端事件的命名，必填。

3.2 事件说明

事件说明即前端事件的描述信息，非必填。

3.3 触发动作

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

触发动作支持选择的字段包括：

单行文本、多行文本、数字、日期时间、单选按钮组、复选框组、下拉框、下拉复选框、定位、图片、附件、手写签名、成员单选、成员多选、部门单选、部门多选、子表单子字段。

3.4 执行动作

执行动作是指当发生触发动作时，前端事件将调用接口，完成相应的执行操作。

执行动作支持设置为 自定义请求 或 调用插件。

4. 保存与调试

配置好前端事件的参数后，点击「保存」保存设置，或点击「保存并调试」查看预期效果并进行测试：

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

5. 请求超时

如果使用前端事件时显示请求超时，系统将会自动重新请求，每次请求时长 15 秒，共请求三次，如第三次再次超时，将不再请求。