通用第三方对接系统使用说明书

1、声明衷心感谢您购买并使用哈尔滨新中新电子股份有限公司的产品，请您在安装 使用前仔细阅读本说明书。木公司向您做出如下严肃声明：本手册陈述的内容基本有效，请您认真遵照执行。但在今后的程序升级时可 能会冇所变动，我们将在系统软件说明书的电子文档中做出相应更改并以其为准, 恕不另行通知。本手册的例子中使用的单位皆为虚构。依据有关服务观程的规定. 本公司只对发行的正版软件任介法的使用范囤内承担服务的义务。对丁本系统软 件和相关的文档资料，在未得到哈尔滨新中新电子股份有限公司的止式书面许可 下,您不得抓I拷贝和传播。否则将根据知识产权保护的相关法规追究相冈的法 律责任。本公司不承担如下情况的相关贵任：1）

2、木正确按照本操作手册说明的规程进行操作2）病毒感染和黑客破坏造成的各种故障3）因其他厂家生产的软硬件的不兼容或存在缺陷而导致的故障4）使用非法软件（操作系统和数据库）本系统采用的产品的注册商标声明:1）金龙、Synjones是哈尔滨新中新电子股份有限公司的注册商标2）SCO UNIXWARE是SCO公司的注册商标3）Windows是美国微软（Microsoft）公司的注册商标4）奔腾、Pentium是美国英特尔（Intel）公司的注册商标5）ORACLE是Oracle公司的注册商标6）本书提及的所有其它公司及产品名称加各II公司的专有商标或注册商标金龙卡金融化一卡通系统软件V2.0产品甥记号为

3、：黑DGY-2004-0099,第 三方接入软件模块。1. 术语定义:一卡通系统：指哈尔滨新中新公司开发的校园一卡通系统；第三方系统：指校园内原有的可以与一卡通接入的各应用程序；通用第三方对接系统(第三方对接系统，本系统)：指连接一卡通系统和第三方系统的 程序的统称：用户(操作员)：使用第三方系统和通用第三方对接系统的单位或个人：持卡人：指卡片的持有者和使用者，覚接使用卡片进行个人消费、身份识别等活动的用 户；商户：指通过一卡通系统进行商务活动的实体。终端：指校园内原冇的可以与一卡通系统接入的并应用程序所在校园网中的机器终端。2. 系统安装：操作系统：Windows2000以上的操作系统。一服

