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 |
afterClo |
BOTP监控中心
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
