电子回单转储方案操作文档

1、背景概述

背景：金蝶云盘服务即将于2023年12月31号停用，当前存储在金蝶云盘的回单数据需要转储到数据库（回单库）中，否则会对电子回单的使用产生如下影响：

1) 历史回单将无法调阅；

2) 新的回单文件将无法下载到EAS系统。

为避免影响企业电子回单功能的正常使用，需要在2023年12月31号前对历史电子回单进行转储——将金蝶云盘中的回单数据转储到新的回单数据库中。转储之后历史电子回单仍然可以正常调阅，新的回单将会统一下载到新的回单数据库中。

2、转储环境配置要求

【用途与目的】

转储前需要提供电子回单数据库，将金蝶云盘中的历史回单文件转存到这一数据库中。

【操作说明】

1、可安装一个新的电子回单数据库，支持MySQL、Oracle和SqlServer数据库，或者在原来的MySQL、Oracle和SqlServer数据库里增加一个新的表空间。

2、执行电子回单数据库建表脚本，参考附件语句：电子回单建表语句汇总.rar

安装MySQL数据库、 Oracle数据库或者SqlServer数据库的硬盘存储空间要提前按交易量和保存时效进行估算，至少满足一年期的电子回单存储量需要，建议使用1TB以上的存储空间，并且需要对数据库设置动态扩容。（一个电子回单pdf大概100K左右）

3、修改电子回单存储设置

【用途与目的】

电子回单存储设置可指定电子回单文件的存储方式，原来配置成金蝶云盘存储，需要修改成数据库存储，并配置数据库服务器的URL、用户名、密码等信息。

【操作路径】

选择〖应用〗→〖资金管理〗→〖电子回单〗→〖基础设置〗→〖电子回单存储设置〗

【操作说明】

选择WEB端〖应用〗→〖资金管理〗→〖电子回单〗→〖基础设置〗→〖电子回单存储设置〗，弹出“电子回单存储设置”界面，如下图所示：

1) 首先将“云盘存储”改为“数据库存储”，如下图：

2) 改为“数据库存储”后，会显示“数据库配置”区域，用于配置数据库的相关信息。界面显示字段如下：

数据库类型：支持MySQL或 Oracle；

数据库服务器IP：已安装的MySQL或 Oracle数据库服务器IP地址；

服务器端口：已安装的MySQL或 Oracle数据库服务器端口；

数据库名称：已安装的MySQL或 Oracle数据库名称；

用户名：登录MySQL或 Oracle数据库的用户名；

密码：登录MySQL或 Oracle数据库的密码。

注意：

1、要记下修改存储设置的日期，后面配置需要用到！

2、当把电子回单存储设置的存储类型由云盘存储改为数据库存储之后，双击电子回单后，预览回单将展示为空白。因此修改回单存储设置会影响到业务用户查看回单，建议提前知会下业务用户，转储期间回单查询功能不能正常使用。

4、 部署电子回单转储工具包

1) 下载电子回单转储工具包，压缩包如下：UP00066142-最新.zip

2) 安装工具包

（1） 停止EAS应用服务器；

（2） 将（例如：fm_erec-server_20231201_djj.jar）工具包放置于EAS服务器安装目录的对应路径：~\eas\server\lib\sp 目录下；

（3） 将（例如：fm_erec-metas_20231201_djj.jar）工具包放置于EAS服务器安装目录的对应路径：~\eas\server\meta\sp 和 ~\eas\server\deploy\fileserver.ear\easWebClient\meta\sp 目录下。

（4） 在EAS应用服务器点击【生成子系统树文件】

（5） 启动EAS应用服务器

5、 配置并运行电子回单转储后台事务

【用途与目的】

通过运行电子回单后台事务，批量将云盘中的电子回单转储到新的存储容器中（例如：电子回单库）。

【操作路径】

〖系统平台〗->〖后台事务〗->〖事务定义〗->〖后台事务定义〗

【使用时机】

在金蝶云盘服务停止之前

【操作说明】

在金蝶EAS Cloud主界面，选择〖系统平台〗->〖后台事务〗->〖事务定义〗->〖后台事务定义〗，选择资金管理-银企互联界面，新建一个后台事务，后台事务的〖任务〗选择〖电子回单数据迁移Facade〗（别名：〖EReceiptDataLinkFacade〗）选择〖EReceiptPDFDataMigration〗这个任务，如下图所示：

搜索“电子回单数据迁移”可以找到。

选第一个〖EReceiptPDFDataMigration〗。

该后台事务提供2个参数：

参数1：开始时间，即单次转储执行的开始时间，参考如下格式填写：2023-11-01；

参数2：结束时间，即单次转储执行的结束时间，参考如下格式填写：2023-11-01。

注意：两个参数的时间间隔建议不超过1个月（转储花费的时间比较长，时间跨度大会导致存储负荷大运行时间长），且结束时间一定要配置在【步骤3】重新设置【电子回单存储设置】之前。（如果配置在重新设置【电子回单存储设置】之后，会造成存储的数据冲突）。

〖调度计划〗设置为一次性执行，根据调度计划的时间执行，如下图：