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
184
185
186
187
188
189
190
191
192
193
//! ImmunizationRecommendation
//!
//! URL: http://hl7.org/fhir/StructureDefinition/ImmunizationRecommendation
//!
//! Version: 5.0.0
//!
//! ImmunizationRecommendation Resource: A patient's point-in-time set of recommendations (i.e. forecasting) according to a published schedule with optional supporting justification.
//!
//! 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;
/// ImmunizationRecommendation resource.
///
/// A patient's point-in-time set of recommendations (i.e. forecasting)
/// according to a published schedule, with optional supporting justification.
/// The resource captures which vaccines or vaccine groups a patient should
/// receive, the forecast status of each recommendation (for example due,
/// overdue, complete, or contraindicated), the dose number within a series,
/// and the calendar dates that govern when a dose becomes due. Each
/// recommendation may also cite the past immunizations and patient
/// observations that support the reasoning, so the forecast can be audited
/// and explained.
///
/// In FHIR R5 this resource is typically produced by a clinical decision
/// support system or immunization forecasting engine and consumed by
/// electronic health records, patient portals, and immunization information
/// systems to remind clinicians and patients of vaccinations that are due.
/// Because it is a point-in-time snapshot, a new instance is generally
/// generated whenever the forecast is recalculated rather than updating a
/// prior one.
///
/// # Related resources
///
/// The recommendation is always about a single subject, referenced from the
/// `patient` field and typically resolving to a [`Patient`](crate::r5::resources::patient::Patient).
/// Supporting evidence commonly references past [`Immunization`](crate::r5::resources::immunization::Immunization)
/// records and [`Observation`](crate::r5::resources::observation::Observation) results. Coded
/// concepts such as the vaccine code and forecast status use
/// [`CodeableConcept`](crate::r5::types::CodeableConcept), while links to other
/// resources use [`Reference`](crate::r5::types::Reference).
///
/// # Examples
///
/// ```
/// use fhir::r5::resources::immunization_recommendation::ImmunizationRecommendation;
///
/// let value = ImmunizationRecommendation::default();
/// let json = ::serde_json::to_value(&value).unwrap();
/// let back: ImmunizationRecommendation = ::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 ImmunizationRecommendation {
/// 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
pub identifier: Option<Vec<types::Identifier>>,
/// Reference to the patient for whom this set of recommendations is forecast.
pub patient: types::Reference,
/// Point in time at which this set of recommendations was generated.
pub date: types::DateTime,
/// Organization responsible for the immunization protocol used to forecast.
pub authority: Option<types::Reference>,
/// One entry per vaccine or vaccine group being recommended for the patient.
pub recommendation: Vec<ImmunizationRecommendationRecommendation>,
}
/// Vaccine administration recommendations.
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct ImmunizationRecommendationRecommendation {
/// 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>>,
/// Coded vaccine or vaccine group that this recommendation applies to.
pub vaccine_code: Option<Vec<types::CodeableConcept>>,
/// Coded disease or diseases the recommended vaccine protects against.
pub target_disease: Option<Vec<types::CodeableConcept>>,
/// Vaccine which is contraindicated to fulfill the recommendation
pub contraindicated_vaccine_code: Option<Vec<types::CodeableConcept>>,
/// Coded forecast status such as due, overdue, immune, complete, or contraindicated.
pub forecast_status: types::CodeableConcept,
/// Vaccine administration status reason
pub forecast_reason: Option<Vec<types::CodeableConcept>>,
/// Dates governing proposed immunization
pub date_criterion: Option<Vec<ImmunizationRecommendationRecommendationDateCriterion>>,
/// Protocol details
pub description: Option<types::Markdown>,
/// Name of vaccination series
pub series: Option<types::String>,
/// Recommended dose number within series
pub dose_number: Option<types::String>,
/// Recommended number of doses for immunity
pub series_doses: Option<types::String>,
/// Past immunizations supporting recommendation
pub supporting_immunization: Option<Vec<types::Reference>>,
/// Patient observations supporting recommendation
pub supporting_patient_information: Option<Vec<types::Reference>>,
}
/// Dates governing proposed immunization.
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct ImmunizationRecommendationRecommendationDateCriterion {
/// 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>>,
/// Type of date
pub code: types::CodeableConcept,
/// Recommended date
pub value: types::DateTime,
}
#[cfg(test)]
mod tests {
use super::*;
type T = ImmunizationRecommendation;
#[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);
}
}