HL7 FHIR JP Core ImplementationGuide
1.1.2-clins - ci-build Japan

HL7 FHIR JP Core ImplementationGuide - Local Development build (v1.1.2-clins) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: JP Core FamilyMemberHistory Profile

項目内容
定義URL http://jpfhir.jp/fhir/core/StructureDefinition/JP_FamilyMemberHistory
Version 1.1.2-clins
Name

JP_FamilyMemberHistory
Title

JP Core FamilyMemberHistory Profile
Status Active ( 2023-06-26 )
Copyright

Copyright FHIR Japanese implementation research working group in Japan Association of Medical Informatics (JAMI) 一般社団法人日本医療情報学会NeXEHRS課題研究会FHIR日本実装検討WG

このプロファイルはFamilyMemberHistoryリソースに対して、データを送受信するための共通の制約と拡張を定めたものである。



電子カルテ情報共有サービス対応 V1.1.2-clins 版について

このV1.1.2-clins 版は、CodeSystemのシステムURIをOID形式からhttp:で始まるURL形式に変更したバージョンです。 例）OID形式：urn:oid:1.2.392.10495.x.y.z
　→　 http:で始まるURL形式: http://jpfhir/fhire/core/CodeSystem/…..
電子カルテ情報共有サービスの実装ガイドではこのJP-Core v1.1.2-clins版を参照しています。 通常版はこちらを参照ください。


本プロファイルは、JP_FamilyMemberHistoryリソースの記録・更新・検索を行う上で、準拠するべき必須となる要素や、サポートすべき拡張、用語、検索パラメータを定義する。

スコープ

  • JP_FamilyMemberHistoryは、FHIRワークフロー仕様のイベントリソースの１つである。
  • 本プロファイルは、対象者に関連する特定の個人の重要な健康状態を記録する。この情報は、さまざまなレベルの正確さで知ることができる。正確な状態（喘息）がわかっている場合もあれば、あまり正確でない場合（ある種のがん）もある。同様に、人物を特定できる場合もあれば（e.g. 私の叔母（母方の長女）である幸子）、その人物が叔父であることだけがわかっている場合もある。
  • 本プロファイルは、特定の家族の「初歩的な」家族史を把握するために使用される単純な構造を表している。しかし、遺伝子解析やその他の分析に有用な、より厳密な歴史を把握するための基礎とすることもできる。 - 例として、Genetic Pedigreeプロファイルを参照すること。
  • JP_FamilyMemberHistoryインスタンスへの参照をListリソースインスタンスに結合することで、個人の家族歴全体を表現することができる。

想定シナリオ

本プロファイルは、以下のようなユースケースを想定する。

  • JP_FamilyMemberHistoryリソースの記録・更新・検索

プロファイル定義

Usages:

You can also check for usages in the FHIR IG Statistics

