久久最新最好视频|精品福利视频在线|狠狠狠干在线播放|色尼玛亚洲综合网|日韩加勒比无码AV|亚洲AV人人澡人人爽人人爱|国产精品免费怡红院|婷婷一区二区XXX|日韩成人一区二区三|欧美熟妇另类AAAAAA

歡迎訪問智慧醫(yī)療網(wǎng) | 網(wǎng)站首頁
 

醫(yī)院信息系統(tǒng)交互接口開發(fā)過程管理經(jīng)驗(yàn)分享

發(fā)布時(shí)間：2023-02-07 來源：HC3i中數(shù)新醫(yī) 瀏覽量： 字號：【加大】【減小】 手機(jī)上觀看

打開手機(jī)掃描二維碼
即可在手機(jī)端查看

背景
醫(yī)院信息系統(tǒng)不是一個(gè)獨(dú)立運(yùn)行的系統(tǒng)，而是由很多子系統(tǒng)(歸屬不同開發(fā)商)集成協(xié)同工作的大系統(tǒng)。子系統(tǒng)之間的數(shù)據(jù)交互，不管是通過集成平臺總線還是點(diǎn)對點(diǎn)對接，都存在大量接口集成開發(fā)工作量，甚至有的子系統(tǒng)全部的字典接口與業(yè)務(wù)接口的總數(shù)量超過100個(gè)。由于各子系統(tǒng)開發(fā)商的技術(shù)水平不平衡，有的子系統(tǒng)開發(fā)商經(jīng)驗(yàn)不足、項(xiàng)目交付進(jìn)度緊迫、對業(yè)務(wù)流程的理解不夠深入、開發(fā)技術(shù)路線不能適應(yīng)項(xiàng)目建設(shè)等原因，造成接口開發(fā)周期長、文檔不完整、運(yùn)行穩(wěn)定性欠缺、故障排查時(shí)間長，是影響醫(yī)院信息子系統(tǒng)交付與運(yùn)維的重要原因之一，筆者經(jīng)歷過多家開發(fā)商的多個(gè)子系統(tǒng)及集成平臺交付的實(shí)踐，在接口開發(fā)過程管理方面積累了一定的經(jīng)驗(yàn)，現(xiàn)總結(jié)分享如下。


接口開發(fā)過程管理
(一) 業(yè)務(wù)流程梳理
首先要根據(jù)合同的內(nèi)容，確定項(xiàng)目交付的范圍，根據(jù)項(xiàng)目范圍確定項(xiàng)目需要上線哪些業(yè)務(wù)模塊，與客戶溝通這些業(yè)務(wù)模塊的業(yè)務(wù)流程、規(guī)則，整理成需求調(diào)研文檔，然后針對客戶的需求，給出相應(yīng)的解決方案，與客戶溝通確認(rèn)，形成最終的項(xiàng)目需求文檔。在這個(gè)環(huán)節(jié)，最重要的是要給出解決方案并由客戶確認(rèn)，讓各方對需求實(shí)現(xiàn)的方式達(dá)成一致意見。少了這部分的內(nèi)容，項(xiàng)目很難落地交付。
(二) 接口交互時(shí)序圖編寫
1.  概要時(shí)序圖
概要時(shí)序圖是定義接口調(diào)用觸發(fā)的時(shí)機(jī)(如建檔時(shí)、修改檔案時(shí)、分診時(shí)、接診時(shí)、定時(shí)調(diào)用等)及調(diào)用的接口名稱和返回的結(jié)果，概要時(shí)序圖是項(xiàng)目接口全集的總覽，一看就明白項(xiàng)目有哪些接口及各個(gè)接口的作用，概要時(shí)序圖是接口清單內(nèi)容的組成部分，編寫完成后，插入到接口清單文檔。
微信圖片_20230207090806.png

2.  詳細(xì)時(shí)序圖

