事件交互
2 分钟阅读
事件介绍
页面中控件的事件交互通常由两部分组成：触发事件和执行动作。
触发事件是指用户与页面交互时发生的行为，如鼠标点击、键盘输入、页面滚动等，当这些行为发生时，会触发相应的动作，平台可以通过JavaScript等技术来监听这些事件并做出相应的响应，例如单击按钮控件，打开指定详情页面，其中【单击】属于按钮控件的触发事件，【打开指定页面】属于对应的执行动作。
平台提供通用的事件管理机制，预置有多种常见的触发事件和执行动作，支持配置不同的控件事件，执行不同的动作，满足不同场景下的页面交互的多样性。
事件触发
系统内预置了多种常用的事件触发，如下表所示。
| 类型 | 涉及控件 | 触发事件 |
|---|---|---|
| 页面 | PC、移动页面 | 页面初始化： 页面初始化加载时，执行对应动作 参数变化时： 针对外框和子页面，入参变化时，执行对应动作 页面关闭前： 页面关闭时会触发该事件，执行对应动作后，关闭页面 |
| 移动页面 | 顶部下划： 仅移动端有该事件，当移动页面已划动至顶部，再次下划，执行对应动作，常用于页面刷新，或数据控件刷新 底部上划： 仅移动端有该事件，当移动页面已划动至底部，再次上划，执行对应动作，常用于数据控件加载更多 |
|
| 布局控件 | 页签 | 切换到某页签： 当切换至指定页签时，执行对应动作 |
| 容器 | 单击： 鼠标点击时，执行对应动作 双击： 仅PC端有该事件，鼠标双击时，执行对应动作 右键： 仅PC端有该事件，鼠标右键点击时，执行对应动作 鼠标移入： 仅PC端有该事件，鼠标移入容器区域时，执行对应动作 鼠标移出： 仅PC端有该事件，鼠标移出容器区域时，执行对应动作 |
|
| 面板 | 面板初始化： 面板初始化加载时，，执行对应动作 面板关闭： 面板关闭时，执行对应动作 双击： 鼠标双击面板区域时，执行对应动作 右键： 鼠标右键点击面板区域时，执行对应动作 |
|
| 数据控件 | 单一记录 | 数据加载后： 当数据控件数据加载完成后，执行对应动作 |
| 多记录数据控件 （重复表录入/查询、 树表录入/查询、 重复节、树） |
点击行/节时： 单击行时，执行对应动作 双击行/节时： 双击行时，执行对应动作 勾选行/节时： 表格产生勾选动作时，执行对应动作 全选时： 表格产生全选动作时，执行对应动作 取消全选时： 表格产生取消全选动作时，执行对应动作 勾选行改变时： 勾选行产生改变时，包含新增勾选和取消勾选，执行对应动作 数据加载后： 当数据控件数据加载完成后，执行对应动作 分页改变时： 分页发生改变时，执行对应动作 自定义列/顶部操作： 多记录数据控件支持自定义添加按钮操作，点击操作时，执行对应动作 |
|
| 录入控件 | 单行文本、数字、货币、多行文本、OCR、 日期、时间、参照、下拉、开关、单选、多选 |
获取焦点： 录入控件获取焦点时，执行对应动作， 如光标移至输入框即获取焦点 焦点离开： 录入控件失去焦点时，执行对应动作， 如光标从输入框移开即失去焦点 值发生改变： 控件值发生改变时，执行对应动作，如下拉的选项改变时被触发 |
| 附件 | 附件上传后： 附件上传完成后，执行对应动作 | |
| 展示控件 | 文字标签、按钮、图标、图片、图文 | 单击： 鼠标点击时，执行对应动作 双击： 鼠标双击时，执行对应动作 右键： 鼠标右键点击时，执行对应动作 |
平台支持设置条件事件，即满足不同条件，执行不同的事件。
事件行为
实体类行为
系统中，实体作为表单应用的核心，是数据库表的可视化表示形式，所有数据控件均需要绑定对应实体，而实体类动作就是针对数据控件进行的数据类操作，包括对于实体数据进行添加、编辑、删除、导入导出等操作。实体类动作均需要有承载实体数据的页面或数据控件，不同控件也支持不同的实体类动作。
- 存为草稿
动作描述：系统中单据和档案类型实体，预置有状态字段（草稿、待提交、提交中、已生效），该动作将保存单条数据，并变更状态为【草稿】。
适用范围：单一记录且实体为单据或档案类型
参数配置：
- 实体：选择执行该动作的数据控件
- 行为执行之后：动作执行完成后连带执行的动作。
- 无操作
- 刷新当前页面
- 关闭当前页面
- 关闭并刷新父页面
- 保存记录
动作描述：用于数据的保存。
适用范围：数据控件（树暂不支持）。
参数配置：
- 实体：选择执行该动作的数据控件
- 行为执行之后：动作执行完成后连带执行的动作，同【存为草稿】
- 保存并新增
动作描述：用于单条数据的连续新增，保存后将重置对应数据控件数据。
适用范围：单一记录控件，若控件绑定实体为单据或档案类型，将同步变更状态为【待提交】。
参数配置：
- 实体：选择执行该动作的数据控件
- 保存并复制
动作描述：用于单条数据的连续复制新增，保存后将复制对应数据控件数据。
适用范围：单一记录控件，复制的范围同当前人新增填写页面可操作数据范围一致。
参数配置：
- 实体：选择执行该动作的数据控件
- 提交记录
动作描述：该动作将保存单条数据，并触发执行对应流程，变更当前数据的状态为提交中。
适用范围：单一记录且实体为单据或档案类型。
参数配置：
- 实体：选择执行该动作的数据控件
- 行为执行之后：动作执行完成后连带执行的动作，同【存为草稿】
- 撤回记录
动作描述：。
适用范围：单一记录且实体为单据或档案类型。
参数配置：
- 实体：选择执行该动作的数据控件
- 刷新记录
动作描述：该动作将重新获取对应数据控件的数据。
适用范围：数据控件（单一记录、重复表录入/查询、树表录入/查询、重复节、树）。
参数配置：
- 实体：选择执行该动作的数据控件
- 删除记录
动作描述：该动作将删除指定数据项，删除后不可找回。
适用范围：数据控件（单一记录、重复表录入/查询、树表录入/查询、重复节）。
参数配置：
- 实体：选择执行该动作的数据控件
- 行为执行之后：动作执行完成后连带执行的动作，同【存为草稿】
注：
1）单一记录为删除当前记录
2）多记录数据控件中列操作配置该动作，为删除选中行数据
3）多记录数据控件中顶部操作（批量操作）配置该动作，为删除勾选行数据
- 导入
动作描述：列表页面，从本地文件表格中批量导入数据，例如批量导入人员信息、批量导入数据记录等。
适用范围：多记录数据控件（重复表录入/查询、树表录入/查询、重复节）。
参数配置：
- 实体：选择执行该动作的数据控件
- 导入模板管理
1）支持设置默认导入模板
2）支持编辑和删除已有模板
3）支持新建导入模板：可选择对应实体所有数据项作为导入字段（必填字段为必选项）
- 导入事件
- 导入模板设置
- 导出
动作描述：列表页面，从列表导出数据到本地，例如批量导出人员信息、批量导出数据记录等。
适用范围：多记录数据控件（重复表录入/查询、树表录入/查询、重复节）。
参数配置：
- 实体：选择执行该动作的数据控件
- 导出模板管理
1）支持设置默认导出模板
2）支持编辑和删除已有模板
3）支持新建导出模板：可选择对应实体所有数据项作为导出字段
- 打印
动作描述：该动作支持打印当前页面。
注：打印内容可在页面属性中选择需打印的组件。
流程类行为
当表单需要多方参与、且按一定顺序提交数据时，就需要用到流程。流程类动作用于配置流程各节点中节点负责人处理节点时可以进行的特定操作，通常用于按钮控件、工具栏控件的事件配置。
- 处理提交
审批节点的操作之一，保存在此节点中的操作，数据流转到下一节点。
- 同意提交
同意申请，保存在此节点中的操作，数据流转到下一节点。
- 已阅提交
已知晓表单内容，保存节点操作，数据继续流转。
- 不同意处理
不同意申请，处理后执行特定动作，如回退上一节点。
- 暂存代办
保存在此节点中的操作，并且流程数据保留在我的待办中。
- 保存内容
保存在此节点中的数据，暂不向往下一节点流转。
- 回退
当流程已办节点（不一定是上一节点）处理有误或者上一节点指定错人员时，相关人员需要退回到相应节点由其重新处理。
- 终止
相当于流程提前结束，当前节点后的其它节点不再执行。
- 撤销
与"终止"类似，由发起人执行。
- 移交
当流程实际并非由当前处理人处理或当前处理人因故不能审批时，支持将该条流程待办数据转交给其他成员进行处理。
- 加签
审批时，可以征求另一人或多人的意见，加签将出现在流程中。
- 减签
当加签人数大于等于 1 时，可以移除被加签的审批人，对方无需再审批。例如加签有误时，可以通过减签来操作。
- 咨询
流程审批过程中，审批人需要与流程外的人员进行沟通才能做出审批决策时，可进行流程外人员的咨询，且不会出现在流程中，也不影响流程流转。
- 知会
告知指定人员知道有该流程，支持查看。
- 取回
参与者提交任务后，发现自己办理此任务有误或不应该立刻提交等情况，可将此已办理完成的任务取回重新办理或稍后再提交。主要针对本人的"已办任务"。
- 催办
当流程超期或紧急时，相关人员需要对流程进行催办，从而加速流程执行。
- 查看流程
查看当前页面所属的流程。
- 辅助页面
以右侧抽屉的弹窗形式打开辅助信息页面。辅助页面支持在流程设计时指定。
注：1.流程动作选择发送、处理提交、同意提交、不同意处理时，显示参数：“是否弹下一节点弹窗”
2.流程动作选择加签、会签、知会、回退时，可选该类型的标准操作和封装操作
页面行为
- 打开页面
动作描述：打开当前应用内的指定页面。
参数配置：
- 目标页面：当前应用已创建好的页面
- 打开方式：
- 新开浏览器页签
- 新开系统页签
- 当前页打开
- 打开弹窗：以弹窗的形式打开指定页面，支持设置弹窗的标题、类型、大小
- 入参映射规则：当前页面控件数据可做为被打开页面的入参参数
- 出参映射规则：页面打开模式为弹窗时可配置，被打开页面的出参可以作为返回值，映射为当前页面中某控件数据
- 刷新页面
动作描述：触发后刷新指定页面。
参数配置：
- 页面：支持刷新当前页面或父页面
- 打开链接
动作描述：触发后打开指定地址的链接。
参数配置：
- 链接地址：支持输入固定地址或通过表达式拼接动态地址
- 打开方式
- 新开浏览器页签
- 新开系统页签
- 当前页打开
- 链接参数
- 锚点跳转
动作描述：用于页面内容过长时，快捷跳转到页面内指定位置。
参数配置：
- 定位控件：用于明确定位跳转点
- 取消关闭页面
动作描述：关闭当前页面，且不携带返回值。
- 确定关闭页面
动作描述：关闭当前页面，关闭页面为弹窗页面时，在关闭页面之后出参映射生效。
控件行为
| 行为 | 动作描述 | 附图 |
|---|---|---|
| 值操作 | 支持对控件设置值、清空值 |
|
| 高级属性操作 | 支持对控件高级属性：比如标题、占位提示等进行值设置 |
|
| 控件状态 | 支持设置控件状态 |
|
| 控件动作 | 见控件动作详细 | |
| 必填 | 支持设置必填控件和非必填控件有哪些 |
|
| 提示信息 | 支持设置全局提示和跟随控件的提示信息 |
|
| 清空提示 | 可设置清空提示信息，包括全局和跟随控件的提示 |
|
控件动作详细
| 控件 | 控件动作 |
|---|---|
| 单一记录 | 新增：保存并新增记录编辑：编辑指定记录查看：只读状态查看指定记录删除：删除指定记录 |
| 支持数据录入的多记录控件（重复表录入、重复节、树表录入） | 插入行/节：当前行/节下方插入行/节复制行/节：复制当前行/节或选中行/节删除行/节：删除当前行/节或选中行/节 |
| 页签 | 激活规则：会重新执行页签设置的激活规则，适用于发生的事件执行后激活规则执行后，当前激活页签发生变化的情况。 |
| 附件 | 上传附件：调用附件控件的上传能力，支持上传附件下载附件：下载对应附件控件下所有附件内容预览附件：查看指定附件，预览附件内容 |
| 参照 | 打开参照弹窗：打开指定参照控件的内容选择弹窗 |
| …… |
执行页面规则
页面规则是一种可视化的页面逻辑编排工具，可以帮助设计师实现较复杂页面业务逻辑。页面中支持通过事件触发，执行指定的页面规则。
参数配置：
- 选择页面规则：当前页面中已创建的页面规则
- 执行前校验：支持规则执行前进行实体校验
执行生单规则
在应用搭建的过程中，存在上下游实体间的数据流转和映射，在系统中通常会使用生单规则来进行配置上下游实体间的数据流程规则，生单规则的触发方式分为两种，自动触发和手动触发，其中手动触发是指在页面中通过事件配置将控件的触发事件和生单规则进行绑定。事件触发后将执行对应的生单规则。
- 执行生单规则（推单）：上游单据驱动生成下游单据。
- 执行生单规则（拉单）：下游单据驱动拉取上游单据，生成下游单据，单据为草稿状态。
其他
- 扫码：移动端支持配置扫码事件，可设置二维码与条形码事件执行。
- 附件下载：下载对应附件控件下所有附件内容
- 附件预览：查看指定附件，预览附件内容
- 附件上传：调用附件控件的上传能力，支持上传附件
- 单据转文档：可将实体数据转换为附件
- 批量标签打印：可将实体中所有标签进行批量打印