1 拼音
W S / T 7 9 0 . 1 — 2 0 2 1 qū yù wèi shēng xìn xī píng tái jiāo hù biāo zhǔn dì 1 bù fèn : zǒng zé
3 基本信息
ICS 11.020
CCS C 07
中華人民共和國衛生行業標準WS/T 790.1—2021《區域衛生信息平臺交互標準 第1部分:總則》(Regional health information platform interactive standard—Part 1: General specification)由中華人民共和國國家衛生健康委員會2021年10月27日《關於發佈〈國家衛生信息資源分類與編碼管理規範〉等21項推薦性衛生行業標準的通告》(國衛通〔2021〕10號)發佈,自2022年4月1日起施行。
4 發佈通知
關於發佈《國家衛生信息資源分類與編碼管理規範》等21項推薦性衛生行業標準的通告
國衛通〔2021〕10號
現發佈《國家衛生信息資源分類與編碼管理規範》等21項推薦性衛生行業標準,編號和名稱如下:
WS/T 787—2021 國家衛生信息資源分類與編碼管理規範
WS/T 788—2021 國家衛生信息資源使用管理規範
WS/T 790.1—2021 區域衛生信息平臺交互標準 第1部分:總則
WS/T 790.2—2021 區域衛生信息平臺交互標準 第2部分:時間一致性服務
WS/T 790.3—2021 區域衛生信息平臺交互標準 第3部分:節點驗證服務
WS/T 790.4—2021 區域衛生信息平臺交互標準 第4部分:安全審計服務
WS/T 790.5—2021 區域衛生信息平臺交互標準 第5部分:基礎通知服務
WS/T 790.6—2021 區域衛生信息平臺交互標準 第6部分:居民註冊服務
WS/T 790.7—2021 區域衛生信息平臺交互標準 第7部分:醫療衛生機構註冊服務
WS/T 790.8—2021 區域衛生信息平臺交互標準 第8部分:醫療衛生人員註冊服務
WS/T 790.9—2021 區域衛生信息平臺交互標準 第9部分:術語註冊服務
WS/T 790.10—2021 區域衛生信息平臺交互標準 第10部分:健康檔案存儲服務
WS/T 790.11—2021 區域衛生信息平臺交互標準 第11部分:健康檔案管理服務
WS/T 790.12—2021 區域衛生信息平臺交互標準 第12部分:健康檔案採集服務
WS/T 790.13—2021 區域衛生信息平臺交互標準 第13部分:健康檔案調閱服務
WS/T 790.14—2021 區域衛生信息平臺交互標準 第14部分:文檔訂閱發佈服務
WS/T 790.15—2021 區域衛生信息平臺交互標準 第15部分:預約掛號服務
WS/T 790.16—2021 區域衛生信息平臺交互標準 第16部分:雙向轉診服務
WS/T 790.17—2021 區域衛生信息平臺交互標準 第17部分:簽約服務
WS/T 790.18—2021 區域衛生信息平臺交互標準 第18部分:提醒服務
上述標準自2022年4月1日起施行。
特此通告。
國家衛生健康委
2021年10月27日
5 前言
本標準是WS/T 790《區域衛生信息平臺交互標準》的第1部分。WS/T 790已經發布以下部分:
——第1部分:總則;
——第2部分:時間一致性服務;
——第4部分:安全審計服務;
——第5部分:基礎通知服務;
——第6部分:居民註冊服務;
——第7部分:醫療衛生機構註冊服務;
——第8部分:醫療衛生人員註冊服務;
——第9部分:術語註冊服務;
——第10部分:健康檔案存儲服務;
——第11部分:健康檔案管理服務;
——第12部分:健康檔案採集服務;
——第13部分:健康檔案調閱服務;
——第14部分:文檔訂閱發佈服務;
——第15部分:預約掛號服務;
——第16部分:雙向轉診服務;
——第17部分:簽約服務;
——第18部分:提醒服務。
本標準由國家衛生健康標準委員會衛生健康信息標準專業委員會負責技術審查和技術諮詢,由國家衛生健康委統計信息中心負責協調性和格式審查,由國家衛生健康委規劃發展與信息化司負責業務管理、法規司負責統籌管理。
本標準起草單位:國家衛生健康委統計信息中心、上海市衛生健康信息中心、湖南省衛生計生委信息統計中心、中國人民解放軍空軍軍醫大學、華中科技大學同濟醫學院、國家衛生信息共享技術及應用工程技術研究中心、國家電子計算機質量監督檢驗中心、中國軟件評測中心。
本標準主要起草人:胡建平、李嶽峯、董方傑、謝樺、雷永貴、何煒、徐勇勇、沈麗寧、邊紅麗、黃江平、許德俊、葉彥波、馮東雷、鄭良、孟曉。
6 標準正文
區域衛生信息平臺交互標準 第1部分:總則
6.1 1 範圍
本標準規定了區域衛生信息平臺交互服務編碼和消息結構的編制說明、消息與服務定義、數據類型與通用元素、通用服務、通用服務處理等一系列約束。
本標準適用於基於居民健康檔案的區域衛生信息平臺與接入平臺的醫療衛生應用系統間、平臺與其它接入平臺間以及平臺內部服務組件間的信息交互與共享。
6.2 2 規範性引用文件
下列文件中的內容通過文中的規範性引用而構成本標準必不可少的條款。其中,注日期的引用文件,僅該日期對應的版本適用於本標準;不注日期的引用文件,其最新版本(包括所有的修改單)適用於本標準。
GB/T 26231 信息技術 開放系統互連 OID的國家編號體系和註冊規程
WS 363 衛生信息數據元目錄
WS 364 衛生信息數據元值域代碼
WS 365 城鄉居民健康檔案基本數據集
WS 445(所有部分) 電子病歷基本數據集
WS/T 448 基於居民健康檔案的區域衛生信息平臺技術規範
WS/T 483(所有部分) 健康檔案共享文檔規範
WS/T 500(所有部分) 電子病歷共享文檔規範
6.3 3 術語和縮略語
6.3.1 3.1 術語和定義
WS/T 448、WS/T 483界定的術語和定義適用於本標準。
6.3.2 3.2 縮略語
下列縮略語適用於本標準。
IST:交互服務交易(Interactive Service Transaction)
W3C:萬維網聯盟(World Wide Web Consortium)
WSDL:網絡服務描述語言(Web Services Description Language)
XML Schema:可擴展標記語言結構模式(Extensible Markup Language Schema)
XPath:XML路徑語言(XML PathLanguage)
SOAP:簡單對象訪問協議(Simple Object Access Protocol)
6.4 4 編制說明
6.4.1 4.1 內容結構
除本部分及第2部分、第3部分、第4部分外,應包括如下內容:
封面
目次
名稱
1 範圍
2 規範性引用文件
3 術語和縮略語
3.1術語和定義
3.2縮略語
4 角色
4.1 角色定義
4.2 角色的交易關係
4.3 角色的交易可選性
5. 交易
5.1交易1
…
5.x 交易x
5.x.1 用例
5.x.2 交易流程
5.x.3 消息請求(或通知)
5.x.3.1觸發事件
5.x.4 消息應答
5.x.4.1觸發事件
6 交互服務
6.1 服務定義
6.2 服務技術要求
7 安全審計
7.1 安全約定
7.2 XXX交易消息審計
7.2.1 XXX交易請求者
7.2.2 XXX交易應答者
6.4.2 4.2 編碼說明
6.4.2.1 4.2.1 服務編碼
除本部分外,其餘部分的服務提供者角色代碼見表1。
表1 服務提供者代碼
6.4.2.2 4.2.2 交易編碼
IST-{服務編號}{交易序號}
例如: IST-PR1表示居民註冊服務提交居民信息服務交易。
6.4.2.3 4.2.3 數據類型編碼
簡單數據類型採用Camel格式,複合數據類型採用Pascal格式。在與消息元素名稱易產生混淆的場合,數據類型應後綴Type以示區分。
6.4.2.4 4.2.4 消息元素編碼
消息根元素及通用元素編碼採用Pascal格式,其餘元素採用Camel格式。
6.4.3 4.3 消息結構表示
消息結構採用XML Schema架構模式進行表達。在文本描述中,消息節點爲XML元素的採用元素代碼或加註尖括號“<”“>”表示,、消息節點爲XML屬性的在屬性代碼前加註“@”前綴表示。
6.4.4 4.4 消息節點的可選性約束表示
消息節點採用XPath表達式指向。消息元素及屬性“可選項”約束採用表2代碼表示。
6.5 5 消息與服務定義
6.5.1 5.1 通訊協議
6.5.1.1 5.1.1 消息封裝結構
區域衛生信息平臺服務消息宜通過SOAP1.2版進行通訊。消息封裝結構如下:
在SOAP1.2版本中服務請求的HTTP頭部信息中應設置Content-Type爲application/soap+xml。
6.5.1.2 5.1.2 消息編碼
本規範所有部分中所定義的交互消息、文檔編碼應用 UTF-8。
6.5.1.3 5.1.3 命名空間
SOAP消息頭使用指定的命名空間:"http://www.chiss.org.cn/rhin/is/2015",其中rhin指代區域衛生信息網絡,is指代交互規範,2015指代本規範的版本。
在命名空間不衝突的情況下,使用名稱rhin來指代該命名空間。
6.5.2 5.2 消息定義
6.5.2.1 5.2.1 消息模式定義
消息模式應採用XML Schema進行定義,並遵循W3C XML Schema規範。
6.5.2.2 5.2.2 消息節點編碼與數據元的對應
所有部分與業務相關的消息節點在可能情況下,應引用以下標準的數據元代碼,並建立節點代碼與數據元代碼間的關係:
——WS 218;
——WS 363;
——WS 364;
——WS 365;
——WS 371;
——WS 372;
——WS 373;
——WS 374;
——WS 375;
——WS 376;
——WS 377;
——WS 445。
6.5.2.3 5.2.3 消息數據類型
消息數據類型宜採用6.1所列基礎數據類型。
6.5.2.4 5.2.4 對象 OID 標識
對象OID標識應符合GB/T 26231符定。
6.5.3 5.3 服務定義
6.5.3.1 5.3.1 服務描述
每個部分的交互服務均應提供用於定義服務交互接口的WSDL文件。
服務定義語言應遵循W3C WSDL 1.2規範,分別對消息、服務接口、服務綁定以及服務物理位置4個部分進行定義。
6.5.3.2 5.3.2 消息定義
服務定義WSDL文件通過引入已定義的消息格式文件定義消息類型。
消息元素
——部分元素
——部分元素
6.5.3.3 5.3.3 服務端口類型描述
服務端口類型元素< portType >包括名稱屬性@name和一系列的服務操作元素
——操作元素
——輸入元素:應定義@message 屬性,並與消息格文件中請求消息元素保持一致,表示操作的輸入參數;
——輸出元素:應定義@message 屬性,並與消息格文件中應答消息元素保持一致,表示操作的輸出參數;
——通知操作只含輸出參數。
6.5.3.4 5.3.4 服務綁定類型
本規範中的網絡服務綁定類型爲"Document/literal Wrapped模式",該模式與WS-I規範兼容。選用該模式可以根據利用與函數同名的元素名進行消息的分發,可以利用Schema進行消息的驗證,綁定元素定義如下:
——綁定
——兼容 SOAP1.2 的綁定
——操作
——輸入元素:應定義兼容 SOAP1.2 的
元素及@use 屬性爲“literal”,表示輸入消息的格式;——輸出元素
6.5.3.5 5.3.5 服務物理位置
服務物理位置由以下WSDL元素約定:
——服務
——端口
——地址
元素:應定義@location 屬性,表示實際提供服務的物理地址。6.6 6 數據類型與通用元素
6.6.1 6.1 基礎數據類型
本部分規定的基礎數據類型適用於本標準所有部分。
基礎數據類型包括簡單數據類型及複合數據類型,簡單數據類型符合 W3C的XML Schema1.0、1.1的數據型規定,複合類型是多種數據類型的組合型式。一般情況下,複合類型是其基類與任何類型的組合。任何類型僅當所表示的類型空值時,其屬性“nullFlavor”進行進一步說明。
數據類型的及代碼說明見表3,數據類型的表達示應符合A.1數據類型結構模式的約束。
表3 數據類型及代碼說明
表 3(續)
表 3(續)
6.6.2 6.2 註冊服務基礎對象數據類型
與個人、機構、醫療衛生人員相關的註冊服務,其消息應採用的數據類型及代碼說明見表4,數據類型的表達示應符合A.2主數據對象數據類型結構模式的約束。
表4 註冊服務基礎對象數據類型
表 4(續)
6.6.3 6.3 術語註冊基礎數據類型
與術語註冊服務相關的消息應採用的數據類型及代碼說明見表5,數據類型的表達示應符合A.3術語註冊數據類型結構模式的約束。
表5 通知服務基礎對象數據類型
6.6.4 6.4 文檔共享服務數據類型
與文檔共享相關服務的數據類型及通用元素,包括文檔存儲服務、文檔管理服務、文檔採集服務、文檔調閱服務、文檔訂閱-發佈服務以及其它應用服務。
數據類型的及代碼說明見表6,數據類型的表達示應符合A.4文檔共享服務通用元素及數據類型的結構模式的約束。文檔類型未加說明時應符合WS/T 483(所有部分)及WS/T 500(所有部分)規定。
表6 文檔共享服務通用元素及數據類型
6.7 7 通用查詢
6.7.1 7.1 應用範圍
通用查詢應用於個人、醫療衛生機構、醫療衛生人員及文檔的一般預存儲查詢、通知的訂閱過濾條件設定。
6.7.2 7.2 消息結構及約束
通用查詢消息結構應符合A.2主數據對象數據類型及通用元素消息格式adhocQuery元素構件要求,消息補充約束見表7。
表 7(續)
6.8 8 通用服務處理
6.8.1 8.1 異步處理
交互服務中如需要提供異步支持,應在交互規範中編寫交互服務的異步處理流程。
6.8.2 8.2 錯誤處理
在處理服務的網絡請求出現錯誤時,應通過SOAP消息Fault元素將錯誤信息反饋給服務調用者。Fault元素應位於SOAP消息體內,在一條SOAP消息中,Fault元素只能出現一次。 具體細節請參考W3C SOAP Version 1.2 Part 1:Messaging Framework規範。
6.8.3 8.3 審計要求
在每部分具體交互規範中應編寫所有交互服務的審計消息。
6.8.4 8.4 安全要求
在SOAP消息頭中,應採用符合W3C WS-Security規範的元素進行服務交互雙方的身份認證,以及確保服務交互中信息的完整性、不可篡改性和不可抵賴性。
6.8.4.1 8.4.1 服務尋址
在SOAP消息中,應採用符合W3C WS-Addressing規範的元素進行服務尋址,以標識服務發送者、服務接收者和服務交易。規定如下:
——應提供 From 節點用以標識服務的發送者;
——應在 Address 子節點中記錄區域平臺分配給服務發送者的節點標識符,該節點標識符爲 OID類型,在記錄時應添加"urn:oid:"前綴;
——應提供 To 節點用以標識服務的接收者,取值爲服務的可訪問網絡地址;
——應提供 Action 節點用以標識服務交易,根據 WS-Addressing 規範 Action 節點命名規則爲:
<目標命名空間><分隔符><端口類型><分隔符><交易(輸入|輸出)名稱>
示例見C.2。
6.8.4.2 8.4.2 服務訪問安全
應遵循W3C WS-Security規範,在SOAP消息頭中,採用WS-Security消息進行服務交互雙方的身份認證,以及確保服務交互中信息的完整性、不可篡改性和不可抵賴性。Security節點規定如下:
——應使用 BinarySecurityToken 安全性令牌,用以存儲 X509v3 證書;
——應使用 Base64Binary 對 X509v3 證書進行轉碼;
——應使用數字簽名確保服務傳輸信息的完整性、不可篡改性和不可抵賴性;
在對消息進行簽名前應對被簽名的消息依據W3C專用XML規範化協議1.0進行規範化,標識爲"https://www.w3.org/TR/2002/REC-xml-exc-c14n-20020718/"。可選用的簽名算法包括:
——HMAC 算法,標識爲"http://www.w3.org/2000/09/xmldsig#hmac-sha1";
——DSA 算法,標識爲"http://www.w3.org/2000/09/xmldsig#dsa-sha1";
——PKCS1 算法,標識爲"http://www.w3.org/2000/09/xmldsig#rsa-sha1"。
摘要算法應使用SHA-1算法,標識爲"http://www.w3.org/2000/09/xmldsig#sha1"。
示例見C.3。
7 附錄A(規範性)消息數據類型結構模式
7.1 A.1 基礎數據類型
基礎數據類型的結構模式採用XML Schema定義如下:
7.2 A.2 主數據對象數據類型及通過元素
主數據對象相關數據類型定義如下:
7.3 A.3 術語註冊數據類型
術語相關數據類型定義如下:
7.4 A.4 文檔共享數據類型
文檔共享相關數據類型定義如下:
8 附錄B(規範性)基本數據類型值域代碼表
8.1 B.1 空值原因代碼
空值原因代碼見表B.1。
表 B.1 空值原因代碼(CV_NullFlavor)
8.2 B.2 時長計量單位
時間長度計量單位代碼見表B.2。
表 B.2 時長計量單位代碼(CV_DurationUnit)
8.3 B.3 人名用途代碼
人名用途代碼見表B.3。
表 B.3 人名用途代碼(CV_NameUse)
8.4 B.4 地址用途代碼
地址用途代碼見B.4。
表 B.4 地址用途代碼(CV_AddressUse)
8.5 B.5 地址類別代碼
地址類別代碼見B.5。
表 B.5 地址類別代碼(CV_AddressType)
8.6 B.6 通訊方式代碼
通訊方式代碼見表B.6。
表 B.6 通訊方式代碼(CV_TelecomMode)
表 B.6(續)
8.7 B.7 對象狀態代碼
對象狀態代碼見表B.7。
表 B.7 對象狀態代碼(CV_ObjectStatus)
8.8 B.8 文檔關聯狀態代碼
文檔關聯狀態代碼見表B.8。
表 B.8 文檔關聯狀態代碼(CV_AssociationStatus)
8.9 B.9 文檔關聯類型態代碼
文檔關聯類型代碼見表B.9。
表 B.9 文檔關聯類型代碼(CV_AssociationType)
8.10 B.10 對象類型代碼
對象類型代碼見表B.10。
表 B.10 文檔關聯類型代碼(CV_ObjectType)
8.11 B.11 錯誤代碼
錯誤代碼見表B.11。
表 B.11 錯誤代碼(CV_FaultCode)
9 附錄C(資料性)示例
9.1 C.1 故障消息示例
9.2 C.2 服務尋址消息示例
服務尋址消息示例見示例2
示例2:服務尋址消息示例
9.3 C.3 安全認證消息示例
安全認證消息示例見示例3
示例3:安全認證消息示例
10 參考文獻
[1] IHE International, Inc.IHE IT Infrastructure Technical Framework, Volume 1 (ITI TF-1): Integration Profiles,2015.
[2] IHE International, Inc.IHE IT Infrastructure Technical Framework, Volume 2a (ITI TF-2a): Transactions Part A,2015.
[3] IHE International, Inc.IHE IT Infrastructure Technical Framework, Volume 2b (ITI TF-2b): Transactions Part B,2015.
[4] IHE International, Inc.IHE Technical Framework Supplement - Document Metadata Subscription (DSUB),2010
[5] W3C.Web Services Description Language 1.1(WSDL 1.1)
[6] W3C.Simple Object Access Protocol 1.2(SOAP 1.2)
[7] W3C.Web Services Addressing (WS-Addressing),10 August 2004
[8] W3C/OASIS Standard.Web Services Base Notification 1.3(WS-Base Notification),1 October 2006
[9] W3C/OASIS Standard. Web Services Topics 1.3(WS-Topics),1 October 2006
[10] W3C.Web Services Security 1.0(WS-Security), April 5, 2002
[11] W3C.XML Schema Definitions 1.1(XSD)
[12] W3C.XML Path Language 2.0(X Path 2.0)