批量发起
未升级到新版信息架构的组织,请 点此查看 使用手册
能力 | 免费版 | 轻享版 | 专业版 | 专属版 |
批量发起流程 | 不支持 | 支持 | 支持 | 支持 |
1. 什么是批量发起
宜搭流程表单,支持应用管理员在应用后台通过上传 Excel 文件来批量发起流程。
当前批量发起支持以下功能:
(1)支持代人发起流程;Excel 中有一列数据是发起人的信息,批量发起流程时可以指定人员列作为流程发起人。
(2)支持「宜搭平台」公共账号发起流程,比如为了跟进外部用户投诉 case 的处理过程,流程发起人则不合适是某个人,而应该是公共账号发起。
(3)支持根据 Excel 中某一列数据动态决定流程的处理人。比如一个记录外部客户跟进信息的一个 Excel,其中一列是跟进人。那么在流程发起时,就可以指定这一列数据作为流程的处理人。
(4)支持按批次删除批量发起的数据,当批量发起失败,或者不符合预期时,可以按批次直接删除数据。
(5)Excel 列数据格式说明。
2. 批量发起案例场景
场景描述:
部门现在想对一个季度以来优秀员工进行奖励,希望每个优秀员工的主管可以给各自的员工写「提名词」。主管写好提名词后,会有消息通知员工来领取礼物。
2.1 操作步骤
2.1.1 先设置好流程表单内需要填写的内容
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639363395514-70708903-95b8-4874-a294-1f27634fc236.png)
流程表单编辑页面
2.1.2 接着设置流程,流程设置中,设置流程发起后,由获奖人主管作为第一个审批人,填写提名词
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639363506982-2f23d606-9bc0-4482-8de5-88bb11d911a1.png)
设置审批人
2.1.3 设置流程结束后,设置好消息通知,发消息给获奖人
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639363613140-bda392c3-1974-4545-ac7a-9ceba2091142.png)
2.1.4 选择 excel 批量发起
excel 文件内容展示如下:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1619077258860-1482c081-71eb-4130-aa17-6c5ef29dd813.png)
excel 批量发起
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639376477381-ee5639aa-b6f9-4c44-a1b1-56275791fe65.png)
数据管理的批量发起
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639377066304-48b02e0d-86dc-4c17-b9fa-e6d693ed95dd.png)
注意:流程批量发起人支持自定义
支持自定义选择以下三种类型作为数据发起人:
①宜搭平台
②当前导入 excel 的用户
③表单中人员搜索框选择的人员(假如人员搜索框选了多个人,默认取第一个人员)(若选择人员搜索框的值作为发起人,但是表单中成员组件的值又为空, 会发起失败,)
展示图为「申请人」为表单中的人员搜索框组件
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639377106977-a78b6f9f-5198-46f9-ba22-d229c911fb93.png)
2.1.5 批量发起结果查询
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639376452466-f206245e-617b-4606-9068-a9d46c45e398.png)
对于错误的数据,点击可直接查看导入失败的数据(成功导入的数据不会展示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639376387963-fb28bd04-904b-4d9d-b4b2-cd7a6fe4bee8.png)
2.1.6 对于导入失败的数据,可以批量删除本批次数据
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639376423704-ffc67f58-7e91-46db-ba17-75a30484595a.png)
删除本批次数据
以上为了演示批量导入的功能,演示的是导入失败的场景,以上导入失败是由于导入的 userid 格式错误,下面演示下成功导入的案例:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1631085102828-f4fcc8b1-e417-43a9-9b9b-20ce477b2064.png)
格式修改正确后,可以成功导入:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639377288949-ce28246f-7a74-4b3c-99bf-97d04e2192b5.png)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639377325326-f8680f7c-cf20-4cb1-9346-5e906e235171.png)
注:成员组件的格式:若用工号导入,格式为 「姓名1(工号),姓名2(工号2)」, 注意,是英文( )
若用「员工 userId」导入,格式为 「姓名1[员工userId],姓名2[员工userId]」, 注意,是英文[ ]
3. 常见问题
3.1 为什么批量发起失败 ?
批量发起失败时,请检查以下问题
(1)应用是否已上线,只有当应用上线后,才能成功批量发起;
(2)发起人是否自定义为表单中的成员组件,若是,检查人员搜索框是否有值,若有值,请检查格式是否正确;
(3)当前最多只允许导入1000 条数据,且文件大小不超过 20MB;
(4)仅支持 (*.xls 和 *.xlsx) 文件;
(5)请确保您需要导入的 sheet 表头中不包含空的单元格,否则该 sheet 页数据系统将不做导入;
(6)批量导入的数据不支持以“内置变量”作为条件的过滤;
(7)导入文件不支持 Excel 公式计算,如 SUM,=H2*J2 等;
(8)目前导入图片/附件会转存,占用一定附件容量
3.2 批量导入时选择发起人为【宜搭平台】后如何进行审批?
当流程表单审批人设置为发起人本人,导入数据将发起人选择【宜搭平台】,那流程数据的审批节点则会显示【宜搭平台】为审批人,并且无法操作审批。
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1644560979186-eea32913-a375-4403-829d-071375e71ac0.png)
此时只能通过下面这个开放接口去执行审批,更多详情可 点击此处 查看。
- 接口: /yida_vpc/process/executePlatformTask.json
- 参数
参数名 | 描述 | 是否必填 | 示例 | 备注 |
appType | 应用ID | 是 | APP_PBKT0MFBEBTDO8T7SLVP | |
systemToken | 应用秘钥 | 是 | hexxyyddd | 在应用数据中获取。 |
userId | 钉钉的userId | 是 | yida_pub_account | 写死 yida_pub_account |
language | 语言 | 否 | zh_CN | 可选值:zh_CN/en_US 默认:zh_CN |
procInstId | 流程实例ID | 是 | f30233fb-72e1-4af4-8cb8-c7e0ea9ee530 | |
outResult | 审批结果 | 是 |
| |
formDataJson | 更新的表单数据 | 否 | 参考:附录1保存/更新 表单数据格式说明。 | |
remark | 审批意见 | 是 | 确认同意 | |
noExecuteExpressions | 是否不执行校验&关联操作 | 否 | y | 本任务节点有绑定校验规则或者关联操作时, y -> 不执行校验规则&关联操作 n -> 执行校验规则&关联操作 不传默认为n,即会执行校验规则&关联操作 |
4. Excel 各组件数据导入格式
如图所示:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1631085380330-23dec0d7-0547-47b3-95b8-98d304c279ea.png)
--------------------欢迎关注我们--------------------
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/jpeg/1631861711706-8b6b606d-26db-4978-8416-d588b2d155c9.jpeg)