1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
//! Medication
//!
//! URL: http://hl7.org/fhir/StructureDefinition/Medication
//!
//! Version: 5.0.0
//!
//! Medication Resource: This resource is primarily used for the identification and definition of a medication, including ingredients, for the purposes of prescribing, dispensing, and administering a medication as well as for making statements about medication use.
//!
//! FHIR: <https://build.fhir.org/>
//!
//! UML: <https://build.fhir.org/uml.html>
// Allow unused crate::r5::types as types;
#![allow(unused_imports)]
use crate::r5::types;
use ::serde::{Deserialize, Serialize};
use fhir_derive_macros::Validate;
/// The Medication resource is primarily used for the identification and
/// definition of a medication, including its ingredients, for the purposes of
/// prescribing, dispensing, and administering a medicinal product, as well as
/// for making statements about medication use. In FHIR R5 it represents a
/// specific medication as an actual instance or as an abstract definition: it
/// carries the code that identifies the drug, its dose form (such as tablet,
/// capsule, or powder), its total volume, the active and inactive ingredients
/// together with the strength each contributes, and packaging details such as
/// the batch lot number and expiration date. A Medication may also cite the
/// organization authorized to market it and link to broader knowledge through a
/// definition reference.
///
/// Clinically and administratively, Medication acts as the shared, reusable
/// description of a drug that medication-workflow resources point to rather than
/// duplicate. It is referenced by resources such as `MedicationRequest`,
/// `MedicationDispense`, `MedicationAdministration`, and `MedicationStatement`,
/// which record the ordering, supply, giving, and reported use of the drug for a
/// particular subject.
///
/// # See also
///
/// The medication is described using data types including
/// [`CodeableConcept`](crate::r5::types::CodeableConcept),
/// [`Quantity`](crate::r5::types::Quantity), and
/// [`Reference`](crate::r5::types::Reference). Ingredients and packaging are
/// modeled by the nested [`MedicationIngredient`] and [`MedicationBatch`] types.
///
/// # Examples
///
/// ```
/// use fhir::r5::resources::medication::Medication;
///
/// let value = Medication::default();
/// let json = ::serde_json::to_value(&value).unwrap();
/// let back: Medication = ::serde_json::from_value(json).unwrap();
/// assert_eq!(value, back);
/// ```
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct Medication {
/// Logical id of this artifact
pub id: Option<types::String>,
/// Metadata about the resource
pub meta: Option<types::Meta>,
/// A set of rules under which this content was created
pub implicit_rules: Option<types::Uri>,
/// Language of the resource content
pub language: Option<types::Code>,
/// Text summary of the resource, for human interpretation
pub text: Option<types::Narrative>,
/// Contained, inline Resources
pub contained: Option<Vec<::serde_json::Value>>,
/// Additional content defined by implementations
pub extension: Option<Vec<types::Extension>>,
/// Extensions that cannot be ignored
pub modifier_extension: Option<Vec<types::Extension>>,
/// Business identifier for this medication
pub identifier: Option<Vec<types::Identifier>>,
/// Coded value, such as an RxNorm or SNOMED CT code, that identifies this medication
pub code: Option<types::CodeableConcept>,
/// Lifecycle status of the record: active, inactive, or entered-in-error
pub status: Option<types::Code>,
/// Organization that has authorization to market medication
pub marketing_authorization_holder: Option<types::Reference>,
/// powder | tablets | capsule +
pub dose_form: Option<types::CodeableConcept>,
/// When the specified product code does not infer a package size, this is the specific amount of drug in the product
pub total_volume: Option<types::Quantity>,
/// Active or inactive ingredients that make up the medication, each with an optional strength
pub ingredient: Option<Vec<MedicationIngredient>>,
/// Details about the packaged medication, such as its batch lot number and expiration date
pub batch: Option<MedicationBatch>,
/// Knowledge about this medication
pub definition: Option<types::Reference>,
}
/// Active or inactive ingredient contained in the medication, identifying the
/// substance or medication and, when known, the strength it contributes.
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct MedicationIngredient {
/// Unique id for inter-element referencing
pub id: Option<types::String>,
/// Additional content defined by implementations
pub extension: Option<Vec<types::Extension>>,
/// Extensions that cannot be ignored even if unrecognized
pub modifier_extension: Option<Vec<types::Extension>>,
/// The ingredient (substance or medication) that the ingredient.strength relates to
pub item: types::CodeableReference,
/// Active ingredient indicator
pub is_active: Option<types::Boolean>,
/// Quantity of ingredient present, as a Ratio
pub strength_ratio: Option<types::Ratio>,
/// Quantity of ingredient present, as a CodeableConcept
pub strength_codeable_concept: Option<types::CodeableConcept>,
/// Quantity of ingredient present, as a Quantity
pub strength_quantity: Option<types::Quantity>,
}
/// Details about the packaged medication, such as the lot number assigned to the
/// batch and the date on which it will expire.
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct MedicationBatch {
/// Unique id for inter-element referencing
pub id: Option<types::String>,
/// Additional content defined by implementations
pub extension: Option<Vec<types::Extension>>,
/// Extensions that cannot be ignored even if unrecognized
pub modifier_extension: Option<Vec<types::Extension>>,
/// Identifier assigned to batch
pub lot_number: Option<types::String>,
/// When batch will expire
pub expiration_date: Option<types::DateTime>,
}
#[cfg(test)]
mod tests {
use super::*;
type T = Medication;
#[test]
fn test_default() {
let _ = T::default();
}
#[test]
fn test_serde_round_trip() {
let value = T::default();
let json = ::serde_json::to_value(&value).expect("to_value");
let back: T = ::serde_json::from_value(json).expect("from_value");
assert_eq!(value, back);
}
}