1--
2-- Example of an openEHR Archetype, written in the Archetype Definition Language (ADL)
3-- Definition available here: http://www.openehr.org/releases/trunk/architecture/am/adl2.pdf
4-- Author: derived from the openEHR-EHR-EVALUATION.adverse_reaction.v1 archetype at http://www.openEHR.org/ckm
5--
6
7archetype (adl_version=2.0.5; rm_release=1.0.2; generated)
8	openEHR-EHR-EVALUATION.adverse_reaction.v1.0.0
9
10language
11	original_language = <[ISO_639-1::en]>
12
13description
14	lifecycle_state = <"unmanaged">
15	original_author = <
16		["name"] = <"Heather Leslie">
17		["organisation"] = <"Ocean Informatics">
18		["email"] = <"heather.leslie@oceaninformatics.com">
19		["date"] = <"2010-11-08">
20	>
21	copyright = <"© openEHR Foundation">
22	details = <
23		["en"] = <
24			language = <[ISO_639-1::en]>
25			purpose = <"To record information about any harmful...">
26			use = <"Use to record all information about the presence ...">
27			keywords = <"reaction", "allergy", "allergic", "adverse">
28			misuse = <"Not to be used for recording the absence (or ...">
29		>
30	>
31	other_contributors = <"Jane Doe, Australia">
32	other_details = <
33		["references"] = <"Adverse Reaction, draft archetype, ...">
34		["MD5-CAM-1.0.1"] = <"260699D2EFDE4F7C7BC3C6C501A51A61">
35	>
36
37definition
38	EVALUATION[id1] matches {	-- Adverse Reaction
39		data matches {
40			ITEM_TREE[id2] matches {
41				items cardinality matches {1..*; unordered} matches {
42					ELEMENT[id3] matches {	-- Substance/Agent
43						value matches {
44							DV_TEXT[id51]
45						}
46					}
47					ELEMENT[id5] occurrences matches {0..1} matches {	-- Absolute Contraindication?
48						value matches {
49							DV_BOOLEAN[id52] matches {
50								value matches {True}
51							}
52						}
53					}
54					ELEMENT[id50] occurrences matches {0..1} matches {	-- Future Use
55						value matches {
56							DV_TEXT[id53]
57						}
58					}
59					ELEMENT[id7] occurrences matches {0..1} matches {	-- Overall Comment
60						value matches {
61							DV_TEXT[id54]
62						}
63					}
64					CLUSTER[id10] matches {	-- Reaction Event
65						items matches {
66							ELEMENT[id11] occurrences matches {0..1} matches {	-- Specific Substance/Agent
67								value matches {
68									DV_TEXT[id55]
69								}
70							}
71							ELEMENT[id12] matches {	-- Manifestation
72								value matches {
73									DV_TEXT[id56]
74								}
75							}
76							ELEMENT[id17] occurrences matches {0..1} matches {	-- Reaction Type
77								value matches {
78									DV_TEXT[id57]
79								}
80							}
81							ELEMENT[id22] occurrences matches {0..1} matches {	-- Certainty
82								value matches {
83									DV_CODED_TEXT[id58] matches {
84										defining_code matches {[ac1]}		-- Certainty (synthesised)
85									}
86								}
87							}
88							ELEMENT[id13] occurrences matches {0..1} matches {	-- Reaction Description
89								value matches {
90									DV_TEXT[id59]
91								}
92							}
93							ELEMENT[id28] occurrences matches {0..1} matches {	-- Onset of Reaction
94								value matches {
95									DV_DATE_TIME[id60]
96								}
97							}
98							ELEMENT[id29] occurrences matches {0..1} matches {	-- Duration of Reaction
99								value matches {
100									DV_DURATION[id61]
101								}
102							}
103							allow_archetype CLUSTER[id30] matches {	-- Additional Reaction Detail
104								include
105									archetype_id/value matches {/openEHR-EHR-CLUSTER\.anatomical_location(-a-zA-Z0-9_]+)*\.v1/}
106							}
107							ELEMENT[id19] occurrences matches {0..1} matches {	-- Exposure Description
108								value matches {
109									DV_TEXT[id62]
110								}
111							}
112							ELEMENT[id21] occurrences matches {0..1} matches {	-- Earliest Exposure
113								value matches {
114									DV_DATE_TIME[id63]
115								}
116							}
117							ELEMENT[id26] occurrences matches {0..1} matches {	-- Duration of Exposure
118								value matches {
119									DV_DURATION[id64]
120								}
121							}
122							allow_archetype CLUSTER[id20] matches {	-- Additional Exposure Detail
123								include
124									archetype_id/value matches {/openEHR-EHR-CLUSTER\.amount(-a-zA-Z0-9_]+)*\.v1|openEHR-EHR-CLUSTER\.medication_admin(-a-zA-Z0-9_]+)*\.v1|openEHR-EHR-CLUSTER\.timing(-a-zA-Z0-9_]+)*\.v1/}
125							}
126							ELEMENT[id41] occurrences matches {0..1} matches {	-- Clinical Management Description
127								value matches {
128									DV_TEXT[id65]
129								}
130							}
131							ELEMENT[id32] matches {	-- Multimedia
132								value matches {
133									DV_MULTIMEDIA[id66] matches {
134										media_type
135									}
136								}
137							}
138							allow_archetype CLUSTER[id42] matches {	-- Reporting Details
139								include
140									archetype_id/value matches {/.*/}
141							}
142							ELEMENT[id33] occurrences matches {0..1} matches {	-- Reaction Comment
143								value matches {
144									DV_TEXT[id67]
145								}
146							}
147						}
148					}
149				}
150			}
151		}
152		protocol matches {
153			ITEM_TREE[id43] matches {
154				items matches {
155					ELEMENT[id45] occurrences matches {0..1} matches {	-- Reaction Reported?
156						value matches {
157							DV_BOOLEAN[id68] matches {
158								value matches {True, False}
159							}
160						}
161					}
162					ELEMENT[id49] occurrences matches {0..1} matches {	-- Report Comment
163						value matches {
164							DV_TEXT[id69]
165						}
166					}
167					ELEMENT[id46] matches {	-- Adverse Reaction Report
168						value matches {
169							DV_URI[id70]
170						}
171					}
172					ELEMENT[id48] occurrences matches {0..1} matches {	-- Supporting Clinical Record Information
173						value matches {
174							DV_EHR_URI[id71]
175						}
176					}
177				}
178			}
179		}
180	}
181
182terminology
183	term_definitions = <
184		["en"] = <
185			["id1"] = <
186				text = <"Adverse Reaction">
187				description = <"A harmful or undesirable, unexpected effect associated with exposure to any substance or agent, including food, plants, animals, venom from animal stings, or a medication at therapeutic or sub-therapeutic doses.">
188			>
189			["id3"] = <
190				text = <"Substance/Agent">
191				description = <"Identification of a substance, agent, or a class of substance, that is considered to be responsible for the Adverse Reaction.">
192			>
193			["id5"] = <
194				text = <"Absolute Contraindication?">
195				description = <"Is administration of this Substance/Agent absolutely contraindicated in this individual?">
196			>
197			["id7"] = <
198				text = <"Overall Comment">
199				description = <"Additional narrative about the Adverse Reaction as a whole, not captured in other fields.">
200			>
201			["id10"] = <
202				text = <"Reaction Event">
203				description = <"Details about each Adverse Reaction Event.">
204			>
205			["id11"] = <
206				text = <"Specific Substance/Agent">
207				description = <"Specific identification of the actual Substance/Agent considered to be responsible for the Adverse Reaction event.">
208			>
209			["id12"] = <
210				text = <"Manifestation">
211				description = <"Clinical manifestation of the Adverse Reaction expressed as a single word, phrase or brief description, e.g. nausea or rash.">
212			>
213			["id13"] = <
214				text = <"Reaction Description">
215				description = <"Narrative description of the Adverse Reaction.">
216			>
217			["id17"] = <
218				text = <"Reaction Type">
219				description = <"The type of Adverse Reaction as determined by the clinician.">
220			>
221			["id19"] = <
222				text = <"Exposure Description">
223				description = <"Description about exposure to the Substance/Agent.">
224			>
225			["id20"] = <
226				text = <"Additional Exposure Detail">
227				description = <"Additional detail about exposure/s for this Adverse Reaction event, including structured medication amount/frequency/route information.">
228			>
229			["id21"] = <
230				text = <"Earliest Exposure">
231				description = <"Record of the date and/or time of the earliest or initial exposure to the Substance/Agent.">
232			>
233			["id22"] = <
234				text = <"Certainty">
235				description = <"Degree of certainty, as assessed by a clinician, that the specific Substance/Agent was the cause of the Adverse Reaction.">
236			>
237			["at23"] = <
238				text = <"Suspected">
239				description = <"Possibly the causative agent.">
240			>
241			["at24"] = <
242				text = <"Probable">
243				description = <"Likely to be the causative agent, but not confirmed by testing or rechallenge.">
244			>
245			["at25"] = <
246				text = <"Confirmed">
247				description = <"Confirmed as the causative agent, by testing or rechallenge.">
248			>
249			["id26"] = <
250				text = <"Duration of Exposure">
251				description = <"The amount of time of exposure to the Substance/Agent.">
252			>
253			["id28"] = <
254				text = <"Onset of Reaction">
255				description = <"Record of the date and/or time of the onset of the Adverse Reaction.">
256			>
257			["id29"] = <
258				text = <"Duration of Reaction">
259				description = <"The amount of time that the Adverse Reaction was present.">
260			>
261			["id30"] = <
262				text = <"Additional Reaction Detail">
263				description = <"Additional detail about the Adverse Reaction, including anatomical location.">
264			>
265			["id32"] = <
266				text = <"Multimedia">
267				description = <"Inclusion of any multimedia file to support the recording of the Adverse Reaction event.">
268			>
269			["id33"] = <
270				text = <"Reaction Comment">
271				description = <"Additional narrative about the Adverse Reaction event not captured in other fields.">
272			>
273			["id41"] = <
274				text = <"Clinical Management Description">
275				description = <"Narrative description of the clinical management provided.">
276			>
277			["id42"] = <
278				text = <"Reporting Details">
279				description = <"Further details required for reporting to regulatory bodies.">
280			>
281			["id45"] = <
282				text = <"Reaction Reported?">
283				description = <"Was the Adverse Reaction reported to a regulatory body?">
284			>
285			["id46"] = <
286				text = <"Adverse Reaction Report">
287				description = <"Link to an Adverse Reaction Report sent to a regulatory body.">
288			>
289			["id48"] = <
290				text = <"Supporting Clinical Record Information">
291				description = <"Link to further information about the presentation and findings that exist elsewhere in the health record, including allergy test reports.">
292			>
293			["id49"] = <
294				text = <"Report Comment">
295				description = <"Additional narrative about the Adverse Reaction Report, including the reason for non-reporting, if required.">
296			>
297			["id50"] = <
298				text = <"Future Use">
299				description = <"Narrative description of clinician instructions or advice related to future exposure to, or administration of, the Substance/Agent.">
300			>
301			["ac1"] = <
302				text = <"Certainty (synthesised)">
303				description = <"Degree of certainty, as assessed by a clinician, that the specific Substance/Agent was the cause of the Adverse Reaction. (synthesised)">
304			>
305		>
306	>
307	value_sets = <
308		["ac1"] = <
309			id = <"ac1">
310			members = <"at23", "at24", "at25">
311		>
312	>
313
314