1.简介

1.1功能概述

前端事件可以实现在表单填报时，主动调用外部接口，进行数据验证、数据分析、触发事件、接口取数等一系列操作。
前端事件需要配合插件使用，使用前需要前往【开放平台】安装对应插件。

1.2使用场景

前端事件支持数据处理、验证、获取等场景，还可灵活扩展自定义功能。更多插件用法详见：插件市场。

使用场景	设置方法
物流查询插件	物流查询插件
企业微信群机器人插件	企业微信群机器人插件
邮箱插件	邮箱插件
企业信息查询插件	企业信息查询插件
汇率转换插件	汇率转换插件

2.设置前准备

本文以汇率转换插件为例，讲解前端事件的设置内容。

2.1插件安装

在工作台中的“为您推荐”组件中，选择“精选插件”，点击右下角的“进入开放平台”，即可进入英雄云插件页面。

点击“插件市场”，选择“汇率转换”，进入插件详情页。

进入详情页后，点击“安装”即可安装插件。在插件详情页中，用户还可以查询到该插件的付费方案。

2.2启用插件

插件安装完成后，需要启用插件，才能在表单中正常使用。
点击“插件管理”，在“已安装插件”中找到刚安装的插件，将开关按钮打开即可。

2.3表单搭建

汇率转换插件可以根据用户输入的转换前货币类型、数值，与转换后的货币类型，返回转换后的货币数值。添加“下拉框”与“数字输入框”字段存放上述信息。

货币类型-转换前/货币类型-转换后：下拉框；
数值-转换前：数字输入框。

添加“单行文本”或“数字输入框”字段，用于存放转换后的货币数值。用户可以根据自身需求修改字段名称。

3.前端事件配置

3.1添加前端事件

搭建好表单后，需要在“表单属性”中配置前端事件。
点击右上角“保存”按钮保存表单后，选择“表单属性”，对前端事件进行设置。

点击右上角的“＋添加前端事件”，进入前端事件设置页面。

3.2设置前端事件

3.2.1事件名称与说明

用户可以根据企业需求自定义事件名称与说明，便于用户在使用时区分各前端事件。

事件名称：前端事件的命名，必填；
事件说明：前端事件的描述信息，选填。

3.2.2触发字段

前端事件的触发字段就是触发前端事件的条件，当触发字段的值被手动修改时，自动触发前端事件。
此处设置触发字段为“货币类型-转换后”字段。

3.2.3配置条件

用户可配置触发条件，仅当数据满足条件时，系统才会调用前端事件并执行插件。点击“配置条件”，显示高级筛选设置弹窗。

1）选择需要筛选的字段，选择筛选规则。

筛选字段：支持选择表单字段与系统字段；
筛选规则：支持选择“等于”、“不等于”、“等于任意一个”、“不等于任意一个”、“包含”、“不包含”、“为空”、“不为空”。

2）若需要设置多个筛选条件，点击下方“添加条件”或“添加条件组”。

3）选择筛选条件之间的关系，英雄云支持选择“并且”与“或者”。

4）筛选条件设置完成后，点击“筛选”按钮即可。

此处设置筛选条件为“数值-转换前”大于等于100，故只有在“数值-转换前”字段的输入数据大于等于100时，前端事件才会被触发。

3.2.4触发插件

触发插件就是当前前端事件需要使用的插件。此处选择“汇率转换”插件。

3.2.5插件发送参数

插件发送参数就是调用插件时输入的数据。此处需要输入转换前的货币类型与数值，和转换后的货币类型，通过下拉框选择对应的表单字段。

3.2.6数据填充

数据填充是指当插件被调用并返回查询结果后，系统自动将获取到的数据填入当前表单的对应字段中。
点击“新增”，选择“数值/元-转换后”，并将查询后的信息存储到表单已有字段中。

3.2.7保存并调试

设置好前端事件后，用户可以对设置好的前端事件进行调试。点击“保存并调试”进入调试页面。

进入调试页面后，在触发字段中输入内容，点击“发送请求”，右侧调试信息处会显示请求内容与返回内容。

4.实际效果

当“数值-转换前”的数据未超过100时，“数值-转换后”字段无数据返回并填充。

当“数值-转换前”的数据超过100时，“数值-转换后”字段有数据返回并填充。

5.管理前端事件

在英雄云平台，用户可对已有的前端事件执行编辑、调试、删除及状态管理（启用/关闭）操作。