4、务器端的安装与设置：要使用通用第三方对接系统需耍台服务器(建议使川-台独立服务器)。此服务 器用丁安装、设宣通用第三方对接系统。1. 在服务器上安装第三方对接系统服务器端程序(senersetup.exe).第三方对接 系统客户端程序(clicntselup.exe),加密狗驱动(SoftDogInstdrv.exe),以及 Firebird数据库后台服务程序(Firebird.5.0.4306-Win32.exe)。1!体安装方法 请参阅卜面的“三.本系统所有程序安装方法”。2. 安装好以上所冇程序之厉，首先确保Firebird服务己启动和加密狗已正确安装. 再运彳服务器端程序(ThirdB

5、ascScrvcr.cxc)。同时请程斥ThirdBaseSener.exe手 工拖动加载到“程序一启动”中。3. 再运行客户端程序(ThirdBascClicm.exe),然后连接服务器端并登陆进行系统 设置(具体请参阅下面的“3系统设置二. 客户端的安装与使用：1. 在石要进行一卡通系统和第三方系统对接的终瑞上安装第三方对接系统客户 端程序(clicntsctup.exe)。2. 运行客戸端程序(clientsetup.exe)时，首先耍连接服务器端，即输入服务器的 IP地址连接成功Z后，使用管理员已经分配好的用户编码进行鳌陆，其初始 密码为空，为了系统使用安全建议在登陆(图1)时更改自己

6、的密码.3. 经陆成功之后，此终端机器上如果正确安装了读卡器而H.注册了第三方系统的 信息(具体注册方法,请参阅卜面的“注册管理第三方系统信息”),即可在 此第三方系统进行拍卡身份认证和消费(请参阅卜而的“4.功能使用”)。注：运行时要确保第三方对接系统的客户端分别和一卡通接入平台SIOS,服务 器端在同一个局域网内，即使用“ping IP”命令互相ping通即可。三. 本系统所有程序安装方法1. 加密狗安装方法：执行SoFtDoglnsldrv.CKC点界而左卜的安装即可.2. 服务器端程序(senersetup.exe)安装方法：执行servcrseiup.exe全部Next即nJ'

7、;。3. 第三方对接系统程序(clientsetup.exe)安装方法：执行clientsetup.exe全部Ncxl即可。4. Firebird数据库后台服务程序(Firebird-1.5.0.4306-Win32.exe)安装方法：执彳亍 Firebird-1.5.0.4306-Win32.exe全部Next,在仃盂要选项的地方使用默认设置无 需改动。安装完后币:启即可。咆启后可以察看服务列表4> Firebird服务是否已 经启动。竝 IX.丨启动类别 登录电）Alerter噪9VOIM+ Erent System电）Qonrputer 由 owsw弋3DHCP ClientDis

8、tributed file 5/slet n电）CH5t“buted Link Irackng dentDistributed Iransaction Cooidnator 镭 DN5 Client动动动mHbsha动动8启启BB 启gB官 己己己己己己己己己瓦制动动5动动动stl 自手自目包自自自自LocaE Loc出 Local? LocaE locat 103性 LocatE Locafe loc或it bird Guvdidn DM&Jt Instance0Q己l0C4£智FiwbirG Server - Defaultinstance 镭血心iilnr方 电）Int

9、erBase Guar dan nter8age Server 轡PSEC Pcbey Agent License Logging Service 智Lgt&IZ 临Mgr 轡陆Cne Debug NaggerFraiMmrklft允诈 Prow Borla.吉瑾5UPP . McAf. 然送启BBEseOCOOQQCD 已己巴已已已己已已已动动动劫动动动动动动 孚自目手自自冃目目目Local?Locals localsL0C3t5Loc-iELoa10C4GloXLocdSL0C4£3系统设置:在客户端程序(ThirdBascClicnl.exe)中主耍包括连接和登陆、第三

10、方対接系统客户端 设置、第三方系统信息注册管理。连接和登陆：一连接设置(图0)：在首次运行客户端程序(ThirdBascClion.exe)时，需耍进行连接服务器设置，输入运 行了服务器端程序(ThirdBaseServer.exe)的服务器的IP地址，点击测试，如果提示“连 接服务器成功”，则点击保存、关闭进行登陆。图0二.登陆（图1）:主界面图进入主界面（主界面图）后，进入菜单“系统一登陆”，如果带要更换用户编码巫新登 陆，则选择"注销”，再“登陆”。管理员在第一次豈陆时使用系统默认的用户编码和密码。为了系统使用安全建议在迁 陆（图1）时更改管理员的默认密码。用户编码：0默认密码

11、：admin图1第三方对接系统客户端设置:管理员在服务器上运行第三方对接系统客户端程序(ThirdBascClicm.exe),在连接服务 器端并登陆正常之后.按照以卜设置说明依次进行设置即可。一本地设置(图2)：图21. 用户可以根据习惯设置在窗体关闭时是否弹出关闭提示。2. 身份信息认证时根据第三方系统的需求设置性别显示，如：男或女，F或M3. 少份认证凹雪方式为在进行拍K身份认证时身份信息回写到第三方系统屮的方式。 注意在第一次进行本地设置时必须选择少份冋写方式，并保存设置，英中少份冋写 方式可以默认为发送消息方式。二. 注册热键设置（图3）：图3设置使用第三方系统对接时的热建，木系统提

12、供8组操作热键。热键组成形式：Ctrl+Fl至F121. 添加单个注册信息热键：将第三方系统樹体屮当前焦点控件信息注册到本系统中。（默认热键Ctrl+F5）；2. 添加注册信息热健：将为前第三方系统窗体中的所冇控件信息注册到本系统中（默 认热键Ctrl+F6）；3. 移除注册信息热键：将第三方系统窗体中当前焦点控件信息移除接系统中。（默认 热键 Ctrl+F8）：4. 测试注册信息热健：测试第三方系统窗体屮所冇注册控件信息。将控件特征返回到 第三方系统窗体控件上。（默认热键Ctrl+F7）5. 消费操作热键和提取消费金额消费热键：弹出一卡通消费窗体进行消费操作。（默 认热键Ctrl+F3）：6

13、. 持卡人在第三方系统中关闭操作热键：弹出身份关闭界面，用J咲闭持卡人在一卡 通屮使用该第三方系统的使用标志（默认热健Ctrl+F9）；7. 持卡人在控制在第三方系统中的使用权限热健：弹出子系统开通关闭界面，用于开通和关闭持卡人该第三方子系统的使用标总（默认热健Ctrl+F10）； 注：如果默认热键跟真他软件系统的热键没仃冲突，建议不作修改。三. 用户管理（图4）：血用尸笞理图4（1）功能管理使用本系统的用户。新建的用户密码为空，该用户可以在登陆时更改密码。（2）操作工貝条操作说明（图5）：图5匸貝调用操作卜方对应的数据列表，其功能从左往右依次是： 按钮一：记录比标指向第一条； 按钮二：记录光

14、标指向前一条： 按钮三：记录光标指向后一移； 按钮四：记录光标指向最后一条： 按钮五：添加一条新记录： 按钮六：删除记录光标指向的记录。注:在其它窗体中操作此工具条时其操作方法均可参照以匕操作说明在左侧列表屮添加用户组，右侧列表中添加该组包倉的用门，然后可以为不同的组分配 不同的权限，这时组小所包倉的用户也就拥冇该权限（权限管理请査看划拨权限管理）。划拨类别管理（图6）：划拨类别名称I 噪存关闭.-° 图6(1) 功能管理划拨类别,如：消费,罚款等.(2) 操作添加、修改、删除划拨类别，然后进行保存。划拨权限管理(图7)：inixi悝存（1）功能用r管理用户组的划拨权限。比如为某用门

15、组分配了罚款权限，那在此组中的用户 只能对持卡人进行罚款操作。操作界面说明：窗体左侧的列表中是用户组名称,程序自动读去在用户管理屮设置的组信息。右侧是 划拨类熨列表，程序自动读去在划拨类别管理中设置的划拨类别信息。划拨类型列表 左侧为功能键。中间列表为用户组拥有的划拨类型权限。功能键：<:将划拨类型列表屮所选划拨类別加入用户组。>:将用户组对应划拨类空列表中所选划拨类别移出用户组。«:将划拨类型列表中全部划拨类别加入用户组。»:将用户组对应划拨类型列表中全部划拨类别移出用户组。操作：选中一个用户组，然厉再划拨类熨列表中选中要分配的划拨类别加入即可。四. 子系统管

16、理（图8）：图8（1）功能管理本系统中的一卡通子系统信息。（2）操作添加子系统结点号和子系统名称，请确保填写的信息和一卡通中的信息一致, 即一卡通后台系统已经给该子系统分配了该节点号。如果该子系统在进行身份认证时要关联白名单则在“是否启用白名单”选样使用的4种情况。（使用白名单的细节请与新中新系统集成部联系，一般情况下否即 可）1. 不使用白名单：不使用黑白名单判断持卡人身份介法性。2. 只使用内部白名单：使用木系统内部白名单判断持卡人身份介法性。3. 只使用外部白名单：使用第三方系统中的白名单判断持卡人身份介法性。4. 使用内部和外部白名单：同时使用系统内部白名单和第三方系统中的白名单判 断

17、持卡人身份介法性。只要持卡人在其中一个门名单中，少份即为合法。设置连接字符串：在使用第三方系统白名单时.需耍设置第三方系统数据库的 连接信息，用户根据第三方系统数据库的实际情况设置即町。选屮“删除子系统信息时同时删除关联的终端信息”时.在删除子系统管理中 的记录并保存时同时删除终端信息中所何关联该子系统名称的记录（见图10）。五. 商户管理（图9）：图9（1）功能管理本系统屮的商户信息。（2）操作点添加在列表屮新加的记录上添入商户代码和商户名称。商户代码和商户名称的内 容对应的足该商户在一卡通系统中的商户账巧和商户名称。填写不能有误否则会造 成消费和对账的错误！选中“删除商户估息时同时删除关联

18、的终端信息”时，在删除商户管理中的记录并 保存时，同时删除终端信息中所仃关联该商户名称的记录（见图10）。八一卡通接入平台与终端管理（图10）：（1）功能 管理一卡通接入平台（SIOS）和第三方系统终端。为第三方对接系统终端指定 SIOSo只有在此已经添加的第三方系统终端才能连接本系统服务器端，否则被视 为非法终端，无法连接服务器端。（2）操作在一卡通接入平台信息列表中添加本系统需要连接的一卡通接入平台IP，就是 SIOS的IP地址。在终端信息列表中添加第三方系统终端信息。终端编巧是指第三方系统终端在 SIOS中设置的编号,终端IP就是第三方系统终端的IP地址，终端名称可以由管 理员口行命名，

19、商户名称为商户管理中添加的商户名称，肖接选择即可，子系统 名称为该第三方系统终端所属的系统名称，即为子系统管理中添加的了系统名称, 直接选择即可。图10注册管理第三方系统信息：在需耍进彳亍-卡通系统和第三方系统对接的终端上，需要把第三方系统的相关涪息注册到本 系统的客户端程序中。具体注册步骤如b:一.特殊身份认证管理（图11）:图11（1）功能进行特殊身份认证信息的管理，如果在子系统中进行拍卡身份认证时，需要进彳r 特殊的认证，区别不同的身份信息，即可在此添加特殊身份认证信息。（2）操作先在特殊子系统信息列表屮添加特殊身份认证名称，然后在特殊身份认证信息列 农屮添加相应的显示内容（舶F时弹出的

20、身份认证提示信息）、一卡通账兮的上下限 （不同的账号范围，对应不同的少份认证提示信息）。二.第三方系统信息注册管理（图12）：图12为了实现第三方系统和一卡通系统的对接，必须将第三方系统程序注册到通用第三方法 中。本系统支持标准的基J* windows的第三方应用程序，和基J-IE web的第三方应用程序。1. 界面说明：窗体左侧的衷中是应用程序窗体列表，记录了所仃注册的第三方应用程序窗体。右侧是 程序窗体中注册了的组件信息。下方是功能操作键。2. 功能键：1. 删除谢体信息：删除选中的应用程序窗体信息。注意此操作还将同时删除此窗体 所对应的所有组件信息。2删除组件信息：删除选中组件的注册信息

21、。3. 保存：将设置信息保存。3. 第三方系统注册操作方法：打开需要对接的第三方系统窗体或web页而（如：第三方系统中的身份认证或消费窗 体）。将焦点放在任意控件I：按注册热健Ctrl+F6（通过注册热键设趕，见图3）,木系统 将把第三方系统窗体所有控件信息读入注册信息管理界面（见图12）,并把控件特征冋 写到第三方系统窗体控件上。用户可以根据实际惰况选择需耍显示身份信息、消费信息 等控件，并対该控件进行编号和选择此控件对应显示的一卡通信息。在编号时，同一编 号的组件信息将在刷卡时同时显示，例如显示身份信息、消费信息、实现身份开通关闭 的控件其控件编号可各口编为一组，设屋完需要注册的控件信息后

22、保存设跟 完成设直 后用八町以在第三方系统窗体上按Ctrl+F7（通过注册热键设宣，见图3）测试注册好的信 息，系统将把“控件特征一控件编号一显示信息内容”回写到第三方系统窗体控件上。4.功能使用一.身份认证第三方系统的相关身份信息控件在本系统注册Z后，当光标焦点定位到第三方系统 的身份信息控件（注：必须完成了该控件在本系统中的注册,比如输入条码卡号的输入 框）上时，持卡人进行拍卡身份认证，本系统将对持卡人进行身份认证，将少份借息冋 写到第三方系统中相应的位置上。二.消费结算（图13）图13情况一.操作员完成了第三方系统消费窗体的注册当持卡人耍在第三方系统进行消费结算时，操作员应把光标焦点定位

23、到第三方系统 的结算金额信息上（注：必须完成了该消费框的注册），这时持卡人刷卡，本系统将对 持卡人进行少份认证后门动弹出消费窗1丨（图13）,并tl动读入消费金额，操作员点结 算后完成持卡消费结算。情况二.操作员无法对第三方系统消费窗体进行注册当持卡人耍在笫三方系统进行消费结算时，此时持尺人刷卡，操作员应按卜热键 Ctrl+F3（iffi过注册热键设置,见上图3）弹出通用第三方对接系统消费窗口 （图13）,操 作员手工输入结算金额，点结算后完成持卡消费结算。注：划拨类型为划拨类别管理中添加的划拨类别名称（见上图6）三.身份关闭（图14）图14情况一.操作员完成了第三方系统身份关闭窗体的注册当持

24、卡人耍注销自己在第三方系统的身份时，操作员应把光标焦点定位到注册了的 身份关闭控键上,这时持卡人刷卡,本系统弹出身份关闭窗口 （图15）,操作员点身份 关闭，本系统将把持卡人在一卡通中使用该第三方系统的标志关闭。情况二.操作员无法対第三方系统身份关闭窗体进行注册当持卡人耍注销口己在第三方系统的身份时，此时持卡人刷卡，操作员应按卜热键 （Ctrl+F9）弹出身份关闭窗口 （图14）,点身份关闭,本系统将把持卡人在一卡通中使用 该第三方系统的标憑关闭。四子系统的开通关闭（图15）-Ini x|学工号关确作|开通操作|关闭姓名图15在第三方系统屮，当光标焦点定位到子系统开通关闭控件（注：必须完成了该

25、控件 在本系统中的注册）上时，持卡人拍卡弹出子系统开通关闭窗体（图15）,操作员即可 进行该卡在此第三方子系统屮的开通，关闭操作。在执行关闭操作Z后，该卡被禁止使 用此子系统.需要重复上面步骤执行开通操作.即可恢复使用。五.对帐（图16）图161. 在一卡通选项中选择要对帐的条件（1）持卡人帐号，持卡人卡号，持卡人身份证号，持卡人学号，这4个选择取决J：第 三方对账文件中包含那个持卡人的唯一标识字段.（例：对账文件中包含持卡人账号字 段就在一卡通中选持卡人账号）。（2）终端名称：在终端名称处选项耍对那个终端上的账。（3）划拨类别：根据用户设置的划拨类别进行刈帐。（4）用户名称：根据用户名称对帐

26、。（5）时间谋差：由J：某些原因（如网络延迟等）造成-卡通消费流水与第三方系统消 费流水之间存在消费时间误差。对帐系统允许在一定时间误差范由能进行对帐。（6）开始时间和结束时间用于指定对账流水的时间范用°注：所仃的选样条件是叠加的关系。即如果选择了终端名称和用户名称，就表示在此终 瑞中此用户名的所有流水纪录2. 第三方对帐文件（1）选择预先设宣好的方案，（方案设宣方法请看方案设宣说明）（2）对账文件处选择要对账的文件。设置完成即可开始对账。对账请确定选择条件的准确。否则无法完成对账。（例：如果 第三方対账文件中不池含持卡人帐号信息，而却在一卡通中选择了持卡人帐号，这样将造成 系统无法

27、对账。因为对帐数据无法対应。）3方案设置（图17）图17方案设置是为了对帐系统能够识别和处理第三方系统対帐文件屮的流水信息。对帐系统 可以为不同的第三方系统设置不同的方案。这样在以后对比此第三方系统流水时就可以选择 对应该系统的方案设置。使用方法：分割符处填写对帐文件用J：分割字段的分割符，对账文件处选择对账的文件, 系统将按分割符把文件中的第行消级流水中所包禽的了段读到卜边的衣中，然后用户选抒 字段按鼠标右键设置半前字段对应的信息。（例：20489是账号信息，就点中20489按鼠标 右键选账号信息。）设置完字段对应的信息后在方案名处为方案起名并保存。以后对比此第 三方系统对账文件时即可选择此方案。六.消费査询（图18）图18消费代询可以让管理员及时准确的r解第三方系统在一卡通中的消费流水情况。