灵医智惠智慧病案（环节质控）C/S SDK开发指南-EMR系统¶

SDK初始化¶

客户端安装¶

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

动态库引用¶

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

[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 = "OpenCDSSByPath",
    CallingConvention = CallingConvention.Cdecl)]
public static extern void OpenCDSSByPath(string cdssPath);

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

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

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

注册¶

// systemType: 信息系统类型
//    | HIS  | 医生工作站（医嘱） |
//    | EMR  | 电子病历系统 |
//    | LIS  | 检查系统 |
//    | RIS  | 检验系统 |
//    | OAMS | 手术系统 |
// handleNum: 窗口句柄号
SetReceiveHandle(string systemType, int handleNum);

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

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

用户登录¶

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

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

开启智慧病案程序¶

//Path : 程序所在路径，如：c:\\xxx\\
OpenCDSSByPath(string path);

EMR等信息系统程序启动后，可调用DLL的OpenCDSSByPath(string path)方法打开程序智慧病案，不使用此方法也可设置程序开机启动;

SDK接口定义¶

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

trigger取值	触发类型	触发交互逻辑	是否可选
0	人工手动触发	点击新增的按钮	可选
11	后台自动触发	切换患者/打开病历	必选
12	后台自动触发	关闭病历	必选
14	后台自动触发	提交病历	必选

点击按钮手动触发¶

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

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

切换患者/打开病历文档时自动触发¶

// message: 患者数据，必须符合《患者数据规范》
// handleNum: 窗口句柄号
// trigger=11: 触发方式为打开病历文档时自动触发
string message = "{\"xx\":\"xx\"}"; 
SendMessageToCDSS(message, handleNum, 11);

当医生**切换患者或打开一份病历时后台自动触发**，将当前病历数据按规定的Json格式通过接口发送给智慧病案程序。触发条件包括：1) 医生切换患者，2）打开新的病历文档窗口或选项卡，3) 切换到已经存在的病历文档窗口或选项卡。

关闭病历文档时自动触发¶

// message: ""
// handleNum: 窗口句柄号
// trigger=12: 触发方式为关闭病历文档时自动触发
SendMessageToCDSS("", handleNum, 12);

当医生**关闭病历窗口时后台自动触发**，通过异步接口发送给智慧病案程序。

保存病历文档时自动触发¶

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

当医生完成病历编辑后，点击提交按钮时后台自动触发，将当前病历数据按规定的Json格式通过接口发送给智慧病案程序。

关闭智慧病案程序¶

CloseCDSS();

当用户关闭EMR系统时，调用DLL提供的CloseCDSS()方法关闭智慧病案程序，如设置开机启动，不需调用此方法。

SDK入参：患者数据规范¶

患者数据格式参考文档《病案数据Schema规范》

功能所需单据说明¶

环节质控功能¶

根据医院实际上线质控点来控制单据。注意：医生端保存病案首页时，单据的key传**病案首页(医生)，病案室保存病案首页时单据的key传**病案首页

付费监测功能¶

注意：医生端保存病案首页时，单据的key传**病案首页(医生)，病案室保存病案首页时单据的key传**病案首页

单据名称	是否必传
入院记录	是
24小时入出院记录	是
医嘱	是
检验报告	否
检查报告	否
首次病程记录	否
出院记录	是
病案首页	是
病案首页(病案科)	是
输血申请单	否
手术申请单	否
术前讨论	否
术前小结	否
手术记录	是
术后病程记录	否
日常病程记录	否
会诊记录	否
疑难病例讨论记录	是
查房记录	否
抢救记录	否
转入记录	否
转出记录	否
死亡记录	是
死亡病例讨论记录	是
新生儿出生记录	否
有创操作记录	是
阶段小结	否
交班记录	否
接班记录	否
病理检查报告单	否
24小时内入院死亡记录	否
输血记录	否
医疗费用明细	是
医保结算表	是