プロファイル詳細

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. FamilyMemberHistory 0..* FamilyMemberHistory Information about patient's relatives, relevant for patient. 患者の家族に関する情報のうち、患者に関連する情報（家族歴）
... patient 1..1 Reference(JP Core Patient Profile) 患者の歴史はについてです / Patient history is about
... reasonReference 0..* Reference(QuestionnaireResponse | DocumentReference | JP Core AllergyIntolerance Profile | JP Core Condition Profile | JP Core Observation Common Profile | JP Core DiagnosticReport Common Profile) 家族歴が作成された理由 / Why was family member history performed?

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. FamilyMemberHistory C 0..* FamilyMemberHistory Information about patient's relatives, relevant for patient. 患者の家族に関する情報のうち、患者に関連する情報（家族歴）
Constraints: fhs-1, fhs-2
... id Σ 0..1 id このアーティファクトの論理ID / Logical id of this artifact
... meta Σ 0..1 Meta リソースに関するMetadata / Metadata about the resource
... implicitRules ?!Σ 0..1 uri このコンテンツが作成されたルールのセット / A set of rules under which this content was created
... language 0..1 code リソースコンテンツの言語 / Language of the resource content
Binding: CommonLanguages (preferred): 人間の言語。 / A human language.
Additional BindingsPurpose
AllLanguages Max Binding
... text 0..1 Narrative 人間の解釈のためのリソースのテキスト概要 / Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource インラインリソースが含まれています / Contained, inline Resources
... extension 0..* Extension 実装で定義された追加のコンテンツ / Additional content defined by implementations
... modifierExtension ?! 0..* Extension 無視できない拡張機能 / Extensions that cannot be ignored
... identifier Σ 0..* Identifier このレコードの外部ID / External Id(s) for this record
... instantiatesCanonical Σ 0..* canonical(PlanDefinition | Questionnaire | ActivityDefinition | Measure | OperationDefinition) FHIRプロトコルまたは定義をインスタンス化します / Instantiates FHIR protocol or definition
... instantiatesUri Σ 0..* uri 外部プロトコルまたは定義をインスタンス化します / Instantiates external protocol or definition
... status ?!Σ 1..1 code 部分的 | 完了 | エラー入力 | 不明 / partial | completed | entered-in-error | health-unknown
Binding: FamilyHistoryStatus (required): 家族歴史記録のステータスを識別するコード。 / A code that identifies the status of the family history record.
... dataAbsentReason Σ 0..1 CodeableConcept サブジェクト未知の|差し控え|観察できない|延期 / subject-unknown | withheld | unable-to-obtain | deferred
Binding: FamilyHistoryAbsentReason (example): 家族の歴史が利用できない理由を説明するコード。 / Codes describing the reason why a family member's history is not available.
... patient Σ 1..1 Reference(JP Core Patient Profile) 患者の歴史はについてです / Patient history is about
... date Σ 0..1 dateTime 履歴が記録されたとき、または最後に更新されたとき / When history was recorded or last updated
... name Σ 0..1 string 家族が説明した / The family member described
... relationship Σ 1..1 CodeableConcept 主題との関係 / Relationship to the subject
Binding: FamilyMember (example): 患者と関連者との関係の性質は、家族の歴史に記載されています。 / The nature of the relationship between the patient and the related person being described in the family member history.
... sex Σ 0..1 CodeableConcept 男性|女性|その他|わからない / male | female | other | unknown
Binding: AdministrativeGender (extensible): 出生登録に文書化された出生時に割り当てられた性別を説明するコード。 / Codes describing the sex assigned at birth as documented on the birth registration.
... born[x] C 0..1 （おおよそ）生年月日 / (approximate) date of birth
.... bornPeriod Period
.... bornDate date
.... bornString string
... age[x] ΣC 0..1 （おおよそ）年齢 / (approximate) age
.... ageAge Age
.... ageRange Range
.... ageString string
... estimatedAge ΣC 0..1 boolean 年齢は推定されていますか？ / Age is estimated?
... deceased[x] Σ 0..1 死？何歳/いつ？ / Dead? How old/when?
.... deceasedBoolean boolean
.... deceasedAge Age
.... deceasedRange Range
.... deceasedDate date
.... deceasedString string
... reasonCode Σ 0..* CodeableConcept 家族歴が作成された理由 / Why was family member history performed?
Binding: SNOMEDCTClinicalFindings (example): 家族の歴史が行われた理由を示すコード。 / Codes indicating why the family member history was done.
... reasonReference Σ 0..* Reference(QuestionnaireResponse | DocumentReference | JP Core AllergyIntolerance Profile | JP Core Condition Profile | JP Core Observation Common Profile | JP Core DiagnosticReport Common Profile) 家族歴が作成された理由 / Why was family member history performed?
... note 0..* Annotation 関連者についての一般的なメモ / General note about related person
... condition 0..* BackboneElement 関連者が持っていた状態 / Condition that the related person had
.... id 0..1 string 要素間参照のための一意のID / Unique id for inter-element referencing
.... extension 0..* Extension 実装で定義された追加のコンテンツ / Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension 認識されていなくても無視できない拡張機能 / Extensions that cannot be ignored even if unrecognized
.... code 1..1 CodeableConcept 関係が被る状態 / Condition suffered by relation
Binding: Condition/Problem/DiagnosisCodes (example): 状態または診断の識別。 / Identification of the Condition or diagnosis.
.... outcome 0..1 CodeableConcept 故人|永久障害|等 / deceased | permanent disability | etc.
Binding: ConditionOutcomeCodes (example): 患者の状態の結果。例えば死、永久障害、一時的な障害など。 / The result of the condition for the patient; e.g. death, permanent disability, temporary disability, etc.
.... contributedToDeath 0..1 boolean 状態が死因に貢献したかどうか / Whether the condition contributed to the cause of death
.... onset[x] 0..1 条件が最初に現れたとき / When condition first manifested
..... onsetAge Age
..... onsetRange Range
..... onsetPeriod Period
..... onsetString string
.... note 0..* Annotation 状態に関する追加情報 / Extra information about condition

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
FamilyMemberHistory.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
FamilyMemberHistory.​status Base required FamilyHistoryStatus 📍4.0.1 FHIR Std.
FamilyMemberHistory.​dataAbsentReason Base example FamilyHistoryAbsentReason 📍4.0.1 FHIR Std.
FamilyMemberHistory.​relationship Base example FamilyMember 📦3.0.0 THO v7.0
FamilyMemberHistory.​sex Base extensible AdministrativeGender 📍4.0.1 FHIR Std.
FamilyMemberHistory.​reasonCode Base example SNOMED CT Clinical Findings 📍4.0.1 FHIR Std.
FamilyMemberHistory.​condition.code Base example Condition/Problem/Diagnosis Codes 📍4.0.1 FHIR Std.
FamilyMemberHistory.​condition.outcome Base example Condition Outcome Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error FamilyMemberHistory リソースが別のリソースに含まれている場合、ネストされたリソースを含めてはなりません / If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error FamilyMemberHistory リソースが別のリソースに含まれている場合、それはリソースの他の場所から参照されるか、含有リソースを参照するものとします / If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error FamilyMemberHistory リソースが別のリソースに含まれている場合、meta.versionidもmeta.lastupdatedも持ってはならない。 / If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error FamilyMemberHistory 別のリソースにリソースが含まれている場合、セキュリティラベルはありません / If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice FamilyMemberHistory リソースには、堅牢な管理のための叙述(Narative)が存在することが望ましい / A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements すべてのFHIR要素には、@valueまたは子要素が必要です / All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions 両方ではなく、拡張または値[x]が必要です / Must have either extensions or value[x], not both extension.exists() != value.exists()
fhs-1 error FamilyMemberHistory 年齢[x]または生まれ[x]を持つことができますが、両方ではありません / Can have age[x] or born[x], but not both age.empty() or born.empty()
fhs-2 error FamilyMemberHistory 年齢[x]が存在する場合にのみ推定される可能性があります / Can only have estimatedAge if age[x] is present age.exists() or estimatedAge.empty()

