灵医智惠CDSS标准版C/S SDK开发指南v1——RIS系统¶

SDK初始化¶

客户端安装¶

在医生电脑上，下载灵医智惠CDSS程序01cdss.exe，按照提示安装即可。

动态库引用¶

在HIS/EMR等医疗信息系统代码中引入01cdss.dll动态库，以csharp为例，引入动态库代码如下：

[DllImport("01cdss.dll", EntryPoint = "SetReceiveHandle",
    CallingConvention = CallingConvention.Cdecl)]
public static extern void SetReceiveHandle(string systemType, int handleNum);

[DllImport("01cdss.dll", EntryPoint = "SetSecurityKeys",
    CallingConvention = CallingConvention.Cdecl)]
public static extern void SetSecurityKeys(string ak, string sk);

[DllImport("01cdss.dll", EntryPoint = "UserLogin",
    CallingConvention = CallingConvention.Cdecl)]
public static extern void UserLogin(string userInfo);

[DllImport("01cdss.dll", EntryPoint = "SendMessageToCDSS",
    CallingConvention = CallingConvention.Cdecl)]
public static extern int SendMessageToCDSS(string message, int handleNum, int trigger);

[DllImport("01cdss.dll", EntryPoint = "BroadcastMessageToCDSS",
    CallingConvention = CallingConvention.Cdecl)]
public static extern void BroadcastMessageToCDSS(string msg, int handleNum);

注册¶

// handleNum: 窗口句柄号
SetReceiveHandle("RIS", int handleNum);

// ak和sk请联系灵医智惠CDSS技术人员提供
SetSecurityKeys(string ak, string sk);

HIS/EMR等信息系统程序启动后： * 1）调用DLL提供的SetReceiveHandle("RIS", int handleNum)方法注册程序信息，用于告知接收Windows消息（医嘱回填数据）的窗体，若接受回传数据的界面在同一个窗体内，则只需要注册一次即可。 * 2）调用DLL提供的SetSecurityKeys(string ak, string sk)方法注册密钥信息，ak和sk请联系灵医智惠CDSS技术人员提供。

用户登录¶

// userInfo: 用户信息，值为JSON字符串，用户包括医生/护士/药师等
//  {
//    "name": "医生/护士/药师姓名",
//    "id": "医生/护士/药师ID",
//    "department": "科室",
//    "hospital": "医院名称"
//  }
UserLogin(string userInfo);

当用户登录HIS系统时，调用DLL提供的UserLogin(string userInfo)方法注册用户基本信息。

SDK接口定义¶

灵医智惠CDSS支持多种触发方式，见下方表格：

trigger取值	触发类型	触发交互逻辑	是否可选
0	人工手动触发	点击新增的CDSS按钮	必选
12	后台自动触发	关闭检查报告	必选
14	后台自动触发	检查预约/检查报告审核/查看检查报告	必选

新增按钮手动触发¶

// message: 患者数据，必须符合《患者数据规范》
// handleNum: 窗口句柄号
// trigger=0: 触发方式为按钮手动触发
string message = "{\"xx\":\"xx\"}";
SendMessageToCDSS(message, handleNum, 0);

当医生编辑检查报告过程中，点击新增的按钮手动触发，将当前检查报告数据按规定的Json格式通过异步接口发送给CDSS程序。新增按钮的样式与文案由医院、HIS厂商、灵医智惠三方共同讨论确定。

检查预约时自动触发¶

// message: 患者数据，必须符合《患者数据规范》
// handleNum: 窗口句柄号
// trigger=14: 触发方式为检查预约时自动触发
string message = "{\"xx\":\"xx\"}";
SendMessageToCDSS(message, handleNum, 14);

当医生**检查预约时后台自动触发**，将当前检查报告数据按规定的Json格式通过异步接口发送给CDSS程序。

检查报告审核时自动触发¶

// message: 患者数据，必须符合《患者数据规范》
// handleNum: 窗口句柄号
// trigger=14: 触发方式为检查报告审核时自动触发
string message = "{\"xx\":\"xx\"}";
SendMessageToCDSS(message, handleNum, 14);

当医生，点击审核按钮时后台自动触发，将当前检查报告数据按规定的Json格式通过异步接口发送给CDSS程序。

查看检查报告时自动触发¶

// message: 患者数据，必须符合《患者数据规范》
// handleNum: 窗口句柄号
// trigger=14: 触发方式为查看检查报告时自动触发
string message = "{\"xx\":\"xx\"}";
SendMessageToCDSS(message, handleNum, 14);

当医生，查看检查报告时后台自动触发，将当前检查报告数据按规定的Json格式通过异步接口发送给CDSS程序。

关闭检查报告时自动触发¶

// message: 空字符串
// handleNum: 窗口句柄号
// trigger=12: 触发方式为关闭检查报告时自动触发
SendMessageToCDSS("", handleNum, 12);

当医生**关闭检查报告窗口时后台自动触发**，通过异步接口发送给CDSS程序。切换到已经存在的检查报告窗口或选项卡时，执行trigger=12告知当前窗口或选项卡已关闭。

SDK入参：患者数据规范¶

检查报告¶

{
  "场景": ["检查项目预约","检查报告审核","查看检查报告"],
  "trigger": "保存/提交/CDSS",   // 触发CDSS的方式
                                //  1) 保存：点击保存时自动触发；
                                //  2) 提交：点击提交时自动触发；
                                //  3) CDSS：点击单独新增的CDSS按钮触发。
  // 工作人员信息
  "医院": "",                   // [必填]医院名称
  "科室": "",                   // [必填]科室名称
  "医生": "",                   // [必填]工作人员姓名
  "uid": "",                   // [必填]医疗信息系统账号
  // 患者信息
  "诊疗类型": "门诊/急诊/体检",   // [必填]
  "rid": "",                  // [必填] 住院号 或者 门诊号
  "pid": "",                  // [必填] 患者ID
  "年龄": "28岁",              // [必填] xx岁/xx月/xx天/xx小时
  "性别": "男/女",             // [必填]
  // 检查报告单
  "检查": [
    {
      "检查单号": "",
      "医嘱单号": "",           // 医嘱申请单单号
      "检查项": "胸部CT",
      "申请时间": "yyyy-MM-dd HH:mm:ss",
      "检查时间": "yyyy-MM-dd HH:mm:ss",
      "报告时间": "yyyy-MM-dd HH:mm:ss",
      "检查原因": "",
      "检查所见": "",
      "检查结果": ""
    }
  ]
}