BOTP监控中心

栏目：云苍穹知识作者：金蝶来源：金蝶云社区发布：2024-09-23浏览：1

BOTP监控中心

1 简介

1.1 功能介绍

单据转换和单据反写，整个过程逻辑比较复杂，出现异常问题时，排查定位问题原因时经常遇到困难。为此，标准产品提供了监控中心功能，输出单据转换过程中重要的节点信息，以方便排查问题，尤其是较难排查的二开插件问题。

监控范围：单据转换（下推参数、关联关系、二开插件），反写（二开插件）。

1.2 应用场景

单据转换和单据反写过程中，出现下推失败、上下查失败、下游单无法反写上游单、反写异常等场景，可以辅助排查出现问题的原因。

1.3 适用版本

V5.0.011

1.4 系统路径

单据转换：

【开发服务云】→【单据转换开发】→【监控报告】 →【单据转换报告】

单据反写：

【开发服务云】→【单据转换开发】→【监控报告】 →【单据反写报告】

1.5 关键字段/按钮说明

关键字段说明（单据转换报告、单据反写报告）

字段名称	详细解释
模块key	当前报告属于哪个模块，比如下推或者反写，分别是push或writeback
唯一标识	某个模块报告的唯一标识，模块key加唯一标识在单据转换报告记录中是唯一的
状态	当前报告状态，有以下几种状态：待生成、生成中、已完成、生成失败
任务id	一次操作的唯一标识，比如下推可能选择很多单据，在报告表中就会有很多记录，可以通过任务id关联所有该次操作的单据报告
traceid	该次操作的traceid，方便后续查看monitor日志，以定位问题

2 生成报告

2.1 单据转换报告

1、转换规则高级选项打开“生成报告”开关，单据在执行单据转换时生成报告。

2、打开单据转换报告列表，支持下载需要查看的报告。

3、单据转换报告的主要内容，包含三个模块：下推参数、转换规则插件、关联关系。当下推出现异常时可根据此报告协助排查。

4、报告详情

• 下推参数

参数	参数描述	参数值
DefOrgId	默认组织	null
hasRight	是否忽略鉴权	false
appId	应用id	4c1y_sample_purchase_zlh
ruleId	转换规则id	1478873531100966912
customParams	自定义参数	{"bos_support_bigdata_aysn":"true","filterselectedvalues":"rO0ABXNyABFqYXZhLnV0aWwuSGFzaE1hcAUH2sHDFmDRAwACRgAKbG9hZEZhY3RvckkACXRocmVzaG9sZHhwP0AAAAAAAAB3CAAAABAAAAAAeA==","botp_requiredatamutex":"true","ishasright":"true","specialdataperm_currentappid":"4c1y_sample_purchase_zlh","mulilangtext.emptyfill.enable":null,"islistviewop4mutex":"true","ignoreassignperson":"false"}
autoSave	方法上的自动保存	false

• 转换规则插件

接口	参数	参数描述	参数值
afterBuildQueryParemeter	ignoreRuleFilterPolicy	是否忽略转换规则配置的数据筛选条件	false
beforeBuildGroupMode	headGroupKey	单据头分组(分单)字段	id
beforeBuildGroupMode	entryGroupKey	单据体分组字段	entryentity.id
beforeBuildGroupMode	subEntryGroupKey	子单据体分组字段	entryentity.id
afterBuildQueryParemeter	qFilters	取数条件	[{"property":"id","cp":"in","value":[1513085650511918080],"expressValue":false,"existsFilter":false,"parseExistsValue" :false,"properties":["id"],"onMetaJoinPropertyFilter":false,"originValue":[1513085650511918080],"joinHint":"LEFT","joinFilter":false,"joinSQLFilter":false}]
beforeGetSourceData	selectSQL	取数select子句	id,billno,entryentity.id f2,entryentity.seq f3,org f4,entryentity.orderedqty f5,entry entity.unit f6,entryentity.price f7,supplier f8,entryentity.requiredate f9,currency f10,entryentity.materia f11,entryentity.model f12,entryentity.applyqty f13,entry entity.status f14
beforeGetSourceData	qFilters	取数条件	[{"property":"id","cp":"in","value":[1513085650511918080],"expressValue":false,"existsFilter":false,"parseExistsValu e":false,"properties":["id"],"onMetaJoinPropertyFilter":false,"originValue":[1513085650511918080],"joinHint":"LEFT","joinFilter":false,"joinSQLFilter":false}]
afterGetSourceData	sourceRows	筛选后的源单行	[1513085650511918080]
beforeCreateLink	cancel	是否取消记录关联关系	false

• 关联关系

目标单	lk信息
1518831678624263168	stableid:1489132905899895809sbillid:1513085650511918080sid:1513085650511917056;

2.2 单据反写报告

1、路径：【公共设置】->【参数配置】->【单据参数】，找到需要生成反写报告的目标单据，打开“反写生成报告”开关。

