archetype (adl_version=1.4)
	openEHR-EHR-EVALUATION.substance_use_summary-alcohol.v1
specialise
	openEHR-EHR-EVALUATION.substance_use_summary.v1

concept
	[at0000.1]	-- Alcohol Use Summary
language
	original_language = <[ISO_639-1::en]>
description
	original_author = <
		["name"] = <"Heather Leslie">
		["organisation"] = <"Ocean Informatics">
		["email"] = <"heather.leslie@oceaninformatics.com">
		["date"] = <"21/06/2009">
	>
	details = <
		["en"] = <
			language = <[ISO_639-1::en]>
			purpose = <"To build up and record an ongoing and persistent summary about the consumption of any and all types of alcohol by the individual.">
			use = <"Use to record a summary of the pattern of consumption for any and all forms of alcohol and about multiple episodes of alcohol consumption over time.">
			keywords = <"consumption", "substance", "use", "usage", "dependence", "alcohol">
			misuse = <"Not to be used to capture event-based information about alcohol consumption, such as an Alcohol consumption or Drinking diary - use the OBSERVATION.substance_use-alcohol archetype.">
			copyright = <"© openEHR Foundation">
		>
	>
	lifecycle_state = <"CommitteeDraft">
	other_contributors = <"Sam Heard, Ocean Informatics, Australia", ...>
	other_details = <
		["MD5-CAM-1.0.1"] = <"F807E79ACD5CC187A929B0A0302A9179">
	>

definition
	EVALUATION[at0000.1] matches {	-- Alcohol Use Summary
		data matches {
			ITEM_TREE[at0001] matches {	-- Tree
				items cardinality matches {0..*; unordered} matches {
					ELEMENT[at0005.1] occurrences matches {0..1} matches {	-- Substance
						value matches {
							DV_TEXT matches {*}
						}
					}
					ELEMENT[at0002.1] occurrences matches {0..1} matches {	-- Usage Status
						value matches {
							DV_CODED_TEXT matches {
								defining_code matches {
									[local::
									at0003, 	-- Current alcohol drinker
									at0004, 	-- Former regular alcohol drinker
									at0006, 	-- Former occasional alcohol drinker
									at0016]	-- Never drunk alcohol
								}
							}
						}
					}
					CLUSTER[at0007.1] occurrences matches {0..*} matches {	-- Consumption Summary
						items cardinality matches {1..*; unordered} matches {
							ELEMENT[at0008.1] occurrences matches {0..1} matches {	-- Type
								value matches {
									DV_TEXT matches {*}
								}
							}
							ELEMENT[at0015.1] occurrences matches {0..1} matches {	-- Method of use
								value matches {
									DV_CODED_TEXT matches {
										defining_code matches {[local::at0.27]}		-- Ingested
									}
								}
							}
							ELEMENT[at0009.1] occurrences matches {0..1} matches {	-- Date commenced
								value matches {
									DV_DATE_TIME matches {*}
								}
							}
							ELEMENT[at0010.1] occurrences matches {0..1} matches {	-- Age commenced
								value matches {
									DV_DURATION matches {*}
								}
							}
							ELEMENT[at0011.1] occurrences matches {0..1} matches {	-- Date ceased
								value matches {
									DV_DATE_TIME matches {*}
								}
							}
							ELEMENT[at0012.1] occurrences matches {0..1} matches {	-- Age ceased
								value matches {
									DV_DURATION matches {*}
								}
							}
							ELEMENT[at0017.1] occurrences matches {0..1} matches {	-- Context of use
								value matches {
									DV_TEXT matches {*}
								}
							}
							ELEMENT[at0013.1] occurrences matches {0..1} matches {	-- Comment
								value matches {
									DV_TEXT matches {*}
								}
							}
						}
					}
					allow_archetype CLUSTER[at0014.1] occurrences matches {0..*} matches {	-- Cessation attempts
						include
							archetype_id/value matches {/openEHR-EHR-CLUSTER\.cessation_attempts\.v1/}
					}
					ELEMENT[at0018.1] occurrences matches {0..1} matches {	-- Comment
						value matches {
							DV_TEXT matches {*}
						}
					}
				}
			}
		}
	}

ontology
	term_definitions = <
		["en"] = <
			items = <
				["at0.27"] = <
					text = <"Ingested">
					description = <"Absorbed through the gastrointestinal tract.">
				>
				["at0000"] = <
					text = <"Substance Use Summary">
					description = <"Overview of use or consumption of a defined substance, including caffeine, alcohol, tobacco, volatile substances and illicit drugs.">
				>
				["at0000.1"] = <
					text = <"Alcohol Use Summary">
					description = <"Summary of alcohol consumption by the individual.">
				>
				["at0001"] = <
					text = <"Tree">
					description = <"@ internal @">
				>
				["at0002.1"] = <
					text = <"Usage Status">
					description = <"Overview of usage of alcohol.">
				>
				["at0003"] = <
					text = <"Current alcohol drinker">
					description = <"Individual is a current consumer of alcohol.">
				>
				["at0004"] = <
					text = <"Former regular alcohol drinker">
					description = <"Individual is a former or ex-consumer of alcohol on a regular basis.">
				>
				["at0005.1"] = <
					text = <"Substance">
					description = <"Identification of alcohol consumed. May be 'all alcohol' or a specific type of alcohol eg wine, beer, or spirit.">
				>
				["at0006"] = <
					text = <"Former occasional alcohol drinker">
					description = <"Individual is a former or ex-consumer of alcohol on an occasional basis.">
				>
				["at0007.1"] = <
					text = <"Consumption Summary">
					description = <"Summary of the pattern of use for any and all forms of alcohol, and for multiple episodes of use.">
				>
				["at0008.1"] = <
					text = <"Type">
					description = <"Identify the specific type of alcohol consumed.">
					fsn = <"Consumption Summary Type">
				>
				["at0009.1"] = <
					text = <"Date commenced">
					description = <"Date that consumption of alcohol commenced (can be a partial date, such as a year).">
				>
				["at0010.1"] = <
					text = <"Age commenced">
					description = <"Age that consumption of alcohol commenced.">
				>
				["at0011.1"] = <
					text = <"Date ceased">
					description = <"Date that consumption of alcohol ceased (can be a partial date, such as a year).">
				>
				["at0012.1"] = <
					text = <"Age ceased">
					description = <"Age that consumption of alcohol ceased.">
				>
				["at0013.1"] = <
					text = <"Comment">
					description = <"Comment on this episode/type of alcohol consumption.">
					fsn = <"Consumption Summary Comment">
				>
				["at0014.1"] = <
					text = <"Cessation attempts">
					description = <"Details about attempts to cease use of alcohol.">
				>
				["at0015.1"] = <
					text = <"Method of use">
					description = <"Method of consumption of alcohol.">
				>
				["at0016"] = <
					text = <"Never drunk alcohol">
					description = <"Individual has never consumed alcohol.">
				>
				["at0017.1"] = <
					text = <"Context of use">
					description = <"Description about the social, cultural or psychological context that contributed to the alcohol consumption.">
				>
				["at0018.1"] = <
					text = <"Comment">
					description = <"Overall comment about the individual's consumption of alcohol.">
					fsn = <"Substance Use Summary Alcohol Comment">
				>
			>
		>
	>