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
//! Person
//!
//! URL: http://hl7.org/fhir/StructureDefinition/Person
//!
//! Version: 5.0.0
//!
//! Person Resource: Demographics and administrative information about a person independent of a specific health-related context.
//!
//! 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;
/// Demographics and administrative information about a person independent of a
/// specific health-related context.
///
/// A Person resource captures the identity and demographic details of an
/// individual who may play one or more roles in the healthcare system, such as
/// a patient, practitioner, related person, or user of a system. Unlike those
/// role-specific resources, a Person is not tied to any single health-related
/// context; instead it models the underlying human being and provides a stable
/// point of identity that can be reused across contexts. Its most distinctive
/// purpose is index and cross-reference management: through its links a Person
/// record can associate the several records that concern the same actual human
/// being, supporting patient-matching, master person indexes, and record
/// linkage across organizations and systems. In FHIR R5 a Person typically
/// carries identifiers, human names, contact details, address, gender, birth
/// date, marital status, preferred communication languages, and the managing
/// organization that acts as custodian of the record.
///
/// # Related resources
///
/// A Person is frequently linked to a [`Patient`](crate::r5::resources::patient::Patient),
/// as well as to `Practitioner` and `RelatedPerson` records that represent the
/// same individual in different roles. Coded elements such as marital status and
/// communication language use [`CodeableConcept`](crate::r5::types::CodeableConcept),
/// and links to other resources use [`Reference`](crate::r5::types::Reference).
///
/// # Examples
///
/// ```
/// use fhir::r5::resources::person::Person;
///
/// let value = Person::default();
/// let json = ::serde_json::to_value(&value).unwrap();
/// let back: Person = ::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 Person {
/// 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 identifiers by which this person is known, such as a national or organizational person identifier
pub identifier: Option<Vec<types::Identifier>>,
/// Whether this person's record is in active use; a false value indicates the record should no longer be relied upon
pub active: Option<types::Boolean>,
/// One or more names associated with the person, each expressed as a structured human name
pub name: Option<Vec<types::HumanName>>,
/// A contact detail for the person
pub telecom: Option<Vec<types::ContactPoint>>,
/// male | female | other | unknown
pub gender: Option<types::Code>,
/// The date on which the person was born
pub birth_date: Option<types::Date>,
/// Indicates if the individual is deceased or not
pub deceased_boolean: Option<types::Boolean>,
/// Indicates if the individual is deceased or not
pub deceased_date_time: Option<types::DateTime>,
/// One or more addresses for the person
pub address: Option<Vec<types::Address>>,
/// Marital (civil) status of a person
pub marital_status: Option<types::CodeableConcept>,
/// Image of the person
pub photo: Option<Vec<types::Attachment>>,
/// A language which may be used to communicate with the person about his or her health
pub communication: Option<Vec<PersonCommunication>>,
/// The organization that is the custodian of the person record
pub managing_organization: Option<types::Reference>,
/// Links to Patient, Practitioner, RelatedPerson, or other Person records that concern the same actual person
pub link: Option<Vec<PersonLink>>,
}
/// A language which may be used to communicate with the person about his or her
/// health.
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct PersonCommunication {
/// 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 language which can be used to communicate with the person about his or her health
pub language: types::CodeableConcept,
/// Language preference indicator
pub preferred: Option<types::Boolean>,
}
/// Link to a resource that concerns the same actual person.
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct PersonLink {
/// 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 resource to which this actual person is associated
pub target: types::Reference,
/// level1 | level2 | level3 | level4
pub assurance: Option<types::Code>,
}
#[cfg(test)]
mod tests {
use super::*;
type T = Person;
#[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);
}
}