詳細(xì)時(shí)序圖是每個(gè)接口調(diào)用的詳細(xì)交互過程，比如：某子系統(tǒng)產(chǎn)品埋點(diǎn)->中間工程接口->院方接口->醫(yī)保接口-->院方接口-->中間工程接口-->某子系統(tǒng)產(chǎn)品埋點(diǎn)(->是調(diào)用，-->是返回結(jié)果)，詳細(xì)時(shí)序圖是接口明細(xì)內(nèi)容的組成部分，編寫完成后，插入到接口明細(xì)文檔。
微信圖片_20230207090810.png
(三) 接口清單與接口明細(xì)編寫
1.  接口清單
接口清單是以表格的形式提供，內(nèi)容包括接口編號、接口英文名稱、接口中文名稱、接口簡要內(nèi)容描述、埋點(diǎn)名稱、調(diào)用時(shí)機(jī)、院方接口英文名稱、院方接口中文名稱、接口的提供方和調(diào)用方等，是概要交互時(shí)序圖的補(bǔ)充說明。
微信圖片_20230207090813.png
2.  接口明細(xì)
接口明細(xì)定義了接口調(diào)用的協(xié)議、URL、入?yún)⒑头祬⒌臄?shù)據(jù)結(jié)構(gòu)，入?yún)⒑头祬⑼ǔＪ荴ML或JSON格式，是樹型結(jié)構(gòu)，有些結(jié)點(diǎn)會有多個(gè)，可用子結(jié)點(diǎn)列表來定義，接口明細(xì)是詳細(xì)時(shí)序圖的補(bǔ)充說明，兩者相互相承。接口明細(xì)的字段定義包括了英文名稱、中文名稱、內(nèi)容描述、字段對照、轉(zhuǎn)換規(guī)則等內(nèi)容，在很多項(xiàng)目中，字段對照和轉(zhuǎn)換規(guī)則是不太重視編寫的，這部分內(nèi)容的缺失，對后續(xù)接口開發(fā)與維護(hù)、故障排查帶來困難。
微信圖片_20230207090816.png
(四) 接口代碼開發(fā)
1.  理解業(yè)務(wù)流程與數(shù)據(jù)轉(zhuǎn)換規(guī)則
接口開發(fā)工程師必須理解業(yè)務(wù)流程與數(shù)據(jù)轉(zhuǎn)換規(guī)則才能編寫出符合業(yè)務(wù)的接口，比如：處方分方，某子系統(tǒng)是按住院醫(yī)囑的方式下達(dá)的，沒有門診處方的概念，不需要考慮處方的分方規(guī)則，分方是由中間工程(接口)根據(jù)HIS的分方規(guī)則自動做分方處理的；另一種情況是字典雙向影射，比如：醫(yī)囑頻率字典，有專業(yè)子系統(tǒng)的頻率字典和HIS的頻率字典，專業(yè)子系統(tǒng)頻率字典是穩(wěn)定的，HIS頻率字典是跟項(xiàng)目走的，拉取藥品字典時(shí)，頻率的默認(rèn)值要轉(zhuǎn)換成專業(yè)子系統(tǒng)的頻率，醫(yī)囑提交時(shí)，要將頻率轉(zhuǎn)換成HIS的頻率。
2.  日志記錄
每一次接口調(diào)用，都必須記錄4個(gè)日志：
1)  產(chǎn)品埋點(diǎn)調(diào)用中間工程入?yún)?/span>
2)  中間工程調(diào)用院方接口入?yún)?/span>
3)  院方接口給中間工程返參
4)  中間工程給產(chǎn)品埋點(diǎn)返參
日志的結(jié)構(gòu)要格式化、標(biāo)準(zhǔn)化，內(nèi)容包括日志時(shí)間、日志級別、記錄時(shí)機(jī)、日志詳細(xì)內(nèi)容，日志詳細(xì)內(nèi)容可用XML或JSON，格式化與標(biāo)準(zhǔn)化方便日志的查找，加快故障的排查。
日志也是出現(xiàn)故障時(shí)，界定責(zé)任的重要依據(jù)，由于接口是雙方或多方交互調(diào)用，很多情況下，各方的日志記錄有的完整有的不完整，由于日志記錄的不完整，造成兩個(gè)或多個(gè)子系統(tǒng)交付實(shí)施人員之間相互推諉扯皮、故障排查時(shí)間長，甚至造成系統(tǒng)帶病運(yùn)行，長期運(yùn)行不穩(wěn)定，最終影響項(xiàng)目交付與運(yùn)維，給系統(tǒng)建設(shè)方(醫(yī)院)帶來損失，開發(fā)商的聲譽(yù)也受到影響。
由于日志內(nèi)容比較龐大，一般分為四個(gè)級別：調(diào)試、信息、警告、錯(cuò)誤，根據(jù)系統(tǒng)配置參數(shù)，控制每個(gè)接口的日志輸出級別，以免輸出的日志信息過多或過少，影響問題的排查。對于日志保留的時(shí)間，應(yīng)根據(jù)日志的輸出量、存儲空間大小、日志的重要程度等方面的要求，綜合考慮日志的保留時(shí)間。過期的日志要自動清除，以免日志信息占用空間過大，造成系統(tǒng)崩潰或影響系統(tǒng)的性能。
(五) 接口測試
接口測試，最重要的是測試環(huán)境的建立及測試用例的編寫，有的開發(fā)商內(nèi)部缺乏測試環(huán)境，接口難以測試，而以現(xiàn)場測試為主，造成測試效率不高、開發(fā)周期長、運(yùn)行不穩(wěn)定等問題。通過在開發(fā)商內(nèi)部建立院方接口仿真環(huán)境，在開發(fā)商內(nèi)部即可進(jìn)行接口的正常流程測試和模擬故障的測試，接口開發(fā)效率、交付質(zhì)量也大大提升。測試用例編寫與接口開發(fā)同樣需要理解業(yè)務(wù)流程和數(shù)據(jù)轉(zhuǎn)換規(guī)則，才能編寫出高質(zhì)量的測試用例。筆者在這方面的經(jīng)驗(yàn)，是由需求調(diào)研人員、接口開發(fā)人員、測試人員組成接口開發(fā)小組，充分分析討論業(yè)務(wù)流程、業(yè)務(wù)規(guī)則及解決方案。
(六) 接口故障監(jiān)控與排查
接口涉及承建方(開發(fā)商)和建設(shè)方(院方)，完整的日志記錄是故障監(jiān)控與排查關(guān)鍵，日志記錄不完整、格式不標(biāo)準(zhǔn)，將無法做到接口自動監(jiān)控和快速故障排查，有的子系統(tǒng)日志記錄是文件方式，不方便自動化監(jiān)控與查找定位，遷移到數(shù)據(jù)庫，可以利用數(shù)據(jù)庫強(qiáng)大的查找和統(tǒng)計(jì)功能，做到自動化監(jiān)控、預(yù)警、統(tǒng)計(jì)分析等。
(七) 接口運(yùn)維閉環(huán)管理
在產(chǎn)品的生命周期內(nèi)，接口會有需求調(diào)整、BUG修復(fù)等，需要有一套完整的管理工具來管理。以往交付人員直接與接口開發(fā)人員溝通，文檔及過程記錄不完整，造成接口開發(fā)質(zhì)量不保證、交付時(shí)間不保證等問題，通過建立完善過程管理制度，交付人員提交完整的需求文檔或bug登記文檔到需求管理系統(tǒng)，需求管理系統(tǒng)指派給相應(yīng)的開發(fā)人員及測試人員，每個(gè)環(huán)節(jié)均有相應(yīng)的文檔及時(shí)間記錄，這樣形成了接口開發(fā)維護(hù)過程的閉環(huán)管理，提高了接口開發(fā)的效率和交付的質(zhì)量，也為開發(fā)商積累接口開發(fā)的經(jīng)驗(yàn)。


總結(jié)
綜上所述，通過上述各個(gè)方面的過程管理，規(guī)范接口開發(fā)過程，健全接口開發(fā)文檔，能夠極大的減少接口開發(fā)過程的返工，真正縮短開發(fā)周期，對開發(fā)人員的技術(shù)水平要求也有所降低，綜合開發(fā)成本也節(jié)省了不少，醫(yī)院信息系統(tǒng)交互的整體效果得到保證，并且也符合CMMI認(rèn)證的宗旨。


智慧醫(yī)療網(wǎng) ? 2022 版權(quán)所有   ICP備案號：滬ICP備17004559號-5