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)