【熊说银企FAQ】电子回单代理程序更新指南20230402

关键词：银企平台、电子回单代理程序、更新元数据、程序更新升级

更新日志：

20221106：结合windows版本回单代理程序20220421全量更新升级至20221028实操示例、尝试下工商银行、光大银行OFD回单功能

20221112：更新星空公有云在电子回单代理程序中需要维护访问白名单，IP为127.0.0.100；启动报错解决

20221127：更新关于访问IP白名单注意事项及遇到问题

20221129：结合星空8.1.0.202211SFTP下载回单时报错的解决办法，更新相关FAQ文档连接

20230108：结合电子回单代理程序20230106版本说明优化（关于增加配置文件配置白名单IP功能，config文件夹里的application.yml文件中的whiteIps后追加，用英文分号分割。专门针对LINUX操作系统无法登录WEB操作界面，Windows也支持）

20230402：升级新版电子回单代理程序和新版银企平台时需注意事项（特别针对星空公有云）

1.问题描述

问题现象、报错信息

在使用银企回单功能一段时间后，由于性能（如下载大批量回单卡顿延迟）或者BUG（部分银行回单下载存在BUG，下载不全）或者功能需求（需要对接新的银行回单，但是当前版本不支持）等缘故，原先使用的电子回单程序，已经没办法直接满足客户的使用诉求。

那么电子回单代理程序能否像银企平台一样，可以打补丁的方式升级回单代理程序呢？

2.原因分析

分析问题出现的可能原因（视情况而定）

补丁方式暂不支持，可通过下述两种方式更新电子回单代理程序：

（1）Jar包更新（类似于银企平台私包更新）

（2）安装包全量更新

回单代理程序暂未开发补丁更新方式。本文主要结合安装包全量更新讲解，如涉及到JAR包更新可参考本文附件。

3.解决方法

解决思路/操作步骤

3.1更新前需考虑

（1）查看从原先版本升级到当前最新版本电子回单程序更新了哪些功能？比如我从2022-04-21版本升级到最新的回单代理程序升级到2022-10-28版本。如下图所示，确认这些功能是否满足本次使用。

（2）银企平台是否也需要升级到最新版本？需要考虑升级的话是否会影响到回单匹配码流水跟回单的一致性？

如下图所示，可能存在部分银行回单匹配码出现更新。

如涉及银行匹配码修改，需删除旧数据并重新下载回单，并且需要升级银企平台。

（3）是否有涉及到部分私包是之前的总部老师提供的，这些私包是否已经更新到最新版本中了？可联系原先提单联系的总部老师或者按之前提单号咨询银企平台老师，沟通联系解决。

目前银企平台暂不支持类似EAS管理控制器的私包记录和补丁记录。

建议按如下设置统计原先私包：提单号、提单内容、解答内容、私包名称、对接总部老师、提供私包日期，是否更新到最新版本中

（4）选择全量更新还是JAR包更新

如无私包，比较建议全量更新，此处介绍只要为全量更新，如需涉及到JAR包更新（主要是替换安装包下bundles文件夹）

3.2数据备份、原先安装包备份（略）

3.3原先回单代理程序停服（略）

3.4下载最新回单代理程序、解压

电子回单代理程序下载及更新论坛 (kingdee.com)

3.5启动start_Config.bat，配置数据库（先测试连接，测试连接通过并保存！）

3.6开启新版本程序

3.7打开网页端，启动回单模块

记住是在服务器本机网页端打开（因为非本机的话会提示如下）

3.8初始化元数据

部分版本更新后数据库会与旧版不兼容，参考常见问题文档重新初始化元数据（升级至20200525之后版本，SqlServer用户需重新初始化元数据；2020.10月版及以后可直接登录电子回单程序页面，配置项-系统配置-重新初始化元数据-更新 即可实现）。

某些版本更新会涉及配置项增加，需要重新初始化元数据。【回单】-【配置项】-【系统配置】-【重新初始化元数据】

3.9新增功能或参数查看

此时查看就会发现有出现新的功能按钮或者参数。

如20221028更新参数，记得顺便修改下

回单程序访问白名单

配置说明：填入允许访问电子回单程序的IP地址，中间以英文分号隔开。银企平台、星空以及EAS访问电子回单程序时需要配置白名单IP，白名单以外的IP无法访问电子回单程序。默认值(127.0.0.1)

需要配置：127.0.0.1、银企平台IP、公有云IP、EAS的IP

此处不改的话会报错：【电子回单】银企平台查询电子回单报错，提示：读取流失败

如果