下推操作使用说明
变更记录
产品版本 | 更新内容 | 更新日期 |
V7.0 | 增加整单下推控制 增加仅展示符合条件的转换规则控制 | 2024年10月 |
1 简介
1.1 功能介绍
下推操作是指:调用下推界面,用户选择目标单据、转换规则,将源单数据携带到目标单。
1.2 应用场景
配置了单据转换规则的上游单据,通过配置下推操作,就可以实现下推功能。
1.3 设计时配置
路径:【开发服务云】→【应用】→【单据】 →【工具栏】→【下推】
1.4 下推操作属性说明
属性名称 | 属性说明 |
跳过下推界面 | 开启此选项后,用户点击下推时,不显示下推界面,用户不需要自行选择目标单和转换规则,而是直接生成默认的目标单并打开目标单页面。 |
默认目标单据 | 可选择转换路线配置中源单为当前单据的的目标单据。 |
转换规则 | 可选转换规则配置中默认目标单据为目标单,源单为当前单据配置的转换规则。 |
不校验目标单新增权限 | 默认生成目标单时,需要验证目标单的新增权。勾上此选项后,不验证目标单的新增权。仅在已经勾选跳过下推界面选项,指定了默认目标单时,允许勾选此选项。 |
必须手工指定转换规则 | 下推前,必须手工指定转换规则,不允许自动匹配规则。 |
2 运行时操作
单据界面或列表界面选择单据点击【下推】按钮,打开下推界面。
2.1 下推界面属性说明
属性名称 | 属性说明 |
选择单据 | 可选择与当前单据建立转换路线的目标单。 |
转换规则 | 可选择与当前所选目标单已建立的可用、可见的转换规则。 |
业务委托 | 自动计算目标单业务委托组织,也可以选择源单主业务组织。 |
整单转换 | 列表选择分录行下推时,按整张单据执行下推;选单列表选择分录行时,按整张单据执行选单。 |
显示下推失败原因 | 下推报告中展示下推失败的具体原因。 |
失败原因中显示表达式原文(供开发分析) | 失败原因中展示堆栈代码或表达式,供开发定位分析问题。 |
2.2 详细功能说明
1、点击【下推】按钮,弹出下推界面:
选择源单数据支持列表界面选择多张单据。
下推界面的单据选项需校验用户的功能权限:当前用户具备目标单【新增】功能权限的单据可以显示。
批量下推生成多张目标单后,打开下推结果界面。
源单列表开启“分录支持被选择”,支持选择分录执行下推,下推时只携带源单所选择分录至目标单。
2、自动匹配规则说明
选择目标单据后,根据转换路线自动识别启用的转换规则,默认为自动匹配规则,支持用户手工选择转换规则。
对转换路线上,所有的转换规则,按下面的规律排序,找到第一个符合条件的规则执行,其他规则略过:
1. 设置启动条件的转换规则优先匹配,多个有启动条件的规则之间随机排序;
2. 勾选了"默认规则"选项的规则,一条路线只有一个规则可以勾选”默认规则”选项;
3. 未设置启动条件的转换规则,多个未设置启动条件规则之间随机排序;
特例:配置了启用条件,且勾选了”默认规则”选项,优先匹配。
3、展示符合条件的转换规则
源单单据参数中增加参数“仅展示符合条件的转换规则”,用于控制当前单据在执行下推时,转换规则下拉列表中,仅展示符合转换规则中设置启用条件的转换规则。
例如:采购订单到销售订单转换路线存在多个转换规则,转换规则设置启用条件。
采购订单下推销售订单时,转换规则下拉列表仅展示符合启用条件的转换规则。
注意:在单据列表选择多张单据下推时,仅展示启用条件同时满足的转换规则,如果所有转换规则都不同时满足启用条件,则目标单据不会展示。
4、业务委托说明
目标单有主业务组织字段,下推时自动分析转换路线上所有的转换规则,列出所有可选的目标组织:
目标单主组织字段,没有设置取值方式:
1)源单没有主组织字段:自动取用户有新建权的所有组织;
2)源单有主组织字段:根据源单主组织、目标单主组织职能,自动取已经有业务委托关系的目标组织;
目标单主组织字段,直接取源单组织字段值:
1)取所有已选的源单组织值;
2)如果有源单关联组织字段是空值,则尝试根据源单主组织到关联组织的委托关系,自动计算可选委托组织;
目标单主组织字段,取常量
目标单主组织字段,取计算公式,则公式中有没有使用取委托组织函数:
1)有委托函数,根据取委托组织函数中设置的源组织字段,委托关系,取已经有业务委托关系的目标组织;
根据上述规则,如果取出可选的委托组织,则显示出业务委托下拉列表:
1)如果没有找到可选的目标委托组织,不显示业务委托下拉框。
2)如果目标单没有主业务组织字段,不显示业务委托下拉框。
3)可选的组织,必须是当前用户有新增权的组织,且符合组织职能。
4)下推时选择的业务委托组织,是在符合转换规则的前提下,优先采用的组织。实际下推时使用的组织,还是以转换规则设置的为准。
5、整单转换
下推界面开启“整单转换”,列表选择关联实体分录行下推时,一张单据无论选择多少行,都按整张单据所有分录执行下推;
单据参数中也提供单据级参数“整单转换”,控制下推界面“整单转换”是否默认开启且锁定。
6、显示下推失败原因
弹窗展示下推失败详细提示信息。
7、下推结果
下推界面点击【确定】按钮则自动打开目标单新增界面,生成多张目标单时,打开下推结果页面。依据转换关系将数据携带到目标单,至此下推操作已经完成。若生成的下游单据保存成功,则加载对应的反写规则,执行反写规则内容。
下推结果页面工具栏说明:
操作按钮 | 操作及功能说明 |
保存 | 保存当前单据,支持在列表中切换单据,也支持通过右上角导航工具栏切换单据。 |
全部保存 | 保存所有单据,保存校验与单张单据相同,执行全部保存后,刷新生成结果。 |
提交 | 提交当前单据 |
全部提交 | 提交所有单据,提交校验与单张单据相同,建议先执全部行保存操作,在执行全部提交操作。 |
审核 | 审核当前单据 |
全部审核 | 审核所有单据,审核校验与单张单据相同,已兼容提交自动审核参数,建议全部提交之后再执行全部审核, |
打开列表 | 打开目标单单据列表,仅展示下推结果页面已经生成的目标单 |
生成结果列表说明:
字段名称 | 字段说明 |
保存状态 | 默认值为未保存,执行保存后刷新列表状态,并生成单据编号。 |
单据状态 | 与当前单据的状态一致,单据执行状态转换操作后,自动刷新列表中的单据状态值。 |
编号 | 单据保存成功后,生成单据编号 |
下推操作使用说明
本文2024-09-23 00:24:03发表“云苍穹知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-cangqiong-139221.html