湖北健康一体机接口规范V10.docx

湖北健康一体机接口规范V10.docx

《湖北健康一体机接口规范V10.docx》由会员分享，可在线阅读，更多相关《湖北健康一体机接口规范V10.docx（15页珍藏版）》请在冰豆网上搜索。

湖北健康一体机接口规范V10

湖北基层卫生系统调用

健康一体机数据集成接口V1.0

备注：

如果健康档案系统是蓝星公司，不需要将此文档发给蓝星，我们跟蓝星已对接；如果健康档案系统是其他公司，需使用我们提供的接口规范，请将此文档发给第三方公司。

北京好医生

2015-3-1

文档信息

项目名称

作者

审核

建立日期

文档编号

密级

接口规范

全体

2015/01/12

项目内部

用户信息

用户名称

湖北省卫生计生委

版本信息

版本号

最近更新日期

V1.0

2015年3月18

版本修订记录

版本

日期

修订说明

修订人

1.0

2015/03/18

新建

田芦飒

1、

1一体机接口服务设计

一体机管理系统提供了面向电子健康档案系统的接口调用服务；保障电子健康档案系统能获取健康一体机的检测数据。

通讯技术

在一体机管理系统中开放的服务中涉及如下技术：

XML

XML（ExtensibleMarkupLanguage）即可扩展标记语言，本规范中的数据交换格式都采用XML格式。

SOAP

简单对象访问协议（SimpleObjectAccessProtocol），SOAP是基于XML的简易协议，可使应用程序在HTTP之上进行信息交换。

或者更简单地说：

SOAP是用于访问网络服务的协议。

WSDL

WSDL指网络服务描述语言（WebServicesDescriptionLanguage）。

WSDL是一种使用XML编写的文档。

这种文档可描述某个Webservice。

它可规定服务的位置，以及此服务提供的操作（或方法）。

UDDI

通用描述、发现与集成服务（UniversalDescription,DiscoveryandIntegration）；UDDI是一个独立于平台的框架，用于通过使用Internet来描述服务，发现企业，并对企业服务进行集成。

WebService

WebServices可使您的应用程序成为Web应用程序。

WebServices通过Web进行发布、查找和使用。

基础的WebServices平台是XML+HTTP；HTTP协议是最常用的因特网协议，XML提供了一种可用于不同的平台和编程语言之间的语言。

Webservices平台的元素：

SOAP（简易对象访问协议）UDDI（通用描述、发现及整合）WSDL（Webservices描述语言）。

服务接口设计介绍

一体机管理系统提供的服务采用通用的接口函数，接口的规范说明参照如下章节说明。

通用接口主函数

系统统一公开的WebService函数统一命名为：

serviceMain。

输入和返回值均为字符串。

服务方法定义

StringserviceMain（Stringheader,Stringbody）

输入参数：

header消息头,XML格式。

body消息体，XML格式。

具体格式规范参考消息结构定义

返回值：

返回服务处理结果，返回的result格式规范参考消息结构定义

部分函数有xml示例。

示例只说明字符串信息样式，传输字段名以文档中规范为准。

注意事项：

●xml格式信息中的encoding字段的值必须是GBK；

●数据项的值如果为空，也必须有数据项，只是内容为空，如；

●在本文的XML接口中，info属性仅作为文档中的注释用于接口说明，不需作为正式传入传出的参数。

如其中“info=”临时码”均为注释信息，在入参、出参中都将不会出现。

字段约定：

●字段信息中“是否为空”栏目：

Y字段可以为空；N字段不允许为空；

●字段信息中“数据规范及说明”中如果有值，传递参数和获取参数时，值为所标明字典目录值或所说明的规定格式。

个性化接口函数

本期接口暂不考虑，后期扩展。

重要说明

String

在本规范中表示不定长度的字符串数据类型，这里采用最常见的字符”String”来表示，由于在不同的计算机语言中字符串会有不同的类型名，因此如果发现所用计算机语言没有String类型，应以正在使用的计算机语言为准

Int

在本规范中用来表示整型数据类型，亦有计算机语言中使用”integer”来表示整型，这采用了最常见的字符”int”来表示

事件

是指一次消息传送的过程、与服务器的交互过程，亦有称之为“交易”、“服务”。

接口参数结构定义

在访问服务过程中，由客户端发送的带有格式的数据统称之为消息，消息有两部分构成，分别为消息头（header）和消息体（body），消息头和消息体都是XML结构的字符串。

消息头（header）

消息头用来定义一个消息的摘要，通过摘要可以获得发起消息的类型，服务编号、创建时间、来源机构信息等，消息头是根节点为