Skip to content

灵医智惠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: "",
    flag: true,
    data: Object
}

诊断推荐回填数据规范

请点击箭头查看内容
{
  "type": "diagnosis_recommend",
  "flag": true, //  true表示勾选  false表示取消勾选
  "data": {
      "detail": 1,
      "expand": 1,
      "hospital_code": "",
      "kgid": "",
      "name": "支气管炎",
      "score": 0.9057542685,
      "selected": 0,
      "tag": []
    }
}

用药推荐回填数据规范

请点击箭头查看内容
{
  "type": "medicine_recommend",
  "flag": true,      //  true表示勾选  false表示取消勾选
  "data": {
      "detail": 1,
      "detail_url": "",
      "hospital_code": "",
      "kgid": "",
      "local": 0,
      "local_name": [],
      "name": "美敏伪麻口服溶液",
      "reason": "用于减轻由感冒、急性气管炎、支气管炎引起的咳嗽、鼻塞、流涕、流泪、喷嚏等症状。",
      "selected": 0,
      "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
  }
}

检验推荐回填数据规范

请点击箭头查看内容
{
  "type": "lab_item_recommend",
  "flag": true,      //  true表示勾选  false表示取消勾选
  "data": {
      "detail": 1,
      "detail_url": "",
      "hospital_code": "", // 院内术语编码
      "kgid": "",
      "local": 0,  // 是否本地化 0:未本地化  1:本地化
      "name": "痰培养",
      "reason": "可发现致病菌。",
      "selected": 0,
      "type": "检验",
      "weight": "0.899"
  }
}

检查推荐回填数据规范

请点击箭头查看内容
{
  "type": "exam_item_recommend",
  "flag": true,      //  true表示勾选  false表示取消勾选
  "data": {
      "detail": 0,
      "detail_url": "",
      "hospital_code": "", // 院内术语编码
      "kgid": "",
      "local": 0, // 是否本地化 0:未本地化  1:本地化
      "name": "腹部超声",
      "reason": "可见阑尾低回声区,横切面呈月样“耙状”。",
      "selected": 0,
      "type": "检查",
      "weight": "0.899"
  }
}

质控结果数据规范

请点击箭头查看内容
{
  "type": "reminder",   // 提醒信息
  "data": [
    {
      "level": "notice/warning/error",  // 提醒级别
      "type": "文书/用药/检验/检查/手术/用血/治疗/血液透析/护理", // 提醒类型
      "message": "提醒详细内容"
    }
  ]
}

详情页信息数据规范

{
  "type": "detail",
  "data": "http://xxx"
}