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。

Newline Delimited JSONの生成と消費に関する厳密なルール: 1行につき1リソース、UTF-8エンコーディング、正しい行末処理、埋め込み改行なし、および正しいメディアタイプ（application/fhir+ndjson）。

バルクサーバー間アクセスに必要な、JWT アサーションを使用した OAuth 2.0 クライアント資格情報フローについて説明します。トークンリクエストの構造およびベアラートークンの使用方法も含まれます。

OperationOutcome の解釈、レート制限（429 Too Many Requests）、トークンの有効期限切れ（401）、ジョブが見つからない場合（404）、および耐障害性のあるポーリングクライアントのための戦略について説明します。

エクスポートを開始し、指数バックオフでステータスURLをポーリングし、完全なマニフェストを解析して、下流処理のためにNDJSONファイルをストリーミングするクライアントを実装します。この実装には FHIR Bulk Data の仕様に準拠したエンドポイントへのリクエスト処理が含まれます。

FHIRサーバーが$exportをサポートするように設定し、ワークフローの各ステージで正しいHTTPレスポンスを返し、CapabilityStatementを通じて適合性を宣言します。

Group/$export を _type、_since、_typeFilter パラメータとともに使用して、特定の分析または研究ユースケースに必要なリソースタイプと日付範囲のみをエクスポートします。

OperationOutcome レスポンスの解釈、HTTPステータスのセマンティクスの理解、部分的なマニフェストやページ分割された出力などのエッジケースの処理を通じて、一括エクスポートエラーを診断・解決します。