HC3i-《住院監(jiān)測系統(tǒng)》V30技術(shù)方案接口說明

1、藥物咨詢及用藥安全監(jiān)測系統(tǒng)V3.0 版本號：1.08接口技術(shù)方案（住院） 日 期：2010-8-20第 PAGE 18 頁 共 NUMPAGES 19 頁藥物咨詢及用藥安全監(jiān)測系統(tǒng)V3.0接口技術(shù)方案(住院)上海大通醫(yī)藥信息技術(shù)有限公司2010年3月修訂歷史記錄日期版本說明作者2009-5-111.00初始版本。馮磊2009-6-231.01XML中藥品名稱有可能出現(xiàn)，要求進行過濾。馮磊s2009-11-51.02dtywzxUI(0,0,)增加返回值馮磊2009-12-171.03要點提示區(qū)分門診和住院。馮磊2010-1-271.04XML中藥品名稱有可能出現(xiàn)，要求進行過濾。馮磊2010-2

2、-111.05XML中藥品名稱有可能出現(xiàn)&，要求進行過濾。馮磊2010-2-231.06加入各種開發(fā)語言的聲明示例。馮磊2010-3-81.07加入BCB6語言的聲明示例。馮磊2010-8-201.08去掉流程圖中調(diào)用4109參數(shù)的步驟。馮磊特 別 聲 明一、版權(quán)聲明本系統(tǒng)的版權(quán)及相關(guān)權(quán)利歸上海大通醫(yī)藥信息技術(shù)有限公司所有。任何組織與個人未經(jīng)許可或授權(quán)，不得擅自復(fù)制該產(chǎn)品的內(nèi)容與包裝。二、授權(quán)使用協(xié)議本系統(tǒng)只能在合法用戶的計算機網(wǎng)絡(luò)上使用。用戶不能對本軟件進行逆向工程、反編譯。用戶不能將本系統(tǒng)知識庫用于合同范圍以外的用途。用戶不能將本系統(tǒng)知識庫以任何形式給第三方。本系統(tǒng)內(nèi)容僅作用藥參考，不作法

3、律訴訟依據(jù)。一、概述現(xiàn)在部分醫(yī)院實現(xiàn)了住院醫(yī)生站的電子處方系統(tǒng)，這就為嵌入式藥物咨詢提供了應(yīng)用基礎(chǔ)；為此，提出以下藥物咨詢及用藥安全監(jiān)測系統(tǒng)與原醫(yī)院信息系統(tǒng)的接口規(guī)范。在嵌入過程中，只需要將醫(yī)生開的醫(yī)囑內(nèi)容如：藥品名稱、用法、用量、用藥時間等參數(shù)傳遞出，再調(diào)用相應(yīng)的函數(shù)，即可實現(xiàn)嵌入工作。二、醫(yī)院系統(tǒng)與嵌入系統(tǒng)接口方式藥物咨詢及用藥安全監(jiān)測系統(tǒng)系統(tǒng)數(shù)據(jù)庫采用類型：SQLserver2000（SP4），需要使用獨立的服務(wù)器進行安裝。藥物咨詢及用藥安全監(jiān)測系統(tǒng)與醫(yī)院信息系統(tǒng)的接口使用動態(tài)鏈接庫的方式進行對接，在數(shù)據(jù)庫層面沒有任何數(shù)據(jù)交換的接口，因此醫(yī)院信息系統(tǒng)使用任何一種數(shù)據(jù)庫對藥物咨詢及用藥安全

