医療記録データは HL7 FHIR 形式で保存されます。
医療記録は、次の Fast Health Interoperable Resources（FHIR）バージョンをサポートしています。
医療リソースタイプ
FHIR は、リソースと呼ばれる一連のモジュラー コンポーネントで構成されています。サポートされている FHIR リソースと対応するカテゴリのセットは、国際患者概要のセクションにほぼ基づいています。
これらのリソースは、ヘルスコネクトのデータカテゴリにマッピングされ、API では医療リソースタイプと呼ばれます。Observation リソースは、Logical Observation Identifiers Names and Codes（LOINC）コードや FHIR カテゴリなどのコンテンツに基づいてマッピングされます。
これらのカテゴリのいずれにも属さないオブザベーションは、ヘルスコネクトに書き込まれません。
| Health Connect の医療リソースのタイプ | FHIR リソース | ヘルスコネクトの権限の申告 |
|---|---|---|
| アレルギー | AllergyIntolerance |
android.permission.health.READ_MEDICAL_DATA_ALLERGIES_INTOLERANCES
|
| 条件 | 条件 |
android.permission.health.READ_MEDICAL_DATA_CONDITIONS
|
| ラボ |
問題点
|
android.permission.health.READ_MEDICAL_DATA_LABORATORY_RESULTS
|
| 服用している薬 | Medication、MedicationRequest、MedicationStatement |
android.permission.health.READ_MEDICAL_DATA_MEDICATIONS
|
| 個人の詳細 | 患者 |
android.permission.health.READ_MEDICAL_DATA_PERSONAL_DETAILS
|
| 医療従事者の詳細 | Practitioner、PractitionerRole |
android.permission.health.READ_MEDICAL_DATA_PRACTITIONER_DETAILS
|
| 妊娠 |
問題点
|
android.permission.health.READ_MEDICAL_DATA_PREGNANCY
|
| 治療 | 手順 |
android.permission.health.READ_MEDICAL_DATA_PROCEDURES
|
| 社会歴 |
問題点
|
android.permission.health.READ_MEDICAL_DATA_SOCIAL_HISTORY
|
| ワクチン | 予防接種 |
android.permission.health.READ_MEDICAL_DATA_VACCINES
|
| 受診 | Encounter、Location、Organization |
android.permission.health.READ_MEDICAL_DATA_VISITS
|
| バイタルサイン |
問題点
|
android.permission.health.READ_MEDICAL_DATA_VITAL_SIGNS
|
患者向けリソース
現時点では、ヘルスコネクトは 1 人の個人の医療記録データのみを保存することを目的としています。したがって、書き込まれるすべての FHIR リソースは同じ人物に属している必要があります。
1 人の個人に対して複数の FHIR 患者リソースがシステムに存在することは珍しくありません。アプリはデータを調整し、単一の Patient リソースをヘルスコネクトに書き込むことが推奨されます。ただし、さまざまな組織構造に対応するため、これは強制されません。
データの検証
医療記録 API は、サポートされているバージョンから有効な FHIR リソースを受け入れます。Health Connect は、サポートされている各バージョンの FHIR 仕様が守られていることを確認するために、いくつかの検証を行います。
近日公開とマークされている検証チェックはまだ適用されていませんが、今後のリリースで適用される予定です。今後のリリースとの互換性を維持するため、リストされているすべての検証チェックに対して開発することをおすすめします。
| ステータス | 検証チェック | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| 有効な JSON | データは JSON 形式に準拠しています。 | ||||||||
| サポートされている FHIR | 書き込みアプリケーションによって宣言された FHIR バージョンがサポートされている。ヘルスコネクトでは、次の FHIR バージョンがサポートされています。
|
||||||||
| サポートされている FHIR | リソース インスタンスに記録された FHIR リソースタイプがサポートされています。ヘルスコネクトでサポートされている FHIR リソースタイプは次のとおりです。
|
||||||||
| 一意のリソース ID | リソースに、正規表現の要件を満たす値を持つ ID フィールドがある。 | ||||||||
| 一意のリソース ID | リソースは、同じ MedicalDataSource の同じリソースタイプを持つ別の FHIR リソースと ID を共有しません。 |
||||||||
| ビジネスルール | 含まれている FHIR リソースは含まれません。含まれているリソースは、「親」リソース内にネストされた FHIR リソースです。これらは、親リソースが別のリソースを参照する必要があるが、システムに独立した存在を持つスタンドアロン リソースとして作成するのに十分な情報がない場合に使用されます。 | ||||||||
| 有効なベース FHIR | FHIR JSON の最上位フィールドは、指定されたリソースタイプの FHIR 仕様に存在します。 | ||||||||
| 有効なベース FHIR | トップレベル フィールドに JSON null 値がありません。 | ||||||||
| 有効なベース FHIR | 最上位の必須フィールドがすべて存在している。 | ||||||||
| 有効なベース FHIR | FHIR の繰り返し要素として定義されたトップレベル フィールドは、JSON array データ型を持ちます。 |
||||||||
| 有効なベース FHIR | FHIR で複合型として定義されたトップレベル フィールド（JSON array 内の要素を含む）は、JSON object データ型を持ちます。 |
||||||||
| 有効なベース FHIR | FHIR でプリミティブ型として定義されているトップレベル フィールド（JSON array 内の要素を含む）に、正しい JSON データ型が設定されている。
|
||||||||
| 有効なベース FHIR | FHIR でプリミティブ型として定義されたトップレベルのフィールドは、正規表現の要件を満たしています。近日提供予定 | ||||||||
| 有効なベース FHIR | プリミティブ型の拡張機能は FHIR 仕様に存在し、JSON object データ型を持ちます。 |
||||||||
| 有効なベース FHIR | 選択フィールド（fieldname[x]）に記録されるフィールドは 1 つだけです。たとえば、effectiveDateTime と effectivePeriod の両方を同じリソース インスタンスに含めることはできません。 |
||||||||
| 有効なベース FHIR | 複合データ型には、FHIR 仕様に一致するフィールドとデータ型が含まれています。近日提供予定 | ||||||||
| 有効なベース FHIR | バックボーン要素（および複合型内の要素）には、FHIR 仕様に一致するフィールドとデータ型が含まれています。近日提供予定 | ||||||||
| 有効なベース FHIR | Extensions 要素
value[x] フィールドは有効な型であり、そのデータ型に従ってコンテンツを含んでいます。拡張要素は、基本仕様の一部ではない追加情報を表すために、任意のリソースに含めることができます。拡張要素には、拡張の定義にリンクするフィールド url と、拡張値を含むフィールド value[x] が含まれています。value[x] は、許可されているデータ型のセットリストから選択する必要があります。近日提供予定 |
変換済みの FHIR データ
一部のアプリは、独自の要件を満たすために FHIR データを変換します。次に例を示します。
- さまざまなソース（通常は FHIR API）のデータを統合する。
- コードをグローバル用語（SNOMED、LOINC、ICD など）にマッピングし、単位を標準化します。
- データの統合と重複除去。
- 書式設定やその他のデータ品質の問題を修正する。
- アプリ固有のビジネスルールに基づいてレコードをフィルタリングします。
変換前と変換後の FHIR データのいずれも、FHIR R4 仕様に準拠していれば、ヘルスコネクトに書き込むことができます。可能な場合は、変換されたデータを書き込むことをおすすめします。ただし、次の点に注意してください。
- ユースケースが狭いアプリでは、エコシステムの他のアプリがユーザー価値を生み出す可能性のあるレコードが大量にフィルタリングされる可能性があります。このような状況では、より完全な変換されていない FHIR を記述することが有益な場合があります。ただし、このより広範なデータセットが共有されることをユーザーに通知してください。
- 異なるソースから取得したデータを統合する場合は、ヘルスコネクトの単一の
MedicalDataSourceにデータを書き込むことができます。また、競合を避けるために、各リソースに新しい ID を割り当て、新しい ID を指すようにリソース参照を更新する必要があります。 - 複数のソースのデータを 1 つの
MedicalDataSourceに統合すると、データの出所が不明になる可能性があります。データ コンシューマーがデータの出所を把握することは多くの場合に役立つため、各リソースのmeta.sourceフィールドにレコードの元のソース（通常は FHIR ベース URL）を入力することをおすすめします。