FHIRの規範的コンテンツとバージョン互換性に関するガイダンス
FHIR normative content and version compatibility
サマリー
本ガイドラインは、FHIRの実装において安定した(規範的な)動作を確保し、破壊的変更を避けるための指針を提供する。特にクライアント側には、未知の要素を無視するフォワードコンパチブルな解析や、標準に依存しないハードコーディングを避けるよう推奨している。
詳細
本資料は、FHIR(Fast Healthcare Interoperability Resources)を利用したシステム連携における「規範的コンテンツ」と「バージョン互換性」の取り扱いについて詳細なガイダンスを提供する。FHIRの内容には、安定性が期待される「規範的(Normative)」な部分と、進化途上の「非規範的(Non-normative)」な部分が混在しているため、後者の領域では破壊的変更が発生する可能性があることを警告している。 システム開発者に対しては、サーバーの進化に伴う混乱を最小限に抑えるため、「クライアント側の防御的な実装」が強く推奨されている。具体的には、JSON解析時に未知の要素があってもエラーで停止せず無視できる「フォワードコンパチブルな解析」を採用することや、必須フィールド以外のオプション要素の存在を前提としたハードコーディングを避けることが求められる。 また、バージョン間の互換性についても注意が必要であり、R4とR6など異なるエンドポイントを使用する場合、リソースモデルや検索パラメータに違いがあることを考慮し、クライアントはバージョン固有の動作に対応するように設計する必要がある。統合を行う際は、まず「ケイパビリティステートメント」(サーバーメタデータ)を用いて、サポートされるリソースタイプや操作(read/search/createなど)を確認することが推奨ワークフローとなっている。
Original content copyright by respective publishers