4、監(jiān)測系統(tǒng)都沒有任何影響?？蛻舳藨?yīng)用程序直接調(diào)用接口函數(shù)，以參數(shù)方式傳遞要發(fā)送的消息。注：參數(shù)格式符合擴展標(biāo)記語言（XML）標(biāo)準(zhǔn)。三、藥物咨詢及用藥安全監(jiān)測系統(tǒng)業(yè)務(wù)流程圖表 SEQ 圖表 * ARABIC 1業(yè)務(wù)流程圖四、客戶端軟、硬件要求4.1軟件要求操作系統(tǒng)：Windows XP、Windows2000（SP4）4.2硬件要求處理器：2.0 GHZ以上內(nèi)存：512M以上硬盤空間：可用空間500M以上五、服務(wù)器軟、硬件要求5.1軟件要求操作系統(tǒng)：Windows2000Server（SP4）、Windows 2003數(shù)據(jù)庫管理系統(tǒng)： Microsoft SQL Server2000（SP4）其他

5、：windows IIS 中的FTP服務(wù)5.2硬件要求處理器：2.0G以上（雙核）內(nèi)存：2G以上硬盤空間：160G以上六、局域網(wǎng)網(wǎng)絡(luò)配置交換式100M到客戶端計算機。 七、藥物咨詢及用藥安全監(jiān)測系統(tǒng)接口調(diào)用說明本系統(tǒng)以動態(tài)鏈接庫方式提供給醫(yī)院信息管理系統(tǒng)開發(fā)商（HIS商）調(diào)用。7.1動態(tài)鏈接庫說明與HIS執(zhí)行文件同級目錄下的文件包括：dtywzxUI.dll 傳遞接口參數(shù)，需要HIS程序調(diào)用。IServiceWiz.dll 觸發(fā)大通分析程序用，不需要HIS調(diào)用。AppAskConsole.dl 解決windows受限用戶訪問服務(wù)的問題，不需要HIS調(diào)用。函數(shù)名稱：dtywzxUI(long,0

6、,string)；返回long （VB.net，C#編程long改成int）第一個參數(shù)：功能參數(shù)，控制調(diào)用的功能。第二個參數(shù)：固定為“0”，作為保留擴展使用，暫時不起作用。分析、保存的時候為“1”。第三個參數(shù)是字符串型式，參照的XML格式（節(jié)點的方式），具體的內(nèi)容在后面詳細(xì)說明。 返回值是long，具體數(shù)值為三種“0”、“1”、“2”，分別代表“沒有問題”、“一般問題”和“嚴(yán)重問題”。7.2 各種開發(fā)語言的聲明示例PB聲明部分：function long dtywzxUI(long l_code, long l_param, string s_buffer) library dtywzxUI.

7、dllVB聲明部分：Public Declare Function dtywzxUI Lib dtywzxUI.dll (ByVal l_code As Long, ByVal l_param As Long, ByVal s_buffer As String) As LongDelphi聲明部分：function dtywzxUI(nCode:Integer; lParam:Integer; lpcszBuffer:PChar): Integer;stdcall; external dtywzxUI.dll;C#聲明部分：DllImport(dtywzxUI.dll)public stati

8、c extern int dtywzxUI(int i_code, int i_param, string s_buffer);ASP/JSP(b/s)聲明部分：function dtywzxUI(nCode,lParam,sXML) var result; result = CaesarComponent.dtywzxUI(nCode, lParam,sXML); return result;BCB6語言聲明部分：typedef int (_stdcall * FDtywzxUI)(int nCode, int lParam, char * lpcszBuffer);FDtywzxUI dt

