浅谈一卡通前置服务与配置说明

1、浅谈一卡通前置服务与配置说明刖旨在海南进行自助设备上线支持工作时，对his 卡通前置服务又进行了一个大的调整, 在服务功能变得强大的同时，同时也改变了服务配置的方式，这样的改变对着实施的难度增 加了不少，回来就准备着手对his 卡通前置服务的说明文档进行重新的整理，由于这次出 差时间较长,积累的重要问题较多，同时也临近两个his版本问题（10. 30. 30,10.31.0）的最 后修改时间,借着这篇文章的机会，带领大家进入一卡通前置服务的成长历程,希望不管是对 正准备实施一卡通,还是已经完成过一卡通上线的同事都有所帮助.前置服务简介his 一卡通在多家医院的使用，一卡通前置服务在一卡通业务中

2、也逐渐体现出其的重要 作用.his前置服务：简单的来说就是对为三方机构提供服务支持和对his请求进行转发的服务程序,服务内 部使用socket采用tcp连接的方式以gb2312格式（编码格式可设置）进行信息通信，目前, 主要有两种作用：一种是his作为服务（即银行向his发送请求），一种是银行作为服务（即 his向银行发送请求）。下面我们就由着前置服务的两个作用开始我们的探索之路1自助服务三方机构诸求i签约 预约挂号等医院ijij-置服务器zlsocketservice服务启动服务hisijk务配置业务响应停卡服务调用诅用zllnitializationzllnitconfigzisocket

3、svreve ntzisocketsvreve ntzisocketsvrevent.dllhis服务器炳人信息病人医疗卡倍息病人挂号记录图1：前置服务提供自助服务从图1中的流程中可以看出；医院前置服务顺序为三方机构发送请求-> 医院的前置服务 器->his服务器;在医院的前置服务器中，其核心部分有两个：一卡通前置服务服务程序 （z i socketserv i ce 服务程序）和 z i socketsvrevent. d i i 部件，z i socketsvrevent 部件属于开 放部件，由渠道或客户等自行编制，供前置服务访问调用.（关于zlsocketsvrevent.d

4、ll部件 编写详情见 通配置说明.docx）,前置服务通过接收到的服务调用zlsocketsvrevent部 件完成签约、预约等等的请求，然后将处理结果通过前置服务回传给三方机构。zlsocketser vic©服务:.方动态dll2请求转发第三宜接提 供动态比如:nsposhts数据库图2:前置服务转发请求图2中的客八端为部署了部件的his业务站点，在一卡通业务中有两种方式想第三方进 行请求，一种就是三方机构玄接提供dll完成通信请求，第二屮就是我们的前过服务进行请求 的转发来完成通信任务；在使川前置服务进行通信任务时，需耍设置三方机构通倍地址.前置服务改进分析通过一卡通流程中前置

5、服务部分的介绍，相信已经能够明白前置服务的工作原理以及其 在一卡通业务中承担的任务。在一卡通前置服务诞生以来经过了两次重要的改进,一次是在吉林中心医院进行了性能 的优化，服务吞吐能力的提高.第二次则是在海南省人民医院对服务进行重构，使服务能够支 持多端口监控的同时，支持了服务程序的多开增加了其使用范围。程序类型服务+程序服务+程序程序参数保存注册表注册表参数文件参数设置方式界面设置界面设置参数文件监控图标无有o有邀最大连接数2050 10050 130cpu闲置52000工作20+020ris内存闲置12256k8056k7504k工作30m+250m250m实时监控是否否服务多开否否是表1：

6、功能调整对比说明：表1中将bate版本的前置服务与第一次调整（吉林中心医院改进）和第二次调整（海南省人民 医院调整）后的服务进行了对比通过对表1的分析也可以看出，在第一次改进时，主要是对性能方面进行了改进,解决了 程序最大的瓶颈，也就是性能问题.其中将服务请求由多线程管理调整为使用线程池对线程进行管理是性能提升的关键，在 去掉了实时监控这个可有可无的功能后,在资源占用上也有所优化.第二次的改进，在海南省人民医院和银行进行一卡通接口时，需要开放不通的端口提供 自助服务,而且院方也正在积极的和另外的银行沟通，希望能够和多家银行进行合作为了对 请求来源进行更好的管理，同时也为了以后增加合作单位时，更

