灵医智惠CDSS标准版B/S SDK开发指南v1——HIS系统¶
SDK初始化¶
Warning
01cdss.baidu.com仅用于开发、测试和联调,禁止用于真实线上/线下诊疗服务。
临床真实环境请使用医院内网私有化部署的正式服务。
<!-- 引入项目js和css文件, 01cdss.baidu.com是联调开发环境,正式环境必须替换为医院内网地址 -->
<script src="http://01cdss.baidu.com/cdss/standard/sdk/static/index.js"></script>
<link rel="stylesheet" href="http://01cdss.baidu.com/cdss/standard/sdk/static/index.css">
<!-- CDSS交互面板,div宽度最小值是400px,推荐放在页面body元素下的第一层级 -->
<div id="cdss-main-container" style="width:400px;"></div>
// 01cdss.baidu.com是联调开发环境,正式环境必须替换为医院内网地址
var server = 'http://01cdss.baidu.com';
// 初始化
var cdss = new CDSS({
container: '#cdss-main-container',
server: server,
ak: 'ak值联系灵医智惠CDSS技术人员提供,请确保ak和sk不会被第三方窃取',
sk: 'sk值联系灵医智惠CDSS技术人员提供,请确保ak和sk不会被第三方窃取',
// 非必选参数 默认为false 控制是否内嵌,如果传入true之后 需要页面预留一块位置给CDSS使用
isEmbed: false,
// 非必选参数 默认为true 控制详情页弹窗,传入false代表不打开详情页弹窗同时详情url会通过详情页信息数据规范传递
detailPopup: true,
// 传入初始的默认emr数据
defaultEmr: {
"工作人员信息": {
"医院": "", // [必填]医院名称
"科室": "" // [必填]科室名称
}
}
});
SDK接口定义¶
// 开发功能点1:组织患者数据并发送给CDSS,打开病历、保存病历、提交病历、鼠标焦点切换(可选)、
// 单独触发按钮(可选)时执行,emrData是患者病历信息, 定义参考《SDK入参:患者数据规范》
var emrData = {};
// 将组织好的emrData通过refresh事件发送给CDSS系统,每次打开一份新的病历,必须请求一次,确保切换用户
cdss.refresh(emrData);
// 开发功能点2:开发诊断和医嘱(用药、检查、检验)回填功能,response定义参考《诊疗推荐回填数据规范》。
function updateEMRData(response) {
// 将response中的诊断和医嘱信息回填到HIS系统,然后组织新的患者数据newEMRData
var newEMRData = {};
return newEMRData;
}
// 监听回填事件
cdss.on('cdss-evt', function(evt, response) {
// 解析response 按需对接诊断/医嘱回填功能
var newEMRData = updateEMRData(response);
// 按需将回填后的新数据重新发送给CDSS
// cdss.refresh(newEMRData);
});
SDK入参:患者数据规范¶
门诊记录¶
请点击箭头查看内容
{
"场景": ["门诊记录"],
"trigger": "保存/提交/CDSS", // 触发CDSS的方式
// 1) 保存:点击保存时自动触发;
// 2) 提交:点击提交时自动触发;
// 3) CDSS:点击单独新增的CDSS按钮触发。
// 工作人员信息
"医院": "", // [必填]医院名称
"科室": "", // [必填]科室名称
"医生": "", // [必填]工作人员姓名
"uid": "", // [必填]医疗信息系统账号
// 患者信息
"诊疗类型": "门诊/急诊/体检", // [必填]
"诊疗次数": "", // "1":初诊,大于1表示复诊
"rid": "", // [必填] 住院号 或者 门诊号
"pid": "", // [必填] 患者ID
"年龄": "28岁", // [必填] xx岁/xx月/xx天/xx小时
"性别": "男/女", // [必填]
"出生日期": "", // YYYY-MM-DD
"职业": "",
"出生地": "",
"现住地": "",
"费用类型": "医保/商保/自费/公费/等",
"身高": "180cm",
"体重": "70kg",
"ABO血型": "A/B/AB/O",
"Rh血型": "阴/阳",
"婚姻状态": "未婚/已婚/离异/丧偶",
// 门诊记录
"门诊科室": "",
"门诊日期": "yyyy-MM-dd HH:mm:ss",
"主诉": "",
"现病史": "",
"既往史": "",
"个人史": "",
"月经史": "",
"婚育史": "",
"家族史": "",
"过敏史": "",
"接种史": "",
"体格检查": "",
"辅助检查": "",
"专科检查": "",
"诊断": [
{
"诊断类型": "初步诊断/补充诊断/确诊诊断/其他诊断/门诊诊断",
"诊断结果": "",
"主要诊断": "是/否"
}
]
}
入院记录¶
请点击箭头查看内容
{
"场景": ["入院记录"],
"trigger": "保存/提交/CDSS", // 触发CDSS的方式
// 1) 保存:点击保存时自动触发;
// 2) 提交:点击提交时自动触发;
// 3) CDSS:点击单独新增的CDSS按钮触发。
// 工作人员信息
"医院": "", // [必填]医院名称
"科室": "", // [必填]科室名称
"医生": "", // [必填]工作人员姓名
"uid": "", // [必填]医疗信息系统账号
// 患者信息
"诊疗类型": "门诊/急诊/体检", // [必填]
"诊疗次数": "", // "1":初诊,大于1表示复诊
"rid": "", // [必填] 住院号 或者 门诊号
"pid": "", // [必填] 患者ID
"年龄": "28岁", // [必填] xx岁/xx月/xx天/xx小时
"性别": "男/女", // [必填]
"出生日期": "", // YYYY-MM-DD
"职业": "",
"出生地": "",
"现住地": "",
"费用类型": "医保/商保/自费/公费/等",
"身高": "180cm",
"体重": "70kg",
"ABO血型": "A/B/AB/O",
"Rh血型": "阴/阳",
"婚姻状态": "未婚/已婚/离异/丧偶",
// 入院记录
"入院科室": "",
"入院日期": "yyyy-MM-dd HH:mm:ss",
"主诉": "",
"现病史": "",
"既往史": "",
"个人史": "",
"月经史": "",
"婚育史": "",
"家族史": "",
"过敏史": "",
"接种史": "",
"体格检查": "",
"辅助检查": "",
"专科检查": "",
"诊断": [
{
"诊断类型": "初步诊断/入院诊断/补充诊断/确诊诊断/其他诊断/鉴别诊断/出院诊断",
"诊断结果": "",
"主要诊断": "是/否"
}
]
}
医嘱¶
请点击箭头查看内容
{
"场景": ["医嘱"],
"trigger": "保存/提交/CDSS", // 触发CDSS的方式
// 1) 保存:点击保存时自动触发;
// 2) 提交:点击提交时自动触发;
// 3) CDSS:点击单独新增的CDSS按钮触发。
// 工作人员信息
"医院": "", // [必填]医院名称
"科室": "", // [必填]科室名称
"医生": "", // [必填]工作人员姓名
"uid": "", // [必填]医疗信息系统账号
// 患者信息
"诊疗类型": "门诊/急诊/体检", // [必填]
"rid": "", // [必填] 住院号 或者 门诊号
"pid": "", // [必填] 患者ID
"年龄": "28岁", // [必填] xx岁/xx月/xx天/xx小时
"性别": "男/女", // [必填]
"医嘱": [
{
"处方ID": "", // 处方号
"医嘱单号": "", // [必填] 医嘱项目的唯一ID,一个门诊处方下的药品之间医嘱ID不同,处方ID相同,请注意:医嘱ID是全局唯一的,不是医嘱项目院内编码
"医嘱类型": "用药/检验/检查/诊疗/手术/护理/出院带药", // [必填]
"医嘱项": "", // [必填]
"长期或临时": "长期/临时", // [必填]
"医嘱状态": "新开/执行/停止/取消", // [必填]
"创建时间": "yyyy-MM-dd HH:mm:ss", // 医嘱创建时间
"审核时间": "yyyy-MM-dd HH:mm:ss", // 医嘱审核时间
"开始时间": "yyyy-MM-dd HH:mm:ss", // 医嘱下达的预期开始时间
"结束时间": "yyyy-MM-dd HH:mm:ss", // 医嘱下达的预期结束时间
"医嘱开立科室": "",
"医嘱开立者": "",
"医嘱审核科室": "",
"医嘱审核者": "",
// 以下为用药医嘱独有字段
"用药天数":"",
"国药准字号": "", // 医嘱类型=用药时 [必填]
"输液单号": "1",
"服药途径": "口服/皮下注射/肌肉注射/静脉注射/外用/雾化吸入/等", // 医嘱类型=用药时 [必填]
"服药频率": "", // 医嘱类型=用药时 [必填]
"单次剂量": "", // 医嘱类型=用药时 [必填]
"总剂量": "", // 医嘱类型=用药时 [必填]
"剂量单位": "", // 医嘱类型=用药时 [必填]
"药物商品名": "", // 医嘱类型=用药时 [必填]
"药物通用名": "",
"药物编码": "",
"药物类别": "电解质平衡调节药",
"药物剂型": "注射剂/片剂/胶囊剂/丸剂/散剂/气雾剂/等",
// 以下为检查医嘱、检验医嘱独有字段
"报告单号": "" // 检验报告单号或者检查报告单号
},
{ // 医嘱执行记录, 不需要传完整的医嘱信息,只需要传如下字段即可,同一条医嘱多次执行拆成多条医嘱(这些医嘱ID相同,执行时间不同)
"医嘱单号": "", // [必填] 医嘱ID
"医嘱类型": "用药/检验/检查/诊疗/手术/护理/出院带药", // [必填]
"医嘱项": "", // [必填]
"长期或临时": "长期/临时", // [必填]
"医嘱状态": "新开/执行/停止/取消", // [必填]
"执行时间": "yyyy-MM-dd HH:mm:ss", // [必填] 医嘱实际执行的时间
"医嘱执行科室": "",
"医嘱执行者": "",
"皮试结果": "" // 皮试结果
}
]
}
SDK出参:结果数据规范¶
返回数据格式如下:
字段 | 值类型 | 含义 |
---|---|---|
type | 字符串 | 回填类型,type取值含义见下方 |
flag | 布尔值 | true: 勾选 false: 取消勾选 |
data | object | 返回数据, 格式根据type取值动态调整 |
诊断推荐回填数据规范¶
请点击箭头查看内容
用药推荐回填数据规范¶
请点击箭头查看内容
手术推荐回填数据规范¶
请点击箭头查看内容
{
"type": "operation_recommend",
"flag": true, // true表示勾选 false表示取消勾选
"data": {
"detail": 0,
"detail_url": "",
"hospital_code": "", // 院内术语编码
"kgid": "",
"local": 0, // 是否本地化 0:未本地化 1:本地化
"name": "阑尾切除术",
"reason": "",
"selected": 0,
"suit_indicators": [],
"tubo_indicators": [],
"type": "手术",
"weight": 0.9
}
}