【熊说银企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

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

如果是星空公有云，请添加127.0.0.100

是否传输sftp账号密码给业务端 

配置说明：启用此功能，会在业务端查询回单信息时将sftp账号密码作为 参数传给业务端，如果系统部署在公网，存在安全问题。默认值(否)

星空可参考帖子操作：【熊说星空银企FAQ】下载回单提示电子回单SFTP服务登录用户名或密码为空

OFD格式：中国工商银行、光大银行（体验下配置咋样）

工商银行推广版支持OFD文件

光大银行支持OFD文件

3.10常见问题-启动回单代理程序报错：:30' is invaild 

查看日志：

此处的每天1:30是指回单查漏的调度，发现查漏调度重新选一下

然后重启回单代理程序服务

3.11常见问题-回单程序访问白名单中，不要删除127.0.0.1 这个默认值

ps：如果删除了127.0.0.1这个默认值，就无法通过 http://127.0.0.1:8089  访问回单系统了，会提示 Request failed with status code 403

这种情况只能连上回单数据库后，自己去update一下：

select * from t_ebg_config where field_name='whiteIp'

备注：下个版本（20230106版本）优化这个问题，支持在application.yml文件中配置白名单ip

除了127.0.1外，建议将回单系统的ip、银企服务器的ip、以及星空（或EAS）服务器的ip也设置到白名单中，中间以英文分号隔开。

如果还有其他电脑要访问回单系统，也需要将这台电脑的ip设置到白名单中

否则访问回单系统会提示：请求ip：x.x.x.x 不存在IP白名单中，请使用http://127.0.0.1:8089 登录后在系统配置添加白名单IP

3.12常见问题-星空中下载提示电子回单文件服务器无法访问：由于目标计算机积极拒绝，无法连接 （由于连接方在一段时间后没有正确答复或连接的主机没有反应，连接尝试失败）

原因是因为银企平台在202211更新参数：全局业务配置-电子回单相关的IP配置项优化，同时兼容了星空公有云的特殊情况。

升级前参数位置：

升级后参数位置：

会发现这边的参数对调位置了，这时候就会导致：

升级后，需要人为到此处调整下参数，否则将影响回单下载。

4.应用小结

注意事项；补充说明（视情况而定）

更新不同于银企平台，更新前需三思、准好事前准备，如【3.1更新前需考虑】

参考资料

【电子回单】银企平台查询电子回单报错，提示：读取流失败

【银企平台——电子回单】电子回单20221028版本注意事项