FHIR Bulk Data

• 您正在构建一个批量数据客户端，需要启动导出任务、轮询状态，并从 FHIR 服务器下载 NDJSON 文件。
• 您正在实现服务器端的 $export 支持，需要了解合规性要求、清单结构或 CapabilityStatement 声明。
• 您需要使用 _type、_since 或 _typeFilter 等参数，按资源类型、日期范围或 FHIR 搜索条件对大型导出任务进行筛选。
• 您正在集成 SMART Backend Services（OAuth 2.0 客户端凭据 + JWT），以实现安全的服务器间批量访问。

• 您只需要通过标准 REST 检索单个 FHIR 资源——请改用通用 FHIR 技能。
• 您的使用场景涉及实时或近实时数据流，而非批量导出。
• 您正在使用不遵循 HL7 Bulk Data Access IG 的专有批量导出格式。

引导您完成批量导出生命周期的每个阶段：启动请求、202 Accepted 处理、使用 Retry-After 和 X-Progress 进行状态轮询、清单解析、文件下载以及 DELETE 清理。

涵盖 Patient/$export（所有患者）、Group/[id]/$export（队列范围）和 [base]/$export（系统级别），包括各自的适用场景以及范围界定如何影响输出结果。

所有支持参数的详细说明：_outputFormat、_since、_until、_type、_elements、_typeFilter、includeAssociatedData、organizeOutputBy 和 allowPartialManifests。

生成和使用换行符分隔 JSON 的精确规则：每行一个资源、UTF-8 编码、正确的行终止符、无嵌入换行符，以及正确的媒体类型（application/fhir+ndjson）。

解释了用于批量服务器间访问所需的带有 JWT 断言的 OAuth 2.0 客户端凭据流程，包括令牌请求结构和持有者令牌的使用方式。

涵盖 OperationOutcome 的解析、速率限制（429 Too Many Requests）、令牌过期（401）、任务不存在（404），以及构建具有弹性的轮询客户端的相关策略。

实现一个客户端，用于发起导出请求、通过指数退避策略轮询状态 URL、解析完整的清单文件，并以流式传输 NDJSON 文件的方式供下游处理使用。

配置 FHIR 服务器以支持 $export，在每个工作流阶段返回正确的 HTTP 响应，并通过 CapabilityStatement 声明一致性。

使用带有 _type、_since 和 _typeFilter 参数的 Group/$export，仅导出特定分析或研究用例所需的资源类型和日期范围。

通过解析 OperationOutcome 响应、理解 HTTP 状态语义，以及处理部分清单和分页输出等边缘情况，诊断并解决 FHIR Bulk Data 批量导出错误。