HL7中国批量数据导出服务实施指南
2026.01.23 - release

HL7中国批量数据导出服务实施指南 - Local Development build (v2026.01.23) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## 首页

官方URL: http://hl7.org.cn/fhir-ig/bulkdata/ImplementationGuide/hl7cn.fhir.bulkdata | 版本: 2026.01.23
Draft as of 2026-02-08 | 机读名称: HL7CN_FHIR_BulkData

### 概述

定义了一套标准化的、基于FHIR的异步操作，用于从资源服务器向授权客户端高效导出大规模医疗数据集。它旨在解决传统FHIR API在处理海量数据时面临的性能瓶颈，并简化跨系统的批量数据交换流程。

传统的医疗数据批量交换流程繁琐，涉及数据提取、格式转换和文件传输等多个步骤，成本高昂。现有的FHIR API适合处理实时、小规模的数据交互，但对于需要导出数十万条记录的场景（如用于研究或质量评估的患者队列数据），发起大量请求是不现实的。本实施指南通过定义标准的`$export`操作，使客户端能够以异步方式一次性请求并获取特定群体（如所有患者、一组患者或系统全部数据）的大量资源，服务器会将结果生成为NDJSON格式的文件供客户端下载。

本实施指南是在Bulk Data Access IG v3.0.0的基础上进行剪裁，以适应中国医疗卫生领域的数据交换环境以及HL7中国的FHIR Connectathon评估要求。

本实施指南是为HL7中国2026年FHIR Connectathon测评新增的主题。

### 使用场景

本实施指南旨在支持共享任何可在FHIR中表示的数据。这意味着本实施指南应适用于如下系统：

- 存储FHIR资源的FHIR服务器；
- 使用FHIR实现作为互操作层的电子病历系统、人群健康系统、公共卫生系统等。

#### 用例

- 术语数据：从术语服务器导出 CodeSystem 和 ValueSet 资源
- 服务提供者数据：导出系统中的医护从业者、地点和医疗卫生机构列表
- 公共卫生数据：用于非实时的大规模公共卫生监测、电子病历报告等
- 财务数据：导出患者的理赔、承保和福利说明等资源，用于财务分析
- 临床与互操作性数据：定期从电子病历系统中导出资源，用于研究数据或人口健康管理
- 传染病上报数据

### 授权与安全

为确保数据安全，Bulk Data Access IG v3.0.0推荐使用 SMART Backend Services授权框架来管理客户端应用的访问权限。在本实施指南中，暂时省略了这一过程，待App Launch Implementation Guide进行本地化剪裁后会增补该部分内容。

### 技术内容

#### 模板

本实施指南由 HL7 IG Publisher 发布。目前包括以下模板：

模板 ID | GitHub 代码库 | 描述
--- | --- | ---
`fhir.base.template` | https://github.com/HL7/ig-template-base | 此模板包含了生成HL7风格实施指南所需的所有脚本、布局文件等。但是，它不包含HL7或FHIR的徽标。它旨在作为大多数非HL7的实施指南的基础。
`fhir.hl7cn.template` | https://github.com/hl7cn/ig-template-fhir-cn | 此此模板继承自 `fhir.base.template`，并加入了HL7中国徽标、通用的HL7配色方案以及一些HL7中国特定的规则。

#### 章节

本实施指南包含以下章节：

- 首页： 本页面。
- 服务与交易： 描述批量数据导出服务的详细技术要求和四个服务交易说明。
- 最佳实践： 关于创建易于理解和使用的实现指南的建议。
- 下载与支持： 提供本实施指南的下载链接。

#### 依赖关系

本实施指南基于FHIR R5 标准的FHIR 异步请求模式实现。

### 贡献者

本实施指南由叶大虾🦐翻译、裁剪、整理，如果发现本指南的任何问题，欢迎通过本邮件进行沟通。