9、ywzxUI;7.3調(diào)用參數(shù)格式說明功能描述第一參數(shù)（長整型）(功能標(biāo)識)第二參數(shù)（長整型）第三參數(shù)（字符串）說明返回參數(shù)（長整型）啟動0固定值：0無初始化，在屏幕上方顯示大通的四個“燈”。函數(shù)調(diào)用格式如下：Rlt=dtywzxUI(0,0,)表示服務(wù)未運行；表示服務(wù)正在運行中。記錄醫(yī)生工號768固定值：0醫(yī)生工號可以由醫(yī)生設(shè)置某一個藥品的“要點提示”信息在以后的工作中顯示或不顯示。所以，必須記錄醫(yī)生的工號。在兩個時刻調(diào)用：（1）醫(yī)生登陸住院工作站完成后調(diào)用；（2）新打開醫(yī)囑的時候調(diào)用。第二種情況主要是考慮一臺機器多開HIS窗口的情況。函數(shù)調(diào)用格式如下：dtywzxUI(768,0,ZY001

10、)其中“ZY001”為醫(yī)生工號。無新醫(yī)囑開始3固定值：0無每次新開醫(yī)囑時應(yīng)調(diào)用該函數(shù)，主要作用是刷新屏幕上的四個燈，使其恢復(fù)到初始狀態(tài)（灰色）。函數(shù)調(diào)用格式如下：dtywzxUI(3,0,)無顯示要點提示12固定值：0有,字符串格式字符串的結(jié)構(gòu)如下:藥品名稱藥品代碼1函數(shù)調(diào)用格式如下：dtywzxUI(12,0,string)type為1表示住院。無重新顯示要點提示4108固定值：0有,字符串格式字符串的結(jié)構(gòu)如下:藥品名稱藥品代碼注：在要點提示信息被關(guān)閉的情況下，如果需要繼續(xù)顯示出來，可進行上述調(diào)用。函數(shù)調(diào)用格式如下：dtywzxUI(4108,0,string)無醫(yī)囑配伍分析（不保存分析結(jié)果

11、）28676固定值：1有,字符串格式僅僅是對醫(yī)囑進行分析，顯示結(jié)果。并不保存結(jié)果。第三個參數(shù)取名叫XML，參考的是XMl格式。函數(shù)調(diào)用格式如下：rlt= dtywzxUI(28676,1,XML)返回值為long0：無問題1：一般問題2：嚴(yán)重問題 醫(yī)囑配伍分析，保存分析結(jié)果28685固定值：1有, 字符串格式對醫(yī)囑進行分析，并保存分析結(jié)果。第三個參數(shù)與調(diào)用分析時候的參數(shù)完全一樣。函數(shù)調(diào)用格式如下：rlt= dtywzxUI(28685,1,XML)返回值為0保存XML（檢查參數(shù)使用）4109固定值：0有, 字符串格式在大通的dtywzx3目錄中生成dtxml.txt，用于檢查XML參數(shù)的正確性

12、。第三個參數(shù)與調(diào)用分析時候的參數(shù)完全一樣。函數(shù)調(diào)用格式如下：dtywzxUI(4109,0,XML)無退出10無退出大通的程序，關(guān)閉屏幕上的四個“燈”。函數(shù)調(diào)用格式如下：dtywzxUI(1,0,)無7.4調(diào)用過程圖表 SEQ 圖表 * ARABIC 2 住院調(diào)用流程圖流程圖說明：灰色部分表示HIS的業(yè)務(wù)流程，黃色部分表示調(diào)用大通的函數(shù)。7.5 調(diào)用說明本系統(tǒng)中，只有功能序號為28676、12、28685、4108、4109的函數(shù)與醫(yī)囑信息或藥品信息有關(guān)，其它函數(shù)與醫(yī)囑信息或藥品信息無關(guān)。醫(yī)囑分析時（28676），返回值為2（long型），表示該醫(yī)囑有嚴(yán)重問題；返回值為1表示一般問題；返回值為

13、0表示沒有問題。嚴(yán)重問題主要指以下問題：有配伍禁忌用藥量超過極限有某些疾病、癥狀禁用藥物有過敏用藥禁用情況有給藥途徑禁用情況八、接口重點內(nèi)容解釋8.1關(guān)于調(diào)用初始化和退出函數(shù)初始化函數(shù)為dtywzxUI(0,0,)，作用是在屏幕上顯示大通的四個“燈”，通常這個功能應(yīng)該放在登陸HIS的時候調(diào)用，醫(yī)生在不開醫(yī)囑的情況下也會需要一些藥物信息的查詢功能，因此大通的四個“燈”應(yīng)該從登陸HIS開始就始終存在。退出函數(shù)為dtywzxUI(1,0,)。大通以前的版本中關(guān)閉HIS以后四個“燈”仍舊顯示在屏幕上，很多醫(yī)院反映干擾了醫(yī)生的正常工作，要求退出HIS系統(tǒng)以后，四個“燈”應(yīng)該關(guān)閉，因此在這個版本中，增加退