7、好更简单的开展工作的情况 下，对服务程序进行了重构，改变以前界面配置参数，并且参数保存到注册表,导致只能单开 服务的弊端最后确定为调整服务使用参数文件（xml格式文件）保存参数，直接修改参数文 件进行配置.服务配置说明说明：1这里的参数介绍针对第二次修改后的服务进行介绍，如果你使用第一次修改后的服务可到” 一卡通 配置说明.docx”中查看详情2. 参数文件采用xml格式进行保存，建议使用notepad+, uestudio等拥有xml格式着色功能的编辑器 对参数进行编辑3. 服务程序采用csharp进行编写,需要.net framework3. 5的支持1程序安装与首次运行中联一诈通服务ms

8、iwindows installer 程序包469 kb图3服务安装包图3为程序安装包，按照正常的程序安装即可，安装完成后会在安装目录下产生如下文 件图4:程序安装目录图4为程序安装完成后，安装目录中文件，图中区域【1】的文件在程序安装后产生，区域 2的zlsocketservices, xml文件一会要对其进行分析的配置文了，区域【3】的文件在服 务首次启动时产生,属于服务的配置文件，一般情况下不需要进行特殊的配置,在本文中也不 对其进行详细讲解.2服务配置文件三方眼务 、 v!医zlcard,* * *. dlli±rj务，清求的运誉丢务奏圭田 戈這息一戒为罢尸提供一1 ：三方眼

9、务vif 地址 >6</ipig 址。一医gezlcard_*.dll«il®«riw的送卷蜜务黯之口号 及埔口号一段为餵行提供"<2» 口号>9988</命 口号<!一编码洛式为:gb2312 utf-8 ascii unicode=et遷當='吏毛的離隹室弍 建议使圣gb2312格式的走三一> <编码幣式xs2312c/穽三夸式/三方眼务。一週讯日志保存的路役"< e $文件路径>d: zlsocketservice</ e总文件路径2

10、 ：月艮务匡宣<!一通時中是否保存通讯记录主要弔于穫宁谒试时可以査泛週讯记录0不保存一氓存一v保存週塔日志>0</保存通 b环境谒试环埃时，两妥于功贞密技0启功舉务取奢关闵侵务"调试状«>l</il试状态3:自助服务<!hospital 医境眼务 bem> <hospital>v!医読绳供服务的本地ip地址"<医規服务ip地址>6</医天聂务ip地址c一医疑握供给第三方机恂通涪的岂口列表一自助眼务第口列表><!-【仅通信一次mttj &服务芫或一次务主

11、功斷开在某垃将定环填下选用<自助味务端口仅週害一次-»0->8088</自助黴务>><自助脈务端口仅週言一决i（t>808火/自助袈务史口</自助脈务吗口列表<! 一监听匡茨216"_"1週迟口一> <卡通竖听端口 >9988</通鉴孑三口<! 一服务在谒用vb动态至（zlsoc炷rsvrevzt）討来三考走电式耳矣戏宇符串逹尸处理还是直棗塗弔byte辻行作为参丈耳尸泛w 0使手宇符串 l-byte（对应vb byte（）>自助脈务:方戒>0</包助眼务遇習方式&

12、quot;1、</root>图 5:参数文件 z isocketservices. xml 内容对参数文件进行设置，主要进行三个内容块的设定,分别为服务程序本身的配置（图中2）、自助服务配置（图中3）以及服务请求转发配置（1 :三方服务），服务程序配置调试状态:用于区分是否为调试开发环境，在一卡通接口开发调试阶段设置参数值 为1,需要手动对服务进行启动关闭以及重启操作。在正式使用上线后，设置为0,服务在 程序启动时，自动启动服务，同时依然可以在服务托盘图标处，使用右键菜单对服务进行 设置以及启动关闭操作保存通信日志:设定是否保存通信日志，保存日志则值设为1,同时需要指定服务日 志保

13、存路径，默认为d:zlsoftketservice目录保存日志服务转发图5中位置1处，为设置服务请求转发参数设置.在一卡通通过前置服务转发请求时, 设置此块参数.ip地址:第三方机构（一般为银行或者与银行合作的设备厂家）接收请求的ip地址. 端口号:第三方机构（一般为银行或者与银行合作的设备厂家）接收请求的端口号. 前置服务接收到医院站点的请求后，向三方提供的地址进行请求，在和三方机构通 信完成后将结果，返回给医院站点编码格式:在和第三方机构通信时，使用的编码格式，默认使用gb2312格式进行通 信，编码格式可设置 自助服务配置医院服务ip地址:为服务程序本机的ip地址，在参数文件创建时默认了一个本机的 ip地址，如果本机存在多个有效ip地址，而默认的不是需要使用的ip地址时，可手动修 改此参数为正确的ip地址自助服务端口列表:设置提供自助服务端口列表，此处可开放多个端口进行设置，默 认只开放端口为8088的端口，如果需要开放多个端口，增加自助服务端口节点即可， 此处需要