> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 批量发起

> 本文介绍了宜搭流程表单的批量发起功能，包括支持的功能、操作步骤、案例场景以及常见问题解答。

| **能力** | **免费版** | **轻享版** | **专业版** | **专属版** |
| ------ | ------- | ------- | ------- | ------- |
| 批量发起流程 | 不支持     | 支持      | 支持      | 支持      |

## 1. 什么是批量发起

宜搭流程表单，支持应用管理员在应用后台通过上传 Excel 文件来批量发起流程。

当前批量发起支持以下功能:

（1）支持代人发起流程；Excel 中有一列数据是发起人的信息，批量发起流程时可以指定人员列作为流程发起人。

（2）支持「宜搭平台」公共账号发起流程，比如为了跟进外部用户投诉 case 的处理过程，流程发起人则不合适是某个人，而应该是公共账号发起。

（3）支持根据 Excel 中某一列数据动态决定流程的处理人。比如一个记录外部客户跟进信息的一个 Excel，其中一列是跟进人。那么在流程发起时，就可以指定这一列数据作为流程的处理人。

（4）支持按批次删除批量发起的数据，当批量发起失败，或者不符合预期时，可以按批次直接删除数据。

（5）Excel 列数据格式说明。

## 2. 批量发起案例场景

**场景描述：**

部门现在想对一个季度以来优秀员工进行奖励，希望每个优秀员工的主管可以给各自的员工写「提名词」。主管写好提名词后，会有消息通知员工来领取礼物。

### 2.1 操作步骤

#### 2.1.1 先设置好流程表单内需要填写的内容

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639363395514-70708903-95b8-4874-a294-1f27634fc236.png)
</Frame>

流程表单编辑页面

#### 2.1.2 接着设置流程，流程设置中，设置流程发起后，由获奖人主管作为第一个审批人，填写提名词

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639363506982-2f23d606-9bc0-4482-8de5-88bb11d911a1.png)
</Frame>

设置审批人

#### 2.1.3 设置流程结束后，设置好消息通知，发消息给获奖人

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639363613140-bda392c3-1974-4545-ac7a-9ceba2091142.png)
</Frame>

#### 2.1.4 选择 excel 批量发起

excel 文件内容展示如下：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1619077258860-1482c081-71eb-4130-aa17-6c5ef29dd813.png)
</Frame>

excel 批量发起

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639376477381-ee5639aa-b6f9-4c44-a1b1-56275791fe65.png)
</Frame>

数据管理的批量发起

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639377066304-48b02e0d-86dc-4c17-b9fa-e6d693ed95dd.png)
</Frame>

**注意：流程批量发起人支持自定义**

支持自定义选择以下三种类型作为数据发起人:

①宜搭平台

②当前导入 excel 的用户

③表单中人员搜索框选择的人员(假如人员搜索框选了多个人，默认取第一个人员)(**若选择人员搜索框的值作为发起人，但是表单中成员组件的值又为空, 会发起失败，**)

展示图为「申请人」为表单中的人员搜索框组件

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639377106977-a78b6f9f-5198-46f9-ba22-d229c911fb93.png)
</Frame>

#### 2.1.5 批量发起结果查询

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639376452466-f206245e-617b-4606-9068-a9d46c45e398.png)
</Frame>

对于错误的数据，点击可直接查看导入失败的数据(成功导入的数据不会展示)

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639376387963-fb28bd04-904b-4d9d-b4b2-cd7a6fe4bee8.png)
</Frame>

#### 2.1.6 对于导入失败的数据，可以批量删除本批次数据

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639376423704-ffc67f58-7e91-46db-ba17-75a30484595a.png)
</Frame>

删除本批次数据

以上为了演示批量导入的功能，演示的是导入失败的场景，以上导入失败是由于导入的 userid 格式错误，下面演示下成功导入的案例：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1631085102828-f4fcc8b1-e417-43a9-9b9b-20ce477b2064.png)
</Frame>

