HL7 FHIR JP Core ImplementationGuide
1.1.2-url - ci-build
Japan
HL7 FHIR JP Core ImplementationGuide - Local Development build (v1.1.2-url) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
項目 | 内容 |
定義URL | http://jpfhir.jp/fhir/core/StructureDefinition/JP_Immunization |
Version | 1.1.2-url |
Name | JP_Immunization |
Title | JP Core Immunization Profile |
Status | Active ( 2023-06-26 ) |
Copyright | Copyright FHIR Japanese implementation research working group in Japan Association of Medical Informatics (JAMI) 一般社団法人日本医療情報学会NeXEHRS課題研究会FHIR日本実装検討WG |
このプロファイルはImmunizationリソースに対して日本での予防接種データを送受信するための制約を加えたものである。
このV1.1.2-url 版は、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-url版を参照しています。
通常版はこちらを参照ください。
本プロファイルはワクチン接種情報をImmunizationリソースを使用して表現する。 以下、本プロファイルのImmunizationリソースを「JP Core Immunizationリソース」と呼ぶ。
ワクチン接種のFHIR仕様に関しては、先行事例としてはデジタル庁が公開している新型コロナワクチン接種証明書アプリがあるが、スマートフォンでQRコードとして表示できるデータサイズに納めるため、記述されている情報は極めて限定的である。そこで、国内で利用されているそれ以外のワクチン接種関係の文書やAPIなども参考にして記述すべき項目の洗い出しや記述方法の検討を行った。具体的には、母子手帳、Yellow Card、 市町村長が有する接種記録(予防接種台帳)、ワクチン接種記録システム(VRS)、マイナポータル自己情報取得APIを参考にした。既存のImmunizationの要素で記述できない項目については、新たに拡張を定義した。
本プロファイルは、以下のようなユースケースを想定している。
本プロファイルの対象は各種ワクチンの接種情報を電子的に連携するためのメッセージを記述することである。
本プロファイルはワクチン以外の一般的な注射薬剤については対象としない。一般的な注射薬剤は、JP Core MedicationRequest Injectionプロファイルで記述することとする。
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from Immunization
Summary
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
Immunization | 0..* | Immunization | 予防接種 | |||||
id | Σ | 0..1 | id | このResourceに対する論理ID | ||||
meta | Σ | 0..1 | Meta | リソースに関するメタデータ / 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.
| |||||
text | 0..1 | Narrative | 人間の解釈のためのリソースのテキスト概要 / Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | インラインリソースが含まれています / Contained, inline Resources | |||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
dueDateOfNextDose | 0..1 | date | 次回接種予定日 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_DueDateOfNextDose | |||||
manufacturedDate | 0..1 | date | 製造年月日 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_ManufacturedDate | |||||
certificatedDate | 0..1 | date | 検定年月日 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_CertificatedDate | |||||
modifierExtension | ?! | 0..* | Extension | 無視できない拡張機能 / Extensions that cannot be ignored | ||||
identifier | 0..* | Identifier | ビジネス識別子 / Business identifier | |||||
status | ?!Σ | 1..1 | code | 完了|エラーに入った|まだ完成してない / completed | entered-in-error | not-done Binding: ImmunizationStatusCodes (required): 予防接種の現在の状態を表すコード | ||||
statusReason | 0..1 | CodeableConcept | 実施しなかった理由 Binding: ImmunizationStatusReasonCodes (example): ワクチンが投与されなかった理由。 / The reason why a vaccine was not administered. | |||||
vaccineCode | Σ | 1..1 | CodeableConcept | 接種されたワクチン製剤 Binding: JP Core MedicationCode Immunization ValueSet (preferred) | ||||
patient | Σ | 1..1 | Reference(JP Core Patient Profile) | 予防接種を受けた人 | ||||
encounter | 0..1 | Reference(JP Core Encounter Profile) | 予防接種を受けた診察 | |||||
occurrence[x] | Σ | 1..1 | ワクチンを接種した日時 | |||||
occurrenceDateTime | dateTime | |||||||
occurrenceString | string | |||||||
recorded | 0..1 | dateTime | 予防接種を受けた対象者の記録として最初に記載された日 | |||||
primarySource | Σ | 0..1 | boolean | データが記録されたコンテキストを示します / Indicates context the data was recorded in | ||||
reportOrigin | 0..1 | CodeableConcept | 二次的に報告された記録の発生源を示す Binding: ImmunizationOriginCodes (example): 主要なソースからのものではないレコードのデータのソース。 / The source of the data for a record which is not from a primary source. | |||||
location | 0..1 | Reference(JP Core Location Profile) | ワクチンを接種した場所 | |||||
manufacturer | 0..1 | Reference(JP Core Organization Profile) | ワクチンメーカー | |||||
lotNumber | 0..1 | string | ワクチンのロット番号 | |||||
expirationDate | 0..1 | date | ワクチンの使用期限 | |||||
site | 0..1 | CodeableConcept | ワクチンが接種された身体部位 Binding: CodesForImmunizationSiteOfAdministration (example): ワクチンが投与されたサイト。 / The site at which the vaccine was administered. | |||||
route | 0..1 | CodeableConcept | ワクチンを接種した経路 Binding: ImmunizationRouteCodes (example): ワクチンが投与されたルート。 / The route by which the vaccine was administered. | |||||
doseQuantity | C | 0..1 | JP_MedicationSimpleQuantity | ワクチンの投与量 qty-3: ユニットのコードが存在する場合、システムも存在するものとします / If a code for the unit is present, the system SHALL also be present sqty-1: コンパレータは、単純なQuantityで使用されません / The comparator is not used on a SimpleQuantity | ||||
performer | Σ | 0..* | BackboneElement | ワクチン接種を実施した人 | ||||
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 | ||||
function | Σ | 0..1 | CodeableConcept | どのような種類のパフォーマンスが行われました / What type of performance was done Binding: ImmunizationFunctionCodes (extensible): 予防接種イベントで開業医または組織が果たす役割。 / The role a practitioner or organization plays in the immunization event. | ||||
actor | Σ | 1..1 | Reference(JP Core Practitioner Profile | JP Core PractitionerRole Profile | JP Core Organization Profile) | 演奏していた個人または組織 / Individual or organization who was performing | ||||
note | Σ | 0..* | Annotation | 予防接種についての補足的記録 | ||||
reasonCode | 0..* | CodeableConcept | 予防接種を接種した理由 Binding: ImmunizationReasonCodes (example): ワクチンが投与された理由。 / The reason why a vaccine was administered. | |||||
reasonReference | 0..* | Reference(Condition | Observation | DiagnosticReport) | 予防接種を実施した理由 | |||||
isSubpotent | ?!Σ | 0..1 | boolean | 効力量 | ||||
subpotentReason | 0..* | CodeableConcept | 効力が減弱する理由 Binding: ImmunizationSubpotentReason (example): 用量がサブポテントと見なされる理由。 / The reason why a dose is considered to be subpotent. | |||||
education | C | 0..* | BackboneElement | 患者に提示された教材 imm-1: DocumentTypeまたは参照の1つが存在するものとします / One of documentType or reference SHALL be present | ||||
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 | ||||
documentType | 0..1 | string | 教育資料文書識別子 / Educational material document identifier | |||||
reference | 0..1 | uri | 教育資料の参照ポインター / Educational material reference pointer | |||||
publicationDate | 0..1 | dateTime | 教育資料の出版日 / Educational material publication date | |||||
presentationDate | 0..1 | dateTime | 教育資料の提示日 / Educational material presentation date | |||||
programEligibility | 0..* | CodeableConcept | ワクチン接種計画での患者適格性 Binding: ImmunizationProgramEligibility (example): 患者の予防接種プログラムの適格性。 / The patient's eligibility for a vaccation program. | |||||
fundingSource | 0..1 | CodeableConcept | ワクチン接種計画のの資金源 Binding: ImmunizationFundingSource (example): 投与されたワクチンの購入に使用される資金源。 / The source of funding used to purchase the vaccine administered. | |||||
reaction | 0..* | BackboneElement | 予防接種後に起こった反応についての詳細な記録 | |||||
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 | ||||
date | 0..1 | dateTime | 反応が始まったとき / When reaction started | |||||
detail | 0..1 | Reference(Observation) | 反応に関する追加情報 / Additional information on reaction | |||||
reported | 0..1 | boolean | 自己申告による反応を示します / Indicates self-reported reaction | |||||
protocolApplied | 0..* | BackboneElement | 提供者が実施したプロトコール | |||||
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 | ||||
series | 0..1 | string | ワクチンシリーズの名前 / Name of vaccine series | |||||
authority | 0..1 | Reference(Organization) | 推奨事項を公開する責任者は誰ですか / Who is responsible for publishing the recommendations | |||||
targetDisease | 0..* | CodeableConcept | ワクチン予防可能な病気が標的にされています / Vaccine preventatable disease being targetted Binding: ImmunizationTargetDiseaseCodes (example): ワクチン予防可能な疾患用量が投与されています。 / The vaccine preventable disease the dose is being administered for. | |||||
doseNumber[x] | 1..1 | シリーズ内の用量数 / Dose number within series | ||||||
doseNumberPositiveInt | positiveInt | |||||||
doseNumberString | string | |||||||
seriesDoses[x] | 0..1 | 免疫のために推奨される用量数 / Recommended number of doses for immunity | ||||||
seriesDosesPositiveInt | positiveInt | |||||||
seriesDosesString | string | |||||||
Documentation for this format |
Terminology Bindings
Path | Conformance | ValueSet | URI | |||
Immunization.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languages from the FHIR Standard | ||||
Immunization.status | required | ImmunizationStatusCodeshttp://hl7.org/fhir/ValueSet/immunization-status|4.0.1 from the FHIR Standard | ||||
Immunization.statusReason | example | ImmunizationStatusReasonCodeshttp://hl7.org/fhir/ValueSet/immunization-status-reason from the FHIR Standard | ||||
Immunization.vaccineCode | preferred | JP_MedicationCode_Immunization_VShttp://jpfhir.jp/fhir/core/ValueSet/JP_MedicationCode_Immunization_VS | ||||
Immunization.reportOrigin | example | ImmunizationOriginCodeshttp://hl7.org/fhir/ValueSet/immunization-origin from the FHIR Standard | ||||
Immunization.site | example | CodesForImmunizationSiteOfAdministrationhttp://hl7.org/fhir/ValueSet/immunization-site from the FHIR Standard | ||||
Immunization.route | example | ImmunizationRouteCodeshttp://hl7.org/fhir/ValueSet/immunization-route from the FHIR Standard | ||||
Immunization.performer.function | extensible | ImmunizationFunctionCodeshttp://hl7.org/fhir/ValueSet/immunization-function from the FHIR Standard | ||||
Immunization.reasonCode | example | ImmunizationReasonCodeshttp://hl7.org/fhir/ValueSet/immunization-reason from the FHIR Standard | ||||
Immunization.subpotentReason | example | ImmunizationSubpotentReasonhttp://hl7.org/fhir/ValueSet/immunization-subpotent-reason from the FHIR Standard | ||||
Immunization.programEligibility | example | ImmunizationProgramEligibilityhttp://hl7.org/fhir/ValueSet/immunization-program-eligibility from the FHIR Standard | ||||
Immunization.fundingSource | example | ImmunizationFundingSourcehttp://hl7.org/fhir/ValueSet/immunization-funding-source from the FHIR Standard | ||||
Immunization.protocolApplied.targetDisease | example | ImmunizationTargetDiseaseCodeshttp://hl7.org/fhir/ValueSet/immunization-target-disease from the FHIR Standard |
Constraints
Id | Grade | Path(s) | Details | Requirements |
dom-2 | error | Immunization | リソースが別のリソースに含まれている場合、ネストされたリソースを含めてはなりません / If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | error | Immunization | リソースが別のリソースに含まれている場合、それはリソースの他の場所から参照されるか、含有リソースを参照するものとします / 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 | Immunization | リソースが別のリソースに含まれている場合、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 | Immunization | 別のリソースにリソースが含まれている場合、セキュリティラベルはありません / If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | best practice | Immunization | リソースには、堅牢な管理のための叙述(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() | |
imm-1 | error | Immunization.education | DocumentTypeまたは参照の1つが存在するものとします / One of documentType or reference SHALL be present : documentType.exists() or reference.exists() | |
qty-3 | error | Immunization.doseQuantity | ユニットのコードが存在する場合、システムも存在するものとします / If a code for the unit is present, the system SHALL also be present : code.empty() or system.exists() | |
sqty-1 | error | Immunization.doseQuantity | コンパレータは、単純なQuantityで使用されません / The comparator is not used on a SimpleQuantity : comparator.empty() |
This structure is derived from Immunization
Summary
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Differential View
Snapshot View
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
Immunization | 0..* | Immunization | 予防接種 | |||||
id | Σ | 0..1 | id | このResourceに対する論理ID | ||||
meta | Σ | 0..1 | Meta | リソースに関するメタデータ / 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.
| |||||
text | 0..1 | Narrative | 人間の解釈のためのリソースのテキスト概要 / Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | インラインリソースが含まれています / Contained, inline Resources | |||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
dueDateOfNextDose | 0..1 | date | 次回接種予定日 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_DueDateOfNextDose | |||||
manufacturedDate | 0..1 | date | 製造年月日 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_ManufacturedDate | |||||
certificatedDate | 0..1 | date | 検定年月日 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_CertificatedDate | |||||
modifierExtension | ?! | 0..* | Extension | 無視できない拡張機能 / Extensions that cannot be ignored | ||||
identifier | 0..* | Identifier | ビジネス識別子 / Business identifier | |||||
status | ?!Σ | 1..1 | code | 完了|エラーに入った|まだ完成してない / completed | entered-in-error | not-done Binding: ImmunizationStatusCodes (required): 予防接種の現在の状態を表すコード | ||||
statusReason | 0..1 | CodeableConcept | 実施しなかった理由 Binding: ImmunizationStatusReasonCodes (example): ワクチンが投与されなかった理由。 / The reason why a vaccine was not administered. | |||||
vaccineCode | Σ | 1..1 | CodeableConcept | 接種されたワクチン製剤 Binding: JP Core MedicationCode Immunization ValueSet (preferred) | ||||
patient | Σ | 1..1 | Reference(JP Core Patient Profile) | 予防接種を受けた人 | ||||
encounter | 0..1 | Reference(JP Core Encounter Profile) | 予防接種を受けた診察 | |||||
occurrence[x] | Σ | 1..1 | ワクチンを接種した日時 | |||||
occurrenceDateTime | dateTime | |||||||
occurrenceString | string | |||||||
recorded | 0..1 | dateTime | 予防接種を受けた対象者の記録として最初に記載された日 | |||||
primarySource | Σ | 0..1 | boolean | データが記録されたコンテキストを示します / Indicates context the data was recorded in | ||||
reportOrigin | 0..1 | CodeableConcept | 二次的に報告された記録の発生源を示す Binding: ImmunizationOriginCodes (example): 主要なソースからのものではないレコードのデータのソース。 / The source of the data for a record which is not from a primary source. | |||||
location | 0..1 | Reference(JP Core Location Profile) | ワクチンを接種した場所 | |||||
manufacturer | 0..1 | Reference(JP Core Organization Profile) | ワクチンメーカー | |||||
lotNumber | 0..1 | string | ワクチンのロット番号 | |||||
expirationDate | 0..1 | date | ワクチンの使用期限 | |||||
site | 0..1 | CodeableConcept | ワクチンが接種された身体部位 Binding: CodesForImmunizationSiteOfAdministration (example): ワクチンが投与されたサイト。 / The site at which the vaccine was administered. | |||||
route | 0..1 | CodeableConcept | ワクチンを接種した経路 Binding: ImmunizationRouteCodes (example): ワクチンが投与されたルート。 / The route by which the vaccine was administered. | |||||
doseQuantity | C | 0..1 | JP_MedicationSimpleQuantity | ワクチンの投与量 qty-3: ユニットのコードが存在する場合、システムも存在するものとします / If a code for the unit is present, the system SHALL also be present sqty-1: コンパレータは、単純なQuantityで使用されません / The comparator is not used on a SimpleQuantity | ||||
performer | Σ | 0..* | BackboneElement | ワクチン接種を実施した人 | ||||
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 | ||||
function | Σ | 0..1 | CodeableConcept | どのような種類のパフォーマンスが行われました / What type of performance was done Binding: ImmunizationFunctionCodes (extensible): 予防接種イベントで開業医または組織が果たす役割。 / The role a practitioner or organization plays in the immunization event. | ||||
actor | Σ | 1..1 | Reference(JP Core Practitioner Profile | JP Core PractitionerRole Profile | JP Core Organization Profile) | 演奏していた個人または組織 / Individual or organization who was performing | ||||
note | Σ | 0..* | Annotation | 予防接種についての補足的記録 | ||||
reasonCode | 0..* | CodeableConcept | 予防接種を接種した理由 Binding: ImmunizationReasonCodes (example): ワクチンが投与された理由。 / The reason why a vaccine was administered. | |||||
reasonReference | 0..* | Reference(Condition | Observation | DiagnosticReport) | 予防接種を実施した理由 | |||||
isSubpotent | ?!Σ | 0..1 | boolean | 効力量 | ||||
subpotentReason | 0..* | CodeableConcept | 効力が減弱する理由 Binding: ImmunizationSubpotentReason (example): 用量がサブポテントと見なされる理由。 / The reason why a dose is considered to be subpotent. | |||||
education | C | 0..* | BackboneElement | 患者に提示された教材 imm-1: DocumentTypeまたは参照の1つが存在するものとします / One of documentType or reference SHALL be present | ||||
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 | ||||
documentType | 0..1 | string | 教育資料文書識別子 / Educational material document identifier | |||||
reference | 0..1 | uri | 教育資料の参照ポインター / Educational material reference pointer | |||||
publicationDate | 0..1 | dateTime | 教育資料の出版日 / Educational material publication date | |||||
presentationDate | 0..1 | dateTime | 教育資料の提示日 / Educational material presentation date | |||||
programEligibility | 0..* | CodeableConcept | ワクチン接種計画での患者適格性 Binding: ImmunizationProgramEligibility (example): 患者の予防接種プログラムの適格性。 / The patient's eligibility for a vaccation program. | |||||
fundingSource | 0..1 | CodeableConcept | ワクチン接種計画のの資金源 Binding: ImmunizationFundingSource (example): 投与されたワクチンの購入に使用される資金源。 / The source of funding used to purchase the vaccine administered. | |||||
reaction | 0..* | BackboneElement | 予防接種後に起こった反応についての詳細な記録 | |||||
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 | ||||
date | 0..1 | dateTime | 反応が始まったとき / When reaction started | |||||
detail | 0..1 | Reference(Observation) | 反応に関する追加情報 / Additional information on reaction | |||||
reported | 0..1 | boolean | 自己申告による反応を示します / Indicates self-reported reaction | |||||
protocolApplied | 0..* | BackboneElement | 提供者が実施したプロトコール | |||||
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 | ||||
series | 0..1 | string | ワクチンシリーズの名前 / Name of vaccine series | |||||
authority | 0..1 | Reference(Organization) | 推奨事項を公開する責任者は誰ですか / Who is responsible for publishing the recommendations | |||||
targetDisease | 0..* | CodeableConcept | ワクチン予防可能な病気が標的にされています / Vaccine preventatable disease being targetted Binding: ImmunizationTargetDiseaseCodes (example): ワクチン予防可能な疾患用量が投与されています。 / The vaccine preventable disease the dose is being administered for. | |||||
doseNumber[x] | 1..1 | シリーズ内の用量数 / Dose number within series | ||||||
doseNumberPositiveInt | positiveInt | |||||||
doseNumberString | string | |||||||
seriesDoses[x] | 0..1 | 免疫のために推奨される用量数 / Recommended number of doses for immunity | ||||||
seriesDosesPositiveInt | positiveInt | |||||||
seriesDosesString | string | |||||||
Documentation for this format |
Terminology Bindings
Path | Conformance | ValueSet | URI | |||
Immunization.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languages from the FHIR Standard | ||||
Immunization.status | required | ImmunizationStatusCodeshttp://hl7.org/fhir/ValueSet/immunization-status|4.0.1 from the FHIR Standard | ||||
Immunization.statusReason | example | ImmunizationStatusReasonCodeshttp://hl7.org/fhir/ValueSet/immunization-status-reason from the FHIR Standard | ||||
Immunization.vaccineCode | preferred | JP_MedicationCode_Immunization_VShttp://jpfhir.jp/fhir/core/ValueSet/JP_MedicationCode_Immunization_VS | ||||
Immunization.reportOrigin | example | ImmunizationOriginCodeshttp://hl7.org/fhir/ValueSet/immunization-origin from the FHIR Standard | ||||
Immunization.site | example | CodesForImmunizationSiteOfAdministrationhttp://hl7.org/fhir/ValueSet/immunization-site from the FHIR Standard | ||||
Immunization.route | example | ImmunizationRouteCodeshttp://hl7.org/fhir/ValueSet/immunization-route from the FHIR Standard | ||||
Immunization.performer.function | extensible | ImmunizationFunctionCodeshttp://hl7.org/fhir/ValueSet/immunization-function from the FHIR Standard | ||||
Immunization.reasonCode | example | ImmunizationReasonCodeshttp://hl7.org/fhir/ValueSet/immunization-reason from the FHIR Standard | ||||
Immunization.subpotentReason | example | ImmunizationSubpotentReasonhttp://hl7.org/fhir/ValueSet/immunization-subpotent-reason from the FHIR Standard | ||||
Immunization.programEligibility | example | ImmunizationProgramEligibilityhttp://hl7.org/fhir/ValueSet/immunization-program-eligibility from the FHIR Standard | ||||
Immunization.fundingSource | example | ImmunizationFundingSourcehttp://hl7.org/fhir/ValueSet/immunization-funding-source from the FHIR Standard | ||||
Immunization.protocolApplied.targetDisease | example | ImmunizationTargetDiseaseCodeshttp://hl7.org/fhir/ValueSet/immunization-target-disease from the FHIR Standard |
Constraints
Id | Grade | Path(s) | Details | Requirements |
dom-2 | error | Immunization | リソースが別のリソースに含まれている場合、ネストされたリソースを含めてはなりません / If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | error | Immunization | リソースが別のリソースに含まれている場合、それはリソースの他の場所から参照されるか、含有リソースを参照するものとします / 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 | Immunization | リソースが別のリソースに含まれている場合、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 | Immunization | 別のリソースにリソースが含まれている場合、セキュリティラベルはありません / If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | best practice | Immunization | リソースには、堅牢な管理のための叙述(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() | |
imm-1 | error | Immunization.education | DocumentTypeまたは参照の1つが存在するものとします / One of documentType or reference SHALL be present : documentType.exists() or reference.exists() | |
qty-3 | error | Immunization.doseQuantity | ユニットのコードが存在する場合、システムも存在するものとします / If a code for the unit is present, the system SHALL also be present : code.empty() or system.exists() | |
sqty-1 | error | Immunization.doseQuantity | コンパレータは、単純なQuantityで使用されません / The comparator is not used on a SimpleQuantity : comparator.empty() |
Other representations of profile: CSV, Excel, Schematron
JP Core Immunization リソースは、次の要素を持たなければならない。
JP Core Immunization リソースで使用される拡張は次の通りである。
拡張 | 説明 | 定義 | 値型 |
---|---|---|---|
DueDateOfNextDose | 次回接種予定日 | JP_Immunization_DueDateOfNextDose | dateTime |
ManufacturedDate | 製造年月日 | JP_Immunization_ManufacturedDate | dateTime |
CertificatedDate | 検定年月日 | JP_Immunization_CertificatedDate | dateTime |
既存のExtensionの利用はない。
HL7 FHIRの基底規格では、ワクチンコードとして CVX コードが使われているが、日本ではHOTコードやYJコードで一通り使用されているワクチンが定義されているため、国内で利用する際の用語集としては HOTコードとYJコードを採用した。それ以外の用語集の利用を妨げるものではない。
分類 | 名称 | URI |
---|---|---|
ワクチン | HOT9 | http://medis.or.jp/CodeSystem/master-HOT9 |
ワクチン | HOT13 | http://medis.or.jp/CodeSystem/master-HOT13 |
ワクチン | YJコード | http://capstandard.jp/CodeSystem/YJ-code |
対象疾患 | MEDIS標準病名マスター病名交換用コード | http://medis.or.jp/CodeSystem/master-disease-exCode |
参考にしたワクチン関係の文書やAPIで扱われている項目に合わせ、以下の項目を追加した。
コンフォーマンス | パラメータ | 型 | 例 |
---|---|---|---|
SHALL | identifier | token | GET [base]/Immunization?identifier=http://myhospital.com/fhir/immunization|1234567890 |
SHOULD | patient | reference | GET [base]/Immunization?patient=123456 |
SHOULD | patient,date | reference,date | GET [base]/Immunization?patient=123456&date=eq2013-01-14 |
MAY | date,lot-number | date,string | GET [base]/Immunization?date=eq2013-01-14 |
次の検索パラメータは必須でサポートされなければならない。
identifier 検索パラメータを使用して、オーダIDなどの識別子によるMedicationRequestの検索をサポートしなければならない(SHALL)
GET [base]/Immunization?identifier={system|}[code]
例:
GET [base]/Immunization?identifier=http://myhospital.com/fhir/medication|1234567890
指定された識別子に一致するImmunizationリソースを含むBundleを検索する。
次の検索パラメータをサポートすることが望ましい。
patient 検索パラメータを使用して、患者のリファレンス情報によるImmunizationの検索をサポートすることが望ましい(SHOULD)
GET [base]/Immunization?patient=[id]
GET [base]/Immunization?patient=[url]
例:
GET [base]/Immunization?patient=123456
リソースIDが123456の患者のImmunizationリソースを含むBundleを検索する。
patient,date 検索パラメータを使用して、患者のリファレンス情報と接種日によるImmunizationの検索をサポートすることが望ましい(SHOULD)
GET [base]/Immunization?patient=[id]&date=[date]
GET [base]/Immunization?patient=[url]&date=[date]
例:
GET [base]/Immunization?patient=123456&date=eq2013-01-14
リソースIDが123456の患者の2013-01-14に服用するImmunizationリソースを含むBundleを検索する。
JP Immunization リソースに対して使用される操作は次の通りである。
$everything:[base]/Immunization/[id]/$everything
この操作は、この操作が呼び出された特定のImmunizationリソースに関連する全ての情報を返す。応答は "searchset" タイプのBundleリソースである。サーバは、少なくとも、識別されたImmunizationコンパートメントに含まれる全てのリソースと、それらから参照されるすべてのリソースを返すことが望ましい。
この操作の公式なURLは以下である。
http://hl7.jp/fhir/OperationDefinition/Immunization-everything
URL: [base]/Immunization/[id]/$everything
本操作は、べき等な操作である。
名前 | 多重度 | 型 | 説明 |
---|---|---|---|
start | 0..1 | date | 特定の日付範囲で提供されたケアに関連する全ての記録を意味する。開始日が指定されていない場合、終了日以前のすべてのレコードが対象に含まれる。 |
end | 0..1 | date | 特定の日付範囲で提供されたケアに関連する全ての記録を意味する。終了日が指定されていない場合、開始日以降のすべてのレコードが対象に含まれる。 |
_since | 0..1 | instant | 指定された日時以降に更新されたリソースのみが応答に含まれる。 |
_type | 0..* | code | 応答に含むFHIRリソース型を、カンマ区切りで指定する。指定されない場合は、サーバは全てのリソース型を対象とする。 |
_count | 0..1 | integer | Bundleの1ページに含まれるリソース件数を指定。 |
名前 | 多重度 | 型 | 説明 |
---|---|---|---|
return | 1..1 | Bundle | バンドルのタイプは"searchset"である。この操作の結果は、リソースとして直接返される。 |
リクエスト:単一のImmunizationに関連する全てのリソースを取得する。
GET [base]/Immunization/1234567890/$everything
[some headers]
レスポンス:指定されたImmunizationに関連する全てのリソースを返す。
HTTP/1.1 200 OK
[other headers]
{
"resourceType": "Bundle",
"id": "example",
"meta": {
"lastUpdated": "2014-08-18T01:43:33Z"
},
"type": "searchset",
"entry": [
{
"fullUrl": "http://example.org/fhir/Immunization/1234567890",
"resource": {
"resourceType": "Immunization",
・・・
},
}
]
}
このワクチン接種例では下記の内容をFHIRで表現する場合について解説する。
項目名 | 項目値 | 備考 |
---|---|---|
接種ワクチン | コミナティ筋注 (182110901) | |
対象疾患 | COVID-19 (S9VN) | |
接種量 | 0.45mL | |
接種部位 | Left arm (LA) | |
接種実施者 | 大阪 一郎 | |
接種日時 | 2021/07/01 10:30 | |
ロット番号 | 12345678 |
Immunizationはワクチンを vaccineCodeとして1つまでしか持つことしかできないので、ワクチン単位でImmunizationリソースを作成する。
ワクチンの種類や製剤名は Immunization.vaccineCode要素にCodeableConcept型で記述する。ワクチンを識別するコードは、HOTコード(HOT13を推奨)ないしYJコードを使用する。
"vaccineCode": {
"coding": [
{
"system": "http://medis.or.jp/CodeSystem/master-HOT13",
"code": "1820201040101",
"display": "インフルエンザHAワクチン「第一三共」1mL"
}
]
}
ワクチンを接種した日は Immunization.occurrenceDateTime要素にdateTime型で記述する。日付での記述が難しい場合は、Immunization.occurrenceString要素にテキストで記述してもよい。
Immunization.occurrenceDateTime要素を使用した例:
"occurrenceDateTime": "2022-03-02"
Immunization.occurrenceString要素を使用した例:
"occurrenceString": "6才頃"
ワクチン接種の情報を記録した日時は Immunization.recorded要素にdateTime型で記述する。
"recorded": "2022-03-02T10:45:23+09:00"
ワクチンの接種場所は Immunization.location要素にReference型でLocationリソースの参照情報を記述する。
"location" : {
"reference" : "Location/1234"
}
ワクチンの製造会社は Immunization.manufacturer要素にReference型でOrganizationリソースの参照情報を記述する。
"manufacturer" : {
"reference" : "Organization/1234"
}
ワクチンのロット番号は Immunization.lotNumber要素にstring型で記述する。
"lotNumber" : "FF3620"
ワクチンの接種部位は Immunization.site要素に CodeableConcept型で記述する。部位を識別するコードにはJAMI処方・注射オーダ標準用法規格(外用部位コード) を推奨する
"site": {
"coding": [
{
"system": "http://jami.jp/CodeSystem/MedicationBodySiteExternal"
"code": "74L",
"display": "左上腕"
}
]
}
ワクチンの接種量は Immunization.doseQuantity要素にSimpleQuantity型で記述する。全体の容量をUCUM("http://unitsofmeasure.org")を使用してmL単位で指定する。
"doseQuantity": {
"value": 1,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
ワクチンの接種実施者 Immunization.performer.actor要素にReference型でPractitionerリソースの参照情報を記述する。Immunization.performer.functionにはValueSet "http://hl7.org/fhir/ValueSet/immunization-function"から"AP" (Administering Provider)を指定する。
"performer": [
{
"function": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0443",
"code": "AP",
"display": "Administering Provider"
}
]
},
"actor": {
"reference": "Practitioner/1234"
}
}
]
ワクチン接種を行わなかった理由を記述したい場合は、Immunization.reasonCode要素にCodeableConcept型で記述する。適当な標準コードが整備されていないため、ローカルコードを定義するか、CodeableConcept.text要素にテキストとして記述する。
"reasonCode": [
{
"text": "37.5℃以上の発熱があったため。"
}
]
ワクチン接種により感染や重症化を予防できる疾患(記録によっては「予防接種の種類」と呼ばれることもある)は、Immunization.protocolApplied.targetDisease要素にCodeableConcept型で記述する。使用する用語集としては、「診療情報提供書HL7FHIR記述仕様 第1版」などでも採用されている MEDIS標準病名マスターの病名交換用コード("http://medis.or.jp/CodeSystem/master-disease-exCode")を推奨する。
"protocolApplied": [
{
"targetDisease": [
{
"coding": [
{
"system": "http://medis.or.jp/CodeSystem/master-disease-exCode",
"code": "ES0L",
"display": "インフルエンザ"
}
]
}
]
}
]
ワクチン接種の回数はImmunization.protocolApplied.doseNumberPositiveInt要素にpositiveInt型で記述する。
"protocolApplied": [
{
"doseNumberPositiveInt": 2
}
]
次回のワクチン接種予定日は既存のImmunization要素では記述ができないため、Immunizationリソースに対する拡張「DueDateOfNextDose」を使用してdate型で記述する。extension.urlには"http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_DueDateOfNextDose"を指定する。
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_DueDateOfNextDose",
"valueDate": "2022-04-02"
}
]
ワクチンの製造年月日、検定年月日はいずれも既存のImmunization要素では記述ができないため、Immunizationリソースに対する拡張「ManufacturedDate」「CertificatedDate」をそれぞれ使用してdate型で記述する。extension.urlにはそれぞれ"http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_ManufacturedDate"、"http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_CertificatedDate"を指定する。
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_ManufacturedDate",
"valueDate": "2021-10-14"
},
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Immunization_CertificatedDate",
"valueDate": "2021-10-18"
}
]