HealthRecordCommunity
FHIRHL7🌏 International整理済

FHIR JSONにおけるプリミティブ拡張の表現方法を解説

FHIR primitive extensions in JSON - Oracle Help Center

2026年8月15日

サマリー

本記事は、FHIRリソースにおいて、基本的な値(プリミティブ)に付加的なメタデータ(拡張情報)を持たせる際のJSON表現ルールを詳細に説明している。具体的には、値を保持するプロパティと、そのメタデータを格納するアンダースコア付きのコンパニオンプロパティを使用する必要がある。

詳細

FHIRにおいて、単なる値だけでなく、追加的な意味を持つメタデータ(拡張)を付与したい場合、JSON構造が用いられる。この仕組みでは、プリミティブの値自体は通常のプロパティ(例:`birthDate`)に格納され、その値に関連するオプションのIDや拡張情報は、アンダースコアが付いたコンパニオンプロパティ(例:`_birthDate`)に分離して記述される。この設計により、データ本体と付加的なメタデータを明確に区別できる。 具体的なルールとして、値とメタデータの両方を持つ場合は両方のプロパティを含め、メタデータのみの場合もコンパニオンプロパティを必須とする。また、拡張情報(`extension`)は特定のURL定義に基づき使用され、コアFHIR要素では表現できない情報を補完する目的で利用される。 本ガイドラインには、Patientリソースにおける生年月日や、HumanNameリソースにおける名前の構成要素など、具体的なデータ構造の例が示されている。さらに、配列(リスト)形式で繰り返されるプリミティブ要素の場合の取り扱い方や、バリデーションエラーの修正方法についても言及されており、FHIR JSONを用いた高度なデータ表現技術を理解する上で非常に有用である。 この知識は、日本の医療情報システムが国際標準規格に準拠し、よりリッチで詳細な臨床情報を交換するために不可欠となる。特に、HL7やSNOMED CTなどのコード体系と連携した拡張情報の取り扱いは、相互運用性の向上に直結する。

📰
原文を読む
docs.oracle.com
→

Original content copyright by respective publishers