HL7 FHIR JP Core ImplementationGuide
1.1.1 - ci-build
HL7 FHIR JP Core ImplementationGuide - Local Development build (v1.1.1). See the Directory of published versions
項目 | 内容 |
定義URL | http://jpfhir.jp/fhir/core/StructureDefinition/JP_MedicationAdministration_Injection |
Version | 1.1.1 |
Name | JP_MedicationAdministration_Injection |
Title | JP Core MedicationAdministration Injection Profile |
Status | Active ( 2022-10-24 ) |
Copyright | Copyright FHIR Japanese implementation research working group in Japan Association of Medical Informatics (JAMI) 一般社団法人日本医療情報学会NeXEHRS課題研究会FHIR日本実装検討WG |
このプロファイルはMedicationAdministrationリソースに対して、注射薬剤処方投与実施情報のデータを送受信するための基礎となる制約と拡張を定めたものである。
このResource/Profileは注射の薬剤処方の投与実施情報を表現する。薬剤処方は指示する項目、使用する用語集、プロセスなどにおいて諸外国と日本では異なっており、日本国内で規格を運用するためにExtensionの追加や用語集の追加・変更を行った。現在、日本での注射関連規格として利用されている JAHIS注射データ交換規約Ver.2.1C を参考にした。
本プロファイルは、以下のようなユースケースを想定している。
このProfileの対象は注射の一般的な薬剤処方の投与実施情報を電子的に連携するためのメッセージを記述することである。
このProfileは注射の薬剤に関するものであり、内服・外用薬剤については対象としない。内服・外用薬剤は、指示の仕方や指示する項目が注射とは大きく異なるため、別のProfileとして記述することとする。
また、このリソースは薬剤の投与実施に関するものであり、指示(オーダ)、調剤や払い出しは対象としない。それぞれ、MedicationRequest、MedicationDispense が対応するリソースである。
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from JP_MedicationAdministrationBase
Summary
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MedicationAdministration | 0..* | JP_MedicationAdministrationBase | 患者への注射薬剤投与記録 | |||||
id | Σ | 0..1 | id | このアーティファクトの論理ID | ||||
meta | Σ | 0..1 | Meta | 「リソースに関するメタデータ」 | ||||
implicitRules | ?!Σ | 0..1 | uri | このコンテンツが作成されたルールセット | ||||
language | 0..1 | code | 「リソースコンテンツの言語」(Risōsukontentsu no gengo) Binding: CommonLanguages (preferred): 「人間の言語。」(Ningen no gengo.)
| |||||
text | 0..1 | Narrative | 「人間の解釈のためのリソースのテキスト要約」 | |||||
contained | 0..* | Resource | 「含まれている、インラインのリソース」(Fukuma rete iru, inrain no risōsu) | |||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
requestDepartment | 0..1 | CodeableConcept | 依頼科 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_RequestDepartment Binding: JP Core Department SS-MIX ValueSet (preferred) | |||||
requestAuthoredOn | 0..1 | dateTime | 依頼日時 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_RequestAuthoredOn | |||||
location | 0..1 | Reference(JP Core Location Profile) | 実施場所 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_Location | |||||
requester | 0..* | Reference(JP Core Practitioner Profile) | 依頼医 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_Requester | |||||
uncategorizedComment | 0..* | CodeableConcept | 未分類コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_UncategorizedComment Binding: JP Core MedicationAdministration Example Uncategorized Comment ValueSet (example) | |||||
modifierExtension | ?! | 0..* | Extension | 無視できない拡張機能 (Mushi dekinai kakuchou kinou) | ||||
Slices for identifier | 1..* | Identifier | 外部から参照されるID Slice: Unordered, Open by value:system | |||||
identifier:rpNumber | 1..1 | Identifier | 処方箋内部の剤グループとしてのRp番号 | |||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
use | ?!Σ | 0..1 | code | 通常|公式|温度|セカンダリ|古い(知られている場合) / usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): 既知の場合、この識別子の目的を識別します。 / Identifies the purpose for this identifier, if known . | ||||
type | Σ | 0..1 | CodeableConcept | 識別子の説明 / Description of identifier Binding: Identifier Type Codes (extensible): 特定の目的に使用する識別子を決定するために使用できる識別子のコード化されたタイプ。 / A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
system | Σ | 1..1 | uri | Rp番号(剤グループ番号)についてのsystem値 Fixed Value: urn:oid:1.2.392.100495.20.3.81 | ||||
value | Σ | 1..1 | string | Rp番号(剤グループ番号) Example General: 123456 | ||||
period | Σ | 0..1 | Period | IDが使用に有効だった時間期間 / Time period when id is/was valid for use | ||||
assigner | Σ | 0..1 | Reference(Organization) | IDを発行した組織(単なるテキストである可能性があります) / Organization that issued id (may be just text) | ||||
identifier:requestIdentifier | 0..* | Identifier | 処方オーダに対するID(MedicationRequestからの継承) | |||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
use | ?!Σ | 0..1 | code | 通常|公式|温度|セカンダリ|古い(知られている場合) / usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): 既知の場合、この識別子の目的を識別します。 / Identifies the purpose for this identifier, if known . | ||||
type | Σ | 0..1 | CodeableConcept | 識別子の説明 / Description of identifier Binding: Identifier Type Codes (extensible): 特定の目的に使用する識別子を決定するために使用できる識別子のコード化されたタイプ。 / A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
system | Σ | 1..1 | uri | 識別子値の名前空間 / The namespace for the identifier value Fixed Value: http://jpfhir.jp/fhir/core/IdSystem/resourceInstance-identifier | ||||
value | Σ | 1..1 | string | 一意の値 / The value that is unique Example General: 123456 | ||||
period | Σ | 0..1 | Period | IDが使用に有効だった時間期間 / Time period when id is/was valid for use | ||||
assigner | Σ | 0..1 | Reference(Organization) | IDを発行した組織(単なるテキストである可能性があります) / Organization that issued id (may be just text) | ||||
instantiates | Σ | 0..* | uri | Instantiates protocol or definition プロトコルや定義のインスタンス化 | ||||
partOf | Σ | 0..* | Reference(MedicationAdministration | Procedure) | Part of referenced event 親イベントへの参照 | ||||
status | ?!Σ | 1..1 | code | completed | stopped Binding: MedicationAdministration Status Codes (required): 患者への投与状況 | ||||
statusReason | 0..* | CodeableConcept | Reason administration not performed 実施されていない理由 Binding: SNOMEDCTReasonMedicationNotGivenCodes (example): "医薬品投与が取り消された理由を示すコードのセット" | |||||
category | 0..1 | CodeableConcept | Type of medication usage 薬が使用される区分 Binding: MedicationAdministration Category Codes (preferred): 薬剤の投与が予想される場所を記述するコード化された概念。 | |||||
medication[x] | Σ | 1..1 | Reference(JP Core Medication Profile) | What medication was supplied 医薬品 | ||||
subject | Σ | 1..1 | Reference(JP Core Patient Profile) | Who received medication 投与対象患者 | ||||
context | 0..1 | Reference(JP Core Encounter Profile | EpisodeOfCare) | Encounter or Episode of Care administered as part of Encounter、または一部として実施されるケアエピソード | |||||
supportingInformation | 0..* | Reference(Resource) | Additional information to support administration 投与をサポートする追加情報 | |||||
effective[x] | Σ | 1..1 | Start and end time of administration 開始時間と終了時間 | |||||
effectiveDateTime | dateTime | |||||||
effectivePeriod | Period | |||||||
performer | Σ | 0..* | BackboneElement | Who performed the medication administration and what they did 投薬を実施した人 | ||||
id | 0..1 | string | エレメント相互参照のためのユニークID | |||||
extension | 0..* | Extension | 実装によって定義される追加コンテンツ | |||||
modifierExtension | ?!Σ | 0..* | Extension | 「認識されなくても無視できない拡張機能」(Ninshiki sarenakutemo mushi dekinai kakuchou kinou) | ||||
function | 0..1 | CodeableConcept | 「パフォーマンスの種類」(Pafōmansu no shurui) Binding: MedicationAdministration Performer Function Codes (example): 「薬物管理を行った個人の役割を説明するコード」 | |||||
actor | Σ | 1..1 | Reference(JP Core Practitioner Profile | JP Core PractitionerRole Profile | JP Core Patient Profile | RelatedPerson | Device) | 「薬剤投与を行ったのは誰ですか?」(Yakuzaiteiyogyou o okonatta no wa dare desu ka?) | ||||
reasonCode | 0..* | CodeableConcept | Reason administration performed 投薬が実施された理由 Binding: ReasonMedicationGivenCodes (example): 「薬剤投与が行われた理由を示すコードのセット。」 | |||||
reasonReference | 0..* | Reference(JP Core Condition Profile | JP Core Observation Common Profile | JP Core DiagnosticReport Common Profile) | Condition or observation that supports why the medication was administered 薬が投与された理由を裏付ける状態または観察 | |||||
request | 0..1 | Reference(MedicationRequest) | Request administration performed against 実施された元の投与依頼情報 | |||||
device | 0..* | Reference(Device) | Device used to administer 投与に使用されるデバイス | |||||
note | 0..* | Annotation | Information about the administration 投与に関する備考情報 | |||||
dosage | C | 0..1 | BackboneElement | Details of how medication was taken 薬の服用方法の詳細 | ||||
id | 0..1 | string | エレメント相互参照のためのユニークID | |||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
dosageComment | 0..* | CodeableConcept | 用法コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_DosageComment Binding: JP Core Medication Example DosageComment ValueSet (example) | |||||
device | 0..* | Reference(Device) | 投与装置 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_Device | |||||
line | 0..* | CodeableConcept | 指示ライン URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_Line | |||||
lineComment | 0..* | CodeableConcept | ラインコメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_LineComment Binding: JP Core Medication Example LineComment ValueSet (example) | |||||
rateComment | 0..* | CodeableConcept | 投与速度コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_RateComment Binding: JP Core Medication Example RateComment ValueSet (example) | |||||
modifierExtension | ?!Σ | 0..* | Extension | 「認識されなくても無視できない拡張機能」(Ninshiki sarenakutemo mushi dekinai kakuchou kinou) | ||||
text | 0..1 | string | Free text dosage instructions e.g. SIG フリーテキストの投与方法の説明 SIG:用法 | |||||
site | 0..1 | CodeableConcept | Body site administered to 投与部位 Binding: JP Core Medication JAMI External Body Site ValueSet (preferred) | |||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
Slices for extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
bodySite | 0..* | Reference(BodyStructure) | ターゲットの解剖学的位置または構造 URL: http://hl7.org/fhir/StructureDefinition/bodySite | |||||
siteComment | 0..* | CodeableConcept | 投与部位コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_SiteComment Binding: JP Core Medication Example SiteComment ValueSet (example) | |||||
coding | Σ | 0..* | Coding | 用語システムによって定義されたコード / Code defined by a terminology system | ||||
text | Σ | 0..1 | string | コンセプトの単純なテキスト表現 / Plain text representation of the concept | ||||
route | 0..1 | CodeableConcept | Path of substance into body 体への投与経路 Binding: JP Core Medication HL70162-based Route ValueSet (preferred) | |||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
Slices for extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
routeComment | 0..* | CodeableConcept | 投与経路コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_RouteComment Binding: JP Core Medication Example RouteComment ValueSet (example) | |||||
coding | Σ | 0..* | Coding | 用語システムによって定義されたコード / Code defined by a terminology system | ||||
text | Σ | 0..1 | string | コンセプトの単純なテキスト表現 / Plain text representation of the concept | ||||
method | 0..1 | CodeableConcept | 投与方法 Binding: SNOMEDCTAdministrationMethodCodes (example): 「薬剤が投与される方法を記述する暗号化された概念。」 | |||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
Slices for extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
methodComment | 0..* | CodeableConcept | 手技コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_MethodComment Binding: JP Core Medication Example MethodComment ValueSet (example) | |||||
Slices for coding | Σ | 0..* | Coding | 用語システムによって定義されたコード / Code defined by a terminology system Slice: Unordered, Open by value:system | ||||
coding:unitDigit1 | Σ | 0..1 | Coding | 投与⽅法に対応するJAMI 用法コード表基本用法1桁コード Binding: JP Core Medication JAMI Basic Usage Type ValueSet (preferred) | ||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
system | Σ | 1..1 | uri | 用語システムのアイデンティティ / Identity of the terminology system Fixed Value: urn:oid:1.2.392.200250.2.2.20.30 | ||||
version | Σ | 0..1 | string | システムのバージョン - 関連する場合 / Version of the system - if relevant | ||||
code | Σ | 0..1 | code | システムによって定義された構文のシンボル / Symbol in syntax defined by the system | ||||
display | Σ | 0..1 | string | システムによって定義された表現 / Representation defined by the system | ||||
userSelected | Σ | 0..1 | boolean | このコーディングがユーザーによって直接選択された場合 / If this coding was chosen directly by the user | ||||
coding:unitDigit2 | Σ | 0..1 | Coding | 投与⽅法に対応するJAMI 用法コード表基本用法2桁コード Binding: JP Core Medication JAMI Detail Usage ValueSet (preferred) | ||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
system | Σ | 1..1 | uri | 用語システムのアイデンティティ / Identity of the terminology system Fixed Value: urn:oid:1.2.392.200250.2.2.20.40 | ||||
version | Σ | 0..1 | string | システムのバージョン - 関連する場合 / Version of the system - if relevant | ||||
code | Σ | 0..1 | code | システムによって定義された構文のシンボル / Symbol in syntax defined by the system | ||||
display | Σ | 0..1 | string | システムによって定義された表現 / Representation defined by the system | ||||
userSelected | Σ | 0..1 | boolean | このコーディングがユーザーによって直接選択された場合 / If this coding was chosen directly by the user | ||||
text | Σ | 0..1 | string | 投与⽅法のテキスト表現 | ||||
dose | C | 0..1 | JP_MedicationSimpleQuantity | Amount of medication per dose 用量あたりの投薬量 | ||||
Slices for rate[x] | 0..1 | Dose quantity per unit of time 単位時間あたりの用量 Slice: Unordered, Closed by type:$this | ||||||
rateRatio | Ratio | |||||||
rateQuantity | Quantity(SimpleQuantity) | |||||||
rate[x]:rateRatio | C | 0..1 | JP_MedicationRatio_DosePerPeriod | 単位時間内での薬剤の容量 | ||||
rate[x]:rateQuantity | C | 0..1 | SimpleQuantity | 投与速度(流量)を指定する単位は流量を表す単位(e.g. 量/時間)を指定する | ||||
eventHistory | 0..* | Reference(Provenance) | A list of events of interest in the lifecycle ライフサイクルで関心のあるイベントのリスト | |||||
Documentation for this format |
Terminology Bindings
Path | Conformance | ValueSet | ||||
MedicationAdministration.language | preferred | CommonLanguages
| ||||
MedicationAdministration.identifier:rpNumber.use | required | IdentifierUse | ||||
MedicationAdministration.identifier:rpNumber.type | extensible | Identifier Type Codes | ||||
MedicationAdministration.identifier:requestIdentifier.use | required | IdentifierUse | ||||
MedicationAdministration.identifier:requestIdentifier.type | extensible | Identifier Type Codes | ||||
MedicationAdministration.status | required | MedicationAdministration Status Codes | ||||
MedicationAdministration.statusReason | example | SNOMEDCTReasonMedicationNotGivenCodes | ||||
MedicationAdministration.category | preferred | MedicationAdministration Category Codes | ||||
MedicationAdministration.performer.function | example | MedicationAdministration Performer Function Codes | ||||
MedicationAdministration.reasonCode | example | ReasonMedicationGivenCodes | ||||
MedicationAdministration.dosage.site | preferred | JP_MedicationBodySiteJAMIExternal_VS (a valid code from urn:oid:1.2.392.200250.2.2.20.32 ) | ||||
MedicationAdministration.dosage.route | preferred | JP_MedicationRouteHL70162_VS (a valid code from http://jpfhir.jp/fhir/core/CodeSystem/route-codes ) | ||||
MedicationAdministration.dosage.method | example | SNOMEDCTAdministrationMethodCodes | ||||
MedicationAdministration.dosage.method.coding:unitDigit1 | preferred | JP_MedicationMethodJAMIBasicUsage_VS (a valid code from urn:oid:1.2.392.200250.2.2.20.30 ) | ||||
MedicationAdministration.dosage.method.coding:unitDigit2 | preferred | JP_MedicationMethodJAMIDetailUsage_VS (a valid code from urn:oid:1.2.392.200250.2.2.20.40 ) |
Constraints
Id | Grade | Path(s) | Details | Requirements |
ele-1 | error | **ALL** elements | すべてのFHIR要素は、@valueまたはchildrenを持っている必要があります。 : hasValue() or (children().count() > id.count()) | |
ext-1 | error | **ALL** extensions | 「拡張機能または値[x]のいずれかが必要です。両方ではありません。」 : extension.exists() != value.exists() | |
mad-1 | error | MedicationAdministration.dosage | 「用量、投与回数、投与速度[x] のうち少なくとも1つを有するものとする」と訳すことができます。 : dose.exists() or rate.exists() | |
qty-3 | error | MedicationAdministration.dosage.dose, MedicationAdministration.dosage.rate[x]:rateQuantity | ユニットのコードが存在する場合、システムも存在するものとします / If a code for the unit is present, the system SHALL also be present : code.empty() or system.exists() | |
rat-1 | error | MedicationAdministration.dosage.rate[x]:rateRatio | 分子と分母の両方が存在するか、両方が存在します。両方が欠席している場合、いくつかの拡張が存在するものとします / Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present : (numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists()) | |
sqty-1 | error | MedicationAdministration.dosage.dose | コンパレータは、単純なQuantityで使用されません / The comparator is not used on a SimpleQuantity : comparator.empty() | |
sqty-1 | error | MedicationAdministration.dosage.rate[x]:rateQuantity | コンパレータは、単純なQuantityで使用されません / The comparator is not used on a SimpleQuantity : comparator.empty() |
This structure is derived from JP_MedicationAdministrationBase
Summary
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
Differential View
Snapshot View
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MedicationAdministration | 0..* | JP_MedicationAdministrationBase | 患者への注射薬剤投与記録 | |||||
id | Σ | 0..1 | id | このアーティファクトの論理ID | ||||
meta | Σ | 0..1 | Meta | 「リソースに関するメタデータ」 | ||||
implicitRules | ?!Σ | 0..1 | uri | このコンテンツが作成されたルールセット | ||||
language | 0..1 | code | 「リソースコンテンツの言語」(Risōsukontentsu no gengo) Binding: CommonLanguages (preferred): 「人間の言語。」(Ningen no gengo.)
| |||||
text | 0..1 | Narrative | 「人間の解釈のためのリソースのテキスト要約」 | |||||
contained | 0..* | Resource | 「含まれている、インラインのリソース」(Fukuma rete iru, inrain no risōsu) | |||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
requestDepartment | 0..1 | CodeableConcept | 依頼科 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_RequestDepartment Binding: JP Core Department SS-MIX ValueSet (preferred) | |||||
requestAuthoredOn | 0..1 | dateTime | 依頼日時 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_RequestAuthoredOn | |||||
location | 0..1 | Reference(JP Core Location Profile) | 実施場所 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_Location | |||||
requester | 0..* | Reference(JP Core Practitioner Profile) | 依頼医 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_Requester | |||||
uncategorizedComment | 0..* | CodeableConcept | 未分類コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_UncategorizedComment Binding: JP Core MedicationAdministration Example Uncategorized Comment ValueSet (example) | |||||
modifierExtension | ?! | 0..* | Extension | 無視できない拡張機能 (Mushi dekinai kakuchou kinou) | ||||
Slices for identifier | 1..* | Identifier | 外部から参照されるID Slice: Unordered, Open by value:system | |||||
identifier:rpNumber | 1..1 | Identifier | 処方箋内部の剤グループとしてのRp番号 | |||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
use | ?!Σ | 0..1 | code | 通常|公式|温度|セカンダリ|古い(知られている場合) / usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): 既知の場合、この識別子の目的を識別します。 / Identifies the purpose for this identifier, if known . | ||||
type | Σ | 0..1 | CodeableConcept | 識別子の説明 / Description of identifier Binding: Identifier Type Codes (extensible): 特定の目的に使用する識別子を決定するために使用できる識別子のコード化されたタイプ。 / A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
system | Σ | 1..1 | uri | Rp番号(剤グループ番号)についてのsystem値 Fixed Value: urn:oid:1.2.392.100495.20.3.81 | ||||
value | Σ | 1..1 | string | Rp番号(剤グループ番号) Example General: 123456 | ||||
period | Σ | 0..1 | Period | IDが使用に有効だった時間期間 / Time period when id is/was valid for use | ||||
assigner | Σ | 0..1 | Reference(Organization) | IDを発行した組織(単なるテキストである可能性があります) / Organization that issued id (may be just text) | ||||
identifier:requestIdentifier | 0..* | Identifier | 処方オーダに対するID(MedicationRequestからの継承) | |||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
use | ?!Σ | 0..1 | code | 通常|公式|温度|セカンダリ|古い(知られている場合) / usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): 既知の場合、この識別子の目的を識別します。 / Identifies the purpose for this identifier, if known . | ||||
type | Σ | 0..1 | CodeableConcept | 識別子の説明 / Description of identifier Binding: Identifier Type Codes (extensible): 特定の目的に使用する識別子を決定するために使用できる識別子のコード化されたタイプ。 / A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | ||||
system | Σ | 1..1 | uri | 識別子値の名前空間 / The namespace for the identifier value Fixed Value: http://jpfhir.jp/fhir/core/IdSystem/resourceInstance-identifier | ||||
value | Σ | 1..1 | string | 一意の値 / The value that is unique Example General: 123456 | ||||
period | Σ | 0..1 | Period | IDが使用に有効だった時間期間 / Time period when id is/was valid for use | ||||
assigner | Σ | 0..1 | Reference(Organization) | IDを発行した組織(単なるテキストである可能性があります) / Organization that issued id (may be just text) | ||||
instantiates | Σ | 0..* | uri | Instantiates protocol or definition プロトコルや定義のインスタンス化 | ||||
partOf | Σ | 0..* | Reference(MedicationAdministration | Procedure) | Part of referenced event 親イベントへの参照 | ||||
status | ?!Σ | 1..1 | code | completed | stopped Binding: MedicationAdministration Status Codes (required): 患者への投与状況 | ||||
statusReason | 0..* | CodeableConcept | Reason administration not performed 実施されていない理由 Binding: SNOMEDCTReasonMedicationNotGivenCodes (example): "医薬品投与が取り消された理由を示すコードのセット" | |||||
category | 0..1 | CodeableConcept | Type of medication usage 薬が使用される区分 Binding: MedicationAdministration Category Codes (preferred): 薬剤の投与が予想される場所を記述するコード化された概念。 | |||||
medication[x] | Σ | 1..1 | Reference(JP Core Medication Profile) | What medication was supplied 医薬品 | ||||
subject | Σ | 1..1 | Reference(JP Core Patient Profile) | Who received medication 投与対象患者 | ||||
context | 0..1 | Reference(JP Core Encounter Profile | EpisodeOfCare) | Encounter or Episode of Care administered as part of Encounter、または一部として実施されるケアエピソード | |||||
supportingInformation | 0..* | Reference(Resource) | Additional information to support administration 投与をサポートする追加情報 | |||||
effective[x] | Σ | 1..1 | Start and end time of administration 開始時間と終了時間 | |||||
effectiveDateTime | dateTime | |||||||
effectivePeriod | Period | |||||||
performer | Σ | 0..* | BackboneElement | Who performed the medication administration and what they did 投薬を実施した人 | ||||
id | 0..1 | string | エレメント相互参照のためのユニークID | |||||
extension | 0..* | Extension | 実装によって定義される追加コンテンツ | |||||
modifierExtension | ?!Σ | 0..* | Extension | 「認識されなくても無視できない拡張機能」(Ninshiki sarenakutemo mushi dekinai kakuchou kinou) | ||||
function | 0..1 | CodeableConcept | 「パフォーマンスの種類」(Pafōmansu no shurui) Binding: MedicationAdministration Performer Function Codes (example): 「薬物管理を行った個人の役割を説明するコード」 | |||||
actor | Σ | 1..1 | Reference(JP Core Practitioner Profile | JP Core PractitionerRole Profile | JP Core Patient Profile | RelatedPerson | Device) | 「薬剤投与を行ったのは誰ですか?」(Yakuzaiteiyogyou o okonatta no wa dare desu ka?) | ||||
reasonCode | 0..* | CodeableConcept | Reason administration performed 投薬が実施された理由 Binding: ReasonMedicationGivenCodes (example): 「薬剤投与が行われた理由を示すコードのセット。」 | |||||
reasonReference | 0..* | Reference(JP Core Condition Profile | JP Core Observation Common Profile | JP Core DiagnosticReport Common Profile) | Condition or observation that supports why the medication was administered 薬が投与された理由を裏付ける状態または観察 | |||||
request | 0..1 | Reference(MedicationRequest) | Request administration performed against 実施された元の投与依頼情報 | |||||
device | 0..* | Reference(Device) | Device used to administer 投与に使用されるデバイス | |||||
note | 0..* | Annotation | Information about the administration 投与に関する備考情報 | |||||
dosage | C | 0..1 | BackboneElement | Details of how medication was taken 薬の服用方法の詳細 | ||||
id | 0..1 | string | エレメント相互参照のためのユニークID | |||||
Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
dosageComment | 0..* | CodeableConcept | 用法コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_DosageComment Binding: JP Core Medication Example DosageComment ValueSet (example) | |||||
device | 0..* | Reference(Device) | 投与装置 URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_Device | |||||
line | 0..* | CodeableConcept | 指示ライン URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_Line | |||||
lineComment | 0..* | CodeableConcept | ラインコメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_LineComment Binding: JP Core Medication Example LineComment ValueSet (example) | |||||
rateComment | 0..* | CodeableConcept | 投与速度コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_RateComment Binding: JP Core Medication Example RateComment ValueSet (example) | |||||
modifierExtension | ?!Σ | 0..* | Extension | 「認識されなくても無視できない拡張機能」(Ninshiki sarenakutemo mushi dekinai kakuchou kinou) | ||||
text | 0..1 | string | Free text dosage instructions e.g. SIG フリーテキストの投与方法の説明 SIG:用法 | |||||
site | 0..1 | CodeableConcept | Body site administered to 投与部位 Binding: JP Core Medication JAMI External Body Site ValueSet (preferred) | |||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
Slices for extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
bodySite | 0..* | Reference(BodyStructure) | ターゲットの解剖学的位置または構造 URL: http://hl7.org/fhir/StructureDefinition/bodySite | |||||
siteComment | 0..* | CodeableConcept | 投与部位コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_SiteComment Binding: JP Core Medication Example SiteComment ValueSet (example) | |||||
coding | Σ | 0..* | Coding | 用語システムによって定義されたコード / Code defined by a terminology system | ||||
text | Σ | 0..1 | string | コンセプトの単純なテキスト表現 / Plain text representation of the concept | ||||
route | 0..1 | CodeableConcept | Path of substance into body 体への投与経路 Binding: JP Core Medication HL70162-based Route ValueSet (preferred) | |||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
Slices for extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
routeComment | 0..* | CodeableConcept | 投与経路コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_RouteComment Binding: JP Core Medication Example RouteComment ValueSet (example) | |||||
coding | Σ | 0..* | Coding | 用語システムによって定義されたコード / Code defined by a terminology system | ||||
text | Σ | 0..1 | string | コンセプトの単純なテキスト表現 / Plain text representation of the concept | ||||
method | 0..1 | CodeableConcept | 投与方法 Binding: SNOMEDCTAdministrationMethodCodes (example): 「薬剤が投与される方法を記述する暗号化された概念。」 | |||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
Slices for extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
methodComment | 0..* | CodeableConcept | 手技コメント URL: http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_MethodComment Binding: JP Core Medication Example MethodComment ValueSet (example) | |||||
Slices for coding | Σ | 0..* | Coding | 用語システムによって定義されたコード / Code defined by a terminology system Slice: Unordered, Open by value:system | ||||
coding:unitDigit1 | Σ | 0..1 | Coding | 投与⽅法に対応するJAMI 用法コード表基本用法1桁コード Binding: JP Core Medication JAMI Basic Usage Type ValueSet (preferred) | ||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
system | Σ | 1..1 | uri | 用語システムのアイデンティティ / Identity of the terminology system Fixed Value: urn:oid:1.2.392.200250.2.2.20.30 | ||||
version | Σ | 0..1 | string | システムのバージョン - 関連する場合 / Version of the system - if relevant | ||||
code | Σ | 0..1 | code | システムによって定義された構文のシンボル / Symbol in syntax defined by the system | ||||
display | Σ | 0..1 | string | システムによって定義された表現 / Representation defined by the system | ||||
userSelected | Σ | 0..1 | boolean | このコーディングがユーザーによって直接選択された場合 / If this coding was chosen directly by the user | ||||
coding:unitDigit2 | Σ | 0..1 | Coding | 投与⽅法に対応するJAMI 用法コード表基本用法2桁コード Binding: JP Core Medication JAMI Detail Usage ValueSet (preferred) | ||||
id | 0..1 | string | 要素間参照のための一意のID / Unique id for inter-element referencing | |||||
extension | 0..* | Extension | 実装で定義された追加のコンテンツ / Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
system | Σ | 1..1 | uri | 用語システムのアイデンティティ / Identity of the terminology system Fixed Value: urn:oid:1.2.392.200250.2.2.20.40 | ||||
version | Σ | 0..1 | string | システムのバージョン - 関連する場合 / Version of the system - if relevant | ||||
code | Σ | 0..1 | code | システムによって定義された構文のシンボル / Symbol in syntax defined by the system | ||||
display | Σ | 0..1 | string | システムによって定義された表現 / Representation defined by the system | ||||
userSelected | Σ | 0..1 | boolean | このコーディングがユーザーによって直接選択された場合 / If this coding was chosen directly by the user | ||||
text | Σ | 0..1 | string | 投与⽅法のテキスト表現 | ||||
dose | C | 0..1 | JP_MedicationSimpleQuantity | Amount of medication per dose 用量あたりの投薬量 | ||||
Slices for rate[x] | 0..1 | Dose quantity per unit of time 単位時間あたりの用量 Slice: Unordered, Closed by type:$this | ||||||
rateRatio | Ratio | |||||||
rateQuantity | Quantity(SimpleQuantity) | |||||||
rate[x]:rateRatio | C | 0..1 | JP_MedicationRatio_DosePerPeriod | 単位時間内での薬剤の容量 | ||||
rate[x]:rateQuantity | C | 0..1 | SimpleQuantity | 投与速度(流量)を指定する単位は流量を表す単位(e.g. 量/時間)を指定する | ||||
eventHistory | 0..* | Reference(Provenance) | A list of events of interest in the lifecycle ライフサイクルで関心のあるイベントのリスト | |||||
Documentation for this format |
Terminology Bindings
Path | Conformance | ValueSet | ||||
MedicationAdministration.language | preferred | CommonLanguages
| ||||
MedicationAdministration.identifier:rpNumber.use | required | IdentifierUse | ||||
MedicationAdministration.identifier:rpNumber.type | extensible | Identifier Type Codes | ||||
MedicationAdministration.identifier:requestIdentifier.use | required | IdentifierUse | ||||
MedicationAdministration.identifier:requestIdentifier.type | extensible | Identifier Type Codes | ||||
MedicationAdministration.status | required | MedicationAdministration Status Codes | ||||
MedicationAdministration.statusReason | example | SNOMEDCTReasonMedicationNotGivenCodes | ||||
MedicationAdministration.category | preferred | MedicationAdministration Category Codes | ||||
MedicationAdministration.performer.function | example | MedicationAdministration Performer Function Codes | ||||
MedicationAdministration.reasonCode | example | ReasonMedicationGivenCodes | ||||
MedicationAdministration.dosage.site | preferred | JP_MedicationBodySiteJAMIExternal_VS (a valid code from urn:oid:1.2.392.200250.2.2.20.32 ) | ||||
MedicationAdministration.dosage.route | preferred | JP_MedicationRouteHL70162_VS (a valid code from http://jpfhir.jp/fhir/core/CodeSystem/route-codes ) | ||||
MedicationAdministration.dosage.method | example | SNOMEDCTAdministrationMethodCodes | ||||
MedicationAdministration.dosage.method.coding:unitDigit1 | preferred | JP_MedicationMethodJAMIBasicUsage_VS (a valid code from urn:oid:1.2.392.200250.2.2.20.30 ) | ||||
MedicationAdministration.dosage.method.coding:unitDigit2 | preferred | JP_MedicationMethodJAMIDetailUsage_VS (a valid code from urn:oid:1.2.392.200250.2.2.20.40 ) |
Constraints
Id | Grade | Path(s) | Details | Requirements |
ele-1 | error | **ALL** elements | すべてのFHIR要素は、@valueまたはchildrenを持っている必要があります。 : hasValue() or (children().count() > id.count()) | |
ext-1 | error | **ALL** extensions | 「拡張機能または値[x]のいずれかが必要です。両方ではありません。」 : extension.exists() != value.exists() | |
mad-1 | error | MedicationAdministration.dosage | 「用量、投与回数、投与速度[x] のうち少なくとも1つを有するものとする」と訳すことができます。 : dose.exists() or rate.exists() | |
qty-3 | error | MedicationAdministration.dosage.dose, MedicationAdministration.dosage.rate[x]:rateQuantity | ユニットのコードが存在する場合、システムも存在するものとします / If a code for the unit is present, the system SHALL also be present : code.empty() or system.exists() | |
rat-1 | error | MedicationAdministration.dosage.rate[x]:rateRatio | 分子と分母の両方が存在するか、両方が存在します。両方が欠席している場合、いくつかの拡張が存在するものとします / Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present : (numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists()) | |
sqty-1 | error | MedicationAdministration.dosage.dose | コンパレータは、単純なQuantityで使用されません / The comparator is not used on a SimpleQuantity : comparator.empty() | |
sqty-1 | error | MedicationAdministration.dosage.rate[x]:rateQuantity | コンパレータは、単純なQuantityで使用されません / The comparator is not used on a SimpleQuantity : comparator.empty() |
Other representations of profile: CSV, Excel, Schematron
次のデータ項目は必須(データが存在しなければならない)である。
MedicationAdministrationリソースは、次の要素を持たなければならない。
completed
or stopped
に限定されるMedicationAministrationリソースに内包されるMedicationリソースでは、次の要素を持たなければならない。
※投与実施のユースケースにおいては、実施投与量(ingredient.strength)が必須であることが望ましいが、ワーキンググループでの検討の結果、投与中止のユースケースも考慮して必須としない結論となった。
JP Core MedicationAdministration Injection プロファイルで使用される拡張は次の通りである。
拡張 | 説明 | 定義 | 値型 |
---|---|---|---|
依頼科 | 依頼科を格納するための拡張 | JP_MedicationAdministration_RequestDepartment | CodeableConcept |
依頼日時 | 依頼日時を格納するための拡張 | JP_MedicationAdministration_RequestAuthoredOn | DateTime |
実施場所 | 実施場所を格納するための拡張 | JP_MedicationAdministration_Location | Reference(Location) |
依頼医 | 依頼医を格納するための拡張 | JP_MedicationAdministration_Requester | Reference(Practitioner) |
未分類コメント | 未分類コメントを格納するための拡張 | JP_MedicationAdministration_UncategorizedComment | CodeableConcept/String |
RP内薬剤番号 | RP内の薬剤の連番を格納する拡張 《medicationReference配下》 |
JP_Medication_Ingredient_DrugNo | integer |
力価区分 | 投与量が製剤単位か成分単位かを格納する拡張 《medicationReference配下》 |
JP_Medication_IngredientStrength_StrengthType | CodeableConcept |
用法コメント | 用法コメントを格納するための拡張 | JP_MedicationDosage_DosageComment | CodeableConcept/String |
投与装置 | 投与装置を格納する拡張 | JP_MedicationDosage_Device | Reference (Device) |
指示ライン | 指示ラインを格納する拡張< | JP_MedicationDosage_Line | CodeableConcept |
ラインコメント | ラインコメントを格納するための拡張 | JP_MedicationDosage_LineComment | CodeableConcept/String |
投与部位詳細 | 投与部位詳細を格納するための拡張 《dosageInstruction配下》 |
bodySite(hl7.org) | Reference (BodyStructure) |
投与部位コメント | 投与部位コメントを格納するための拡張 | JP_MedicationDosage_SiteComment | CodeableConcept/String |
投与経路コメント | 投与経路コメントを格納するための拡張 | JP_MedicationDosage_RouteComment | CodeableConcept/String |
手技コメント | 手技コメントを格納するための拡張 | JP_MedicationDosage_MethodComment | CodeableConcept/String |
投与速度コメント | 投与速度コメントを格納するための拡張 | JP_MedicationDosage_RateComment | CodeableConcept/String |
HL7 FHIRの基底規格では、薬剤コードをはじめとして、剤形などでSNOMED CTが使われているが、日本ではライセンスの問題もあり普及していない。代替としてJAHIS処方データ交換規約やSS-MIX2で使われている用語集を採用した。
HL7 V2系では用語集を識別するコーディングシステム名(以下、「CS名」)は文字列であったが、FHIRではURIを指定する必要があるため、それぞれにURIを割り当てた。以下に使用する用語集のCS名とURI表記を列記する。
分類 | CS名 | URI |
---|---|---|
医薬品 | HOT7 | urn:oid:1.2.392.200119.4.403.2 |
医薬品 | HOT9 | urn:oid:1.2.392.200119.4.403.1 |
医薬品 | HOT13 | urn:oid:1.2.392.200119.4.402.1 |
医薬品 | YJコード | urn:oid:1.2.392.100495.20.1.73 |
医薬品 | ⼀般処⽅名マスター | urn:oid:1.2.392.100495.20.1.81 |
薬品単位 | MERIT-9(単位) | urn:oid:1.2.392.100495.20.2.101 |
力価区分 | 処方情報 HL7FHIR 記述仕様(力価区分) | urn:oid:1.2.392.100495.20.2.22 |
用法 | JAMI処方・注射オーダ標準用法規格(用法コード) | urn:oid:1.2.392.200250.2.2.20 |
用法 | JAMI処方・注射オーダ標準用法規格(補足用法コード) | urn:oid:1.2.392.200250.2.2.20.22 |
部位 | JAMI処方・注射オーダ標準用法規格(部位コード) | urn:oid:1.2.392.200250.2.2.20.32 |
投与方法 | JAMI処方・注射オーダ標準用法規格(基本用法区分) | urn:oid:1.2.392.200250.2.2.20.30 |
投与経路 | JAMI処方・注射オーダ標準用法規格(用法詳細区分) | urn:oid:1.2.392.200250.2.2.20.40 |
入外区分 | HL7V2(HL7表0482) | http://terminology.hl7.org/CodeSystem/v2-0482 |
MedicationAdministrationリソースでは、依頼元のMedicationRequestリソースをrequest要素にReferenceで参照できるようになっているが、 依頼元のMedicationRequestリソースが取得できないケースも考慮して、依頼情報を直接記述できるように以下の項目を追加した。
また、投薬実施場所(病棟、病室、ベッド番号など)を記述できるように以下の項目を追加した。
コンフォーマンス | パラメータ | 型 | 例 |
---|---|---|---|
SHALL | identifier | token | GET [base]/MedicationAdministration?identifier=http://myhospital.com/fhir/medication|1234567890 |
SHOULD | patient | reference | GET [base]/MedicationAdministration?patient=123456 |
SHOULD | patient,effective-time | reference,date | GET [base]/MedicationAdministration?patient=123456&effective-time=eq2013-01-14 |
MAY | effective-time,medication,performer,request | date,reference,reference,reference | GET [base]/MedicationAdministration?medication.ingredient-code=urn:oid:1.2.392.200119.4.403.1|105271807 |
次の検索パラメータは必須でサポートされなければならない。
identifier 検索パラメータを使用して、オーダIDなどの識別子によるMedicationAdministrationの検索をサポートしなければならない(SHALL)
GET [base]/MedicationAdministration?identifier={system|}[code]
例:
GET [base]/MedicationAdministration?identifier=http://myhospital.com/fhir/medication|1234567890
指定された識別子に一致するMedicationAdministrationリソースを含むBundleを検索する。
次の検索パラメータをサポートすることが望ましい。
patient 検索パラメータを使用して、患者のリファレンス情報によるMedicationAdministrationの検索をサポートすることが望ましい(SHOULD)
GET [base]/MedicationAdministration?patient=[id]
GET [base]/MedicationAdministration?patient=[url]
例:
GET [base]/MedicationAdministration?patient=123456
リソースIDが123456の患者のMedicationAdministrationリソースを含むBundleを検索する。
patient,effective-time 検索パラメータを使用して、患者のリファレンス情報と払い出し日によるMedicationAdministrationの検索をサポートすることが望ましい(SHOULD)
GET [base]/MedicationAdministration?patient=[id]&effective-time=[date]
GET [base]/MedicationAdministration?patient=[url]&effective-time=[date]
例:
GET [base]/MedicationAdministration?patient=123456&effective-time=eq2013-01-14
リソースIDが123456の患者の2013-01-14に投与実施されたMedicationAdministrationリソースを含むBundleを検索する。
追加検索パラメータは定義しない。
JP MedicationAdministration リソースに対して使用される操作は次の通りである。
$everything:[base]/MedicationAdministration/[id]/$everything
この操作は、この操作が呼び出された特定のMedicationAdministrationリソースに関連する全ての情報を返す。応答は “searchset” タイプのBundleリソースである。サーバは、少なくとも、識別されたMedicationAdministrationコンパートメントに含まれる全てのリソースと、それらから参照されるすべてのリソースを返すことが望ましい。
この操作の公式なURLは以下である。
http://hl7.jp/fhir/OperationDefinition/MedicationAdministration-everything
URL: [base]/MedicationAdministration/[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”である。この操作の結果は、リソースとして直接返される。 |
リクエスト:単一のMedicationAdministrationに関連する全てのリソースを取得する。
GET [base]/MedicationAdministration/1234567890/$everything
[some headers]
レスポンス:指定されたMedicationAdministrationに関連する全てのリソースを返す。
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/MedicationAdministration/1234567890",
"resource": {
"resourceType": "MedicationAdministration",
・・・
},
}
]
}
JAHIS注射データ交換規約Ver.2.1Cに記載されている下記の注射実施をFHIRで表現する場合のサンプルを示す。
MedicationAdministrationは薬剤をCodeableConceptとして1つまでしか持つか、Medicationリソースのreferenceをもつことしかできない。したがって、複数の薬剤を同一のRp番号で表現する場合にはMedicationAdministrationを繰り返すか、複数の薬剤をまとめたMedication Resourceのインスタンスを参照することとなる。ワーキンググループでの検討の結果、複数の薬剤をまとめたMedicationリソースのインスタンスをcontained属性に内包した上で参照することとした。
1回の投与薬剤と投与量は、RP内の薬剤が1薬剤の場合も混注などで複数の薬剤を含む場合も、すべての薬剤を記述したMedicationリソースを contained 属性に内包し、それをMedicationRequest.medicationReference属性で参照するようにする。
Medicationリソースのingredient.itemCodeableConcept要素にCodeableConcept型で各薬剤の識別情報を記述し、ingredient.strength.numerator要素に1回あたりの含有量を記述する。薬剤を識別するコードはHOT7、HOT9、YJコードを推奨するが、ローカルコードを使用してもよい。含有量の単位コードは MERIT-9を使用する。ingredient.strength.denominatorには固定値「1回」をMERIT-9を使用して指定する。
dosage.dose要素には、情報が得られる場合には全体の容量をUCUM(http://unitsofmeasure.org
)を使用してmL単位で指定する。
投与が実施された場合、status要素に completed
を記述する。
"status": "completed"
投与が中止された場合、status要素に stopped
を記述する。
"status": "stopped"
投与が実施された日時をeffectiveDateTime、またはeffectivePeriod要素にRFC3339形式で記述する。 タイムゾーンはJST(+09:00)を指定する。
開始日時、終了日時が明確である場合はeffectivePeriodに記述する。(e.g. 点滴注射)
"effectivePeriod": {
"start": "2016-07-01T08:05:21+09:00",
"end": "2016-07-01T13:05:43+09:00"
}
開始日時しか存在せず終了日時が明確でない場合、effectivePeriodのstartとendに同じ値を記述するか、effectiveDateTime要素に記述する。(e.g. ワンショット注射)
"effectiveDateTime": "2016-08-25T08:30:00+09:00"
投与を実施した医療従事者(自己管理の場合は患者)をperformer要素に記述する。
performer.functionには、FHIR標準のValueSetである http://terminology.hl7.org/CodeSystem/med-admin-perform-function
から、実施者を表す performer
を固定で記述する。
performer.actorには、医療従事者(Practitioner)、または患者(Patient)リソースの参照を記述する。
"performer": {
"function": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/med-admin-perform-function",
"code": "performer",
"display": "Performer"
}
]
},
"actor": {
"reference": "Practitioner/1"
}
}
投与を実施した場所(病棟、病室、ベッド番号など)を、拡張「JP_MedicationAdministration_Location」を使用して、Reference型でLocationリソースの参照情報を記述する。 (Location Resourceの記述仕様については、当プロファイルのスコープ外とする)
{
"resourceType": "MedicationAdministration",
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_Location",
"valueReference": {
"reference": "Location/1"
}
}
]
}
投与時に使用したラインを記述する場合は、dosage要素で拡張「JP_MedicationDosage_Line」を使用し、CodeableConcept型で指定する。推奨するコードシステムはないので、ローカルコードを使用する。
"dosage": {
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_Line",
"valueCodeableConcept": {
"coding": [
{
"system": "http://jpfhir.jp/fhir/Examples/CodeSystem/JP_MedicationRequestDosageInstructionLine_CS",
"code": "01",
"display": "末梢ルート"
}
]
}
}
]
}
「1:内服」、「2:外用」などJAMI標準用法コードにて基本用法区分として表現される区分は、dosage.route 要素にコードまたは文字列で指定する。基本用法区分を識別するURIとして、”urn:oid:1.2.392.200250.2.2.20.30”を使用する。
"dosage": {
"route": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0162",
"code": "IV",
"display": "静脈内"
}
]
}
}
投与部位を指定する場合は、dosage.site 要素に、CodeableConcept型で指定する。部位コードは、JAMI標準用法コード 表13 外用部位コード(”urn:oid:1.2.392.100495.20.2.33”)を推奨する。 HL7表0550 身体部位(“http://terminology.hl7.org/CodeSystem/v2-0550”)とHL7表0495 身体部位修飾子(“http://terminology.hl7.org/CodeSystem/v2-0495”)を組み合わせて使用してもよいが、その場合は拡張「BodyStructure」を使用する。 この拡張は BodyStructureリソースを参照することができるので、location 要素にHL7表0550 身体部位(“http://terminology.hl7.org/CodeSystem/v2-0550”)のコードを、locationQualifier 要素に 身体部位修飾子(“http://terminology.hl7.org/CodeSystem/v2-0495”)のコードをそれぞれ指定したBodyStructureリソースをMedicationRequestリソースのcontained属性に内包し、それをExtension.valueReference 要素で参照するようにする。
投与部位「左腕」をJAMI標準用法コードで指定した場合のインスタンス例を示す。
"dosage": [
{
"site": {
"coding": [
{
"system": "urn:oid:1.2.392.100495.20.2.33",
"code": "73L",
"display": "左腕"
}
]
},
投与部位「左腕」をHL7表0550 身体部位とHL7表0495 身体部位修飾子で指定した場合のインスタンス例を示す。
"contained": [
{
"resourceType": "BodyStructure",
"id": "#site",
"location": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0550",
"code": "ARM",
"display": "腕"
}
]
},
"locationQualifier": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0495",
"code": "L",
"display": "左"
}
]
}
]
}
],
"dosage": [
{
"site": {
"extension": [
{
"url": "http://hl7.org/fhir/core/StructureDefinition/bodySite",
"valueReference": "#site"
}
]
}
}
]
「A:貼付」、「B:塗布」などJAMI標準用法コードにて用法詳細区分として表現される区分は、dosage.method 要素にコードまたは文字列で指定する。 用法詳細区分を識別するURIとして、”urn:oid:1.2.392.200250.2.2.20.40”を使用する。
"dosage": {
"method": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0165",
"code": "IVP",
"display": "IVプッシュ"
}
]
}
}
Medication.ingredientに記述される薬剤の合計容量(mL)を dosage.dose に、SimpleQuantity型で記録する。単位コードには、医薬品単位略号を使用する。
以下薬剤を混注した際の合計容量「510mL」を記述したインスタンス例を示す。
ソリタ-T3号輸液500mL ... 1本
アドナ注(静脈用)50mg/10mL ... 1アンプル
=> 510mL (500mL + 10mL) をdosage.doseに記述する。
"dosage": {
"dose": {
"value": 510,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
点滴注射など一定の速度で時間をかけて投与する場合、その投与速度は dosageInstruction.doseAndRate.rateRatioを使用してRatio型で表現する。単位コードには、UCUM(http://unitsofmeasure.org
)を使用する。
投与速度「100mL/h」を記述したインスタンス例を示す。
"dosage": {
"rateRatio": {
"numerator": {
"value": 100,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"denominator": {
"value": 1,
"unit": "h",
"system": "http://unitsofmeasure.org",
"code": "h"
}
}
}
投与経路を補足するためのコメントは、route要素に対して定義した拡張「JP_MedicationAdministration_Route_RouteComment」を使用する。 この拡張は、コメントがコード化されている場合はCodeableConcept型を使用して記述する。コード化されていない場合はString型を使用して記述する。 複数のコメントを記述する場合は、この拡張を繰り返して記述する。
投与経路コメントをString型で記述したインスタンス例を示す。
"route": {
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_Route_RouteComment",
"valueString": "右手に実施"
}
],
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0162",
"code": "IV",
"display": "静脈内"
}
]
}
投与部位を補足するためのコメントは、site要素に対して定義した拡張「JP_MedicationAdministration_Site_SiteComment」を使用する。 この拡張は、コメントがコード化されている場合はCodeableConcept型を使用して記述する。コード化されていない場合はString型を使用して記述する。 複数のコメントを記述する場合は、この拡張を繰り返して記述する。
投与部位コメントをString型で記述したインスタンス例を示す。
"site": {
"extension": [
{
"url": "http://hl7.org/fhir/core/StructureDefinition/bodySite",
"valueReference": {
"reference": "BodyStructure/1",
"display": "右腕"
}
},
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_Site_SiteComment",
"valueString": "左利きのため"
}
]
}
手技を補足するためのコメントは、method要素に対して定義した拡張「JP_MedicationAdministration_Method_MethodComment」を使用する。 この拡張は、コメントがコード化されている場合はCodeableConcept型を使用して記述する。コード化されていない場合はString型を使用して記述する。 複数のコメントを記述する場合は、この拡張を繰り返して記述する。
手技コメントをString型で記述したインスタンス例を示す。
"method": {
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_Method_MethodComment",
"valueString": "1分ほどかけて緩徐に行いました"
}
],
"coding": [
{
"system": "http://jpfhir.jp/medication/99ILL",
"code": "101",
"display": "静注(末梢)"
}
]
}
ラインを補足するためのコメントは、dosage要素に対して定義した拡張「JP_MedicationDosage_LineComment」を使用する。 この拡張は、コメントがコード化されている場合はCodeableConcept型を使用して記述する。コード化されていない場合はString型を使用して記述する。 複数のコメントを記述する場合は、この拡張を繰り返して記述する。
ラインコメントをString型で記述したインスタンス例を示す。
"dosage": {
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_Line",
"valueCodeableConcept": {
"coding": [
{
"system": "http://jpfhir.jp/fhir/Examples/CodeSystem/JP_MedicationRequestDosageInstructionLine_CS",
"code": "01",
"display": "末梢ルート"
}
]
}
},
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_LineComment",
"valueString": "末梢キープ"
}
]
}
投与速度を補足するためのコメントは、rate要素に対して定義した拡張「JP_MedicationAdministration_Rate_RateComment」を使用する。 この拡張は、コメントがコード化されている場合はCodeableConcept型を使用して記述する。コード化されていない場合はString型を使用して記述する。 複数のコメントを記述する場合は、この拡張を繰り返して記述する。
投与速度コメントをString型で記述したインスタンス例を示す。
"rateRatio": {
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_Rate_RateComment",
"valueString": "倍速で実施"
}
],
"numerator": {
"value": 102,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"denominator": {
"value": 1,
"unit": "h",
"system": "http://unitsofmeasure.org",
"code": "h"
}
}
用法を補足するためのコメントは、dosage要素に対して定義した拡張「JP_MedicationDosage_DosageComment」を使用する。 この拡張は、コメントがコード化されている場合はCodeableConcept型を使用して記述する。コード化されていない場合はString型を使用して記述する。 複数のコメントを記述する場合は、この拡張を繰り返して記述する。
用法コメントをString型で記述したインスタンス例を示す。
"dosage": {
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationDosage_DosageComment",
"valueString": "痙攣が発生したため、主治医に確認の上実施しました"
}
]
}
進捗を補足するためのコメントは、reasonCode要素を使用してCodeableConcept型でテキストによる記述とコードによる記述のどちらかを選択することができる。
進捗コメントをテキストで記述したインスタンス例を示す
"reasonCode": {
"text": "容体急変のため倍の速度で実施"
}
上記のコメントに分類できない、またはシステム的に分類して管理されていない場合、MedicationAdministrationに対して定義した拡張「JP_MedicationAdministration_UncategorizedComment」を使用する。 この拡張は、コメントがコード化されている場合はCodeableConcept型を使用して記述する。コード化されていない場合はString型を使用して記述する。 複数のコメントを記述する場合は、この拡張を繰り返して記述する。
未分類コメントをString型で記述したインスタンス例を示す。
{
"resourceType": "MedicationAdministration",
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_UncategorizedComment",
"valueString": "1分ほどかけて緩徐に行いました"
},
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_UncategorizedComment",
"valueString": "痙攣が発生したため、主治医に確認の上実施しました"
}
]
}
実施の元となった投薬依頼(MedicationRequest)リソースの参照を記述する。
"request": {
"reference": "MedicationRequest/1"
}
投薬依頼を行なった診療科を、拡張「JP_MedicationAdministration_RequestDepartment」を使用して、CodeableConcept型で記述する。
{
"resourceType": "MedicationAdministration",
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_RequestDepartment",
"valueCodeableConcept": {
"coding": [
{
"system": "urn:oid:1.2.392.200250.2.2.2",
"code": "01",
"display": "内科"
}
]
}
}
]
}
投薬依頼を行なった医師を、拡張「JP_MedicationAdministration_Requester」を使用して、Reference型でPractitionerリソースの参照情報を記述する。 (Practitioner Resourceの記述仕様については、当プロファイルのスコープ外とする)
{
"resourceType": "MedicationAdministration",
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_Requester",
"valueReference": {
"reference": "Practitioner/2"
}
}
]
}
投薬依頼を行なった日時を、拡張「JP_MedicationAdministration_RequestAuthoredOn」を使用して、RFC3339形式で記述する。 タイムゾーンはJST(+09:00)を指定する。
{
"resourceType": "MedicationAdministration",
"extension": [
{
"url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_MedicationAdministration_RequestAuthoredOn",
"valueDateTime": "2016-08-20T09:30:00+09:00"
}
]
}
投与実施の基となった薬剤処方の用法などの情報は、特に記述のない限り JP Core MedicationRequest Injection と同様の記述方法とする。該当する項目としては以下のものがある。