14、出函數(shù)，并且要求制作接口的時候在退出HIS系統(tǒng)的同時調(diào)用大通的退出函數(shù)。8.2關(guān)于調(diào)用刷新功能的說明刷新功能的函數(shù)是dtywzxUI(3,0,)，作用是把大通的4個燈置為初始狀態(tài)，變成灰色，建議在新開醫(yī)囑的時候調(diào)用刷新函數(shù)。如果不調(diào)用刷新函數(shù)，上一個醫(yī)囑中的問題，大通的“燈”一直保留著，當(dāng)醫(yī)生新開醫(yī)囑的時候就會產(chǎn)生誤解“藥還沒有開就有問題了？”。8.3關(guān)于當(dāng)前醫(yī)生工號的記錄醫(yī)生的個性設(shè)置，都是與當(dāng)前醫(yī)生的工號進行關(guān)聯(lián)的，因此大通程序需要知道當(dāng)前正在使用的醫(yī)生的工號，要求制作接口的時候在HIS登陸的時候調(diào)用一次記錄工號函數(shù)dtywzxUI(768,0,當(dāng)前工號)，在新開醫(yī)囑的時候再次調(diào)用記錄工號

15、函數(shù)，再次調(diào)用的目的是考慮到很多HIS系統(tǒng)允許同一臺計算機同時登錄多個HIS帳號，在新開醫(yī)囑的時候重新記錄醫(yī)生工號，確保開醫(yī)囑的醫(yī)生工號與記錄的當(dāng)前醫(yī)生工號一致。8.4要點提示“暫不提示”功能的說明醫(yī)生在日常的工作中，很多藥品每天都會開很多次，因此某些藥品的要點提示，醫(yī)生是非常熟悉的，不需要大通的軟件進行提示。根據(jù)較多醫(yī)院的要求，大通提供了暫時關(guān)閉某個藥品要點提示的功能。功能簡單描述為要點提示顯示的時候，可以單擊要點提示上的標(biāo)簽“始終提示”進行切換。當(dāng)顯示為“暫不提示”標(biāo)簽狀態(tài)的時候，表示該藥品要點提示不會主動顯示；當(dāng)顯示為“始終提示”標(biāo)簽狀態(tài)的時候，表示該藥品要點提示會主動顯示。如果單擊要點

16、提示上的 “始終提示”標(biāo)簽，標(biāo)簽顯示為“暫不提示”。當(dāng)雙擊某一個藥品的時候，重新顯示要點提示，這個時候單擊“暫不提示”標(biāo)簽，可以把已經(jīng)關(guān)閉的要點提示重新打開。接口中dtywzxUI(12,0,string)為讀取當(dāng)前醫(yī)生設(shè)置的信息，根據(jù)醫(yī)生的需要判斷是否顯示要點提示。接口中dtywzxUI(4108,0,string)為不讀取當(dāng)前醫(yī)生設(shè)置的信息，始終顯示該藥品的要點提示。此外可以將醫(yī)生已經(jīng)關(guān)閉的要點提示重新顯示出來，再進行設(shè)置。8.5每個藥品開完后調(diào)用分析函數(shù)大通的分析函數(shù)是dtywzxUI(28676,1,XML)，調(diào)用這個函數(shù)分析得到的結(jié)果只進行提示，不進行保存。每個藥品開完后就調(diào)用分析函

