# e-builder评论操作事件

来源快照：`result_data_new_260518.json`

- 来源 ID：`1256722325796118599`
- 模块：低代码平台e-builder
- 目录：动作流 - 触发事件 - e-builder事件触发
- space ID：`1157961794811633670`
- 原文链接：未提供
- 产品基线：未提供

## 正文

一、

# 功能介绍

低代码平台e-builder建模表单提供了标准化触发组件和执行组件，用户可使用这些组自由编排设计动作流，实现建模表单和各模块之间的自动化业务处理和数据交互。

组件类型| 组件名称| 描述  
---|---|---  
触发组件| 点击按钮时| 点击表单按钮时触发，系统按钮支持按钮执行前触发  
表单数据触发| 表单数据发生新增、删除、更新时触发，可覆盖按钮操作和动作流执行等不同情形导致的数据变化  
e-builder评论操作事件| 在EB的表单评论以及页面的评论组件中发表和编辑评论可以触发动作流  
执行组件| 更新表单数据| 支持一对一、一对多、多对多数据更新  
新建表单数据| 支持单个新增和批量新增  
删除表单数据| 支持单个删除和批量删除  
获取表单数据详情| 获取指定ID的单个表单数据详情  
还原表单| 还原指定ID的单个表单数据  
存为版本| 对指定的e-Builder应用下的表单数据存为版本  
  
二、

# 使用说明

## 触发组件

### 点击按钮时

#### 功能介绍

点击按钮时触发能和EB 表单系统按钮和自定义按钮绑定，监听表单按钮点击事件自动执行。系统按钮的触发位置支持执行前和执行后，执行前常和终止组件的“阻止触发模块后续操作 ”配置项搭配使用，作用于数据校验场景，如数据删除前进行规则校验，校验失败阻止删除操作。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320638449565703&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

批量勾选数据点击按钮后如何触发动作流支持依次触发、并行触发、合并触发三种。

**依次触发：** 批量勾选多条数据触发按钮事件时，动作流分多次执行生成多条执行记录，每次只传入一条数据给下文组件；动作流执行时按照先后顺序，上一条执行完毕才开始下一条。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320638511317000&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320638511317008&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**并行触发：** 批量勾选多条数据触发按钮事件时，动作流分多次执行生成多条执行记录，每次只传入一条数据给下文组件；动作流执行时无先后顺序，多条数据异步处理。

注意：数据持续累加累减的场景不适合用并行触发，如活动报名表点击批量删除按钮删除某活动的报名信息时需要将活动基础信息的报名人数同步-1，该场景不适用并行触发。假设初始报名人数是20，批量删除5个报名信息，依次触发会经历5次-1，最终变成15；而并行触发，会5条数据同时进行-1计算也就是20-1=19，报名人数最终变成19。

**合并触发：** 批量勾选多条数据触发按钮事件时，动作流只执行一次生成一条记录，勾选数据以数组的形式传入给下文组件，适用于需要勾选多条数据写入明细表、数据需要先分组汇总再处理、数据需要多选校验等场景。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320638511317014&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320638511317023&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 场景案例

##### 场景介绍：

批量删除项目前对项目待删除项目分别进行校验，项目如果存在关联任务正在进行中，则提示该项目不允许删除。要求若勾选的项目存在一个未通过校验，就阻止本次批量删除并提示原因，不必所有项目都校验完毕后再抛出报错。

 

##### 操作步骤：

**1.点击表单系统按钮批量操作执行前触发，对多个项目合并处理**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320642672066566&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**2.添加循环组件对多选项目依次校验**

循环方式选择按明细循环，对象选择触发组件项目表单勾选对象集合。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320642665775111&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

循环内添加数据源查询组件查询项目任务表中是否有属于当前项目且仍在进行中的任务，启用返回数量需要根据数量字段判断校验结果。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320642665775117&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

注意：设置查询条件时，项目任务表单的所属项目是个关联eb单选字段，只能和单个项目表数据ID比较，当循环方式是按明细数据时可以直接从循环组件下取得当前循环批次的单个数据；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320642721570828&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

如果从触发组件获取项目ID，默认获取到的是数据ID【全部】（此时会因为条件两边的数据类型不符而永远查不到满足条件的数据，无法获取真实的校验结果），必须手动给项目数据ID集合对象加上下标【已循环次数】。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320642672066589&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320642665775135&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**3.添加分支组件判断校验结果**

如果数据源查询组件返回的数量大于0说明存在进行中的项目任务，添加应用变量暂存校验失败的项目名称，并跳出循环，提前结束校验；反之继续校验下一个项目。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320647033315331&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**4.循环外添加条件分支判断是否执行删除**

如果删除失败的项目名称为空说明校验通过，正常删除所有勾选项目；反之代表存在项目不允许删除，分支下添加结束组件输出失败状态并提示具体哪个项目不允许删除，阻止批量删除操作。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320647033315339&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 表单数据触发

#### 功能介绍

表单数据触发可实现当表单数据发生新增、删除、更新，且满足一定的条件时触发动作流。和按钮触发的区别在于，以数据更新为例：表单数据触发可以监听到各种来源、各类事件导致的更新动作（在编辑布局修改数据点击编辑保存按钮、动作流执行组件更新表单数据等）。点击按钮只能监听到当前表单布局上点击编辑保存按钮更新表单数据的情形，经过其他动作流更新表单数据的情形监听不到。

20260201基线新增指定任意字段值发生变化触发动作流功能：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1245507371586953222&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

详细功能介绍参考：[https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1245316644969693185&freepass_doc=1&space_id=1157961794811633670](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1245316644969693185&freepass_doc=1&space_id=1157961794811633670)

 

#### 场景案例