2、执行操作生成报告，比如反写规则配置的“保存时反写”，则在保存时会生成报告。

3、打开单据反写报告列表，支持下载需要查看的报告。

4、单据反写报告，记录了二开插件干预后各个对象的值，当反写异常时，方便根据报告排查是否二开插件导致的反写异常。

5、报告详情

每个表格上面有个标题，标题有两种，其中有两个“_”分隔符的，分别是：反写插件、目标单内码、反写插件方法；有一个“_”分割符的，分别是：反写插件、反写插件方法。

• kd.bos.entity.botp.plugin.AbstractWriteBackPlugIn_1518831678624263168_beforeCloseRow，行关闭之前插件方法

接口	参数	参数描述	参数值
beforeCloseRow	cancel	略过超额检查	false

• kd.bos.entity.botp.plugin.AbstractWriteBackPlugIn_beforeExecWriteBackRule，执行反写规则之前插件方法

接口	参数	参数描述	参数值
beforeExecWriteBackRule	cancel	取消当前反写规则的执行	false

• kd.bos.entity.botp.plugin.AbstractWriteBackPlugIn_1518831678624263168_afterCloseRow，行关闭之后插件方法

接口	参数	参数描述	参数值
afterCloseRow	rule	反写规则	1493524228371161088
afterCloseRow	srcSubMainType	源单主实体	4c1y_purreqa_zly
afterCloseRow	srcEntity	源单关联主实体	entryentity
afterCloseRow	srcActiveRow	源单关联主实体数据行	1513085650511917056
afterCloseRow	targetEntity	目标单关联主实体	entryentity
afterCloseRow	targetActiveRow	目标单关联主实体数据行	1518831822589552640
afterCloseRow	closeRow	是否达成行关闭条件	false

• kd.bos.entity.botp.plugin.AbstractWriteBackPlugIn_1518831678624263168_beforeExcessCheck，超额检查之前插件方法

接口	参数	参数描述	参数值
beforeExcessCheck	cancel	取消超额检查	false

• kd.bos.entity.botp.plugin.AbstractWriteBackPlugIn_1518831678624263168_beforeCreateArticulationRow，构建关联关系之前二开插件方法

接口

参数

参数描述

参数值

beforeCreateA

rticulationRow

cancel

是否创建本行的关联记录

目标单id:1518831678624263168,分录id:1518831822589552640,参数cancel:false

beforeCreateA

rticulationRow

cancelReDis

tributeAmount

取消系统分配反写量

cancelReDistributeAmount：false,lk信息：[{"id":1518831822589553664,"seq":1,

"entryentity_lk_stableid":1489132905899895809,"entryentity_lk_sbillid":151308

5650511918080,"entryentity_lk_sid":1513085650511917056,"entryentity_lk_app

lyqty_old":10.0000,"entryentity_lk_applyqty":10.0000}]

• kd.bos.entity.botp.plugin.AbstractWriteBackPlugIn_1518831678624263168_afterCommitAmount，反写量更新到源单之后二开插件方法

接口	参数	参数描述	参数值
afterCommitAmount	rule	反写规则	1493524228371161088
afterCommitAmount	srcSubMainType	源单主实体	4c1y_purreqa_zly
afterCommitAmount	srcEntity	源单关联主实体	entryentity
afterCommitAmount	srcActiveRow	源单关联主实体数据行	1513085650511917056
afterCommitAmount	srcFieldKey	源单反写字段	orderedqty
afterCommitAmount	currVal	对源单行执行的反写差量	10.0000
afterCommitAmount	realVal	操作执行完对源单行的反写总量	10.0000
afterCommitAmount	currCVal	覆盖反写值	null
afterCommitAmount	targetEntity	目标单关联主实体	entryentity
afterCommitAmount	targetActiveRow	目标单关联主实体当前数据行	1518831822589552640

• kd.bos.entity.botp.plugin.AbstractWriteBackPlugIn_1518831678624263168_afterExcessCheck，超额检查之后二开插件方法

接口	参数	参数描述	参数值
afterExcessChec	excess	是否超额是否提示超额	false
afterExcessChec	message	超额提示	null

• kd.bos.entity.botp.plugin.AbstractWriteBackPlugIn_1518831678624263168_afterCalcWriteValue，反写值计算完毕后二开插件方法。

接口	参数	参数描述	参数值
afterCalcWriteValue	单据信息	单据信息	目标单id:1518831678624263168,目标单分录:1518831822589552640,源单信息：{"{\"mainTableId\":1489132905899895808,\"billId\":1513085650511918080,\"tableId\":1489132905899895809,\"entryId\":1513085650511917056,}":10.0000}
afterCalcWriteValue	rule	反写规则	1493524228371161088
afterCalcWriteValue	val	反写量	10.0000
afterCalcWriteValue	cVal	覆盖反写量	null