余额巡检重算

栏目：云星瀚知识作者：金蝶来源：金蝶云社区发布：2024-09-22浏览：1

余额巡检重算

变更记录

产品版本	更新内容	更新日期
V5.0.014	初始版本	2023.7.1

1 简介

1.1 功能介绍

余额巡检重算是一个用于检查、修复余额数据一致性问题的模型工具。

1.2 应用场景

在任何系统中，一方面因系统BUG、服务异常是无法绝对避免，另一方面，由于某些人员在系统进行了某些不合理的操作时，会导致一些整体数据一致性问题，余额作为一个高频写，高频读，与业务单据操作紧密联系的业务，很难避免数据一致性问题。通过以往客户问题的分析发现，有90%以上是业务使用问题导致。比如：配置配错了、中途发现方案要调整、后台改数据了、二开代码未考虑一致性设计等等，这些问题，最初可能在报表系统，或存货系统中得以发现，余额与单据之间出现了数据一致性问题，最终影响业务操作，比如：财务结账、库存出库。

当发现数据一致性问题后，就可以使用此工具修复数据。

1.3 系统路径

【开发服务云】→【余额模型】→【巡检重算】 →【余额巡检重算】

1.4 关键字段/按钮说明

关键字段说明

字段名称	详细解释
任务编号	录入编号，便于后续查询
任务类型	定义本次巡检任务的查询方式，主要使用前两种：检查单据生成快照：以单据出发检查快照是否正确，可用于业务上认为单据需要更新余额，但系统并没有更新，又或者数量、维度不一致的问题检查单据删除或回滚：反过来以快照检查单据，发现快照还在但单据已经不存在的问题检查快照合计余额：检查快照合计数量与余额数量是否一致，期间余额期初和结存数量是否连续，期间是否连续的问题清除已回滚的快照：有的余额表选择了保留历史快照的方式，在系统运行一段时间后，如果存量数据很大，可以使用此选项来清除已回滚状态的快照
操作范围	增量操作：读取“增量标记”接着上次巡检完的单据开始本次巡检，用于减少巡数据量，“增量标记”相关介绍详见全量操作：检查所有单据按单据条件操作：可按单据字段设置过滤条件，缩小巡检范围按余额条件操作：可按余额表字段设置过滤条件，缩小巡检范围
余额表实体	定义需要巡检的余额表，为必录项
单据实体	定义需要巡检的单据实体，非必录
余额规则	定义具体的余额更新规则，非必录
操作原因	用于备注本次巡检的目的或原因
余额条件：	当操作范围设置为“按余额条件操作”时，可以设置余额表中字段作为过滤条件
单据条件：	当操作范围设置为“按单据条件操作”时，可以设置单据中字段作为过滤条件

关键按钮说明

按钮名称	详细解释
发布子任务	按已设置的参数和条件范围发起本次巡检任务，巡检的数据量大或范围广时，系统自动按一定规则拆分成多个子任务执行
查看子任务	发布子任务后，通过次按钮联查所有的子任务，可对有差异的子任务操作数据修复，“子任务”相关介绍详见

1.5 注意事项

1）余额巡检重算，作为一个人工补偿手段，它无法指导业务本身的准确性（比如：余额需要几个维度，余额规则要怎么配置，单据数据有没有做正确等），这些都是业务本身决定，不同的客户需求配置就不一样。因此执行余额巡检重算的一个大前提就是默认：业务单据数据、余额相关的配置（如：余额表、余额规则、重算条件等）都是正确的。

2）余额巡检重算，是数据修复的工具，无法解决引起余额不一致的根本问题，尽量要定位到根本问题并修复后再修复余额，否则问题会不断出现。

3）修复数据要考虑所有余额表，比如库存单据有可能同时更新即时库存余额、库存期间余额、核算期间余额、总量预留余额等多个表，那么在修复数据时要根据实际情况把有问题的表都同时修复。

4）修复数据要考虑流程中上下游数据的一致性，比如修复了库存单据的数据，那么其与上游订单、下游的存货核算、应收应付数据是否一致。

5）余额重算是一个调度任务，在千万级别以上数据量情况下，发布子任务过程可能会耗时较长（长的有1-2分钟），出现长时间转圈的情况，这是正常情况。不要重复点击，可返回列表刷新查看是否发布成功。