名称标签：东莞农商行推广版部署、东莞农村商业银行部署

1.      背景

配置之前，先要和银行申请环境和资料，找IT管理员配好网络。

银行资料请参考：

（1）前置机安装材料

（2）客户相关数据；

（3）测试使用账套数据；

请仔细阅读文档。清晰步骤了再进行配置。

2.      实施流程

实施部署流程

3.      搭建东莞农商行银行前置机程序

3.1.  东莞农商行前置机环境配置

请注意：搭建银行前置机的操作指南银行一般都会提供，更为详细的步骤直接参考银行的银企直连使用说明文档。

l  获取银行前置机安装包

现场实施伙伴或客户方需向银行请求获取银行前置机安装包（如需U盾也需提前准备好）

l  东莞农商行的前置机安装配置

1、点击CMS.Transmitter.exe 安装文件开始安装

2、选择安装目录时，如果不是管理员用户，不建议装在系统盘（有些系统盘没有写权限）。

安装完成后会在桌面生成一个银企直连应用。

3、找到程序安装目录，将HsConfigTools.exe文件复制到此安装目录下

4、然后点击 HsConfigTools.exe 打开参数配置工具

然后配置通讯连接页的服务器地址、交易端口、文件端口以及企业代码，以及升级更新页的服务器地址、交易端口。确认配置好后，点击确定退出。

参数填写说明：

服务器：银行提供的银企直连使用说明文档中会提供

交易端口、文件端口：银行提供，一般默认即可；

企业代码：企业客户号，测试环境银行会提供

l  如果是U盾，需要安装DRCBank_ES_USBKey_Install(YQZL).exe

确保已安装东莞农商的UKEY驱动，插入登录UKEY ,点击桌面图标登陆，输入用户密码 （首次登录默认密码是123456（测试环境默认密码空），会提示修改密码）

（生成环境）下一步会要求输入Ukey密码 （首次登录默认密码是888888，首次会提示修改密码）

l  正确登录后会有提示试用期只有一个月，需联系银行人员获取正式授权（申请正式授权请参考生产正式授权步骤）。

登录后可以进行参数配置，银企直连通讯机默认的交易端口为本机的10010端口，文件端口为20010

通讯协议：需要选择TCP，不能选择HTTP

交易端口：对应银企云的银企连接通道配置上的端口号，保持一致即可

文件端口：银企云暂时没用到，默认即可

注意：修改端口后需要重新开启服务才可生效，如非特殊需要请不要擅自修改此配置

生产正式授权步骤（测试前置机环境不需要此步骤）

 登录后，点击界面右上角，切换用户旁边的钥匙图标，会弹出一个申请码窗口，将申请码全选中复制到一个记事本文件中，发给银行相关人员，银行会用此申请码注册返回一个授权码文件，将银行提供的授权码复制到授权码一栏，点确认即会提示已授权。（建议将申请码全选后复制到记事本并保存，然后再发给银行相关人员）授权码在同一个终端可重复使用，注意保存备份。

回单打印功能设置

如需使用银企前置机打印电子回单功能，则需在登录后，在服务开启前，打开【参数配置】> 【通讯插件】 >选择安装路径下的 /Plugin/HsDetailVoucherPrint.bpl

 确认后，重新启动一次前置机即可调用回单打印功能。后续在配置回单云参数。

4.      安装部署银企云

4.1.  配置【查询与支付】参数

前提：需要更新银企云最新补丁

4.1.1.   配置银企连接通道配置参数

（1）登录金蝶云星瀚，进入银企云的应用【查询与支付】

（2）进入【银企连接通道配置】页面，选择东莞农商行推广版，然后点击新增

（3）进入前置机新增页面，对基础连接配置和网银登录配置参数进行配置

1、前置机IP地址：东莞农商银企通讯平台2.0所在的服务器IP地址；

2、端口号：与东莞农商银企通讯平台2.0的参数配置上的“交易端口”保持一致；

3、字符集：按银行要求可修改为UTF-8或GBK协议，正常情况下默认就可以，但是需要注意，代理程序配置上的字符集保持一致。

4、并发锁数量：同时提交银行前置机的并发锁设置，默认1，如果银行支持多并发则可以设置，但是并发锁数量之和不能大于银行前置机的最大并发，否则会导致交易出现问题。

5、金蝶代理服务器端口号：由于这个银行交易明细也是文件格式，需部署代理程序，对应的是代理程序的“服务端口”，配置参考4.2.1的说明

6、客户号：跟企业代码是相同的

7、银行测试系统日期：测试环境需要，银行测试服务器日期不是当前日期，配置日期需要咨询银行后填入，但是生产环境一定不能配置任何日期。

（4）配置完成后，点击保存，然后点击测试连接；

   注意：点击测试连接，代表银企到前置机安装的服务器端口通了；如果不通的话，请检查ip和端口的配置，如果是公有云环境，这里测试连接不通是正常的，需要通过网络代理连接配置中进行测试连接。

4.1.2.   配置银企账户

如何添加银企账户可参考

4.1.3.   银企联通测试

银企账户配置完成之后，可以在在【查询与支付】-银行账户查询内，查询该账户余额，如果余额能够成功查询，代表与银行前置机的通讯配置是成功的，可以进行实际的交易测试；

4.1.4.   银行参数配置

银行参数配置本身有默认参数，如果没有特殊情况可以不用配置。以下只对本银行的关键参数进行说明：

1、支付/非支付通道开关说明

2、业务单据防重付款验证开关

3、回单明细限制查询日期：

4、交易明细摘要取值：

5、付款摘要特殊字符池：

6、支付是否需要进行KD标识：付款摘要中加入KD标记,区分付款是否由银企发起，可以自动把付款单和付款交易明细匹配关联起来，由于是摘要中添加标识，会导致电子回单摘要会附带KD标识，例如客户真实摘要是费用报销100元，加入KD后摘要变成类似kd@ke1k2k2k费用报销100元，因此能接受的用户再去开启。不开启的情况下，付款单和交易明细的匹配可以用银企互联的规则设置。

4.2.  配置【金蝶代理程序】参数

4.2.1.   配置东莞农商行推广版参数

前提说明：东莞农商行 交易明细和批量付款接口都需要用到代理程序上传和下载文件。

l  下载金蝶前置机代理程序安装包，解压后启动

l  进入“东莞农商行推广版”页面进行配置

服务端口：设置未被占用的端口，并且需要开放给银企云访问，与金蝶代理程序端口号一致

代理服务器端口字符集：一般默认，如果银企连接通道配置上改了字符集，两边保持一致

东莞农商行交易明细文件下载目录：与银行确认交易明细文件会在哪个目录下生成，然后配置

代发付款文件下载目录：一般设置东莞农商行安装目录下的download目录

代发付款上传文件目录：一般设置东莞农商行安装目录下的temp目录

是否自动启动：设置成true则下次启动代理程序的时候会自动启动服务

访问IP地址白名单：这个非常重要，关系到是否能正常访问代理程序，需要配置本机IP地址、银企云的IP地址，银行服务地址,通过英文逗号,分隔，注意不要多余空格

配置完成后，在代理程序服务中启动即可。