EAS税务补丁更新全流程
一、补丁获取
1.1 补丁发放说明:
82 | 82开收票补丁介绍合辑 |
85 | 85开收票补丁介绍合辑 |
861 | 861开收票补丁介绍合辑 |
88 | 88开收票补丁介绍合辑 |
全电发票:开票、应付集成全电、GUI支持全电、全电勾选、统计。
二、补丁更新规范:
2.1 检查私包
2.1.1 检查元数据私包
①通过服务工具平台查询
右上角搜索服务工具平台--类加载查看功能—左侧下拉框选择元数据—输入元数据全路径查询。
②财务会计—出纳管理—收付款管理—收款单/付款单单据—界面上按快捷键ctrl + shift + A,打开查询界面。
定位元数据加载位置,客户端FMClientHelper.locateMetaClt("")
定位元数据加载位置,服务端FMClientHelper.locateMetaSvr("")
双引号中填入元数据路径—“脚本-选中”按钮
2.1.2 检查类私包
①通过查询分析器查询类加载路径
查询分析器进入方式:右上角搜索“md0402”打开币别菜单,在币别菜单按快捷键ctrl + shift + Q,输入管理员密码后进入。
查询类加载操作:更多工具—客户端类加载路径/服务端类加载路径—输入类的全路径,末尾加.class
如类路径中包含“app”,则查询服务端类加载路径;
如类路径中包含“client”,则查询客户端类加载路径;
如均未包含,二者选其一。
查询结果如下图:
路径为lib/patch:意味着类加载自标准产品补丁
路径为lib/sp或lib/industry:类加载自私包
②通过服务工具平台查询路径
右上角搜索服务工具平台--类加载查看功能—输入类名(全路径, 不用加class,不需要管理员密码)
③通过服务工具平台,查看服务端文件
有时,我们并不知道具体的类名,此时需要检查服务端路径下的jar文件,才能分析是否有类私包。
右上角搜索服务工具平台—服务端文件浏览—输入管理员密码—查看server/lib/sp或server/lib/industry路径下的jar包,是否包含本模块的关键字,TM/IM,如包含则可能为税务模块的私包。
如下图,包含TM、IM则很可能为税务模块有关的私包。
④通过服务器路径查找:
1、元数据私包路径:
\server\metas\sp
\server\deploy\fileserver.ear\easWebClient\metas\sp
2、后台代码私包路径:
\server\lib\sp
\server\deploy\fileserver.ear\easWebClient\lib\sp
3、Web查看私包:
http://IP:PORT/easweb/dynamicPage.do?event=initialize&method=doEvent&uipk=com.kingdee.eas.webDev.webDevTools&waf2skin=easbase&inwafpage=false&debug=true。(IP、PORT填自己的)
2.2 存在私包时如何处理
2.2.1 先分析是否是标准私包,如果是,请查看上方的补丁介绍合辑是否已包含;如已包含,请卸载。
三、补丁更新报错:
3.1 脚本报错
第一步,分析是否表不存在;如果是,大概率是主键约束冲突导致创表失败,可以云之家咨询总部老师或提单。
第二步,分析是插入数据报错;可能是字段类型不一致等。
3.2 私包冲突
如果经过上面排查后,还提示私包冲突,说明没有排查干净;
打开冲突的html,一个一个分析对应的私包,是解决什么问题,如果是标准产品功能,可以查看补丁发放说明对比是否可卸载;如果无法确定,可以云之家咨询总部老师或提单。
四、补丁更新完毕后
4.1 生成子系统树
在管理控制台,工具-产生子系统树
4.2 同步权限项、日志项
登录eas管理员,打开 用户管理 菜单,文件-同步权限数据
登录eas管理员,打开 上机日志 菜单,文件-同步日志项数据
4.3 分配权限
登录eas管理员,打开 用户管理 菜单,选择对应的用户,分配对应的权限
4.4 清除客户端缓存
路径:客户端根目录$EAS_CLIENT\eas\client\cache
五、补丁更新导致的问题
5.1 权限找不到
第一步,分析是否同步权限;
第二步,分析是否有权限的私包;
5.2 类找不到该方法
第一步,分析是否清楚客户端缓存;
第二步,通过查询加载路径分析是否存在私包,然后分析是否可卸载;如果不能,需自行合并冲突私包。
例如下图:可观察是否有“NoSuchMethodError”
六、如何定位业务类问题
6.1 如何判断提单属于EAS税务模块
首先查看是否为EAS税务标准界面,排除掉二开或DEP影响;
其次周边业务模块界定:应付的发票助手是税务模块代码,应收单开票也是调用税务接口;
费用报销的发票助手属于费用报销模块(不属于税务),但费用提交(开启了与税务集成参数)会调税务接口下载发票。
6.2 如何判断提单属于发票云模块
以下图为例讲解,首先在金税互联日志列表中找到对应的日志类型,然后双击打开,查看返回报错,除了访问超时、非法的客户id这两个,其余基本上都是属于发票云模块/税局问题。
6.3、如何进一步定位问题
客户提单容易出现问题描述不详细,或者与实际有偏差的情况,需提单人反馈的信息尽可能详细:
产品操作问题,建议让反馈人提供报错截图、系统配置截图;
与发票云交互的功能,建议让反馈人提供金税互联日志或TMtarce日志;
系统中断类问题,需反馈人提供报错日志、apusic日志;
数据类问题,需反馈人导出系统里的单据数据;例如应收单下推开票单尾差问题,需提供应收单、开票单数据、合并规则、限额限行参数截图。
若初步判断为复杂问题,或者与提单人口头沟通不清时,建议远程分析。
6.4 方法论
一、在获取到报错截图和日志的前提下,分析步骤如下:
1、先分析是否是应用问题产生;当分析后排查非应用问题后,再分析是否是环境问题,通过查看client.log和apusic.log查看报错堆栈,可以通过tm.im或者报错文本搜索,然后找到类路径,进而通过查询私包的方式排查是否私包影响;还可以排查是否DEP影响。
2、如果分析非应用问题、非私包、非DEP,进而分析是否属于已知问题,更新补丁即可。
3、如果非上面一、二类型,进而分析是否程序错误,可在测试环境复现。
二、遇到提单是数据问题,分析步骤如下:
1、当确认是数据问题时,先分析是否DEP、二开导致,可咨询实施同事。如果未能有所收获,需联系研发同事查看私包。
2、先确认是什么模块,什么功能,再判断是什么类型:反写、历史数据、脏数据等;一切数据问题都是以了解业务如何反写数据为前提。
3、可查看典型问题列表,是否已有解决方案;如果无,则可通过《EAS税务数据修复和常用SQL合辑》进行修复。
七、如何提供错误日志和解决常见问题
(五)开票管理知识合辑
(六)收票管理知识合辑
EAS税务补丁更新全流程
本文2024-09-22 19:22:56发表“eas cloud知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-eas-106837.html