中国银行排队机系统技术标准

模板版本:V3.0.0.0密级：普通普通普通普通中国银行中国银行中国银行中国银行排队机排队机排队机排队机上线上线上线上线指南指南指南指南之之之之技术标准技术标准技术标准技术标准版本版本版本版本::::1.0.0.01.0.0.01.0.0.01.0.0.0总行个人金融部、软件中心文档修订记录文档修订记录文档修订记录文档修订记录版本*变化状态修订说明日期变更人V1.0.0.0M发布前结构修订2012-6-29*变化状态：A——增加，M——修改，D——删除1一、中国银行排队机硬件配置标准概要本标准适用于中国银行排队机系统，目的在于对排队机厂商提供的硬件设备进行统一规范，以利于软件的兼容性、稳定性及统一管理。除非特别说明，本标准列举的内容均为厂商必须符合的要求。1111总体要求总体要求总体要求总体要求网点排队设备包括排队主机、条屏、综合屏、呼叫器、评价器及无线音箱,详见下表。系统的架构为X86硬件WindowXp操作系统上的应用。排队主机与设备之间采用无线方式进行通信。设备数量说明排队机主机1-2台/网点采用X86硬件架构,安装WindowsXP操作系统条屏1个/窗口显示本窗口叫号信息综合屏1-2个/网点显示整个网点叫号信息呼叫器1个/窗口柜员用此设置呼叫客户评价器1个/窗口客户对柜员服务评价的设备无线音箱根据网点需要配置当排队主机内含音箱不能达到要求时,在网点合适位置安装音箱2222分项要求分项要求分项要求分项要求2.12.12.12.1排队主机排队主机排队主机排队主机子设备/模块条目要求触摸屏分辨率1024*768(横屏)或768*1024(竖屏)屏幕校正排队机出厂时必须安装屏幕校正软件打印机字库GB18030打印图片打印logo图片（彩色或灰阶图片）打印字体至少支持黑体，宋体2打印大小通过二位数字控制大小，第一位表示宽度，第二位表示高度打印位置能控制打印的上/下/左间距得到设备状态至少能检测是否缺纸二代身份证阅读器刷卡器功放音量控制能够以硬件的方式提供手动调节音量功能扬声器/内置音箱音量人声清楚,无杂音CPU主频1.6G以上硬盘容量7200转，80G以上设备无线通信模块通信范围半径50米内存容量1GB或以上轮询板模块通信范围半径50米网卡通信速率100Mb/s以上外观符合人机工程、符合我行CI要求2.22.22.22.2窗口条屏窗口条屏窗口条屏窗口条屏项目要求设备地址可以通过外部设置软件或者拨码器修改设备的地址版本信息版本信息记录在硬件中,可通过软件方式获得硬件的版本信息设备上电显示设备的地址和版本信息显示长度4～12个汉字的长度显示样式至少支持静止显示,从左往右显示,从右往左显示,从下往上显示,从上往下显示,闪烁显示6种方式字库及显示方式支持GB18030字库,任意显示单元都可以显示字库中的任意字符显示的格式提供控制显示格式的功能，使用配置文件和指令参数方式控制实现得到设备状态至少能检测是否在线2.32.32.32.3综合屏综合屏综合屏综合屏项目要求设备地址可以通过外部设置软件或者拨码器修改设备的地址版本信息版本信息记录在硬件中,可通过软件方式获得硬件的版本信息设备上电显示设备的地址和版本信息显示长度至少8个汉字的长度3显示行数至少2行汉字的宽度显示样式每行的信息至少支持静止显示,从左往右显示,从右往左显示,从下往上显示,从上往下显示,闪烁显示6种方式，有新的信息送入，当前显示的信息往上移动。字库及显示方式GB18030,任意显示单元都可以显示字库中的任意字符显示格式提供控制显示格式及信息上推时间的功能，使用配置文件和指令参数方式控制实现得到设备状态至少能检测是否在线2.42.42.42.4呼叫器呼叫器呼叫器呼叫器项目要求设备地址可以通过外部设置软件，设备内部设置或者拨码器修改设备的地址版本信息版本信息记录在硬件中,可通过软件方式获得硬件的版本信息设备上电显示设备地址和版本信息屏幕显示的长度至少支持14个字符显示和输入（7个汉字长度）屏幕显示的行数2行或者2行以上,任意显示单元都可以显示字库中的任意字符显示汉字能显示字库集GB18030中所有汉字，输入英文输入26个英文字母（大/小写）输入数字输入0～9阿拉伯数字提示声至少有1种声音按键通过单键或组合键的方式实现：登录、注销、呼叫、暂停、恢复、重呼、转移到柜台、转移到业务队列、呼叫指定号码、特殊呼叫，其中，“呼叫”必须以单键的方式操作并采用较大的按键放于显要位置方便使用。得到设备状态至少能够检测是否在线2.52.52.52.5评价器评价器评价器评价器项目要求设备地址可以通过外部设置软件，设备内部设置或者拨码器修改设备的地址版本信息版本信息记录在硬件中,可通过软件方式获得硬件的版本信息设备上电显示设备的地址和版本信息(有显示屏时)播放声音能够播放：1欢迎光临；2请评价；3谢谢评价,再见按键至少有3个按键，能送出不同的评价信息。超时可以通过配置来控制评价超时时间（默认为10秒），并送出未评价信息得到设备状态至少能检测是否在线柜员信息显示能通过插卡折方式在评价器上显示柜员的相片、姓名、工号4二、中国银行排队机系统软件////驱动程序接口标准中国银行排队机系统软件/驱动程序接口标准Ver1.9日期：2012-6-295修订记录编号日期描述版本作者审核12011/6/2增加了无线多媒体音响指令说明，增加了评价器显示柜员号和服务星级指令,删除了打印机相关的驱动程序标准V1.1刘东映22011/6/7修改示例中的设备地址串V1.2刘东映、高吉明32011/6/29新增二代证阅读器、刷卡器和打印机V1.3高吉明42011/7/5修改了设备定义格式，增加了Dev_typeV1.4刘东映52011/7/63.2读取呼叫器消息的参数描述V1.5高吉明62011/7/20删除刷卡器、打印机的多余说明。产家只需提供满足WOSA/XFS标准接口即可V1.6高吉明72011/7/27删除通用设备控件需求V1.7高吉明82011/7/27修改无线音箱命令格式V1.8刘东映92011/7/29修改了设备发出消息说明部分V1.9刘东映61.前言本标准目的在于对排队机厂商提供的硬件设备及配套的驱动程序进行统一规范，以获得多个厂商软硬件的兼容性和稳定性。除非特别说明，本标准列举的内容均为厂商必须符合的要求。通用设备：二代证阅读器、刷卡器、打印机专用设备：窗口屏、综合屏、呼叫器、评价器、音箱、无线音箱72.总体说明2.1.通用设备通用设备驱动必须满足WOSA/XFS标准的控件形式提供。2.1.1.2.1.1.2.1.1.2.1.1.通用设备SPSPSPSP的需求A）在SP在执行任何命令时必须捕捉所有异常，不能发生不可预知的异常导致SP崩溃。B）在SP在执行任何命令时无论正确和错误都必须能够结束并返回，不能发生死循环或结束后不返回或不向XFSMananger发送Complete消息。C）SP在执行任何命令（包括阻塞式命令）时，对CPU的长时间占用率不能超过10%，对内存资源的占用率不能超过50%，瞬间的峰值允许达到100%但是持续时间不能超过50毫秒。D）SP在执行任何命令完成时必须按XFS标准规定的本条命令的错误码返回错误值，不能返回XFS未定义的错误或者其它命令的返回值。E）SP在执行任何命令完成时SP为执行此条命令临时创建并使用到的资源必须全部释放，不能发生内存泄露。在SP完全卸载时所创建的全部资源都必须释放。F）SP执行任何命令时不能要求输入XFS标准中没有说明的自定义参数。输出参数也必须按XFS标准规定的类型和格式输出，不能输出XFS标准中没有说明的自定义参数。G）SP执行任何命令时发生和应用的连接意外中断，必须向XFSManager发送WFS_SYSE_APP_DISCONNECT系统事件，在事件参数WorkstationName中说明SP所在的主机名，在事件参数LogicalName中说明本连接的逻辑设备名。同时清理本连接所占用的资源。H）SP执行任何命令发生错误导致SP或硬件设备无法继续工作时，必须向XFSManager触发WFS_SYSE_HARDWARE_ERROR或WFS_SYSE_SOFTWARE_ERROR或WFS_SYSE_USER_ERROR事件，在事件参数WorkstationName中说明SP所在的主机名，在事件参数LogicalName中说明本连接的逻辑设备名，在事件参数PhysicalName中说明发生异常的物理设备名，在事件参数Action中说明如何处理该错误。8I）SP执行任何命令过程中导致设备状态发生变化时或没有任何命令执行设备状态也发生变化时，必须向XFSManager触发WFS_SYSE_DEVICE_STATUS系统事件，在事件参数WorkstationName中说明SP所在的主机名，在事件参数PhysicalName中说明发生状态变化的物理设备名，在事件参数dwState中说明变化后的状态。J）XFS标准中规定的WFS_SERVICE_EVENT、WFS_USER_EVENT、WFS_SYSTEM_EVENT这三类事件只要满足触发条件，即使没有任何命令在执行,SP都必须向XFSMamager触发。K）SP必须支持远程访问，应用层可以通过WFSOpen连接建立和本机SP或远程SP的逻辑连接。无论本地或远程的SP只要发生逻辑连接的异常中断都必须按第G条所描述的触发事件。L）SP必须支持共享访问，多个应用程序或一个应用程序可以建立和一个SP的多个逻辑连接，每个连接都能对SP发起命令调用并得到执行，各连接之间的调用不能相互干扰或导致崩溃、死锁。任何一个逻辑连接的拆除不能影响其余逻辑连接的继续使用。2.1.2.2.1.2.2.1.2.2.1.2.通用设备配置的需求A）主机名称WorkStationName按XFS规定取设备所在的计算机名称。B）在注册表HKEY_LOCAL_MACHINE\SOFTWARE\XFS\SERVICE_PROVIDERS路径下的每个具体的SERVICE_PROVIDER配置项中增加一个配置WorkStationName用于说明提供该设备服务所在的主机名称，是远程的就提供远程的主机名，是本地的就提供本地的主机名。C）在注册表HKEY_USERS\.DEFAULT\XFS\LOGICAL_SERVICES路径下的各个逻辑设备名命名规范如下：二代身份证读卡器：IDCardReader刷卡读卡器：SWCardReader打印机：ReceiptPrinter2.2.专用设备网点端应用子系统的硬件设备包括主控机(网点排队控制器,应与取号机整合为一体）和各类终端设备。本文档主要针对部署在主控机上的各类硬件设备的驱动程序接口标准。模块协作关系图如下：9排队设备网点端排队模块(BSMA_C)设备总控API(DLL)条屏呼叫器评价器主屏音响由厂商提供(C)由项目组提供(JAVA)JNIBSMA_C采用JNI的方式调用厂商动态库驱动排队设备，厂商必须保证驱动程序的稳定性，对发生的异常给予捕捉和处理，以免由动态库导致整个JVM崩溃。2.2.1.2.2.1.2.2.1.2.2.1.专用设备动态库要求厂商提供的设备驱动程序必须以DLL文件（及附属文件）的方式提供完整的功能，而不能依赖于任何其它独立的执行程序。所有厂商的文件（包括DLL文件及附属文件），均须放在以厂商英文小写名称命名的目录（后称厂商目录）下面，厂商目录的内部组织由厂商自行管理。厂商的DLL运行时必须以厂商目录作为相对路径的起始目录，因而，无论厂商目录复制到任何地方均应能正常工作。动态库要提供详细的日志，以方便问题的排查和定位。建议厂商产生的所有日志均放在厂商目录下的Trace目录下，每个dll每天一个日志文件（如南天dev_sound.dll的日志为：nantian\Trace\dev_sound.log.yyyy-MM-dd），并自动删除30天前的日志,厂商驱动程序详细描述见第8节。所有传入参数中的路径，都应允许同时使用“/”或“\”作为路径分隔符，DLL应能自动识别（或转换）