WS_T 790.1-2021 区域卫生信息平台交互标准 第1部分：总则.pdf

ICS 11.020 CCS C 07 WS 中 华 人 民 共 和 国 卫 生 行 业 标 准 WS/T 790.12021 区域卫生信息平台交互标准 第 1 部分：总则 Regional health information platform interactive standard Part 1: General specification 2021-10-27 发布 2022-04-01 实施中华人民共和国国家卫生健康委员会 发 布 WS/T 790.12021 I前 言 本标准是WS/T 790区域卫生信息平台交互标准的第1部分。WS/T 790已经发布以下部分： 第1部分：总则； 第2部分：时间一致性服务； 第3部分：节点验证服务； 第4部分：安全审计服务； 第5部分：基础通知服务； 第6部分：居民注册服务； 第7部分：医疗卫生机构注册服务； 第8部分：医疗卫生人员注册服务； 第9部分：术语注册服务； 第10部分：健康档案存储服务； 第11部分：健康档案管理服务； 第12部分：健康档案采集服务； 第13部分：健康档案调阅服务； 第14部分：文档订阅发布服务； 第15部分：预约挂号服务； 第16部分：双向转诊服务； 第17部分：签约服务； 第18部分：提醒服务。 本标准由国家卫生健康标准委员会卫生健康信息标准专业委员会负责技术审查和技术咨询， 由国家卫生健康委统计信息中心负责协调性和格式审查，由国家卫生健康委规划发展与信息化司负责业务管理、法规司负责统筹管理。 本标准起草单位：国家卫生健康委统计信息中心、上海市卫生健康信息中心、湖南省卫生计生委信息统计中心、中国人民解放军空军军医大学、华中科技大学同济医学院、国家卫生信息共享技术及应用工程技术研究中心、国家电子计算机质量监督检验中心、中国软件评测中心。 本标准主要起草人：胡建平、李岳峰、董方杰、谢桦、雷永贵、何炜、徐勇勇、沈丽宁、边红丽、黄江平、许德俊、叶彦波、冯东雷、郑良、孟晓。 WS/T 790.12021 1区域卫生信息平台交互标准 第 1 部分：总则 1 范围 本标准规定了区域卫生信息平台交互服务编码和消息结构的编制说明、 消息与服务定义、 数据类型与通用元素、通用服务、通用服务处理等一系列约束。 本标准适用于基于居民健康档案的区域卫生信息平台与接入平台的医疗卫生应用系统间、 平台与其它接入平台间以及平台内部服务组件间的信息交互与共享。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本标准必不可少的条款。 其中， 注日期的引用文件，仅该日期对应的版本适用于本标准；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本标准。 GB/T 26231 信息技术 开放系统互连 OID的国家编号体系和注册规程 WS 218 卫生机构(组织)分类与代码 WS 363 卫生信息数据元目录 WS 364 卫生信息数据元值域代码 WS 365 城乡居民健康档案基本数据集 WS 445（所有部分） 电子病历基本数据集 WS/T 448 基于居民健康档案的区域卫生信息平台技术规范 WS/T 483（所有部分） 健康档案共享文档规范 WS/T 500（所有部分） 电子病历共享文档规范 3 术语和缩略语 3.1 术语和定义 WS/T 448、WS/T 483界定的术语和定义适用于本标准。 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） 库七七 w w w .k q q w .c o m 提供WS/T 790.12021 24 编制说明 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.3.2消息结构及约束 5.x.4 消息应答 5.x.4.1触发事件 5.x.4.2消息结构与约束 6 交互服务 6.1 服务定义 6.2 服务技术要求 7 安全审计 7.1 安全约定 7.2 XXX交易消息审计 7.2.1 XXX交易请求者 7.2.2 XXX交易应答者 4.2 编码说明 4.2.1 服务编码 除本部分外，其余部分的服务提供者角色代码见表1。 库七七 w w w .k q q w .c o m 提供WS/T 790.12021 3表1 服务提供者代码 服务提供者角色名称 英文名称 服务编码 时间一致性服务 Consistent Time Service CT 节点认证服务 Node Authentication Service NA 安全审计服务 Audit Trail Services AT 居民注册服务 Person Registration Service PR 医疗卫生机构注册服务 Medical Institution Registration Service MIR 医疗卫生人员注册服务 Medical Staff Registration Service MSR 术语注册服务 Terminology Registration Service TR 健康档案存储服务 Documents Storage Service DS 健康档案管理服务 Documents Management Service DM 健康档案采集服务 Documents Collection Service DC 健康档案调阅服务 Documents Retrieval Service DR 文档订阅发布服务 Documents Subscribe-Publish Service DSP 预约挂号服务 Appointment and Registration Service ARS 双向转诊服务 TwoWay Referral service TRS 签约服务 Contract Service CS 远程会诊服务 Remote Consultation Service RCS 提醒服务 Reminder Service RS 居民健康卡服务 Health Card Service HC 4.2.2 交易编码 交易编码使用如下格式： IST-服务编号服务编号交易序号交易序号 例如： IST-PR1表示居民注册服务提交居民信息服务交易。 4.2.3 数据类型编码 简单数据类型采用Camel格式，复合数据类型采用Pascal格式。在与消息元素名称易产生混淆的场合，数据类型应后缀Type以示区分。 4.2.4 消息元素编码 消息根元素及通用元素编码采用Pascal格式，其余元素采用Camel格式。 4.3 消息结构表示 消息结构采用XML Schema架构模式进行表达。在文本描述中，消息节点为XML元素的采用元素代码或加注尖括号“”表示，、消息节点为XML属性的在属性代码前加注“”前缀表示。 4.4 消息节点的可选性约束表示 消息节点采用XPath表达式指向。消息元素及属性“可选项”约束采用表2代码表示。 库七七 w w w .k q q w .c o m 提供WS/T 790.12021 4表2 消息节点的可选性约束编码 约束名称 英文名称 描述 代码必选 Required 必选节点，应填充节点信息。如果节点信息不可获得或不被传送，则必须指明空值原因。 R 条件必选 Required for data exists 条件必选，如果节点信息存在则该节点必选。 R2 可选 Optional 可选节点。无论节点信息是否存在，可选择提供或不提供的节点。O 条件可选 Conditional 符合特定条件时必选的节点。条件可选节点应注明必选条件。 C 强制 Mandatory 强制要求该节点不可缺少，如果该节点没有值或者没有定义缺省值，消息将不能被合法解析。 M 已废弃 Invalid 已废弃的无效节点，不可选择。 X 5 消息与服务定义 5.1 通讯协议 5.1.1 消息封装结构 区域卫生信息平台服务消息宜通过SOAP1.2版进行通讯。消息封装结构如下： . 在SOAP1.2版本中服务请求的HTTP头部信息中应设置Content-Type为application/soap+xml。 5.1.2 消息编码 本规范所有部分中所定义的交互消息、文档编码应用 UTF-8。 5.1.3 命名空间 SOAP消息头使用指定的命名空间：http:/ 在命名空间不冲突的情况下，使用名称rhin来指代该命名空间。 5.2 消息定义 5.2.1 消息模式定义 消息模式应采用XML Schema进行定义，并遵循W3C XML Schema规范。 5.2.2 消息节点编码与数据元的对应 所有部分与业务相关的消息节点在可能情况下， 应引用以下标准的数据元代码， 并建立节点代码与数据元代码间的关系： WS 218； WS 363； WS 364； 库七七 w w w .k q q w .c o m 提供WS/T 790.12021 5WS 365； WS 371； WS 372； WS 373； WS 374； WS 375； WS 376； WS 377； WS 445。 5.2.3 消息数据类型 消息数据类型宜采用6.1所列基础数据类型。 5.2.4 对象 OID 标识 对象OID标识应符合GB/T 26231符定。 5.3 服务定义 5.3.1 服务描述 每个部分的交互服务均应提供用于定义服务交互接口的WSDL文件。 服务定义语言应遵循W3C WSDL 1.2规范，分别对消息、服务接口、服务绑定以及服务物理位置4个部分进行定义。 5.3.2 消息定义 服务定义WSDL文件通过引入已定义的消息格式文件定义消息类型。 消息元素的结构模式应包括名称属性name和一个部分元素,部分元素包括名称属性name和元素属性element。定义要求如下： 消息元素的名称属性name 宜与服务操作同名； 部分元素的名称属性name 宜定义为“message”； 部分元素的元素属性element 指向消息格式文件中的相应的消息元素。 5.3.3 服务端口类型描述 服务端口类型元素包括名称属性name和一系列的服务操作元素。每个操作元素包括入口消息及出口消息属性。定义要求如下： 操作元素：应定义name 属性，并与消息的名称保持一致，表示操作名称； 输入元素：应定义message 属性，并与消息格文件中请求消息元素保持一致，表示操作的输入参数； 输出元素：应定义message 属性，并与消息格文件中应答消息元素保持一致，表示操作的输出参数； 通知操作只含输出参数。 5.3.4 服务绑定类型 库七七 w w w .k q q w .c o m 提供WS/T 790.12021 6本规范中的网络服务绑定类型为Document/literal Wrapped模式,该模式与WS-I规范兼容。 选用该模式可以根据利用与函数同名的元素名进行消息的分发，可以利用Schema进行消息的验证，绑定元素定义如下： 绑定:应定义name 属性，采用服务名称+“Binding”格式；应定义type 属性，指向服务提供者对应的节点定义； 兼容 SOAP1.2 的绑定:应定义transport 属性；