搜索
校园一卡通v2.0——第三方接入数字化校园技术支持部主讲人：沈涛一卡通第三方接入－问题的提出¾第三方接入是一卡通系统应用过程中很普遍的一个问题，由于目前一些学校、单位在管理方面已经应用了较为成熟且专业的应用管理系统，如：图书管理系统，上机管理系统，教务收费系统等，那么怎样既确保原有系统的正常使用，又能实现第三方系统和一卡通系统的连通，真正做到“一卡在手，走遍校园”？为此，为了保护客户的前期投资和系统的平滑升级，一卡通平台提供“通用第三方接入服务”产品，与其他方的产品耦合成一卡通系统。一卡通第三方接入－内容简介¾接入方式¾功能介绍¾接口配置¾常见问题解答¾接入方案举例一卡通第三方接入－接入方式网络结构图综合前置机代理服务器第三方子系统网络第三方子系统网络一卡通网络sios一卡通第三方接入－接入方式代理服务器sios非消费交易流水一卡通V2.0第三方的对接采用通用动态链接库（dll）的方式，由我方提供函数给第三方子系统，第三方系统则通过调用函数实现与一卡通系统的耦合。特点：简单，易用，安全，便于以后的维护和升级。第三方系统AIO_API.dll转发交易流水后台交易结果转发交易结果一卡通第三方接入－功能介绍一卡通接口按功能主要分为以下几类：9读卡器和验证白名单类9卡片状态修改类9卡片消费交易类9查询交易类9文件下载类一卡通第三方接入－功能介绍先来介绍几个术语：¾开通：为防止用户离开单位时在某一子系统中存在帐目不清的情况，当用户在该子系统开通时在中心数据库相关表的特定字段置一个标志位，这样如果用户办理离岗销户手续，处理系统将检索他是否在某一子系统曾置“开通”标志位，如果已置位，必须先到相关子系统修改该标志位才可放行；（典型例子：图书馆）¾关闭：修改“开通”标志位；¾验证身份功能开关：为true的话在身份管理子系统中“身份功能开启或关闭”将起作用，如果为false的话则不起作用；一卡通第三方接入－功能介绍（读卡器和验证白名单类）一卡通读卡器基本操作：包括初始化、关闭、蜂鸣和快速读取卡片序列号；读取卡上信息：包括读取卡号、帐号、姓名、性别、学工号、身份证号、身份、余额、过期时间、消费密码、补助序号等信息；根据帐号和卡号验证白名单，可以设置是否验证身份功能；读卡并判断卡片的有效性，可以设置是否验证身份功能，并可以根据补助戳提取补助（新增功能）；一卡通第三方接入－功能介绍（卡片状态修改类）卡片在本子系统内的开通（在一卡通数据库做标记，必须关闭才能销户）；卡片在本子系统内的关闭；卡片的挂失一卡通第三方接入－功能介绍（卡片消费交易类）卡片消费(可以脱机)：脱机消费，是指在一卡通后台与代理服务器断网的情况下，将流水保留在代理服务器的某个文件下，在网络恢复时自动将流水上传；卡片退费(联机)，此功能一般需要有财务部门的允许；一卡通第三方接入－功能介绍（查询交易类）根据帐号/卡号/学工号/证件号精确查询帐户信息（包括姓名、性别、部门代码、卡号、帐号、学工号、身份证号、身份代码、身份序号、余额、过期时间、补助序号、是否在本系统内开通）；根据查询条件(可以是姓名、部门代码、性别、学号、身份代码)模糊查询帐户信息，以二进制文件的形式返回，如条件为空则查询全部信息；根据条件（持卡人帐号，商户帐号，终端号，起止日期等）模糊查询（当日或历史）交易流水信息，以二进制文件的形式返回；根据条件（帐号，系统代码等）模糊查询（当日或历史）开通流水信息，以二进制文件的形式返回；一卡通第三方接入－功能介绍（文件下载类）下载控制文件control.bin,存放于目录.\controlFile下（控制文件中存放的是当前一卡通系统的全局字典信息，如部门代码，身份代码，证件类型，国籍，民族，政治面貌等）；根据根据身份序号下载相片文件，存放于.\Photo目录下；一卡通第三方接入－功能介绍说明：以上的功能基本能满足大部分的第三方接入的需要，如果有个别特殊的需求可以以个性化的方式提交。至于开发人员如何的调用dll中的函数实现上述的功能以及如何读取相关的文件不在这次课程之内，请详见《一卡通第三方开发说明》。一卡通第三方接入－配置运行环境PII300，64M以上内存，安装网卡代理服务器端需要加密卡Windows2000/NT等安装TCP/IP协议一卡通第三方接入－配置（程序清单）服务端清单客户端清单上传下载文件APIUpdateAPI.dll底层APICCardLib.dll一卡通统一接入平台Sios.exe第三方代理服务器底层APICCardLib.dllReadCardUSB.dllUSB读卡器ReadCardCom.dll串口读卡器读卡器底层APICardInterfaceDll.dll第三方APIAIO_API.dll第三方通用读卡器上层API一卡通第三方接入－配置（服务器端）¾首先，在综合业务子系统中为第三方新增一个子系统，并记住所分配的处理机号；¾kit代理服务器的加密卡（pcinew.hex），（如果是以前使用过的加密卡要利用加密卡维护工具先进行擦除），运行第三方代理服务软件sios2.exe（版本不同名称可能略有差异），这时会提示加密卡未初始化，按提示进行加密卡的初始化，处理机号为上述在综合业务系统中新增第三方系统中所分配的处理机号，输入正确的综合前置机IP地址，其余两项用默认，如图：一卡通第三方接入－配置（服务器端）一卡通第三方接入－配置（服务器端）¾初始化加密卡后按提示重启sios程序，重启后首先弹出性能设置界面，按默认保存退出即可，如图：一卡通第三方接入－配置（服务器端）¾这时还会提示“需要设置子系统信息”，如图：¾点击确定进入子系统设置界面一卡通第三方接入－配置（服务器端）¾增加子系统，代码为在综合业务进行系统登记时所对应的节点号，一般就是前述的处理机号一卡通第三方接入－配置（服务器端）¾此时如果网络正常的话，sios应该可以正常的运行，并显示在计算机屏幕的右下角；¾注意：此时还需要进行商户的配置，否则会使第三方接口程序不能正常工作；方法是鼠标右键单击sios图标，出现如下菜单：一卡通第三方接入－配置（服务器端）¾点击商户配置，出现如图界面：一卡通第三方接入－配置（服务器端）¾进行设置商户及所拥有的pos机号（也可称站点号、终端号，即调用消费、补助等函数所在终端计算机的编号），商户帐号一定是在综合业务子系统中已设置完成的，注意POS机号和商户的对应关系；¾至此，已完成代理服务器端的配置，还有一点需要说明的是，服务器端的ping命令不能封掉，否则会引起无法上传流水和交易失败；¾下面让我们看一下客户端的配置：一卡通第三方接入－配置（客户端）¾客户端的配置比较容易一些，只需把CCardLib.dll，ReadCardUSB.dll，ReadCardCom.dll，CardInterfaceDll.dll，AIO_API.dll5个动态链接库同第三方系统的可执行文件放在同一个目录下即可(静态调用方式)。一卡通第三方接入－配置（综述）以上是第三方接入服务器端和客户端的配置过程，现在做一总结：要想使第三方系统在一卡通系统中正确运行，需要经过以下步骤：在综合业务系统中增加第三方系统Æ初始化代理服务器的加密卡Æ启动sios、添加设置子系统Æ设置商户信息Æ在客户端将第三方系统的可执行文件与所需动态链接库放在一个目录下，运行第三方系统软件一卡通第三方接入－配置（目录说明）服务器端－－\etc配置文件目录¾config.dat:sios配置文件¾Merchant.dat:商户配置文件¾ortjn.dat:脱机流水文件¾subcode.bin:子系统类型代码文件\RecvTemp接收文件临时目录\SendTemp发送文件临时目录（暂时没有用）\siosLogsios日志文件一卡通第三方接入－配置（目录说明）客户端－－\ControlFile存放控制文件\Photo存放下载照片\RecvTemp存放查询时返回的二进制文件\ApiLog存放调用Api时产生的日志文件以上目录和文件都是由系统自动维护，一般都不需要我们手工去改动。一卡通第三方接入－常见问题及解决常见问题1：运行sios时提示“无法向综合前置机签到”原因：通常有以下原因1）综合前置机没有启动；2）综合前置机网络服务没有启动；3）sios节点没有在系统数据库登记；4）网络故障；解决：按上述逐项排除、解决。一卡通第三方接入－常见问题及解决常见问题2想在一台代理服务器代理多个子系统，可不可以？解答：可以，一卡通2.0代理服务器已经可以支持多代理功能。具体方法：右键单击屏幕右下角的sios图标，选“子系统维护”菜单，在子系统维护界面加上其他子系统的设置即可（前提是该子系统已经在系统登记过），如图：一卡通第三方接入－常见问题及解决一卡通第三方接入－常见问题及解决常见问题3怎样根据第三方操作员查询交易流水？解答：为了与一卡通的操作员进行区别，现定义第三方系统的操作员代码为小写字母t＋两个字节的字符，如t01，taa等；其中t为系统自动维护，01、aa为第三方系统维护；这就要求学校统一分配各第三方子系统的操作员代码，否则可能导致根据操作员查询的流水不准确；一卡通第三方接入－方案举例1上机系统对接需求：1，一卡通提供所有帐户信息2，认证刷卡用户的合法性3，提交上机交费流水到一卡通系统4，在刷卡处刷卡需要读取学生卡号（帐号），卡内余额等信息；一卡通第三方接入－方案举例2图书馆借阅系统对接需求：1，读卡，需要验证身份功能2，对超期还书的进行罚款3，下载照片功能4，对多扣除的费用可以退费5，持卡人要在毕业前到这里注销结束，谢谢合作！