Differential View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. FamilyMemberHistory 0..* FamilyMemberHistory Information about patient's relatives, relevant for patient. 患者の家族に関する情報のうち、患者に関連する情報（家族歴）
... patient 1..1 Reference(JP Core Patient Profile) 患者の歴史はについてです / Patient history is about
... reasonReference 0..* Reference(QuestionnaireResponse | DocumentReference | JP Core AllergyIntolerance Profile | JP Core Condition Profile | JP Core Observation Common Profile | JP Core DiagnosticReport Common Profile) 家族歴が作成された理由 / Why was family member history performed?

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. FamilyMemberHistory C 0..* FamilyMemberHistory Information about patient's relatives, relevant for patient. 患者の家族に関する情報のうち、患者に関連する情報（家族歴）
Constraints: fhs-1, fhs-2
... id Σ 0..1 id このアーティファクトの論理ID / Logical id of this artifact
... meta Σ 0..1 Meta リソースに関するMetadata / Metadata about the resource
... implicitRules ?!Σ 0..1 uri このコンテンツが作成されたルールのセット / A set of rules under which this content was created
... language 0..1 code リソースコンテンツの言語 / Language of the resource content
Binding: CommonLanguages (preferred): 人間の言語。 / A human language.
Additional BindingsPurpose
AllLanguages Max Binding
... text 0..1 Narrative 人間の解釈のためのリソースのテキスト概要 / Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource インラインリソースが含まれています / Contained, inline Resources
... extension 0..* Extension 実装で定義された追加のコンテンツ / Additional content defined by implementations
... modifierExtension ?! 0..* Extension 無視できない拡張機能 / Extensions that cannot be ignored
... identifier Σ 0..* Identifier このレコードの外部ID / External Id(s) for this record
... instantiatesCanonical Σ 0..* canonical(PlanDefinition | Questionnaire | ActivityDefinition | Measure | OperationDefinition) FHIRプロトコルまたは定義をインスタンス化します / Instantiates FHIR protocol or definition
... instantiatesUri Σ 0..* uri 外部プロトコルまたは定義をインスタンス化します / Instantiates external protocol or definition
... status ?!Σ 1..1 code 部分的 | 完了 | エラー入力 | 不明 / partial | completed | entered-in-error | health-unknown
Binding: FamilyHistoryStatus (required): 家族歴史記録のステータスを識別するコード。 / A code that identifies the status of the family history record.
... dataAbsentReason Σ 0..1 CodeableConcept サブジェクト未知の|差し控え|観察できない|延期 / subject-unknown | withheld | unable-to-obtain | deferred
Binding: FamilyHistoryAbsentReason (example): 家族の歴史が利用できない理由を説明するコード。 / Codes describing the reason why a family member's history is not available.
... patient Σ 1..1 Reference(JP Core Patient Profile) 患者の歴史はについてです / Patient history is about
... date Σ 0..1 dateTime 履歴が記録されたとき、または最後に更新されたとき / When history was recorded or last updated
... name Σ 0..1 string 家族が説明した / The family member described
... relationship Σ 1..1 CodeableConcept 主題との関係 / Relationship to the subject
Binding: FamilyMember (example): 患者と関連者との関係の性質は、家族の歴史に記載されています。 / The nature of the relationship between the patient and the related person being described in the family member history.
... sex Σ 0..1 CodeableConcept 男性|女性|その他|わからない / male | female | other | unknown
Binding: AdministrativeGender (extensible): 出生登録に文書化された出生時に割り当てられた性別を説明するコード。 / Codes describing the sex assigned at birth as documented on the birth registration.
... born[x] C 0..1 （おおよそ）生年月日 / (approximate) date of birth
.... bornPeriod Period
.... bornDate date
.... bornString string
... age[x] ΣC 0..1 （おおよそ）年齢 / (approximate) age
.... ageAge Age
.... ageRange Range
.... ageString string
... estimatedAge ΣC 0..1 boolean 年齢は推定されていますか？ / Age is estimated?
... deceased[x] Σ 0..1 死？何歳/いつ？ / Dead? How old/when?
.... deceasedBoolean boolean
.... deceasedAge Age
.... deceasedRange Range
.... deceasedDate date
.... deceasedString string
... reasonCode Σ 0..* CodeableConcept 家族歴が作成された理由 / Why was family member history performed?
Binding: SNOMEDCTClinicalFindings (example): 家族の歴史が行われた理由を示すコード。 / Codes indicating why the family member history was done.
... reasonReference Σ 0..* Reference(QuestionnaireResponse | DocumentReference | JP Core AllergyIntolerance Profile | JP Core Condition Profile | JP Core Observation Common Profile | JP Core DiagnosticReport Common Profile) 家族歴が作成された理由 / Why was family member history performed?
... note 0..* Annotation 関連者についての一般的なメモ / General note about related person
... condition 0..* BackboneElement 関連者が持っていた状態 / Condition that the related person had
.... id 0..1 string 要素間参照のための一意のID / Unique id for inter-element referencing
.... extension 0..* Extension 実装で定義された追加のコンテンツ / Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension 認識されていなくても無視できない拡張機能 / Extensions that cannot be ignored even if unrecognized
.... code 1..1 CodeableConcept 関係が被る状態 / Condition suffered by relation
Binding: Condition/Problem/DiagnosisCodes (example): 状態または診断の識別。 / Identification of the Condition or diagnosis.
.... outcome 0..1 CodeableConcept 故人|永久障害|等 / deceased | permanent disability | etc.
Binding: ConditionOutcomeCodes (example): 患者の状態の結果。例えば死、永久障害、一時的な障害など。 / The result of the condition for the patient; e.g. death, permanent disability, temporary disability, etc.
.... contributedToDeath 0..1 boolean 状態が死因に貢献したかどうか / Whether the condition contributed to the cause of death
.... onset[x] 0..1 条件が最初に現れたとき / When condition first manifested
..... onsetAge Age
..... onsetRange Range
..... onsetPeriod Period
..... onsetString string
.... note 0..* Annotation 状態に関する追加情報 / Extra information about condition

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
FamilyMemberHistory.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
FamilyMemberHistory.​status Base required FamilyHistoryStatus 📍4.0.1 FHIR Std.
FamilyMemberHistory.​dataAbsentReason Base example FamilyHistoryAbsentReason 📍4.0.1 FHIR Std.
FamilyMemberHistory.​relationship Base example FamilyMember 📦3.0.0 THO v7.0
FamilyMemberHistory.​sex Base extensible AdministrativeGender 📍4.0.1 FHIR Std.
FamilyMemberHistory.​reasonCode Base example SNOMED CT Clinical Findings 📍4.0.1 FHIR Std.
FamilyMemberHistory.​condition.code Base example Condition/Problem/Diagnosis Codes 📍4.0.1 FHIR Std.
FamilyMemberHistory.​condition.outcome Base example Condition Outcome Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error FamilyMemberHistory リソースが別のリソースに含まれている場合、ネストされたリソースを含めてはなりません / If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error FamilyMemberHistory リソースが別のリソースに含まれている場合、それはリソースの他の場所から参照されるか、含有リソースを参照するものとします / If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error FamilyMemberHistory リソースが別のリソースに含まれている場合、meta.versionidもmeta.lastupdatedも持ってはならない。 / If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error FamilyMemberHistory 別のリソースにリソースが含まれている場合、セキュリティラベルはありません / If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice FamilyMemberHistory リソースには、堅牢な管理のための叙述(Narative)が存在することが望ましい / A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements すべてのFHIR要素には、@valueまたは子要素が必要です / All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions 両方ではなく、拡張または値[x]が必要です / Must have either extensions or value[x], not both extension.exists() != value.exists()
fhs-1 error FamilyMemberHistory 年齢[x]または生まれ[x]を持つことができますが、両方ではありません / Can have age[x] or born[x], but not both age.empty() or born.empty()
fhs-2 error FamilyMemberHistory 年齢[x]が存在する場合にのみ推定される可能性があります / Can only have estimatedAge if age[x] is present age.exists() or estimatedAge.empty()

 