##### 场景介绍：

在项目管理中，项目进展更新、项目变更流程和项目验收汇报流程结束之后都会更新项目信息，每次更新都需要提醒项目的参与人项目发生变更，请及时关注。此场景通过表单数据触发实现只需一条动作流即可，如果用流程触发就要创建三条动作流。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320647042531342&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

##### 操作步骤：

新建动作流触发组件选择表单数据触发，执行组件选择消息提醒，当项目信息表发生变更后向项目负责人发送消息提醒关注项目变动。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320647042531352&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### e-builder评论操作事件

#### 功能介绍

##### 1、EB表单评论

在EB表单的评论中，点击发表评论或者编辑评论可添加对应的动作流，触发组件为e-builder操作事件，该触发组件只可以在表单评论这点击新建动作流才可以，动作流处新建动作流是选择不到该触发组件的；设置动作流后启用后发表和编辑评论就会触发该动作流。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256728484859658245&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256728557924433922&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256728781239885829&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256728923066605569&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

批量勾选对评论的触发事件可以设置触发条件，即只有满足条件的数据，发表或者编辑评论才会触发该动作流，否则是不会触发的，触发应用和评论来源以及触发事件是只读不允许修改的。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256729494197059593&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

在评论设置中选择动作流时，只可以选择当前表单所对应的触发组件是e-builder评论操作事件的动作流，动作流且是需要启用才可以

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256731199211880451&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

e-builder评论操作事件上下文中可以获取到当前评论的表单数据的基本信息，也可以获取到评论数据的信息

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256731594323705860&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

##### 2、页面评论组件评论

在页面的评论组件中，也可设置发表评论或者编辑评论，可添加对应的动作流，触发组件为e-builder操作事件，该触发组件只可以在页面评论组件这点击新建动作流才可以，设置动作流后启用后在页面评论中发表和编辑评论就会触发该动作流，功能和表单评论的功能一致

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256730258675605516&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 场景案例

##### 场景介绍：

用户对表单数据进行评论时，需要给对应表单字段的人员发送消息提醒，且提醒信息需要包含评论的内容以及评论人。

 

##### 操作步骤：

**1.在表单评论中的发送评论添加评论动作流**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256742477890592786&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256742546636226590&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**2.在e-builder评论操作事件下面添加消息提醒组件**

消息提醒选择IM提醒，提醒标题可自行定义，提醒内容可设置为：xxx评论了你的数据，评论内容为：xxx，请点击查看。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256743066268082184&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

其中param1为评论人，需要从触发组件的评论表中选择创建者字段，但创建者传来的是人员id，需要通过函数GETHRMNAME获取到人员姓名

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256743508663648258&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

param2为评论内容，需要从触发组件的评论表中选择评论内容字段

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256744015572770820&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)  
PC端链接地址为打开EB数据的地址，地址后面的#{dataId}为当前评论数据的数据ID，需要从从触发组件的表单数据中选择数据ID字段

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256744543666880515&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

消息的发送人为评论的创建者，需要从触发组件的评论表中选择创建者字段

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256744908707864583&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

消息的提醒对象为当前评论的数据中的人员字段值，需要从触发组件的表单数据中选择人员选择字段

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256745054759600133&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

##### 执行效果：

配置后，用户发表评论则会发送对应的消息提醒

![](https://weapp.eteams.cn/papi/file/preview?fileId=1256746021221834756&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 

## 执行组件

### 更新表单数据

更新表单数据可实现更新e-builder表单数据，支持多种更新方式。

[ _点击查看更新表单数据组件帮助文档_](https://www.e-cology.com.cn/sp/doc/docShare/1133915252239837000?tenantKey=t7akvdnf84)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320647033315368&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 新建表单数据

新建表单数据组件用于向e-builder表单新增单条数据或批量新增多条数据，常用于流程转数据等场景。

[ _点击查看新建表单数据帮助文档_](https://www.e-cology.com.cn/sp/doc/docShare/1133915162011665465?tenantKey=t7akvdnf84)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320647033315374&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

###  删除表单数据

删除表单数据组件用于删除指定e-builder应用下的表单数据，常用于关联数据的删除，以及废弃数据的定时清理。

[ _点击查看删除表单数据帮助文档_](https://www.e-cology.com.cn/sp/doc/docShare/1133915054579066755?tenantKey=t7akvdnf84)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320651477073923&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

###  获取表单数据详情

获取表单数据详情组件，是指通过上下文将表单的数据id传入之后，查询该条数据的详细信息，之后可以用查到的数据做一些更新数据或消息提醒等动作 。

[ _点击查看获取表单数据详情帮助文档_](https://www.e-cology.com.cn/sp/doc/docShare/1133914938698834285?tenantKey=t7akvdnf84)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320651356373002&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 触发逻辑流

### 还原表单

还原表单数据组件用于还原指定e-builder应用下的表单数据，常用于一些关联数据的还原。例如有“合同表”与“合同付款表”。当合同表中的某条合同状态，从“废弃”改为“正常”时，付款表中对应的合同付款数据，从回收站中还原回来。

[ _点击查看还原表单数据帮助文档_](https://www.e-cology.com.cn/sp/doc/docShare/1133914809757239460?tenantKey=t7akvdnf84)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320651303116814&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

###  存为版本

存为版本组件，是指通过上下文将对应可存版本的表单的数据id传入之后，对该条信息进行存为版本，之后可以用上下文数据做一些更新数据或消息提醒等动作 。

[ _点击查看存为版本帮助文档_](https://www.e-cology.com.cn/sp/doc/docDetail/1156467090533654646___emUid=6490972622571858268&_isEm=1)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163320651463327757&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

三、

# 常见问答
