杭州逸曜合理用药接口文档V3.0.3.doc
- 文档编号:527049
- 上传时间:2023-04-29
- 格式:DOC
- 页数:80
- 大小:1.43MB
杭州逸曜合理用药接口文档V3.0.3.doc
《杭州逸曜合理用药接口文档V3.0.3.doc》由会员分享,可在线阅读,更多相关《杭州逸曜合理用药接口文档V3.0.3.doc(80页珍藏版)》请在冰点文库上搜索。
杭州逸曜信息技术有限公司
杭州逸曜合理用药系统接口文档(V3.0.3)
杭州逸曜信息技术有限公司
2016/06/13
变更记录
变更日期
变更内容
变更人
2015/08/
初稿建立
Dingjj
2015/09/15
门诊处方信息增加“Recipe_No”字段
Dingjj
2015/12/31
干预部分“Zoneid”修改为“Hospital_Code”等
Dingjj
2016/06/
删除处方通知接口
Huayy
2016/06/
调整1.6合并进1.5为1.5.2
Huayy
2016/06/
“(四)dll接口参数定义”名称修改为“XML接口参数定义”
Huayy
2016/06/
增加处方/医嘱禁止保存描述
Huayy
2016/06/
干预模块增加“(三)http请求方式(B/S)”
Huayy
2016/06/
调整点评模块中“
(二)webservices方式”内容到附件,不在本接口文档中体现
Huayy
2016/06/
删除c++定义中存在的postpresutf8
Huayy
前言
《逸曜合理用药管理系统》是根据临床合理用药管理实际要求,专门针对临床用药使用的合理性管理和干预的一套用药管理系统。
该系统的实施安装需要医院his系统提供相关的接口和视图。
该文档规定了杭州逸曜信息技术有限公司产品《逸曜合理用药管理系统》在医院使用过程中,相关接口描述、参数定义及视图等规范,his开发公司可以根据该文档开发相关接口,提供相关视图。
《逸曜合理用药管理系统》在处方/医嘱干预审核模块接口方式为DLL方式,在处方/医嘱点评模块是通过由his创建的相关视图或WebServices方式来导入处方/医嘱数据进行分析。
一、处方/医嘱干预审核模块
(一)C++DLL方式(C/S)
1.接口描述
《逸曜合理用药管理系统》在处方/医嘱干预审核模块接口方式为dll方式,支持his系统以c++,pb等语言开发。
His开发商可以在程序中调用接口文件hisinfopost.dll来传入数据。
1.1DLL调用流程图
1.2说明书调用接口
a.产品共用
接入场景
门诊医生工作站,门诊审方中心,药房发药,住院电子病历,药房备药,护士执行
函数说明
1)c++:
constchar*PASCALrunGetPrescription(strServerip,id)
2)pb:
FUNCTIONStringrunGetPrescription(StringstrServerip,Stringid)LIBRARY"hisinfopost.dll"ALLASFOR"runGetPrescription"
参数说明
输入参数:
参数名
参数类型
参数说明
strServerip
字符串
请求地址如http:
//192.168.0.1:
80/engineAsync
IP地址按医院实际部署状况进行替换。
建议HIS在写接口时把此配置写在配置文件里,避免服务重新部署时调整序。
id
字符串
药品ID号
b.产品非共用
接入场景
门诊医生工作站,门诊审方中心,药房发药,住院电子病历,药房备药,护士执行
函数原型:
1)c++:
constchar*PASCALrunGetPrescriptionWithZoneId(constchar*server,constchar*HisDrugID,constchar*zoneId)
2)pb:
FUNCTIONStringrunGetPrescriptionWithZoneId(Stringserver,StringHisDrugID,StringzoneId)LIBRARY"hisinfopost.dll"ALIASFOR"runGetPrescriptionWithZoneId"
参数说明
输入参数:
参数名
参数类型
参数说明
server
字符串
请求地址如http:
//192.168.0.1:
80/engineAsync
IP地址按医院实际部署状况进行替换。
建议HIS在写接口时把此配置写在配置文件里,避免服务重新布暑时调整序。
HisDrugID
字符串
药品ID号
zoneId
字符串
院区id(具体对接的机构代码)
1.3干预处方医嘱审核接口
接入场景
门诊医生工作站,门诊审方中心,门诊药房发药,住院电子病历,药房发药(出院带药),住院护士执行,静配中心
函数说明
1)C++:
constchar*PASCALpostPres(strServerip,xml,intPostType,strCharset)
2)PB:
FUNCTIONStringpostPres(StringstrServerip,Stringxml,IntintPostType,StringstrCharset)LIBRARY"hisinfopost.dll"ALIASFOR"postPres"
参数说明
输入参数:
参数名称
参数类型
参数说明
strServerip
字符串
合理用药系统的服务器ip地址,由合理用药系统提供医院信息系统。
(示例:
http:
//127.0.0.1:
80/engineAsync),通常应该保存在医院信息系统全局配置文件中
strXml
字符串
处方或住院药嘱数据的xml的数据
该字符串的编码类型为gbk,定义见(四)xml接口参数定义
intPostType
整数
根据医院场景传入参数
strCharset
字符串
客户端所使用的字符集,如:
utf-8,gbk等,服务器端会根据该参数对字符串进行解码
注:
在医院其他场景调用《逸曜合理用药管理系统》时,上述输入参数中intPostType字段可以参考以下:
1.门诊处方住院医嘱保存发送
2.门诊审方
3.药房发药
4.配置中心发药
5.护士执行
6.患者咨询
输出参数:
参数类型
附加说明
字符串
返回审方警示XML结果信息,如果审方接口内部发生错误就返回错误信息
1.4干预处方医嘱审核接口(自定义弹框大小及位置)
接入场景
门诊医生工作站,门诊审方中心,门诊药房发药,住院电子病历,药房发药(出院带药),住院护士执行,静配中心
函数说明
1)C++:
constchar*PASCALpostPresWithXY(strServerip,xml,intPostType,strCharset,X,Y,width,height)
2)PB:
FUNCTIONStringpostPresWithXY(StringstrServerip,Stringxml,IntintPostType,StringstrCharset,X,Y,width,height)LIBRARY"hisinfopost.dll"ALIASFOR"postPresWithXY"
参数说明
输入参数:
参数名称
参数类型
参数说明
strServerip
字符串
合理用药系统的服务器ip地址,由合理用药系统提供医院信息系统。
(示例:
http:
//127.0.0.1:
80/engineAsync),通常应该保存在医院信息系统全局配置文件中。
strXml
字符串
处方或住院药嘱数据的xml的数据
该字符串的编码类型为gbk,定义见(四)xml接口参数定义
intPostType
整数
根据医院场景传入参数
strCharset
字符串
客户端所使用的字符集,如:
utf-8,gbk等,服务器端会根据该参数对字符串进行解码。
X
整数
弹框位置的X坐标(相对于屏幕左上角横向距离)
Y
整数
弹框位置的Y坐标(相对于屏幕的左上角纵向距离)
width
整数
弹框的宽度
height
整数
弹框的高度
输出参数:
参数类型
附加说明
字符串
返回审方警示XML结果信息,如果审方接口内部发生错误就返回错误信息
1.5干预处方医嘱审核接口(不弹出警示信息窗口)+获取最近的审方xml结果
1.5.1干预处方医嘱审核接口(不弹出警示信息窗口)
接入场景
住院药房备药,静配中心
函数说明
1)C++:
constintPASCALpostPresNoWindow(strServerip,strXml,intPostType,strCharset)
2)PB:
FUNCTIONIntpostPresNoWindow(StringstrServerip,StringstrXml,IntintPostType,StringstrCharset)LIBRARY"hisinfopost.dll"ALIASFOR"postPresNoWindow"
在批量审方时调用
注意:
不支持在多线程下调用
参数说明
输入参数:
参数名
参数类型
参数说明
strServerip
字符串
请求地址如合理用药服务器url如http:
//127.0.0.1:
80/engineAsync
IP地址按医院实际部署状况进行替换.
建议HIS在写接口时把此配置写在配置文件里,避免服务重新布暑时调整序.
strXml
字符串
见处方保存输入xml定义,定义见(四)xml接口参数定义
intPostType
数值
根据医院场景传入参数
strCharset
字符串
客户端所使用的字符集,如:
utf-8,gbk等,服务器端会根据该参数对字符串进行解码。
输出参数:
参数类型
附加说明
数值
返回值如下:
0:
成功
1:
网络错误
2:
无效的URL
3:
网络连接异常
4:
打开请求异常
5:
发送请求异常
6:
合理用药内部服务器解析XML异常
1.5.2获取最近的审方xml结果接口
接入场景
静配中心,住院药房备药
函数说明
1)C++:
constchar*PASCALgetLastXmlResult()
2)PB:
FUNCTIONStringgetLastXmlResult()LIBRARY"hisinfopost.dll"ALIASFOR"getLastXmlResult"
参数说明
输出参数:
参数类型
附加说明
字符串
返回最近一次调用postPresNoWindow返回的XML数据。
2.具体医院流程及调用接口、参数说明
门诊流程及具体调用接口说明:
医院场景
调用接口
参数说明
门诊医生工作站
1.3或1.4
intPostType为1
门诊审方中心审方
1.3或1.4
intPostType为2
药房发药
1.3或1.4
intPostType为3
住院流程及具体调用接口说明:
医院场景
调用接口
参数说明
备注
住院医生工作站
1.3或1.4
intPostType为1
住院药房备药
1.5;1.6
intPostType为3
调用1.5成功(即输出返回值为0)后;再调用1.6
药房发药(出院带药)
1.3或1.4
intPostType为3
护士执行
1.3或1.4
intPostType为5
静配中心及具体调用接口说明(某医院流程):
医院场景
调用接口
参数说明
备注
静配中心
1.5;1.6
intPostType为4
调用1.5成功(即输出返回值为0)后;再调用1.6
(二)C#DLL方式(C/S)
1.接口描述
His开发商可以在程序中调用接口文件ipharmacare.HisInfoPostNet2.dll来传入数据。
1.1干预处方医嘱审核接口
接入场景
门诊医生工作站,门诊审方中心,门诊药房发药,住院电子病历,药房发药(出院带药),住院护士执行,静配中心
函数说明
c#:
publicstringpostXml(StringserverAddr,Stringxml,Stringcharset,boolsilence,intpost_type)
参数说明
输入参数:
参数名称
参数类型
参数说明
serverAddr
字符串
合理用药系统的服务器ip地址,由合理用药系统提供医院信息系统。
(示例:
http:
//localhost:
80/),通常应该保存在医院信息系统全局配置文件中
xml
字符串
处方或住院药嘱数据的xml的数据,定义见(四)xml接口参数定义
charset
字符串
客户端所使用的字符集,如:
utf-8,gbk等,服务器端会根据该参数对字符串进行解码
silence
布尔型
是否处于安静模式,
true=不弹出任何提示窗口
false=弹出任何提示窗口
post_type
整数
提交类型
注:
在医院其他场景调用《逸曜合理用药管理系统》时,上述输入参数中Post_Type字段可以参考以下:
1.门诊处方住院医嘱保存发送
2.门诊审方
3.药房发药
4.配置中心发药
5.护士执行
6.患者咨询
输出参数:
参数类型
附加说明
字符串
返回审方警示XML结果信息,如果审方接口内部发生错误就返回错误信息(返回参考输出xml定义及实例)
1.2说明书调用接口
a.产品共用
接入场景
门诊医生工作站,门诊审方中心,药房发药,住院电子病历,药房备药,护士执行
函数原型:
c#:
publicvoidopenInstructionById(StringserverAddr,StringhisDrugId)
输入参数:
参数名
参数类型
参数说明
server
字符串
请求地址如http:
//192.168.0.1:
80/
IP地址按医院实际部署状况进行替换.
建议HIS在写接口时把此配置写在配置文件里,避免服务重新布暑时调整序.
hisDrugId
字符串
药品ID号
b.产品非共用
接入场景
门诊医生工作站,门诊审方中心,药房发药,住院电子病历,药房备药,护士执行
函数原型:
c#:
publicvoidopenInstructionByIdzoneId(StringserverAddr,StringhisDrugId,StringzoneId)
输入参数:
参数名
参数类型
参数说明
server
字符串
请求地址如http:
//192.168.0.1:
80/
IP地址按医院实际部署状况进行替换.
建议HIS在写接口时把此配置写在配置文件里,避免服务重新布暑时调整序.
hisDrugId
字符串
药品ID号
zoneId
字符串
院区id(具体对接的机构代码)
(三)http请求方式(B/S)
1.干预处方医嘱审核接口
(1)http请求方式:
POST
http:
//serverAddr/engineAsync?
charset=charset&post_type=post_type
参数说明:
参数名称
参数类型
参数说明
serverAddr
字符串
合理用药系统的服务器ip地址,由合理用药系统提供医院信息系统。
(示例:
http:
//localhost:
80/),通常应该保存在医院信息系统全局配置文件中
charset
字符串
客户端所使用的字符集,如:
utf-8,gbk等,服务器端会根据该参数对字符串进行解码
post_type
整数
提交类型
Post数据
xml
字符串
处方或住院药嘱数据的xml的数据见(四)xml接口参数定义
Post_Type字段可以参考以下:
1.门诊处方住院医嘱保存发送
2.门诊审方
3.药房发药
4.配置中心发药
5.护士执行
6.患者咨询
输出参数:
参数类型
附加说明
字符串
返回审方警示XML结果信息,如果审方接口内部发生错误就返回错误信息(返回参考输出xml定义及实例)
(2)对返回输出结果进行判断如果
输出结果xml判断示例:
intistartIdx=resultXml.IndexOf("
intilen=resultXml.IndexOf("")-istartIdx;
if((resultXml.Substring(istartIdx,ilen)).Length>20)
http请求方式:
GET
http:
//serverAddr/returnInfo_v2.jsp?
presNo=presNo&hospitalCode=zoneId&post_type=post_type&patientNo=patientNo&name=name&departId=departId;
参数说明:
参数名称
参数类型
参数说明
serverAddr
字符串
合理用药系统的服务器ip地址,由合理用药系统提供医院信息系统。
(示例:
http:
//localhost:
80/),通常应该保存在医院信息系统全局配置文件中
Post数据
presNo
字符串
处方号
zoneId
字符串
院区id
post_type
字符串
提交类型,同第一次请求
patientNo
字符串
患者号
name
字符串
患者姓名
departId
字符串
科室id(可为空)
下图为展示效果,展示大小至少为690*450:
2.说明书调用接口
a.产品共用
调用这个URL即可返回药品的说明书:
http:
//127.0.0.1:
80/zlcx/data_detail.action?
webHisId=773200
webHisId后面跟的是药品的ID
http:
//127.0.0.1:
80是合理用药的在线服务器的地址,真实环境下请配置部署的合理用药服务器地址
b.产品非共用
调用这个URL即可返回药品的说明书:
http:
//127.0.0.1:
80/zlcx/data_detail.action?
webHisId=773200&zoneId=1
webHisId后面跟的是药品的ID
zoneId后面跟的是院区ID
127.0.0.1:
80是合理用药的在线服务器地址,真实环境下请配置医院部署的合理用药服务器地址
(四)XML接口参数定义
1.输入xml标签定义
注意:
请按xml规范,严格区分大小写
标签名称
标签描述
数据类型
允许值
1
病人基本信息节点
2
医院Code
varchar(32)
3
科室ID
varchar(32)
4
科室名称
varchar(128)
5
住院床号
varchar(32)
6
处方类型
varchar(16)
草药方|中成药方|西药方
7
来源
varchar(8)
门诊|急诊|医嘱
8
处方时间
Datetime
YYYY-MM-DDHH:
MM:
SS格式,少于两位补0
9
费用类型
varchar(32)
自费|省医保|市级医保等
10
病人号
varchar(32)
11
门诊号/住院号(当门诊时传入门诊号)
varchar(32)
12
处方号/医嘱号
varchar(32)
13
病人姓名
varchar(64)
14
主诊断
varchar(256)
多个以|分隔
15
诊断
varchar(256)
多个以|分隔
16
ICD10编码
varchar(256)
多个以|分隔
17
病人地址
varchar(256)
18
身份证号码
varchar(64)
19
联系电话
varchar(32)
20
出生年月
datetime
YYYY-MM-DD格式
21
性别
varchar(16)
M|F|男|女
22
身高
varchar(16)
[0-9|\\.]+[m|cm](如果没带单位的系统默认为0)
23
体重
varchar(16)
[0-9|\\.]+[mg|g|kg](如果没带单位的系统默认为0)
24
出生时体重
varchar(16)
[0-9|\\.]+[mg|g|kg](如果没带单位的系统默认为0)
25
内生肌酐清除率
varchar(32)
以“ml/min”为单位,若未填单位,则默认为“ml/min”
26
过敏药品列表
varchar(512)
多个药以|分隔(需传药品名称)
27
是否怀孕
varchar(8)
true|false
28
孕期
int
不用加单位,只对数字识别
29
是否哺乳
varchar(8)
true|false
30
是否透析
varchar(8)
true|false
31
代办人姓名
varchar(64)
32
代办人身份证号
varchar(64)
33
医生工号
varchar(32)
34
医生姓名
varchar(32)
35
医生职称
varchar(64)
36
审核药师工号
varchar(32)
37
发药药师工号
varchar(32)
38
发药药师名称
varchar(32)
39
审核药师名称
varchar(32)
40
发药药师职称
varchar(64)
41
处方总额
double(11,4)
42
中药帖数
varchar(32
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 杭州 合理 用药 接口 文档 V3 0.3