17、數(shù)，方便醫(yī)生在發(fā)現(xiàn)問題的時候及時調(diào)整醫(yī)囑。目前，大通程序的分析速度完全可以滿足醫(yī)院開醫(yī)囑的要求。8.6保存前進行判斷大通的分析函數(shù)dtywzxUI(28676,1,XML)有一個返回值long型的變量，內(nèi)容分為三種：0、1、2，分別代別沒有問題，一般問題和嚴(yán)重問題，HIS保存前應(yīng)該調(diào)用大通的分析函數(shù)，根據(jù)返回值提示醫(yī)生是否要把醫(yī)囑中的相關(guān)問題修改正確后再進行保存。某些醫(yī)院還可以根據(jù)這個技術(shù)手段制定一些管理要求，發(fā)現(xiàn)有嚴(yán)重問題的醫(yī)囑不允許醫(yī)生直接保存，必須填寫理由以后才能進行保存。提示的內(nèi)容，通常為“醫(yī)囑中可能在存不合理用藥問題，是否進行修改？”。8.7保存XML參數(shù)功能通過調(diào)用dtywzxUI

18、(4109,0,xml)函數(shù)可以把XML參數(shù)保存到大通的dtywzx3目錄中，便于檢查參數(shù)的準(zhǔn)確性。九、醫(yī)囑內(nèi)容參數(shù)說明藍色表示非必傳字段，可以為空，但是節(jié)點請保留使用的是字符串格式，參照的XML中的節(jié)點的方式，拼接的時候請把回車換行空格等去掉，拼接成一個字符串。醫(yī)生名醫(yī)生級別代碼科室代碼科室名稱病歷卡號住院號床號病人名病人性別生理情況菌檢結(jié)果血壓肌酐清除率孕婦懷孕時間懷孕時間計量單位 過敏源代碼過敏源名稱過敏源代碼過敏源名稱過敏源代碼過敏源名稱診斷代碼（ICD10）診斷代碼（ICD10）-循環(huán)開始 組號通用名醫(yī)院藥品代碼商品名單次量頻次代碼次數(shù) 單位（mg,g等）用藥途徑用藥開始時間(YYY

19、Y-MM-DD HH:mm:SS) 用藥結(jié)束時間(YYYY-MM-DD HH:mm:SS) 醫(yī)囑時間(YYYY-MM-DD HH:mm:SS) -循環(huán)結(jié)束 注:通用名，商品名的內(nèi)容中，發(fā)現(xiàn)有些醫(yī)院帶有“”符號，例如“氨茶堿片”，“”符號是XML中的保留字符，因此制作接口的過程中，必須把“”替換成“()”。在VB中可以這樣替換： test = 氨茶堿片 test = Replace(Replace(test, , ) 替換為 (甲)氨茶堿片通用名，商品名的內(nèi)容中，發(fā)現(xiàn)有些醫(yī)院帶有“”符號，例如“二甲雙呱片”，“”符號是大通程序中的分隔符，因此制作接口的過程中，必須把“”去掉。在VB中可以這樣替換

20、： test = 二甲雙呱片 test = Replace(test, , ) 替換為二甲雙呱片同第2條中的描述，“&”符號也需要在接口中進行替換。相同“組號”是指在同一容器中的注射液，組號相同我們才進行配伍問題的判斷。如果片劑之類沒有組號的藥品，我們約定傳空值，如：。所有出現(xiàn)引號的地方都用單引號。date=系統(tǒng)時間 （舉例說明：2006-10-27 14:20:30）要求把時分秒也傳給我們。日期格式使用標(biāo)準(zhǔn)的“yyyy-MM-dd HH:mm:ss”，不足兩位的補零。過敏判斷，過敏源可以傳入三種內(nèi)容：大通提供的分類代碼，大通提供的成分代碼，HIS數(shù)據(jù)庫里的藥品代碼（如果是藥品代碼需要在前面加

21、上Y）。過敏源代碼過敏源名稱過敏源代碼過敏源名稱過敏源代碼過敏源名稱首先把我們的過敏源代碼表放進HIS系統(tǒng)里，然后讓醫(yī)生選擇過敏源名稱，HIS把過敏源名稱和過敏源代碼傳給我們，用上面的格式。舉例：假設(shè)一個病人對頭霉素類（），羅格列酮成分（A1727），注射用青霉素鈉針（6738）過敏，參數(shù)如下所示：三個參數(shù)沒有先后之分。頭霉素類A1727羅格列酮Y6738注射用青霉素鈉針過敏源節(jié)點要求保留三個，不足三個過敏源的情況，內(nèi)容可以為空，節(jié)點保留；如果大于三個過敏源的情況，可以無限制增加節(jié)點。診斷（ICD10）診斷代碼（ICD10）傳診斷的時候type=0,名稱和代碼都需要傳給大通的程序。診斷節(jié)點要求

22、保留三個，不足三個診斷的情況，內(nèi)容可以為空，節(jié)點保留；如果大于三個診斷的情況，可以無限制增加節(jié)點。病生理狀態(tài)病生理情況包括（孕婦、哺乳期、肝功能不全、腎功能不全、嚴(yán)重肝功能不全、嚴(yán)重腎功能不全）醫(yī)生選擇上述病生理狀態(tài)后，把中文名稱傳給我們。病生理狀態(tài)節(jié)點要求保留三個，不足三個病生理狀態(tài)的情況，內(nèi)容可以為空，節(jié)點保留；從業(yè)務(wù)邏輯上分析，不可能有大于三個病生理狀態(tài)的情況出現(xiàn)。頻次頻次代碼要求傳頻次代碼。次數(shù)次數(shù)，實際執(zhí)行的用藥次數(shù)，可以不傳。增加一個單位的參數(shù)單位（mg,g等）就是藥品的劑量單位，例如mg,g等。相應(yīng)的單次量也要與該單位一致。用藥時間日期格式使用標(biāo)準(zhǔn)的“yyyy-MM-dd HH:

23、mm:ss”，不足兩位的補零。用藥開始時間(YYYY-MM-DD HH:mm:SS) 用藥結(jié)束時間(YYYY-MM-DD HH:mm:SS)醫(yī)囑時間(YYYY-MM-DD HH:mm:SS) 醫(yī)囑時間：表示該藥品在醫(yī)囑中產(chǎn)生的時間。關(guān)于住院號的處理住院號這里的“住院號”是住院病人此次住院的唯一號碼，若醫(yī)院內(nèi)此類號碼會被循環(huán)使用，無法確切保證長遠唯一，則可在傳入的住院號時右首拼入日期（格式Y(jié)YYYMMDD）即可。住院部分關(guān)于臨時醫(yī)囑和長期醫(yī)囑的處理同一個病人的住院醫(yī)囑作為一個XML參數(shù)傳給大通公司，長期醫(yī)囑和臨時醫(yī)囑放在同一個XML參數(shù)中，通過標(biāo)識進行區(qū)別。標(biāo)識如下：醫(yī)囑類型中 L為長期醫(yī)囑，T

24、為臨時醫(yī)囑；如果醫(yī)囑號沒有就傳住院號。需要過濾的信息：臨時醫(yī)囑開出時間超過7天、長期醫(yī)囑中停藥超過7天的藥不放入XML參數(shù)中進行傳遞，也就是說服用超過7天的藥不考慮用藥相關(guān)問題。13、在住院監(jiān)控系統(tǒng)中，可以由醫(yī)生設(shè)置某一個藥品的“要點提示”在以后的工作中顯示或不顯示，所以，必須記錄醫(yī)生的工號。在兩個時刻調(diào)用：（1）醫(yī)生登陸住院工作站完成后調(diào)用；（2）醫(yī)生登陸醫(yī)囑界面完成后調(diào)用。第二種情況主要是防止不同的醫(yī)生在同一個醫(yī)生工作站上開醫(yī)囑，必須進行區(qū)分。14、孕周期說明。一些藥品在孕婦懷孕的不同時期有禁用或者慎用等不同的限制，因此如果要精確判斷，必須要知道孕婦的懷孕時間。孕婦懷孕時間 懷孕時間計量單位 孕婦懷孕時間：整數(shù)，懷孕的天數(shù)