网银适配器二次开发手册

网银适配器 2.0 版二次开发手册
一、 版本说明 网银适配器 1.X 版主要实现了和全国性银行的连接。 为了满足越来越多的地区性商业银 行、外资银行与标准产品连接的需求，网银适配器 2.0 中增加了集成框架，便于用友的二次 开发人员、伙伴开发人员、客户开发人员在此基础上进行地区性商业银行、外资银行接口的 开发，且开发成果具有一致性，能与 NC、U8 等标准产品正确连接。 二、 支持银行及 NC\U8 版本 目前网银适配器支持包括国内各大银行在内的 17 家银行，外资银行支持日本瑞穗， 银行的业务功能主要支持余额查询、明细下载、支付转账、支付转账查询、集团支付、集团 支付查询等业务功能。注意银行功能对应的 ERP 版本号。
功能 银行
北京银行 交通银行 中国银行 建设银行 建设银行外联 光大银行 中信实业银行 招商银行 民生银行 农业银行 广发银行 华夏银行 工商银行
集团支付 财务室 财务室批量 对应 NC 余额 明细 支付 支付查询 及查询 批量指令 指令查询 版本 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 NC3.1+SP2
对应 U8 版本
NC3.1+SP2 U852 NC3.1+SP2 U852 NC3.1+SP2 U860 NC3.1+SP2 U861 NC3.1+SP2 U860 NC3.1+SP2 NC3.1+SP2 U860 NC3.1+SP2 NC3.1+SP2 U861 NC3.1+SP2 NC3.1+SP2 NC3.1+SP2 U860 NC3.1+SP2 U861 NC3.1+SP2 U861 NC3.1+SP2 U861 NC3.1+SP2 U861
工商银行专业版 是 日本瑞穗银行 上海浦发银行 兴业银行
备注：对应 U8 版本是 U861、U852、U860 依次向后兼容！ 三、 运行环境 硬件要求：CPU：1.6GHz，内存：512M，磁盘空间：500M 操作系统：Windows2000 Professional 支持二次开发语言：可编译生成动态库的任何语言，如：VB，VC 等。 四、 软件加密

暂无。 五、 网银适配器原理
1、UFBank 作用 、 网银适配器（UFBank）的主要作用是作为业务系统 业务系统（即 NC、U8 等）与银行系统 银行系统连接 业务系统 银行系统 的桥梁。UFBank 屏蔽了不同银行数据格式和连接方式的不同，将其转换成统一的数据格式 （内部标准格式）和连接方式，业务系统只与内部标准接口打交道。 在增加新的银行接口，或银行系统升级时，只需要升级 UFBank 即可，从而有效地保证 了业务系统的相对独立性，使其受增加新的银行接口、银行系统升级的影响很小。 在 UFBank 中，不进行任何业务处理。UFBank 只有银行参数配置、日志查询、测试界 面外。在实际运行时没有可见界面。 2、UFBank 构成与工作原理 、 UFBank 主要由两部分组成：UFBank Service 和 UFBankPlugin。 UFBank Service 主要包括： 一个 Web Service， 通过 WEB 服务的方式接收来自业务系统的指令， 并将执行结果 通过 WEB 服务再传回业务系统。在 UFBank2.0 中，Web Service 的核心文件是 UFBank.asp。其核心代码如下： Set objDom = CreateObject("msxml2.domdocument") objDom.Load(Request) ’获得业务系统发来的指令 srcData = objDom.xml ’将指令数据赋予字符串变量 srcData objUFBank = CreateObject("UFBank.clsService")’创建接口服务对象 retdata=objUFBank.sendBank(cstr(srcdata)) ’调用接口服务对象的方法，并返回指令执行的结果 Response.write retdata’将执行结果返回业务系统

一个接口服务类 UFBank.clsService。 该接口服务类主要作用是： 解析业务系统的指 令数据， 根据指令数据中的银行标识调用相应的银行接口插件 （即 UFBankPlugin） 。 该类是 UFBank Service 的核心。银行接口插件必须实现 UFBank.clsService 要求的 接口方法 sendBank(tasked as string, strBankID as string, strFunc as string, lngParaNum as long, aParaValue as variant, SrcData as string, RetData as string, strErrMsg as string, objLog as object)。 一个日志文件类 UFBank.clsLog。该类实现了对日志文件的读和写，该类的一个实 例会通过 UFBank.clsSercice 传递给银行接口插件，供其写日志文件用。 一 个 银 行 接 口 插 件 注 册 文 件 UFBankConfig.xml 及 读 写 该 注 册 文 件 的 类 UFBank.clsConfig。 一个用户使用的银行参数配置的模块（可执行文件为 UFBankConfig.exe） 。用户通 过该模块设置各个银行需要的参数。此外，本模块还额外提供了日志查询的功能。 UFBankPlugin 指银行接口插件。银行接口插件的主要功能是： （1）将业务系统发来的 指令数据（内部标准格式） 转换为相应银行的格式； （2）连接银行并向其发送指令数据； （3） 接收银行的返回值并将其转换为内部标准格式； （4）将返回值传递给 UFBank.clsSercice。 网银适配器二次开发的主要工作就是开发新的银行接口插件。UFBank2.0 中提供了 17 网银适配器二次开发的主要工作就是开发新的银行接口插件 个银行接口插件，对于 UFBank2.0 中没有提供的银行接口，分公司、伙伴、用户可以自在 本手册的指导下二次开发新的银行接口插件。 在银行接口插件中，必须实现 UFBank.clsService 要求的接口方法 sendBank。银行接口 插件必须编译为 dll 并且在银行接口插件注册文件 UFBankConfig.xml 中注册。 六、 二次开发过程 开发一个新的银行接口，过程如下： 开发一个新的银行接口，过程如下： 1、 安装业务系统（NC、U8） 并在业务系统中注册银行标识等信息。 、 安装业务系统（ 、 ） 并在业务系统中注册银行标识等信息。 ，并在业务系统中注册银行标识等信息 ， 银行标识指银行的唯一标识，如浦发银行标识为：SPDB，民生银行标识为 CMBC。一 般采用银行的英文缩写。 在业务系统中注册的银行标识与在 UFBank 中注册的银行标识要前 后一致（包括大小写） 。 NC3.1SP 及以上版本支持银行标识等信息的注册，NC3.1 及以前版本、U8 各版本不支 持二次开发人员注册，需要通知 NC 资金开发部、U8 财务开发部的开发人员修改程序并发 放专项补丁。 2、 建立 UFBank 的二次开发环境。 、 的二次开发环境。 获得 UFBank 的安装盘，安装后自动建立起了 UFBank 的二次开发环境。 最新版本的 UFBank 安装盘可从技术支持网站或知识中心下载， 或向集团网银适配器开 发经理索取。2006 年网银适配器的开发经理为郑传炎（分机电话：2756，EMAIL： zhengcy@） 。 3、 注册银行接口插件类及银行参数。 、 注册银行接口插件类及银行参数。 在 UFBank 的安装目录下找到 UFBankConfig.xml。用文本编辑器（如记事本、UltraEdit