灵医智惠CDSS标准版B/S SDK开发指南v2——HIS系统¶
SDK初始化¶
Warning
ihcloud-sandbox.baidu.com仅用于开发、测试和联调，禁止用于真实线上/线下诊疗服务。
临床真实环境请使用医院内网私有化部署的正式服务。
<!-- 引入项目js和css文件, ihcloud-sandbox.baidu.com是联调开发环境，正式环境必须替换为医院内网地址 -->
<script src="https://ihcloud-sandbox.baidu.com/cdss/standard/sdk/static/index.js"></script>
<link rel="stylesheet" href="https://ihcloud-sandbox.baidu.com/cdss/standard/sdk/static/index.css">
<!-- CDSS交互面板，div宽度最小值是400px，推荐放在页面body元素下的第一层级 -->
<div id="cdss-main-container" style="width:400px;"></div>
// ihcloud-sandbox.baidu.com是联调开发环境，正式环境必须替换为医院内网地址
var server = 'https://ihcloud-sandbox.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: {
"工作人员信息": {
"医院": "", // [必填]医院名称
"科室": "" // [必填]科室名称
}
},
// 注意：以下panelCss和floatCss参数仅在isEmbed为false时使用!
// 控制CDSS面板展开后的初始位置, 支持传入两个参数 top和right 值为 数字+px组成的字符串 如：'10px'。
// 以下为使用示例：
panelCss: {
top: '10px', // 代表展开后的CDSS面板距离页面顶部10px
right: '10px', // 代表展开后的CDSS面板距离页面右部10px
zIndex: 3000 // 代表cdss的层级，具体数值请按实际对接调整
},
// 控制悬浮窗的初始位置。支持传入两个参数 top和right 值为 数字+px组成的字符串 如：'10px'。
// 以下为使用示例：
floatCss: {
top: '10px', // 代表悬浮窗的默认位置距离页面顶部10px
right: '10px', // 代表悬浮窗的默认位置距离页面右部10px
zIndex: 3000 // 代表cdss的层级，具体数值请按实际对接调整
}
});
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按钮触发。
"工作人员信息": {
"医院": "", // [必填]医院名称
"科室": "", // [必填]科室名称
"姓名": "", // [必填]工作人员姓名
"账号ID": "", // [必填]医疗信息系统账号
"角色": "医生/护士/药师/等",
"职称": "",
"ip": "" // 医生电脑ip地址
},
"患者信息": {
"就诊类型": "门诊/急诊/体检", // [必填]
"就诊次数": "", // "1":初诊，大于1表示复诊
"就诊ID": "", // [必填] 住院号 或者 门诊号
"患者ID": "", // [必填]
"姓名": "", // [必填]
"年龄": "28岁", // [必填] xx岁/xx月/xx天/xx小时
"性别": "男/女", // [必填]
"出生日期": "", // yyyy-MM-dd
"职业": "",
"民族": "",
"出生地": "",
"现住地": "",
"费用类型": "医保/商保/自费/公费/等",
"身高": "180cm",
"体重": "70kg",
"ABO血型": "A/B/AB/O",
"Rh血型": "阴/阳",
"婚姻状态": "未婚/已婚/离异/丧偶",
"特殊人群": [""],
"生理状态": "月经期/妊娠期/哺乳期/孕早期/孕中期/孕晚期/卵泡期/黄体期/排卵期"
},
"门诊记录": {
"是否复诊": "", //是/否
"科室": "", // 门诊科室
"记录ID": "", // 门诊记录ID
"记录内容": "", // 无结构化纯文本内容, 仅用于无法提供结构化数据的厂商使用
"记录时间": "yyyy-MM-dd HH:mm:ss", // 门诊记录书写时间
"就诊时间": "yyyy-MM-dd HH:mm:ss", // 患者就诊时间
"怀孕状态": "未孕/已孕/已育",
"主诉": "",
"现病史": "",
"既往史": "",
"个人史": "",
"月经史": "",
"婚育史": "",
"家族史": "",
"过敏史": "",
"接种史": "",
"体格检查": "",
"辅助检查": "",
"专科检查": "",
"嘱咐": "", // 医生对患者建议的注意事项
"诊断": [
{
"诊断类型": "初步诊断/补充诊断/确诊诊断/其他诊断/门诊诊断",
"诊断项": "",
"主要诊断": "是/否",
"诊断ICD编码": ""
}
],
"中医诊断": [
{
"诊断类型": "初步诊断/补充诊断/确诊诊断/其他诊断/门诊诊断",
"主要诊断": "是/否",
"中医疾病" : {
"名称": "",
"代码": ""
},
"中医证型": [
{
"名称": "",
"代码": ""
}
]
}
]
}
}
入院记录¶
请点击箭头查看内容
{
"场景": ["入院记录"],
"trigger": "保存/提交/CDSS", // 触发CDSS的方式
// 1) 保存：点击保存时自动触发；
// 2) 提交：点击提交时自动触发；
// 3) CDSS：点击单独新增的CDSS按钮触发。
"工作人员信息": {
"医院": "", // [必填]医院名称
"科室": "", // [必填]科室名称
"姓名": "", // [必填]工作人员姓名
"账号ID": "", // [必填]医疗信息系统账号
"角色": "医生/护士/药师/等",
"职称": "",
"ip": "" // 医生电脑ip地址
},
"患者信息": {
"就诊类型": "住院", // [必填]
"就诊次数": "", // "1":初诊，大于1表示复诊
"就诊ID": "", // [必填] 住院号
"患者ID": "", // [必填]
"姓名": "", // [必填]
"年龄": "28岁", // [必填] xx岁/xx月/xx天/xx小时
"性别": "男/女", // [必填]
"出生日期": "", // yyyy-MM-dd
"职业": "",
"民族": "",
"出生地": "",
"现住地": "",
"费用类型": "医保/商保/自费/公费/等",
"身高": "180cm",
"体重": "70kg",
"ABO血型": "A/B/AB/O",
"Rh血型": "阴/阳",
"婚姻状态": "未婚/已婚/离异/丧偶",
"特殊人群": [""],
"生理状态": "月经期/妊娠期/哺乳期/孕早期/孕中期/孕晚期/卵泡期/黄体期/排卵期"
},
"入院记录": {
"科室": "", // 入院科室
"记录ID": "", // 入院记录ID
"记录内容": "", // 无结构化纯文本内容, 仅用于无法提供结构化数据的厂商使用
"记录时间": "yyyy-MM-dd HH:mm:ss", // 入院记录书写时间
"入院时间": "yyyy-MM-dd HH:mm:ss", // 患者入院时间
"怀孕状态": "未孕/已孕/已育",
"病史陈述者": "",
"主诉": "",
"现病史": "",
"既往史": "",
"个人史": "",
"月经史": "",
"婚育史": "",
"家族史": "",
"过敏史": "",
"接种史": "",
"体格检查": "",
"辅助检查": "",
"专科检查": "",
"诊断": [
{
"诊断类型": "初步诊断/入院诊断/补充诊断/确诊诊断/其他诊断/鉴别诊断/出院诊断",
"诊断项": "",
"主要诊断": "是/否",
"诊断ICD编码": ""
}
],
"中医诊断": [
{
"诊断类型": "初步诊断/入院诊断/补充诊断/确诊诊断/其他诊断/鉴别诊断/出院诊断",
"主要诊断": "是/否",
"中医疾病" : {
"名称": "",
"代码": ""
},
"中医证型": [
{
"名称": "",
"代码": ""
}
]
}
]
}
}
医嘱¶
请点击箭头查看内容
{
"场景": ["医嘱"],
"trigger": "保存/提交/CDSS", // 触发CDSS的方式
// 1) 保存：点击保存时自动触发；
// 2) 提交：点击提交时自动触发；
// 3) CDSS：点击单独新增的CDSS按钮触发。
"工作人员信息": {
"医院": "", // [必填]医院名称
"科室": "", // [必填]科室名称
"姓名": "", // [必填]工作人员姓名
"账号ID": "", // [必填]医疗信息系统账号
"角色": "医生/护士/药师/等",
"职称": "",
"ip": "" // 医生电脑ip地址
},
"患者信息": {
"就诊类型": "门诊/住院/急诊/体检", // [必填]
"就诊次数": "", // "1":初诊，大于1表示复诊
"就诊ID": "", // [必填] 住院号 或者 门诊号(一次就诊有唯一ID)
"患者ID": "", // [必填] (一个患者有唯一ID)
"姓名": "", // [必填]
"年龄": "28岁", // [必填] xx岁/xx月/xx天/xx小时
"性别": "男/女", // [必填]
"出生日期": "", // yyyy-MM-dd
"职业": "",
"出生地": "",
"现住地": "",
"费用类型": "医保/商保/自费/公费/等",
"身高": "180cm",
"体重": "70kg",
"ABO血型": "A/B/AB/O",
"Rh血型": "阴/阳",
"婚姻状态": "未婚/已婚/离异/丧偶",
"特殊人群": [""],
"生理状态": "月经期/妊娠期/哺乳期/孕早期/孕中期/孕晚期/卵泡期/黄体期/排卵期"
},
"医嘱": [
{
"处方ID": "", // 处方号
"医嘱ID": "", // [必填] 医嘱项目的唯一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", // 医嘱下达的预期结束时间
"医嘱开立科室": "",
"医嘱开立者": "",
"医嘱审核科室": "",
"医嘱审核者": "",
//以下为检验医嘱独有字段
"标本":"",
// 以下为用药医嘱独有字段
"用药天数":"",
"药物商品名": "", // 医嘱类型=用药时 [必填]
"药物通用名": "",
"国药准字号": "", // 医嘱类型=用药时 [必填]
"药物编码": "",
"药物类别": "电解质平衡调节药",
"药物剂型": "注射剂/片剂/胶囊剂/丸剂/散剂/气雾剂/等", // 医嘱类型=用药时 [必填]
"用药途径": "口服/皮下注射/肌肉注射/静脉注射/外用/雾化吸入/等", // 医嘱类型=用药时 [必填]
"使用频率": "", // 医嘱类型=用药时 [必填]
"单次剂量": "", // 医嘱类型=用药时 [必填]
"总剂量": "", // 医嘱类型=用药时 [必填]
"剂量单位": "", // 医嘱类型=用药时 [必填]
// 皮试医嘱有2种常见方式: 1)用药医嘱之外单独开一项皮试医嘱；2)开用药医嘱，标记"需要皮试"，护士做完皮试后填写"皮试结果"
"需要皮试": "是/否",
// 以下为护理医嘱、诊疗医嘱独有字段
"执行频率": "",
"护理级别": "",
// 以下为检查医嘱、检验医嘱独有字段
"报告ID": "", // 检验报告ID或者检查报告ID
// 以下为手术医嘱独有字段
"麻醉方式": "",
// 以下为检查
"检查部位": ["胸部","腹部"],
"检查方法": ["平扫","正位"]
}
]
}
检验报告¶
请点击箭头查看内容
{
"场景": ["查看检验报告"],
"trigger": "保存/提交/CDSS", // 触发CDSS的方式
// 1) 保存：点击保存时自动触发；
// 2) 提交：点击提交时自动触发；
// 3) CDSS：点击单独新增的CDSS按钮触发。
"工作人员信息": {
"医院": "", // [必填]医院名称
"科室": "", // [必填]科室名称
"姓名": "", // [必填]工作人员姓名
"账号ID": "", // [必填]医疗信息系统账号
"角色": "医生/护士/药师/等",
"职称": "",
"ip": "" // 医生电脑ip地址
},
"患者信息": {
"就诊类型": "门诊/住院/急诊/体检", // [必填]
"就诊次数": "", // "1":初诊，大于1表示复诊
"就诊ID": "", // [必填] 住院号 或者 门诊号(一次就诊有唯一ID)
"患者ID": "", // [必填] (一个患者有唯一ID)
"姓名": "", // [必填]
"年龄": "28岁", // [必填] xx岁/xx月/xx天/xx小时
"性别": "男/女", // [必填]
"出生日期": "", // yyyy-MM-dd
"职业": "",
"出生地": "",
"现住地": "",
"费用类型": "医保/商保/自费/公费/等",
"身高": "180cm",
"体重": "70kg",
"ABO血型": "A/B/AB/O",
"Rh血型": "阴/阳",
"婚姻状态": "未婚/已婚/离异/丧偶",
"特殊人群": [""],
"生理状态": "月经期/妊娠期/哺乳期/孕早期/孕中期/孕晚期/卵泡期/黄体期/排卵期"
},
"检验报告": [
{
"科室": "", // 检验科室
"检验报告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",
"检验时间": "yyyy-MM-dd HH:mm:ss",
"报告时间": "yyyy-MM-dd HH:mm:ss",
"检验项目": "", // [必填] 检验项目（大项）
"检验结果": [
{
"检验指标项": "", // [必填] 检验指标项目（小项）
"检验指标缩写": "",
"结果": "", // [必填] 检验指标结果
"单位": "", // [必填] 检验指标结果单位
"结果提示": "", // [必填] 检验指标结果状态，枚举值：偏高(↑)、偏低(↓)、正常、异常
// 结果明确的填具体值，不明确留空
"最大值": "", // [必填] 检验指标最大值
"最小值": "", // [必填] 检验指标最小值
"正常值": "" // [必填] 检验指标正常值
}
]
}
]
}
过敏记录¶
请点击箭头查看内容
{
"场景": ["过敏记录"],
"trigger": "提交",
"工作人员信息": {
"医院": "", // [必填]医院名称
"科室": "", // [必填]科室名称
"科室ID": "", // [必填]科室ID
"姓名": "", // [必填]工作人员姓名
"账号ID": "", // [必填]医疗信息系统账号
"角色": "医生/护士/药师/等",
"职称": "",
"ip": "" // 医生电脑ip地址
},
"患者信息": {
"就诊类型": "门诊/住院/急诊/体检", // [必填]
"就诊次数": "", // "1":初诊，大于1表示复诊
"就诊ID": "", // [必填] 住院号 或者 门诊号(一次就诊有唯一ID)
"患者ID": "", // [必填] (一个患者有唯一ID)
"姓名": "", // [必填]
"年龄": "28岁", // [必填] xx岁/xx月/xx天/xx小时
"性别": "男/女", // [必填]
"出生日期": "", // yyyy-MM-dd
"职业": "",
"出生地": "",
"现住地": "",
"费用类型": "医保/商保/自费/公费/等",
"身高": "180cm",
"体重": "70kg",
"ABO血型": "A/B/AB/O",
"Rh血型": "阴/阳",
"婚姻状态": "未婚/已婚/离异/丧偶",
"特殊人群": [""],
"生理状态": "月经期/妊娠期/哺乳期/孕早期/孕中期/孕晚期/卵泡期/黄体期/排卵期"
},
"过敏记录": [
{
"记录ID": "",
"记录时间": "yyyy-MM-dd HH:mm:ss",// 来源类型=过敏源测试，一般由护士根据皮试结果录入，或者医生根据检验报告结果录入
// 来源类型=过敏史，一般由医生根据患者病史录入
// 来源类型=过敏源检测，可选字段
"来源类型": "过敏史/过敏源检测",
"检测名称": "皮肤点刺试验/皮内注射试验/斑贴试验/IgE检测/IgG检测",
"过敏源类型": "药物/食物/环境/其他",
"过敏源": "青霉素类抗生素/磺胺类抗生素/待皮试的药物名称等",
"阴阳性": "阴/阳/未做",
"过敏症状": "",
"严重程度": "",
}
]
}
SDK出参：结果数据规范¶
返回数据格式如下：
| 字段 | 值类型 | 含义 |
|---|---|---|
| type | 字符串 | 回填类型，type取值含义见下方 |
| flag | 布尔值 | true: 勾选 false: 取消勾选 |
| data | object | 返回数据, 格式根据type取值动态调整 |
诊断推荐回填数据规范¶
请点击箭头查看内容
其他疗法回填数据规范¶
请点击箭头查看内容
西药推荐回填数据规范¶
请点击箭头查看内容
{
"type": "medicine_recommend",
"flag": true, // true表示勾选 false表示取消勾选
"data": {
"cfda_id": "国药准字H20010353", //国药准字号
"dosage_form": "片剂", //剂型
"hospital_code": "", //项目编码
"hospital_id": "", //机构编码
"manufacturer": "四川方向药业有限责任公司", //生产厂家
"name": "盐酸头孢他美酯片", //药品名称
"pname": "头孢他美酯",
"specification": "180mg", //规格
}
}
中药推荐回填数据规范¶
请点击箭头查看内容
{
"type": "tcm_medicine_recommend",
"flag": true, // true表示勾选 false表示取消勾选
"data": {
"name": "", // 方剂名称
"details": [
{
"medicine": {
"name":"", // 中药名
"hospital_id":"",
"hospital_code":"", //本地化字段
},
"value":"", // 数量
"unit":"", // 单位
"decoction": {
"name":"", // 煎制法
"hospital_id":"",
"hospital_code":"", //本地化字段
}
}
]
}
}