预约挂号平台his接口设计.docVIP

文档编号： 密 级： 预约挂号系统 接口设计说明书 （HIS部分） 编制： 审核： 批准： 2010年 10 文档修改记录 编号 版本号 修订日期 修订说明 编写者 审核者 1 V1.0.0 2010-11-1 创建 汪凌 2 V1.0.1 2010-12-10 汪凌 总体设计 总体要求 预约挂号系统平台与各医院HIS之间是一对多的接入关系，因医院HIS系统各不相同：建设厂家不同，版本不同，环境不同；与平台间的网络连接方式也存在差异。为保证平台的兼容性和可扩展性，要求该接口规范具备高通用性，可跨平台、跨语言实现，且适用于不同的网络环境和硬件设备。 系统拓扑 模块说明 本文档涉及的接口应用布署于拓扑图中的“医院His前置”上。 预约挂号系统包括两大类应用： HIS向预约挂号平台上传预约挂号系统所需的基本信息（如：医院信息、科室信息、医生信息、排班信息、停诊信息等）和其他交易信息（如：患者预约后的实际就诊情况、患者投诉情况、患者注册信息等）。该类交易平台为服务端，HIS为客户端。平台方提供DLL函数接口，供HIS调用。 平台向HIS发起的实时交易请求（如：预约挂号、预约取消、患者信息向医院传送等）。该类交易平台为客户端，HIS为服务端。HIS提供存储过程供平台调用。 详细业务部分请参阅《省预约挂号平台业务操作规范.doc》 平台与医院HIS接口 平台与医院HIS前置之间采用TCP/IP通讯协议，建立两对SOCKET端口（互为客户/服务端）：一对用于医院HIS系统发起的交易（HisToEbs），一对用于平台发起的交易(EbsToHis)。其中客户端作为发送数据端口，服务端作为接收数据端口。HIS作为客户端时，通过调用平台提供的DLL函数发起交易请求；HIS作为服务端时，向平台开放存储过程。 交易方式采用短链接的方式。在一个TCP/IP连接上完成数据包的发送和接收，在成功发送了一个数据包，并收到成功应答后，即中断该连接。 HisToEbs和EbsToHis均采用同步方式。 文件传输采用FTP方式。 HisToEbs 该接口主要用于HIS系统向平台传输院方相关基础及变更信息，如：医院介绍、科室设置、医生、排班等。 该接口的实现采用HIS调用Dll函数的方式，Dll函数接口由平台提供。函数封装了底层通讯协议和交易逻辑。 初始化服务器设置 Int SetIpAndPort(char*szHospitalID,char *szIp,int nPort) 函数说明：设置医院编号、His Server（HIS前置）的ip和端口号。在HIS系统启动（初始化）时加载调用，必须先调用该函数进行初始化，否则会提示调用失败。 输入参数：szHospitalID 医院ID，由省平台统一分配（6位字符） szIp HIS前置服务器的ip，如02，具体到实施时确定 nPort HIS前置服务器的port，如8098（最大65535），具体到实施时确定 输出参数：无 返回值：0 成功 1 连接服务器失败 HIS数据上传 Int SendPack(char *szTradeCode,char *szOperNo,char *szSendContent,char *szRet); 函数说明：向中心服务器发送数据通讯包 输入参数：szTradeCode （字符串） 交易代码（4位字符） szOperNo （字符串） his系统中的操作员号 szSendContent （字符串）本次发送的数据报文 输出参数：szRet （字符串） 调用成功返回交易定义的返回结果，调用失败则为调用失败的具体原因，如报文格式不正确等。 返回值：0 调用成功 1 调用失败 附：szTradeCode 的取值说明 1101 医院信息上传处理 1102 科室信息上传处理 1103 医生信息上传处理 1104 排班信息上传处理 1105 停诊信息上传处理 1106 预约就诊情况上传处理 1107 查询平台某排班剩余号源数量 1108 患者姓名信息修改 szSendContent 的取值格式：各字段间以“|”分隔，如内容为空则直接加“|”。 处理结果存放在szRet中，szRet的取值格式：各字段间以“|”分隔，如内容为空则直接加“|”。 医院信息上传 序号 字段 类型/长度 备注 必填 1 变更类型 Char/1 0:新增；1：修改； 2：删除 y 1 医院名称 Varchar2/50 医院全称 y 2 医院机构代码 Varchar2/6 y 3 医院介绍 Varchar2/1000 y 4 地址 Varchar2/100 y 5 医院等级 Char/4 三甲;三乙… y 6 医院性