业务场景：

为了实现表单与表单之间的数据推送和更新表单历史数据的能力，新增加了“数据推送”功能，用于设置不同的数据推送和推送规则，根据设置的推送规则，推送和更新单据数据。仅有租户管理员和流程审批管理员有权限设置数据推送的内容。

【权限说明】：

（1）普通用户：无权限查看不到数据推送节点

（2）流程审批管理员：设置数据推送的内容

（3）租户管理员：可设置流程审批管理员及设置数据推送的内容

场景分析：

在YS系统中，进行如下操作可完成设置：

1、流程审批管理员设置

（1）路径：数字化建模 > 权限管理 > 授权 > 授权

（2）在搜索框中搜索目标用户，点击【分配角色】，在待分配角色中搜索“流程审批管理员”，点击【>】将其移动到已分配角色中，点击【确定】

2、创建数据推送

进入数据推送节点，点击【新建】，选择表单设置推送规则，维护表单触发方式、明细表设置、推送数据规则，设置后点击【保存并启用】即可

3、启用/停用、修改、删除数据推送

对于创建好的数据推送，点击【停用/启用】、删除、修改即可

4、回写记录

回写记录中记录了数据推送的详细记录，包括推送成功或失败记录，还能查看所有的定时任务列表。点击【回写记录】即可查看

5、定时任务

若在设置数据推送时设置了定时任务，则点击【定时任务】即可查看

操作步骤：

1、流程审批管理员设置

Step1：进入授权节点：数字化建模 > 权限管理 > 授权 > 授权

Step2：在用户检索中搜索目标用户，点击【分配角色】

Step3：在待分配角色中搜索“流程推送管理员”，点击【>】将其移动到已分配角色中

Step4：点击【确定】

效果展示：

设置前，普通用户无法查看数据推送节点

设置后，出现数据推送节点
 

2、数据推送设置

Step1：进入数据推送节点，路径：协同云>协同服务 > 审批 > 流程辅助 > 数据推送

Step2：点击【新建】，创建新的数据推送名称及推送关系（可建立多个表单和其他应用之间的数据推送关系）。

Step3：选择左侧的表单、其他应用（日程、任务），将其拉到画布中，在2个类型之间连接一条线，选择关系类型。

Step4：点击流程中的【+】，设置管理类型

Step5：新建推送规则

点击推送规则设置下的【新建】，创建推送规则

【说明】：

对于关系类型为数据推送的，点击新增弹出推送规则设置窗口，设置具体的推送规则，可同时设置多个推送规则。多个规则之间没有什么关系，每个规则的推送是独立的。所以这里要特别注意的是，不同规则进行的推送一般都不会推送到同一个目标单据实例中。这样的设计的目的主要用于子表行的推送。每个规则可以用不同条件筛选出不同的子表行，进行不同的数据字段推送。

推送规则设置窗口分为三个部分：表单触发设置、明细表设置、推送数据规则设置

（1）表单触发设置

用于设置表单推送时间和触发推送范围

1、单据状态分为单据生效和单据提交

（1）单据生效来源表单的单据审批完成后或提交后才进行数据推送或更新。

（2）单据提交来源表单中，当某个环节审批后才进行数据推送或更新。

（3）单据生效支持每次更新单据提交后做推送。

2、推送时点分为即时推送和定时推送

（1）即时推送按设置的单据状态后立即推送。

（2）定时推送可以按指定日期或表单中的日期字段做一次性或周期性的推送。

3、推送范围分为全部单据、部分单据

（1）全部单据对目标表单中的全部单据进行推送或更新；

（2）若选择了部分单据，则需要设置单据范围

Eg：对加班天数大于三天的表单进行推送，用户可以选择右侧的属性，利用左侧的函数设置逻辑表达式

这个公式有两个作用，以公式中是否使得到了子表字段进行区分。

a) 若公式中有没有使用到子表字段，或来源表单根本就没有子表。这个公式使用来源表单的数据进行公式运算，得到一个结果。若运算结果为true则进行后续的数据推送，若运算结果为false则表示不在推送范围，不进行数据推送。

b) 若公式中使用到了源表单子表字段，且推送数据规则中也有源表单子表字段参与运算。则使用此公式对源表单相关子表中的每个子表行进行检查，每个子表行是否进行一次数据推送，取决于此公式的运算结果。也就是说，每个子表行都用该子表行的数据进行一次计算，只有运算为true的行才进行了数据推送。

（2）明细表设置

若源表单和目标表单都有多个子表，且推送涉及到了子表，那么必须进行设置，以便明确使用哪一个子表数据进行推送。不支持在一条推送规则中同时推送多个子表的数据，如果需要推送多个子表，请新建多个规则。

（3）推送数据规则

用于设置推送的数据，设置哪些数据推送和更新目标单据。支持批量选择字段进行设置。

推送规则中可以设定并匹配需要进行更新或新增的来源表单和目标表单字段

若推送目标字段有子表字段，则会插入子表行。若推送源字段有子表字段，则来源表子表的每行数据进行一次推送。

Step6：保存并启用

点击【保存并启用】，数据推送设置完毕并生效

3、启用/停用、修改、删除数据推送

点击状态下的开关，可以控制数据推送的启用停用，点击删除可以删除数据推送。若需要修改，点击修改后，重新设置数据推送，点击【保存】即可。

4、回写记录

回写记录中记录数据推送的详细记录，包括推送成功或失败记录，还能查看所有的定时任务列表。

点击【回写记录】即可查看

5、定时任务

如果设置了定时推送，可以在定时任务处查看

常见问题：

Q1：为什么创建数据推送时，左侧列表中没有需要的表单？

答：数据推送中涉及的表单需要预先在表单管理中创建，进入【协同云>协同服务 > 审批 > 审批设置 > 表单管理】，按需求创建一个新表单并启用，然后在新建的数据推送中就可以选择该表单了。