浙江省医院信息交换技术规范.doc

浙江省医院信息交换技术规范872020年5月29日文档仅供参考浙江省医院信息交换技术规范(试行)(V1.1)浙江省智慧健康平台项目组二一四年五月修订日志31前言41.1编写目的41.2术语和定义41.3参考标准52接口设计62.1接入流程62.2接口技术112.2.1服务调用112.2.2服务接入152.2.3消息体结构162.2.4数据集结构192.2.5数据集业务时间配置592.3传输监控602.4数据质控602.5医院前置机配置602.6约定说明612.6.1超时控制612.6.2传输频率612.6.3更新上传623.服务调用场景示例623.1数据上传服务调用示例场景623.2 EHRView健康档案浏览器调阅65修订日志修订时间形成版本修订内容备注 -12-10V1.0初稿 -4-22V1.1修订 -5-13V1.11.修改2.2.1服务调用参数填写说明;2.新增2.2.2服务接入 1.排队叫号说明 接口服务提供3.心跳接入说明心跳接入,还是采用统一的invoke方法,参数不同而已。 -5-14V1.11.门诊处方记录增加5个药物标志 -5-22V1.11.ehrview调用增加调用者参数 -6-19V1.11.修改2.2.2服务接入中排队叫号相关内容1前言1.1编写目的结合卫生部卫生信息化试点项目目标和要求以及浙江省卫生信息化”十二五”规划,搭建浙江省智慧健康平台的基础架构和基本功能;完成卫生信息标准框架建立;依托卫生信息平台建设,实现医疗卫生机构互联互通,支撑广泛的健康档案、临床诊疗和公共卫生服务相关信息的共享和业务协同。实现区域平台的开放运营,从而促进医疗信息化的发展。本规范以医院信息采集为目标,帮助各接入医疗机构和软件开发商了解和掌握该接口定义的规范和接口的使用方法。1.2术语和定义1.2.1健康档案(Health Record ) 健康档案是居民健康管理(疾病防治、健康保护、健康促进等)过程的规范、科学记录。是以居民个人健康为核心、贯穿整个生命过程、涵盖各种健康相关因素、实现信息多渠道动态收集、满足居民自身需要和健康管理的信息资源(文件记录)。来源:1.2.2 区域卫生信息平台 区域卫生信息平台,是连接区域内的医疗卫生机构基本业务信息系统的数据交换和共享平台,是不同系统间进行信息整合的基础和载体。从业务角度看,平台可支撑多种业务,而非仅服务于特定应用层面。来源:1.2.3 基于健康档案的区域卫生信息平台(EHR/RHIN) (Electronic Health Record /Regional Health Information Network)以区域内健康档案信息的采集、存储为基础,能够自动产生、分发、推送工作任务清单,为区域内各类卫生机构开展医疗卫生服务活动提供支撑的卫生信息平台。平台主要以服务居民为中心,兼顾卫生管理和辅助决策的需要。基于健康档案的区域卫生信息平台,在下文中简称为本平台。来源:1.2.4数据元 数据元是经过定义、标识、表示和允许值等一系列属性进行规范描述的基本数据单元,在特定的语义环境中可认定为不可再细分的最小数据单元。来源:1.2.5值域 值域是一组数据元允许值的集合。一个允许值是某个值和该值的含义(值含义)的组合。 来源:1.2.6 主索引(MPI)用于将不同系统中的个人信息匹配起来,由平台统一生成一个唯一id号(MPIID)。1.3参考标准卫生部(WS 363.1- )卫生部(WS 364.1- )卫生部(征求意见稿)浙江省卫生厅浙江省卫生厅2接口设计2.1接入流程平台提供WebService服务,供医院接入系统调用,实现与平台的交互。前置机适配器接入流程图第一步:ip权限管理、密钥权限管理 维护调用方的接入权限。(医院系统管理员操作)Ip权限维护:用户登录前置机管理系统,在标签栏点击”权限管理”,然后在左边功能区中点击”IP权限管理”模块,界面显示如下图:在界面上方点击【新建】按钮,打开新建界面,如图 策略名称、起始地址和结束地址为必填项 策略名称不能重复 起始地址和结束地址必须在同一地址段 ”是否可用”选择”是”,才可被密钥权限管理调用密钥权限维护:用户登录系统,在标签栏点击”权限管理”,然后在左边功能区中点击”密钥权限管理”模块,界面显示如下图:在界面上方点击【新建】按钮,打开新建界面,如图 接入系统编号、接入系统名称、密码、ip策略和机构编号为必填项 接入系统编号不能重复 ip策略调取IP权限管理中设为用的策略 ”是否可用”选择”是”,密钥才能使用第二步:字典对照维护:如要验证字典文件需要进行这一步操作。(医院系统管理员操作)字典服务示意图:平台提供统一的字典服务器,包含所有字典目录,支持各应用系统查询下载字典,也支持医院本地字典的上传,以及医院本地字典和中心字典的对照管理。操作流程说明:1) 用户登录系统,在菜单栏选择”标准管理-字典管理-字典分类目录”,打开页面如下图:图中左侧是医院字典分类列表、右侧是中心数据字典列表。界面上方的文本框是快速查询过滤框。在这里,需要将医院自定义的字典和中心定义的字典进行映射,这样才能进行下一步的操作。2) 用户登录系统,在菜单栏选择”标准管理-字典管理-字典对照”,打开页面如下图:图中左侧是字典分类列表、中间是业务字典、右侧是中心数据字典。界面上方的文本框是快速查询过滤框。在主界面中选择一个字典类型,可根据”字典分类列表”下文本框进行快速查询,如人的性别,如下图:界面中医院字典状态为表示字典已匹配,状态为表示未匹配; 添加数据:添加业务字典点击【添加数据】,会再列表中添加一列,输入医院代码、医院值后,添加完【保存配置】。 手动匹配:在医院数据字典下选中一个未匹配的字典,双击中心数据字典下选择需要进行匹配的字典项,即可匹配成功,匹配完【保存配置】; 自动匹配:点击【自动匹配】,系统会自动将未匹配的医院字典与中心数据字典。匹配规则是将医院值相同的两个字典进行匹配; 【取消】:将已经匹配的字典进行取消匹配; 【删除】将已经添加的医院字典项进行删除;第三步:数据抽取异常配置:维护错误日志发送的邮箱。(医院系统管理员操作)该步骤可选。用户登录系统,在标签栏点击”参数配置”,然后在左边功能区中点击”数据抽取异常配置”模块,界面显示如下图:新增源应用:在界面上方点击【新建】按钮,打开新建界面,如图 源应用为必填项且不能重复,与错误日志中的源应用对应,将错误日志和维护的源应用相同的日志发送到该邮箱; 邮箱地址和手机号码至少需要填一个; 设置是否发送后,系统会自动发送错误报告到用户邮箱或手机;第四步:接入前置机,录入第一步维护的系统接入编码及密码,并进行权限认证。(系统接入商操作)第五步:如第四步验证经过的话,则开始上传bsxml结构的数据。第六步:查看定时上传日志:数据上传正确,点击”传输日志”查看;数据上传失败,点击”错误日志”查看。(系统接入商操作)2.2接口技术2.2.1服务调用平台提供统一WebService服务,调用地址:http:/ip:port/WebServiceEntry?wsdl(当前前置机默认端口号为:8888)1.接口说明:public String invoke (String appID, String pwd, String service, String method, String param);接口名称invoke功能描述数据交换统一入口参数参数名称参数描述appIDWeb服务接入应用id (前置机系统维护)pwdWeb服务接入密码 (前置机系统维护)service能够调用的服务名称method能够调用的服务名称对应的方法名param该参数是字符串数组,包含XML消息体。异常当请求内容或格式有误,或者上传过程中发生其它错误时,返回给应用系统返回结果结果类型描述传输成功调用成功返回200。传输失败返回错误信息备注无2.现有发布功能参数填写说明由参考示例改为”现有发布功能参数填写说明”接口类型参数appIDpwdservicemethodparam定时上传前置机系统维护adapter.transportServicetransportDataByXmlContentparam是指接入商拼装的bsxml数据集,如果有不同的数据集需要上传,则修改数据集内容就能够传输不同的数据集。检验实时上传ehrview.labReportTransportServicesubmitBSXMLDocument检查实时上传ehrview.examReportTransportServicesubmitBSXMLDocument心跳接入esb.heartbeatServiceheartbeatappId(医院端应用程序的唯一识别号,由平台提供给医院)、versionNumber(医院端应用程序版本号,由平台提供给医院)3.示例代码l JAVA调用示例代码public static void main(String args) try URL url = new URL(:XXXX/WebServiceEntry?wsdl);QName qname = new QName(,WebServiceEntryService);Service service = Service.create(url, qname);WebServiceEntry s = service.getPort(WebServiceEntry.class);System.out.println(s);String result=getReSult(1412, 123, esb.serviceInvokeStat, getStatByHours, 1, -10-17 00:00:00)System.out.println(result-+result); catch (MalformedURLException e) e.printStackTrace(); catch (Exception_Exception e) e.printStackTrace();public String getReSult(String appId,String pwd,String service,String method,String params)String result=;if(appId.isEmpty()|pwd.isEmpty()|service.isEmpty()|method.isEmpty()|param.toString().isEmpty()result=调用方法出错,请检查输入信息!;return result;try URL url = new URL(:XXXX /WebServiceEntry?wsdl);QName qname = new QName(,WebServiceEntryService);Service webService = Service.create(url, qname);WebServiceEntry s = webService.getPort(WebServiceEntry.class);result = s.invoke(appId, pwd, service, method, params); catch (Exception_Exception e) e.printStackTrace(); catch (MalformedURLException e) e.printStackTrace();return result;1. 应用系统需要取出标签中的内容,里面的内容就是平台返回的XML结构2. 下面涉及到的所有返回参数,都是基于result的结构的,返回参数全部都在”标签下。Xml实例:901数据不符合要求,节点RecordClassifying不存在l PB调用示例代码OLEObject adapteradapter = CREATE OLEObjectadapter.ConnectToNewObject(BSRHIN.WSAdapter);/设置前置机分配的应用标识adapter.setAppId(his)/设置访问密码adapter.setPassword(xxxxxx)/设置前置机Web service的url地址adapter.setUrl(:port/WebServiceEntry)/设置要调用的服务名和方法名adapter.setupService(serviceName,method);/以上代码可初始化的时候设置一次,即可使用下面的代码重复调用。/清除上次调用的参数adapter.clearParameters()/设置第1个调用参数adapter.addParameterValue(arg1)/设置第2个调用参数adapter.addParameterValue(arg2)/设置第n个调用参数,具体的参数数量和说明参见详细服务接口adapter.addParameterValue(argn)/调用服务,返回结果string resutresult = adapter.InvokeService()/业务处理DESTROY adapter1. 应用系统需要取出标签中的内容,里面的内容就是平台返回的XML结构2. 下面涉及到的所有返回参数,都是基于result的结构的,返回参数全部都在”标签下。Xml实例:901数据不符合要求,节点RecordClassifying不存在l DELPHI调用示例代码var str: Variant; adapter:Variant;begin adapter:= CreateOleObject(BSRHIN.WSAdapter);/设置前置机分配的应用标识adapter.setAppId(EditAppId.Text);/设置访问密码 adapter.setPassword(EditPassword.Text);/设置前置机Web service的url地址adapter.setUrl( http:/+EditUrl.Text +:8080/WebServiceEntry);/设置要调用的服务名和方法名adapter.setupService(adapter.transportService, transportDataByXmlContent);/设置第1个调用参数adapter.addParameterValue (dataContent:+EditContent.Text+);/业务处理 str:=adapter.InvokeService;end;1. 应用系统需要取出标签中的内容,里面的内容就是平台返回的XML结构2. 下面涉及到的所有返回参数,都是基于result的结构的,返回参数全部都在”标签下。Xml实例:901数据不符合要求,节点RecordClassifying不存在2.2.2服务接入1.排队叫号1.1 医院端提供查阅服务增加此服务接口,是为了提供院方对平台访问的可控性,需暴露基于Webservice的2个方法: 1.1.1获得本医院的科室列表方法名称:map getDepartmentList()输入:无输出:科室编码和科室名称的对应信息 1.1.2获得本医院的排队叫号信息方法名称:map getQueueInfo(String xml)修改参数为xml接口参数xml说明:机构编码 * * * 查询类型 输出:当前科室、当前挂号类别、当前专家名称的实时排队叫号信息(内容参考排 队叫号视图输出)1.2 医院端提供排队叫号视图,建立视图名称:v_pd_callinfo,包含以下字段:docid(队列编码 【专家编码或者科室编码 】) doctype(队列类型 【1专家(名医、特需)、2科室、3检验检查】专家包括名医、特需等,增加检验检查队列 )docname(队列名称)currnum(当前队列号)deptid(科室ID)deptname(科室名称)type(时间:1.上午,2.下午)Position(医生职称)warea(候诊区)经院方确认,增加候诊区,方便用户。2.2.3消息体结构消息体是传递信息的载体,在本文中以XML格式进行描述,意在说明消息体中承载着客户端的请求和服务端响应返回的有关信息。依据XML可扩展标记语言的定义,一个消息体对应着一个名字,而每个XML文件又有特定的根标记,用于记载通讯传输中交互的独立于程序的结构化数据。在本规范中,请求消息用请求消息名(Request)作为根节点,根节点下包括两个部分:消息头Header(文档信息和患者基本信息)与消息体 Body (交易业务内容)。其中,消息头 Header用于存储交易请求的文档信息和患者基本信息方面的数据,而消息体Body作为消息体,用于存储交易请求的业务数据。返回消息用返回消息名(Response)作为根节点,根节点下包含返回消息编码(code)和消息(Message)。在本文档中以表格的形式表示XML格式,以下为表格中对元素约束(出现次数)的表示方法的描述:符号含义?0.1,可选项*0.n,能够没有,也能够有多项+.n,至少有1项,也能够有多项1数字1,代表必须且只能填1项1.请求消息XML结构体标签说明必填备注文件头节点是文档节点是InpatientRecordHome记录分类是由第三方系统集成商写 入住院病案首页记录名称是 -06-07T09:28:30业务发生时间是由第三方系统集成商写入,时间格式为:YYYY-MM-DDThh24:mi:ss592885来源标识否由第三方系统集成商写入,本条body数据在医院内部的唯一标示号1.0版本号是221211作者(医生身份证号)否由第三方系统集成商写入王强作者(医生姓名)否由第三方系统集成商写入(可选) -06-07T09:28:30录入系统时间是由第三方系统集成商写入,时间格式为: YYYY-MM-DDThh24:mi:ss患者信息节点是周菁姓名是由第三方系统集成商写入2性别是由第三方系统集成商写入,见性别代码1968-06-16出生日期否由第三方系统集成商写入,可作为个人信息准确定位3202305证件号是由第三方系统集成商写入,证件号和卡号两者必填一03证件类型否由第三方系统集成商写入,见证件类别0056180卡号是由第三方系统集成商写入,证件号和卡号两者必填一02卡类型否由第三方系统集成商写入,见卡类别,有卡号必须填写 03发卡机构否由第三方系统集成商写入,见发卡机构字典,有卡类型必须填写02/AddressType地址类型否由第三方系统集成商写入,见地址类型杭州市西湖区文三路199号地址否由第三方系统集成商写入联系电话否由第三方系统集成商写入文件体(业务数据)是DocFormat属性为body中内容的属性,见卫生信息交换类型具体业务数据(详见数据集标准)将来要检查数据项是否符合规范2.字典上传格式业务数据集拼装XML消息体时,对字典节点内容的规定:1性别localText=”男性”为医院本地名称,”1”为医院本地代码,均必填。3.业务数据集业务数据集作为请求消息的消息体内容,以XML格式组织,在消息传输时作为请求消息的消息体 Body部分和Header一起传输。具体描述请参照2.2.3小节内容。4.返回消息返回码Code 为200,说明客户端请求得到了服务端正确响应,返回码Code不是200,请参见返回信息中的错误描述。XML结构体备注 901成功返回200 数据不符合要求,节点RecordClassifying不存在 2.2.4数据集结构1.挂号序号父节点标识符名称类型长度字典约束说明0BodyOpt_Register挂号表-1节点属性Name必填,如:1Opt_RegisterJZLSH就诊流水号S1AN.34?医院门诊/住院顺序号,医疗机构内部唯一编号。2Opt_RegisterGHKSDM挂号科室代码S3AN.15CVX_DepartmentCode1节点属性localText必填,取值为医院内部名称;节点值为医院内部字典编码。如:13Opt_RegisterGHLSH挂号流水号S1AN.341在本机构内唯一标识本次挂号的流水号4Opt_RegisterPDXH排队序号S1AN.341科室排队序号5Opt_RegisterKH卡号S1AN.3316Opt_RegisterKLX卡类型S3N.2CVX_CardType1节点属性localText必填,取值为医院内部名称;节点值为医院内部字典编码。如:17Opt_RegisterGHRQ挂号时间DTDT151完整时间表示格式,即DT15,YYYYMMDDThhmmss的格式8Opt_RegisterGHLB挂号类别S3N.2CVX_RegisteredCategory1节点属性localText必填,取值为医院内部名称;节点值为医院内部字典编码。如:19Opt_RegisterTHBZ退号标志S2N1CVX_WithdrawalMark1节点属性localText必填,取值为医院内部名称;节点值为医院内部字典编码。如:110Opt_RegisterGHFS挂号方式S2N.2CVX_RegisteredWay1节点属性localText必填,取值为医院内部名称;节点值为医院内部字典编码。如:111Opt_RegisterGHF挂号费NN.10,2112Opt_RegisterZLF诊疗费NN.10,21本次挂号关联的诊疗费用13Opt_RegisterQTF其它费NN.10,21本次挂号关联的其它费用14Opt_RegisterYYLSH预约流水号S1AN.34?在本机构内唯一标识本次预约的流水号消息体内容格式样例 1 1 0301T141012 1 1 1 2.门诊就诊记录序号父节点标识符名称类型长度字典约束说明0BodyOpt_Record门诊就诊记录表-1节点属性Name必填,如:1Opt_Record JZLSH就诊流水号S1AN.341医院门诊/住院顺序号,医疗机构内部唯一编号。2Opt_Record GHLSH挂号流水号S1AN.32?在本机构内唯一标识本次挂号的流水号3Opt_Record SFYY是否预约S2N1CVX_Right1节点属性localText必填,取值为医院内部名称;节点值为医院内部字典编码。如:14Opt_Record SFFZ是否复诊S2N1CVX_Right1节点属性localText必填,取值为医院内部名称;节点值为医院内部字典编码。如:15Opt_Record KH卡号S1AN.3316Opt_Record KLX卡类型S3N.2CVX_CardType1节点属性localText必填,取值为医院内部名称;节点值为医院内部字典编码。如:17Opt_Record MZLB门诊类别S1N1CVX_OutpatientType1节点属性localText必填,取值为医院内部名称;节点值为医院内部字典编码。如:18Opt_Record JZKSBM科室代码S3AN.15CVX_DepartmentCode1节点属性localText必填,取值为医院内部名称;节点值为医院内部字典编码。如:19Opt_Record ZDBM诊断编码(主要)S3AN.501ICD1010Opt_Record ZDMC诊断名称(主要)S1AN.100111Opt_Record ZS主诉S1AN.500?患者向医师描述的对自身本次疾病相关的记录12Opt_Record ZZMS症状描述S1AN.500?对个体出现症状的详细描述13Opt_Record XBS现病史S1AN.1000?对患者当前所患疾病情况的详细描述14Opt_Record JZRQ就诊时间DTD151完整时间表示格式,即DT15,YYYYMMDDThhmmss的格式消息体内容格式样例 1 1 1 1 1 /