PASS嵌入技术文档

PASS系统应用技术手册 美康公司 二00七年三月第一节 PASS系统功能PASS主要为医院医护人员提供病人用药审查和药品信息查询功能，具体如下：1、 病人用药审查根据病人基本情况信息、过敏史/病人状态信息、用药清单信息进行合理用药审查，审查项目包括：（1）、药物与药物类的审查，主要包括：u 药物与药物相互作用审查u 重复用药审查（包括重复成份审查和重复治疗审查）u 注射剂体外配伍审查（2）、药物与病症类审查u 禁忌症审查u 副作用审查u 过敏史审查（3）、特殊人群用药警告类审查u 老年用药审查u 儿童用药审查u 妊娠期用药审查u 哺乳期用药审查（4）、用法、用量类审查u 给药途径审查（包括药品与给药途径审查和剂型与给药途径审查）u 剂量审查（包括对每次剂量、每日剂量、频次、持续时间、终生积累量审查） 2、药物信息查询 PASS系统主要提供以下信息的查询功能：u 药物临床信息参考查询u 药品说明书信息查询u 病人用药教育信息查询u 国家药典信息查询u 检验值信息查询u 药物相互作用信息查询u 药物与食物相互作用信息查询u 注射剂体外配伍信息查询u 禁忌症信息查询u 副作用信息查询u 儿童用药警告信息查询u 老年用药警告信息查询u 妊娠期用药警告信息查询u 哺乳期用药警告信息查询u 医药信息中心3、为了准确进行病人过敏史及药物与病症类审查，PASS系统还提供病人过敏史及病生状态标准管理功能。4、 进行用药研究：向医学人员提供进行合理用药研究的操作功能。 第二节 PASS系统在医院HIS系统中的应用结构图住院医生工作站1、 加入PASS系统病人过敏史、病生状态功能。2、 加入PASS系统标准右键弹出菜单功能3、 保存医嘱时，加入自动审查功能，并要求HIS系统根据PASS系统结果进行警示变色。4、 点击黑、红、橙、黄警示灯时，系统自动弹出“药品审查结果简要提示信息浮动窗口”（可选）。5、 加入“药品信息查询浮动窗口”自动弹出功能（可选）。6、 通过PASS系统客户端程序以DCOM访问PASS服务程序。7、 通过DLL函数调用嵌入PASS功能。门诊医生工作站1、 加入PASS系统病人过敏史、病生状态功能。2、 加入PASS系统标准右键弹出菜单功能3、 保存处方时，加入自动审查功能，并要求HIS系统根据PASS系统结果进行警示变色。4、 点击黑、红、橙、黄警示灯时，系统自动弹出“药品审查结果简要提示信息浮动窗口”（可选）。5、 加入“药品信息查询浮动窗口”自动弹出功能（可选）。6、 通过PASS系统客户端程序以DCOM访问PASS服务程序。7、 通过DLL函数调用嵌入PASS功能。一、PASS系统在医院HIS系统应用模式示意图 PASS系统服务器1、 PASS系统数据（1）、SQL Server或Oracle数据库（2）、审查、查询系统数据（3）、医院药品、给药途径配对结果数据（4）、自动审查结果数据2、 PASS系统服务程序（1）、以ADO方式连接数据库（2）、建立Medicom DIFPASSCore Service和Medicom DIFPASSHelper Service服务 HIS服务器与PASS系统相关数据1、 在门诊处方、住院医嘱表中加入审查结果字段。2、 在药品、给药途径字典所在数据库中加入PASS系统配对结果表。3、 根据HIS药品、给药途径字典表和PASS系统配对结果表生成配对情况视图。PASS配对工作站1、 直接访问HIS系统数据库进行读取HIS药品、给药途径及配对结果信息。2、 通过PASS系统客户端程序以DCOM访问PASS服务程序来提供药物配对功能。3、 程序由美康公司直接提供审查结果统计分析工作站1、 直接访问PASS系统数据库进行审查结果查询、统计。2、 通过PASS系统客户端程序以DCOM访问PASS服务程序来提供药物审查查询功能。3、程序由美康公司直接提供PASS系统在医院中的应用主要包括以下几部分：1、PASS系统服务器为了保证HIS系统、PASS系统的安全性和独立性，要求医院采用独立服务器作“PASS服务器”的应用方式。PASS系统服务器主要用于安装“PASS系统数据库”和“PASS系统服务程序”。PASS系统数据库可以是Sql Server或Oracle，主要包括“PASS系统审查、查询系统数据”、“医院药品、给药途径配对数据”和“自动审查采集数据”。安装PASS系统服务程序后，系统自动在服务器中建立“Medicom DIFPASSCore Servic”、“Medicom DIFPASSHelper Service”服务项目，服务程序通过ADO与PASS数据库连接。2、 嵌入PASS功能的住院（门诊）医生工作站为了实现PASS系统对HIS病人用药自动、实时审查和查询功能，要求HIS医生工作站嵌入PASS系统提供的DLL函数来加入PASS系统提供的功能，嵌入具体要求如下： 加入PASS系统病人过敏史、病生状态管理功能 加入PASS系统标准右键弹出菜单功能 保存处方时，加入PASS自动审查功能，并要求HIS系统根据PASS系统结果进行警示变色。另外，PASS系统自动将审查出的不合理用药结果保存到PASS系统服务器，以便医院管理层、专业人员对PASS审查结果进行查询、统计分析。 加入“药品信息查询浮动窗口”自动弹出功能。（可选） 点击黑、红、橙、黄警示灯时，系统自动弹出“药品审查结果简要提示信息浮动窗口”。（可选）注意：通过PASS系统客户端程序以DCOM访问PASS服务程序，所以住院（门诊）医生工作站只需安装PASS系统客户端程序，不需安装数据库客户连接程序。3、PASS配对工作站为了让PASS能正确、全面识别从HIS系统传入的病人用药情况信息，PASS系统需要预先建立HIS系统药品数据字典和给药途径数据字典的对应关系表，建立对应关系表的过程称为配对，安装配对程序的工作站叫做PASS配对工作站。 PASS系统配对项目主要包括“药品配对”和“给药途径配对”，药品配对主要建立药品名称、剂型、给药单位之间的对应关系，给药途径配对主要要求建立给药途径之间的对应关系。为了让医院能尽快实施和使用PASS，美康公司要求医院在工程实施前以电子文档方式提供医院HIS系统中的药品、给药途径数据字典表，然后由美康公司专业人员负责完成药品、给药途径的配对工作，并将配对结果直接打包到PASS系统安装光盘数据库中。对于安装完PASS系统后医院新进药品，美康公司提供独立的配对工具程序，以便医院专业人员及时完成新进药品配对，保证PASS系统能对医院药品信息进行准确、全面的审查。4、审查结果统计分析工作站 前面提到，PASS系统在医生工作站对病人用药自动审查时，会自动将审查出的不合理用药结果保存到PASS系统服务器。美康公司提供的“审查结果统计分析工作站”就是供医院管理层、专业人员对全院审查结果进行全面、准确统计分析的独立程序，医院管理层、专业人员通过此程序可以了解、掌握全院医生用药情况，有针对性地制定出有效的用药管理措施。第三节 PASS系统工程实施前准备一、向美康公司提供医院药品、给药途径字典数据为了让医院能尽快实施和使用PASS，美康公司要求医院在工程实施前以电子文档(EXCEL表格)方式向美康公司提供医院HIS系统中的药品、给药途径数据字典数据，以便美康公司专业人员在工程实施前完成药品、给药途径的初始配对，初始配对结果将直接打包到PASS系统安装光盘数据库中。医院信息科将医院药品、给药途径数据字典，以EXCEL表格发到美康公司技术支持部邮箱（email: 联系电话。药品数据字典项目要求：u 药品唯一码u 药品名称u 剂型名称（注意不能是代码）u 规格u 最小制剂单位名称（注意不能是代码）u 拼音码 药品数据字典样例： 药品唯一码药品名称拼音码剂型名称规格最小制剂单位名称2415头孢曲松钠(亚松)TBQSN针剂0.5gg2430胆清胶囊DQJN胶囊60s粒245甲基强的松龙JJQDSL针剂40mgmg2466碳酸氢钠片TSQNP片剂0.3*1000g2542洛赛克胶囊LSKJN胶囊20mg*14mg2591(健择)盐酸吉西他滨针JZZ注射液1gg2607卡维地洛片KWDLP片剂10mg*28mg2620格利福斯针GLFSZ针剂10ml*10ml2649易思清YSQ口服液100mlml2654虎力散胶囊HLSJN胶囊0.3g*8g2678维脑路通片WNLTP片剂0.1g*100g2690定克斯胶囊DKSJN胶囊0.1g*6g2759肝炎灵针GYLZ针剂2ml*10ml2769(博宁)帕米磷酸二钠针BN针剂15mgmg2786清开灵针QKLZ针剂10ml*5ml2794(诺为)马来酸曲美布汀片NWP片剂20s粒2830(康锐)氟康唑片FKZP片剂50mg*6mg2842(培达)西洛他唑片PDP片剂50mg*12mg2843粉尘螨针FCMZ针剂1ml*10ml2908芬太尼针FTNZ针剂0.5mg*2mg 给药途径字典项目（注：给药途径指给药方法，也称用法，例如“口服”、“肌注”等）：u 给药途径名称u 拼音码给药途径数据字典样例：给药途径名称拼音码口服Kf肌注Jz静滴Jd 军卫一号HIS系统医院药品、给药途径字典数据要求：1、 老药品结构医院药品数据：（1）、药品数据要求：pham_basic_info表中的pham_code、pham_name、pham_name、dose_unit字段，对应的sql语句为：select pham_code,pham_name,pham_name,dose_unit from pham_basic_info;（2）、给药途径数据要求：administration_dict 表中的administration_name、input_code字段，对应的sql语句为：select administration_name,input_code from administration_dict;2、 新药品结构医院药品数据：（1）、药品数据要求：DRUG_DICT表中的drug_code、drug_name、drug_form、dose_units字段，对应的sql语句为：select drug_code, drug_name, drug_form, dose_units from DRUG_DICT;（2）、给药途径数据要求：administration_dict 表中的administration_name、input_code字段，对应的sql语句为：select administration_name,input_code from administration_dict;二、填写“PASS合理用药客户调查表” 详见“PASS合理用药客户调查表”，填写好后，请尽快发到美康公司邮箱（email: 联系电话。三、医院准备好PASS系统专用服务器为了保证HIS系统、PASS系统的安全性和独立性，要求医院采用独立服务器作“PASS服务器”的应用方式。四、协调好HIS系统技术人员在配合工作为了实现PASS系统对HIS病人用药自动、实时审查和查询功能，要求HIS技术人员在美康公司技术人员的配合下，完成HIS系统相关模块PASS系统功能的嵌入工作。四、PASS系统工程实施1、正确安装PASS系统服务器，具体参见“PASS系统服务器安装手册”：（1）、正确安装操作系统Windows 2000。（2）、正确安装SQL SERVER 2000或oracle 数据库。（3）、正确恢复PASS系统数据库medicomdif、medicomsave。（4）、正确安装PASS系统服务器程序。2、在工作站正确安装PASS系统客户端程序，具体参见“PASS系统客户端安装手册”。3、在HIS系统门诊、住院医生工作站正确嵌入PASS系统审查、查询功能。4、按PASS系统要求在HIS系统数据库中建立药品、给药途径配对视图。5、在药库安装PASS系统配对工作站程序。6、在药剂科安装PASS系统审查结果统计分析程序。第五节、PASS系统在医院医生工作站的嵌入一、PASS系统医生工作站软件结构示意图PASS系统数据（SQL Server或Oracle）PASS系统服务程序ADO连接PASS客户端程序PASS系统应用程序DCOM连接DLL函数调用PASS系统服务器PASS系统工作站1、PASS系统服务器主要用于安装“PASS系统数据库”和“PASS系统服务程序”。PASS系统服务程序通过ADO访问PASS系统数据库。2、PASS系统客户端程序以DCOM访问PASS服务程序，所以住院（门诊）医生工作站只需安装PASS系统客户端程序，不需安装数据库客户连接程序。3、HIS系统程序通过嵌入PASS系统提供的DLL函数来加入PASS系统提供的功能。二、嵌入目标示意图1、“过敏史/病生状态”按钮2、药品信息查询浮动窗口6、药品审查结果简要提示信息浮动窗口3、PASS右键弹出式菜单5、PASS审查结果警示灯4、保存PASS系统自动审查1、在病人医嘱录入界面中加入“过敏史/病生状态”管理按钮，以便按PASS系统标准进行病人过敏史/病生状态管理。2、点击药品时，系统自动弹出“药品信息查询浮动窗口”，提供药品简要提示信息、药物临床信息参考、药品说明书、医药信息中心、病人用药教育、PASS系统帮助等信息的查询功能。3、以右键弹出菜单方式提供PASS系统查询、审查功能。4、在保存医嘱前，实现对病人当天所用医嘱合理用药审查功能。5、HIS系统医嘱界面增加“PASS系统审查结果警示灯”列，以便审查后能根据严重程度进行变灯处理。6、点击黑、红、橙、黄警示灯时，系统自动弹出“药品审查结果简要提示信息浮动窗口”。三、嵌入前的准备工作1、 正确安装好PASS服务器，安装方法与步骤参见“PASS系统服务器安装手册”。2、 正确安装好PASS客户端程序，安装方法与步骤参见“PASS系统客户端程序安装手册”。3、 拷贝嵌入所必须文件（主要是警示灯图标文件，DLL相关文件安装自动实现）。四、HIS系统是否调用PASS功能控制方案与设置1、 在HIS系统数据库中加入“是否调用PASS系统”的数据记录，以便设置全院是否调用PASS系统功能。例如：在HIS系统表“APP_CONFIGER_PARAMETER”中加入一是否调用PASS系统参数设置记录，具体如下：参数名字段参数值字段PARAMETER_NAMEPARAMETER_VALUEPASS1：表示调用PASS功能；0：表示不调用PASS功能；通过在HIS系统中运行下面SQL语句便可在HIS系统加加入PASS功能调用设置：INSERT INTO APP_CONFIGER_PARAMETER (PARAMETER_NAME,PARAMETER_VALUE) Values (PASS,1); 同样通过在HIS系统中运行下面SQL语句便可修改PASS功能调用设置：UPDATE INTO APP_CONFIGER_PARAMETERSET PARAMETER_VALUE = 1WHERE PARAMETER_NAME= PASS; 附：军卫一号HIS系统PASS参数设置SQL语句：INSERT INTO COMM.APP_CONFIGER_PARAMETER (APP_NAME,DEPT_CODE,EMP_NO,PARAMETER_NAME,PARAMETER_VALUE,position) Values (DOCTOR,*, *,PASS,1,*);INSERT INTO COMM.APP_CONFIGER_BASEINFO (APP_NAME,PARAMETER_NO,PARAMETER_NAME ,PARAINIT_VALUE ,PARAMETER_SCOPE, EXPLANATION ) VALUES (DOCTOR,9,PASS,1,1,0, 1全院可以使用，0全院都不可以使用。);COMMIT ;2、可通过在HIS系统建立一表来设定哪些科室、用户可用，哪些科室、用户不可用。3、在嵌入PASS功能工作站的INI文件中加入本机是否调动PASS系统功能的设置参数，INI中要求至少具有如下3 项设置：A、 本地不调用PASS系统功能。B、 本地要调用PASS系统功能，但还要受HIS系统数据库PASS参数设置的控制；C、 本地要调用PASS系统功能，但不受HIS系统数据库PASS参数设置的控制，主要用于全院关闭PASS系统功能调用的情况下，进行软件调试用；例如：在嵌入PASS工作站的DOCTOR.INI中加入是否调用PASS系统功能的参数控制段：PASSPASS = 1 ;0: 表示不调用PASS系统功能； ;1: 表示要调用PASS系统功能，但还要受HIS系统数据库PASS参数设置的控制；;100: 表示要调用PASS系统功能，但不受HIS系统数据库PASS参数设置的控制，主要用于全院关闭PASS系统功能调用的情况下，进行软件调试用；4、为了HIS系统的安全性，一般最好要求进行动态DLL调用。五、门诊、住院医生工作站嵌入步骤第一步：加入PASS DLL函数声明为方便嵌入，下面分别提供了Powerbuilder、VB、Delphi开发语言中DLL函数声明文本，可直接拷贝文本来完成函数声明：（一）、PASS系统DLL函数在PowerBuilder中声明文本1、导入str_Rect结构体定义文件str_rect.srs，完成str_Rect结构体定义。2、拷贝PASS系统DLL函数声明/*美康嵌入代码开始（DLL函数声明）*/1、注册服务器Function Int RegisterServer() Library ShellRunAs.dll/2、PASS初始化Function Int PassInit(String UserName,& String DepartMentName,& Int WorkstationType) Library DIFPassDll.dll/3、PASS运行模式设置Function Int PassSetControlParam(Int SaveCheckResult,& Int AllowAllegen,& Int CheckMode,& Int DisqMode,& Int UseDiposeIdea) Library DIFPassDll.dll/4、传病人基本信息Function Int PassSetPatientInfo(String PatientID,& String VisitID,& String Name,& String Sex,& String Birthday,& String Weight,& String cHeight,& String DepartMentName,& String Doctor,& String LeaveHospitalDate) Library DIFPassDll.dll/5、传病人药品信息Function Int PassSetRecipeInfo(String OrderUniqueCode,& String DrugCode, & String DrugName,& String SingleDose,& String DoseUnit,& String Frequency,& String StartOrderDate,& String StopOrderDate, & String RouteName,& String GroupTag,& String OrderType,& String OrderDoctor)Library DIFPassDll.dll/6、传入病人过敏史Function Int PassSetAllergenInfo(string AllergenIndex,& string AllergenCode,& string AllergenDesc,& string AllergenType,& string Reaction)Library DIFPassDll.dll/7、传入病生状态Function Int PassSetMedCond(string MedCondIndex,& string MedCondCode,& string MedCondDesc,& string MedCondType,& string StartDate,& string EndDate)Library DIFPassDll.dll/8、信息查询药品传入Function Int PassSetQueryDrug(string DrugCode,& string DrugName,& string DoseUnit,& string RouteName) Library DIFPassDll.dll/9、获取右键菜单是否可用值Function Int PassGetState(string QueryItemNo) Library DIFPassDll.dll/10、PASS功能调用Function Int PassDoCommand(Int CommandNo) Library DIFPassDll.dll/11、获取药品警示级别Function Int PassGetWarn(String DrugUniqueCode) Library DIFPassDll.dll/12、设置药品浮动窗口位置Function Int PassSetFloatWinPos(Int left,Int top,Int right,Int bottom) Library DIFPassDll.dll/13、设置需要进行单药警告的药品Function Int PassSetWarnDrug(string DrugUniqueCode) Library DIFPassDll.dll/14、PASS退出函数Function Int PassQuit() Library DIFPassDll.dll/15、Windows API取坐标 Function boolean GetWindowRect(ulong hwnd,ref str_Rect rect) LIBRARY user32.dll /*美康嵌入代码结束（DLL函数声明）*（二）、PASS系统DLL函数在VB中声明文本/*美康嵌入代码开始（DLL函数声明）*Option Explicit1、注册服务器Public Declare Function RegisterServer Lib ShellRunAs.dll () As Integer2、PASS初始化Public Declare Function PassInit Lib DIFPassDll.dll _ (ByVal UserName As String, _ ByVal DepartMentName As String, _ ByVal WorkstationType As Integer) As Integer3、PASS运行模式设置Public Declare Function PassSetControlParam Lib DIFPassDll.dll _ (ByVal SaveCheckResult As Integer, _ ByVal AllowAllegen As Integer, _ ByVal CheckMode As Integer, _ ByVal DisqMode As Integer, _ ByVal UseDiposeIdea As Integer) As Integer4、传病人基本信息Public Declare Function PassSetPatientInfo Lib DIFPassDll.dll _ (ByVal PatientID As String, _ ByVal VisitID As String, _ ByVal Name As String, _ ByVal Sex As String, _ ByVal Birthday As String, _ ByVal Weight As String, _ ByVal cHeight As String, _ ByVal DepartMentName As String, _ ByVal Doctor As String, _ ByVal LeaveHospitalDate As String) As Integer5、传病人药品信息Public Declare Function PassSetRecipeInfo Lib DIFPassDll.dll _ (ByVal OrderUniqueCode As String, _ ByVal DrugCode As String, _ ByVal DrugName As String, _ ByVal SingleDose As String, _ ByVal DoseUnit As String, _ ByVal Frequency As String, _ ByVal StartOrderDate As String, _ ByVal StopOrderDate As String, _ ByVal RouteName As String, _ ByVal GroupTag As String, _ ByVal OrderType As String, _ ByVal OrderDoctor As String) As Integer 6、传入病人过敏史Public Declare Function PassSetAllergenInfo Lib DIFPassDll.dll _ (ByVal AllergenIndex As String, _ ByVal AllergenCode As String, _ ByVal AllergenDesc As String, _ ByVal AllergenType As String, _ ByVal Reaction As String) As Integer7、传入病生状态Public Declare Function PassSetMedCond Lib DIFPassDll.dll _ (ByVal MedCondIndex As String, _ ByVal MedCondCode As String, _ ByVal MedCondDesc As String, _ ByVal MedCondType As String, _ ByVal StartDate As String, _ ByVal EndDate As String) As Integer8、信息查询药品传入Public Declare Function PassSetQueryDrug Lib DIFPassDll.dll _ (ByVal DrugCode As String, _ ByVal DrugName As String, _ ByVal DoseUnit As String, _ ByVal RouteName As String) As Integer9、获取右键菜单是否可用值Public Declare Function PassGetState Lib DIFPassDll.dll _ (ByVal QueryItemNo As String) As Integer10、PASS功能调用Public Declare Function PassDoCommand Lib DIFPassDll.dll _ (ByVal CommandNo As Integer) As Integer11、获取药品警示级别Public Declare Function PassGetWarn Lib DIFPassDll.dll _ (ByVal DrugUniqueCode As String) As Integer12、设置药品浮动窗口位置Public Declare Function PassSetFloatWinPos Lib DIFPassDll.dll _ (ByVal left As Integer, _ ByVal top As Integer, _ ByVal right As Integer, _ ByVal bottom As Integer) As Integer13、设置需要进行单药警告的药品Public Declare Function PassSetWarnDrug Lib DIFPassDll.dll _ (ByVal DrugUniqueCode As String) As Integer14、PASS退出函数Public Declare Function PassQuit Lib DIFPassDll.dll () As Integer/15、Windows API取坐标/BOOL GetWindowRect(HWND hWnd,LPRECT lpRect)/*美康嵌入代码结束（DLL函数声明）*（三）、PASS系统DLL函数在Delphi中声明文本/*美康嵌入代码开始（DLL函数声明）*unit PassDllClare;interfaceUSES Windows, SysUtils,Classes,Controls,Forms;type /注册函数 TRegisterServer = Function:integer;stdcall; /2、PASS初始化 TPassInit = Function (Const UserName:Pchar; Const DepartMentName:Pchar; Const WorkstationType:Integer):Integer;stdcall; /3、PASS运行模式设置 TPassSetControlParam = Function(Const SaveCheckResult:integer; Const AllowAllegen:integer; Const CheckMode:integer; Const DisqMode:integer; Const UseDiposeIdea:Integer):Integer;stdcall; /4、传病人基本信息 TPassSetPatientInfo = Function (Const PatientID:Pchar; Const VisitID:Pchar; Const Name:Pchar; Const Sex:Pchar; Const Birthday:Pchar; Const Weight:Pchar; Const cHeight:Pchar; Const DepartMentName:Pchar; Const Doctor:Pchar; Const LeaveHospitalDate: Pchar):Integer;stdcall; /5、传用药药品清单信息 TPassSetRecipeInfo = Function (Const OrderUniqueCode:Pchar; Const DrugCode:Pchar; Const DrugName:Pchar; Const SingleDose:Pchar; Const DoseUnit:Pchar; Const Frequency:Pchar; Const StartOrderDate:Pchar; Const StopOrderDate:Pchar; Const RouteName:Pchar; Const GroupTag:Pchar; Const OrderType:Pchar; Const OrderDoctor:Pchar):Integer;stdcall; /6、传入病人过敏史 TPassSetAllergenInfo = Function(Const AllergenIndex:Pchar; Const AllergenCode:Pchar; Const AllergenDesc:Pchar; Const AllergenType:Pchar; Const Reaction:Pchar):Integer;stdcall; /7、传入病生状态 TPassSetMedCond = Function (Const MedCondIndex:Pchar; Const MedCondCode:Pchar; Const MedCondDesc:Pc