Other representations of profile: CSV, Excel, Schematron

必須要素

本プロファイルに準拠するためには、次の項目の値が存在しなければならない。

  • patient : 本リソースを有する患者
  • relationship : 患者と家族との関係の種類（父、母、兄弟など）
  • status : 家族歴のステータス（部分的 | 完全 | 記録エラー | 健康状態不明）

Extensions定義

本プロファイルで追加定義された拡張はない。

利用方法

OperationおよびSearch Parameter 一覧

Search Parameter一覧

コンフォーマンス パラメータ 型 例
SHALL identifier token GET [base]/FamilyMemberHistory?identifier=http://myhospital.com/fhir/gamilymemberhistory|123
SHOULD patient reference GET [base]/FamilyMemberHistory?patient=Patient/123
MAY patient,relationship reference,reference GET [base]/FamilyMemberHistory?patient=Patient/123&relationship=FAMMEMB
MAY patient,status reference,code GET [base]/FamilyMemberHistory?patient=Patient/123&status=completed
必須検索パラメータ

本プロファイルに準拠するためには、以下の検索パラメータをサポートしなければならない（SHALL）

  1. 検索パラメータidentifierを指定し、レコードIDなどの識別子によりFamilyMemberHistoryを検索

    GET [base]/FamilyMemberHistory?identifier={system|}[code]

    例：

    GET [base]/FamilyMemberHistory?identifier=http://myhospital.com/fhir/familymemberhistory|123

    指定された識別子に一致するFamilyMemberHistoryリソースを含むBundleを検索する。

推奨検索パラメータ

  1. 検索パラメータpatientを指定し、該当するすべてのFamilyMemberHistoryを検索

    GET [base]/FamilyMemberHistory?patient={reference}

    例：

    GET [base]/FamilyMemberHistory?patient=Patient/123

    指定された患者のすべてのFamilyMemberHistoryを含むBundleを返却する。

追加検索パラメータ

オプションとして次の検索パラメータをサポートすることができる（MAY）

  1. 検索パラメータpatientとstatusの組みを指定し、該当するすべてのFamilyMemberHistoryを検索

    • OR検索のサポートを含む(例えば status={system|}[code],{system|}[code],…)

      GET [base]/FamilyMemberHistory?patient={reference}&status={system|}[code]{,{system|}[code],...}

      例：

      GET [base]/FamilyMemberHistory?patient=Patient/123&status=completed

      指定された患者のすべてのFamilyMemberHistoryを含むBundleを返却する。

オプション検索パラメータ

本プロファイルで追加定義されたオプション検索パラメータはない。

サンプル