湖北健康1体机接口规范V1.0.docVIP

第PAGE \* MERGEFORMAT15页 湖北基层卫生系统调用 健康一体机数据集成接口V1.0 备注：如果健康档案系统是蓝星公司，不需要将此文档发给蓝星，我们跟蓝星已对接；如果健康档案系统是其他公司，需使用我们提供的接口规范，请将此文档发给第三方公司。 北京好医生 2015-3-1 文档信息项目名称作者审核建立日期文档编号密级接口规范全体2015/01/12项目内部用户信息用户名称 湖北省卫生计生委 版本信息版本号最近更新日期V1.02015年3月18 版本修订记录 版本日期修订说明修订人1.02015/03/18新建田芦飒 一体机接口服务设计 一体机管理系统提供了面向电子健康档案系统的接口调用服务；保障电子健康档案系统能获取健康一体机的检测数据。 通讯技术 在一体机管理系统中开放的服务中涉及如下技术： XML XML（Extensible Markup Language）即可扩展标记语言，本规范中的数据交换格式都采用XML格式。 SOAP 简单对象访问协议(Simple Object Access Protocol)，SOAP 是基于 XML 的简易协议，可使应用程序在 HTTP 之上进行信息交换。或者更简单地说：SOAP 是用于访问网络服务的协议。 WSDL WSDL 指网络服务描述语言 (Web Services Description Language)。 WSDL 是一种使用 XML 编写的文档。这种文档可描述某个 Web service。它可规定服务的位置，以及此服务提供的操作（或方法）。 UDDI 通用描述、发现与集成服务(Universal Description, Discovery and Integration)； UDDI 是一个独立于平台的框架，用于通过使用 Internet 来描述服务，发现企业，并对企业服务进行集成。 Web Service Web Services 可使您的应用程序成为 Web 应用程序。Web Services 通过 Web 进行发布、查找和使用。基础的 Web Services 平台是 XML + HTTP；HTTP 协议是最常用的因特网协议，XML 提供了一种可用于不同的平台和编程语言之间的语言。 Web services 平台的元素： SOAP (简易对象访问协议) UDDI (通用描述、发现及整合) WSDL (Web services 描述语言)。 服务接口设计介绍 一体机管理系统提供的服务采用通用的接口函数，接口的规范说明参照如下章节说明。 通用接口主函数 系统统一公开的WebService函数统一命名为：serviceMain。输入和返回值均为字符串。 服务方法定义 String serviceMain (String header,String body) 输入参数： header消息头,XML格式。 body消息体，XML格式。 具体格式规范参考消息结构定义 返 回 值： 返回服务处理结果，返回的result格式规范参考消息结构定义 部分函数有xml示例。 示例只说明字符串信息样式，传输字段名以文档中规范为准。 注意事项： xml格式信息中的encoding字段的值必须是GBK； 数据项的值如果为空，也必须有数据项，只是内容为空，如arg02/arg02； 在本文的XML接口中，info属性仅作为文档中的注释用于接口说明，不需作为正式传入传出的参数。如temp_pwd info=”临时码”其中“info=”临时码”均为注释信息，在入参、出参中都将不会出现。 字段约定： 字段信息中“是否为空”栏目：Y 字段可以为空； N 字段不允许为空； 字段信息中“数据规范及说明”中如果有值，传递参数和获取参数时，值为所标明字典目录值或所说明的规定格式。 个性化接口函数 本期接口暂不考虑，后期扩展。 重要说明 String 在本规范中表示不定长度的字符串数据类型，这里采用最常见的字符”String”来表示，由于在不同的计算机语言中字符串会有不同的类型名，因此如果发现所用计算机语言没有String类型，应以正在使用的计算机语言为准 Int 在本规范中用来表示整型数据类型，亦有计算机语言中使用”integer”来表示整型，这采用了最常见的字符”int”来表示 事件 是指一次消息传送的过程、与服务器的交互过程，亦有称之为“交易”、“服务”。 接口参数结构定义 在访问服务过程中，由客户端发送的带有格式的数据统称之为消息，消息有两部分构成，分别为消息头(header)和消息体