格式修改正确后，可以成功导入：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639377288949-ce28246f-7a74-4b3c-99bf-97d04e2192b5.png)
</Frame>

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639377325326-f8680f7c-cf20-4cb1-9346-5e906e235171.png)
</Frame>

**注**：成员组件的格式：若用工号导入，格式为 「**姓名1(工号)，姓名2(工号2)**」,  注意，是英文( )

若用「员工 userId」导入，格式为 「**姓名1\[员工userId]，姓名2\[员工userId]**」, 注意,是英文\[ ]

## 3. 常见问题

<AccordionGroup>
  <Accordion id="q1" title="3.1 为什么批量发起失败 ？">
    批量发起失败时，请检查以下问题

    （1）应用是否已上线，只有当应用上线后，才能成功批量发起；

    （2）发起人是否自定义为表单中的成员组件，若是，检查人员搜索框是否有值，若有值，请检查格式是否正确；

    （3）当前最多只允许导入1000 条数据，且文件大小不超过 20MB；

    （4）仅支持 (\*.xls 和 \*.xlsx) 文件；

    （5）请确保您需要导入的 sheet 表头中不包含空的单元格，否则该 sheet 页数据系统将不做导入；

    （6）批量导入的数据不支持以“内置变量”作为条件的过滤；

    （7）导入文件不支持 Excel 公式计算，如 SUM，=H2\*J2 等；

    （8）目前导入图片/附件会转存，占用一定附件容量
  </Accordion>

  <Accordion id="q2" title="3.2 批量导入时选择发起人为【宜搭平台】后如何进行审批？">
    当流程表单审批人设置为发起人本人，导入数据将发起人选择【宜搭平台】，那流程数据的审批节点则会显示【宜搭平台】为审批人，并且无法操作审批。

    <Frame>
      ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1644560979186-eea32913-a375-4403-829d-071375e71ac0.png)
    </Frame>

    此时只能通过下面这个开放接口去执行审批，更多详情可 [**点击此处**](https://www.yuque.com/yida-old/help/ihxi9r#evqcsm) 查看。

    * 接口: /yida\_vpc/process/executePlatformTask.json
    * 参数

    | **参数名**              | **描述**       | **是否必填** | **示例**                               | **备注**                                                                                      |
    | -------------------- | ------------ | -------- | ------------------------------------ | ------------------------------------------------------------------------------------------- |
    | appType              | 应用ID         | 是        | APP\_PBKT0MFBEBTDO8T7SLVP            | <br />                                                                                      |
    | systemToken          | 应用秘钥         | 是        | hexxyyddd                            | 在[应用数据](https://www.yuque.com/yida/help/wre21z#qOo9q)中获取。                                   |
    | userId               | 钉钉的userId    | 是        | yida\_pub\_account                   | 写死 yida\_pub\_account                                                                       |
    | language             | 语言           | 否        | zh\_CN                               | 可选值：zh\_CN/en\_US<br />默认：zh\_CN                                                            |
    | procInstId           | 流程实例ID       | 是        | f30233fb-72e1-4af4-8cb8-c7e0ea9ee530 | <br />                                                                                      |
    | outResult            | 审批结果         | 是        | • agree<br />• disagree              | <br />                                                                                      |
    | formDataJson         | 更新的表单数据      | 否        | <br />                               | 参考：附录1保存/更新 表单数据格式说明。<br />参数有的组件更新，没有的组件保持不变。<br />明细的值只能统一更新，无法只更新明细下某个组件的值               |
    | remark               | 审批意见         | 是        | 确认同意                                 | <br />                                                                                      |
    | noExecuteExpressions | 是否不执行校验&关联操作 | 否        | y                                    | 本任务节点有绑定校验规则或者关联操作时，<br />y -> 不执行校验规则&关联操作<br />n -> 执行校验规则&关联操作<br />不传默认为n，即会执行校验规则&关联操作 |
  </Accordion>
</AccordionGroup>

## 4. Excel 各组件数据导入格式

如图所示：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1631085380330-23dec0d7-0547-47b3-95b8-98d304c279ea.png)
</Frame>
