ARCHETYPE Dosage (openEHR-EHR-CLUSTER.dosage.v2)

Name: Dosage
License: http://creativecommons.org/licenses/by-sa/3.0/

ARCHETYPE ID	openEHR-EHR-CLUSTER.dosage.v2
Concept	Dosage
Description	The combination of a medication amount and administration timing for a single day, in the context of a medication order or medication management.
Use	Use to record the combination of a medication amount and the administration timing for a single day, as part of a medication order or medication management or for other appropriate therapeutic/prescribable items. The timing pattern for a single day can be as simple as a single administration time, or multiple administration times with varying levels of complexity. Timing details which are not within a single day, for example, weekly or monthly timings, are carried in the CLUSTER 'Timing - non-daily' archetype carried within the CLUSTER 'Therapeutic direction' archetype. In the context of a therapeutic INSTRUCTION, this archetype may be inserted into the 'Structured dose and timing directions' SLOT in the 'Therapeutic direction' CLUSTER to record the dose and timing details of the pattern of single intended administrations of a therapeutic item. In the context of an ACTION archetype insert this archetype directly into the 'Amount' SLOT to record the dose and timing of the actual administration of a therapeutic item. Specific administration start/stop times should be specified within a contained CLUSTER 'Timing - daily' archetype.
Purpose	To record the combination of a medication amount and the administration timing within a single day, as part of a medication order or medication management or for other appropriate therapeutic/prescribable items.
References	Medication statement, [Internet]. Intermountain Healthcare. Available from http://www.opencem.org/#/20170613/Intermountain/MedicationStatement Messaging Implementation Manual (GP2GP messages) [Internet], NHS Digital England. Available from: https://data.developer.nhs.uk/dms/mim/6.3.01/Domains/GP2GP/Document%20files/GP2GP%20IM.htm#_Toc_Section_7.2 Standards for the clinical structure and content of patient records (Complete document) [Internet]. PRSB London. [cited 2017 Aug 29]. Available from: http://theprsb.org/download/document/7-standards-for-the-clinical-structure-and-content-of-patient-records"
Copyright	© openEHR Foundation
Authors	Author name: Ian McNicoll Organisation: freshEHR Clinical Informatics Email: ian@freshehr.com Date originally authored: 2017-03-21
Other Details Language	Author name: Ian McNicoll Organisation: freshEHR Clinical Informatics Email: ian@freshehr.com Date originally authored: 2017-03-21
OtherDetails Language Independent	{licence=This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/., custodian_organisation=openEHR Foundation, references=Medication statement, [Internet]. Intermountain Healthcare. Available from http://www.opencem.org/#/20170613/Intermountain/MedicationStatement Messaging Implementation Manual (GP2GP messages) [Internet], NHS Digital England. Available from: https://data.developer.nhs.uk/dms/mim/6.3.01/Domains/GP2GP/Document%20files/GP2GP%20IM.htm#_Toc_Section_7.2 Standards for the clinical structure and content of patient records (Complete document) [Internet]. PRSB London. [cited 2017 Aug 29]. Available from: http://theprsb.org/download/document/7-standards-for-the-clinical-structure-and-content-of-patient-records", current_contact=Ian McNicoll, freshEHR Clinical Informatics, UK , original_namespace=org.openehr, original_publisher=openEHR Foundation, custodian_namespace=org.openehr, MD5-CAM-1.0.1=926B8773E3FBB271F2820D4198B4F63E, build_uid=54847bc3-76e5-48b9-831f-d3002ef5cf63, revision=2.0.2}
Keywords	medication, order, prescribe, therapy, substance, drug, therapeutic, therapeutic good, pharmaceutical, product, posology, treatment, fluid, nutrition, timing, administration, dose
Lifecycle	published
UID	938dd9db-f631-4df2-9221-07aeadac7917
Language used	en
Citeable Identifier	1013.1.5948
Revision Number	2.0.2
All	Archetype [runtimeNameConstraintForConceptName=null, archetypeConceptBinding=null, archetypeConceptDescription=The combination of a medication amount and administration timing for a single day, in the context of a medication order or medication management., archetypeConceptComment=For example: '2 tablets at 6pm' or '20 mg three times per day'. Please note: this cluster allows multiple occurrences to enable representation of a complete set of dose patterns for a single dose direction., otherContributors=Tomas Alme, DIPS ASA, Norway Paula Anderson, UCLH, United Kingdom Vebjørn Arntzen, Oslo University Hospital, Norway (openEHR Editor) Koray Atalag, University of Auckland, New Zealand Silje Ljosland Bakke, Nasjonal IKT HF, Norway (openEHR Editor) Marcus Baw, openGPSoC / BawMedical Ltd, United Kingdom John Bennett, NEHTA, Australia SBhusan Bhattacharyya, Sudisa Consultancy Services, India Sharmila Biswas, Australia Lars Bitsch-Larsen, Haukeland University hospital, Norway Laila Bruun, Oslo universitetssykehus HF, Norway Ruth Caudwell, retired, United Kingdom Bjørn Christensen, Helse Bergen HF, Norway Stephen Chu, NEHTA, Australia (Editor) Matthew Cordell, NEHTA, Australia Lisbeth Dahlhaug, Helse Midt - Norge IT, Norway Robert Eager, Healthways, Australia Gail Easterbrook, Flinders Medical Centre, Australia David Evans, Queensland Health, Australia Samuel Frade, Marand, Portugal Hildegard Franke, freshEHR Clinical Informatics Ltd., United Kingdom Sarah Gaunt, NEHTA, Australia Mikkel Gaup Grønmo, FSE, Helse Nord, Norway Heather Grain, Llewelyn Grain Informatics, Australia Trina Gregory, cpc, Australia Robert Hausam, Hausam Consulting LLC, United States Sam Heard, Ocean Informatics, Australia (Editor) Teresa Highway, Alberta Health Services, Canada Annette Hole Sjøborg, DIPS ASA, Norway Hilde Hollås, DIPS ASA, Norway Alfred Honore, Haukeland, Norway Evelyn Hovenga, EJSH Consulting, Australia Lars Ivar Mehlum, Helse Bergen HF, Norway Tom Jarl Jakobsen, Helse Bergen, Norway Mary Kelaher, NEHTA, Australia Nils Kolstrup, Skansen Legekontor og Nasjonalt Senter for samhandling og telemedisin, Norway Robert L'egan, NEHTA, Australia Russell Leftwich, Russell B Leftwich MD, United States Heather Leslie, Ocean Health Systems, Australia (openEHR Editor) Marit Ludvigsen, St Olavs Hospital, Norway Colin Macfarlane, Elsevier, United Kingdom Siv Marie Lien, DIPS ASA, Norway Olof Mattsson, Region Skane, Sweden Susan McIndoe, Royal District Nursing Service, Australia David McKillop, NEHTA, Australia Ian McNicoll, freshEHR Clinical Informatics, United Kingdom (openEHR Editor) Chris Mitchell, RACGP, Australia Stewart Morrison, NEHTA, Australia Andrej Orel, Marand d.o.o., Slovenia Chris Pearce, Melbourne East GP Network, Australia Vladimir Pizzo, Hospital Sírio Libanês, Brazil Camilla Preeston, Royal Australian College of General Practitioners, Australia Margaret Prichard, NEHTA, Australia Norwegian Review Summary, Nasjonal IKT HF, Norway Cathy Richardson, NEHTA, Australia Robyn Richards, NEHTA - Clinical Terminology, Australia Anoop Shah, University College London, United Kingdom Line Silsand, Universitetssykehuset i Nord-Norge, Norway Sam Stokes, Citizen Scientist, United States Iztok Stotl, UKCLJ, Slovenia John Taylor, NEHTA, Australia Nyree Taylor, Ocean Informatics, Australia Rowan Thomas, St. Vincent's Hospital Melbourne, Australia Richard Townley-O'Neill, NEHTA, Australia Gro-Hilde Ulriksen, Norwegian center for ehealthresearch, Norway John Tore Valand, Helse Bergen, Norway (openEHR Editor) Ines Vaz, UFN, Portugal Soon Ghee Yap, Singapore General Hospital, Singapore Kylie Young, The Royal Australian College of General Practitioners, Australia, originalLanguage=en, translators= German: Nazli Soltani, Natalia Strauch, Alexander Bachmeier, UMG, Medizinische Schule Hannover (MHH), Medizinische Hochschule Hannover, Heidelberg University Hospital, nazli.soltani@med.uni-goettingen.de, strauch.natalia@mh-hannover.de, Strauch.Natalia@mh-hannover.de, alexander.bachmeier@med.uni-heidelberg.de Swedish: Therese Lindberg, Cambio CDS, therese.lindberg@cambio.se Norwegian Bokmål: Silje Ljosland Bakke, Nasjonal IKT HF, Helse Vest IKT AS, silje.ljosland.bakke@helse-vest-ikt.no Portuguese (Brazil): Debora Farage, Fernanda Maia, Laíse Figueiredo, Core Consulting, contato@coreconsulting.com.br, Hospital Alemão Oswaldo Cruz (HAOC) , subjectOfData=unconstrained, archetypeTranslationTree=null, topLevelToAshis={items=[ResourceSimplifiedHierarchyItem [path=/items[at0164], code=at0164, itemType=ELEMENT, level=1, text=Dosage sequence, description=The intended position of this dosage within the overall sequence of dosages., comment=For example: '1', '2', '3'. Where multiple dosages are expressed, the 'Pattern sequence' makes the order in which they should be executed explicit. For example: (1) 1 tab in the morning, (2) 2 tab at 2pm, (3) 1 tab at night., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_COUNT, bindings=null, values=min: >=1 , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0144], code=at0144, itemType=ELEMENT, level=1, text=Dose, description=The amount of medication administered at one time., comment=For example: 1 mg, 1.5 ml, 0.125 g; or 1-2 ml, 12.5-20.5 mg., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of: Quantity Interval of Quantity , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0135], code=at0135, itemType=ELEMENT, level=1, text=Dose formula, description=The formula used to calculate the dose amount or administration rate where this is dependent on some other factor, such as body weight or surface area., comment=For example: '10 mg/kg/day'. The result of this formula would normally be held in Dose or Administration rate/duration. Where clinical measurements such as body weight is used in the dose calculation, a LINK attribute should used to specify which particular measurement has been used., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of: Text Quantity , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0178], code=at0178, itemType=ELEMENT, level=1, text=Dose description, description=Text description of the dose., comment=For example: "Apply ointment to affected area until it glistens". This element is intended to allow implementers to use the structures for increasing/tapering dosages without necessarily specifying the doses in a structured way., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0037], code=at0037, itemType=SLOT, level=1, text=Daily timing, description=Structured details about the timing pattern for a single day., comment=For example: 'in the morning', 'at 0600, 1400, 2100'., uncommonOntologyItems=null, occurencesFormal=0.., occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Include:* openEHR-EHR-CLUSTER.timing_daily.v1 and specialisations, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0134], code=at0134, itemType=ELEMENT, level=1, text=Administration rate, description=The rate at which the medication, such as an infusion, is to be administered., comment=For example: '200 ml/h'. Use the text data type to record non- or semi-quantifiable instructions., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of: Quantity Property: Flow rate, volume Units: >=0.0 l/h >=0.0 ml/min >=0.0 ml/s >=0.0 ml/h Text , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0102], code=at0102, itemType=ELEMENT, level=1, text=Administration duration, description=The period of time over which a single dose of the medication or vaccine should be administered., comment=For example: 'Administer over 10 minutes'., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of: Duration Allowed values: days, hours, minutes, seconds >=0 seconds Interval of Duration Lower: Allowed values: days, hours, minutes, seconds >=0 seconds Upper: Allowed values: days, hours, minutes, seconds >=0 seconds , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0176], code=at0176, itemType=ELEMENT, level=1, text=Alternate dose, description=An alternate representation of the amount of medication administered at one time., comment=For example, can be used to represent a unit-dose based value such as 'tabs', when the Dose amount is expressed as an SI unit such as 'mg', or where it is required to express the total volume of an infusion as well as the amount of the active ingredient., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of: Quantity Interval of Quantity , extendedValues=null]], description=[], context=[], activities=[], identities=[], capabilities=[], provider=[], protocol=[], content=[], source=[], credentials=[], events=[], data=[], contacts=[], ism_transition=[], details=[], relationships=[], state=[], target=[], other_participations=[]}, topLevelItems={items=ResourceSimplifiedHierarchyItem [path=ROOT_/, code=at0000, itemType=CLUSTER, level=0, text=null, description=null, comment=null, uncommonOntologyItems=null, occurencesFormal=0.., occurencesText=Optional, repeating, cardinalityFormal=1.., cardinalityText= (Cardinality: 1.., unordered), subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=null, extendedValues=null]}, addHierarchyItemsTo=items, currentHierarchyItemsForAdding=[ResourceSimplifiedHierarchyItem [path=/items[at0164], code=at0164, itemType=ELEMENT, level=1, text=Dosage sequence, description=The intended position of this dosage within the overall sequence of dosages., comment=For example: '1', '2', '3'. Where multiple dosages are expressed, the 'Pattern sequence' makes the order in which they should be executed explicit. For example: (1) 1 tab in the morning, (2) 2 tab at 2pm, (3) 1 tab at night., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_COUNT, bindings=null, values=min: >=1 , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0144], code=at0144, itemType=ELEMENT, level=1, text=Dose, description=The amount of medication administered at one time., comment=For example: 1 mg, 1.5 ml, 0.125 g; or 1-2 ml, 12.5-20.5 mg., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of:* Quantity Interval of Quantity , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0135], code=at0135, itemType=ELEMENT, level=1, text=Dose formula, description=The formula used to calculate the dose amount or administration rate where this is dependent on some other factor, such as body weight or surface area., comment=For example: '10 mg/kg/day'. The result of this formula would normally be held in Dose or Administration rate/duration. Where clinical measurements such as body weight is used in the dose calculation, a LINK attribute should used to specify which particular measurement has been used., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of: Text Quantity , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0178], code=at0178, itemType=ELEMENT, level=1, text=Dose description, description=Text description of the dose., comment=For example: "Apply ointment to affected area until it glistens". This element is intended to allow implementers to use the structures for increasing/tapering dosages without necessarily specifying the doses in a structured way., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0037], code=at0037, itemType=SLOT, level=1, text=Daily timing, description=Structured details about the timing pattern for a single day., comment=For example: 'in the morning', 'at 0600, 1400, 2100'., uncommonOntologyItems=null, occurencesFormal=0.., occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Include:* openEHR-EHR-CLUSTER.timing_daily.v1 and specialisations, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0134], code=at0134, itemType=ELEMENT, level=1, text=Administration rate, description=The rate at which the medication, such as an infusion, is to be administered., comment=For example: '200 ml/h'. Use the text data type to record non- or semi-quantifiable instructions., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of: Quantity Property: Flow rate, volume Units: >=0.0 l/h >=0.0 ml/min >=0.0 ml/s >=0.0 ml/h Text , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0102], code=at0102, itemType=ELEMENT, level=1, text=Administration duration, description=The period of time over which a single dose of the medication or vaccine should be administered., comment=For example: 'Administer over 10 minutes'., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of: Duration Allowed values: days, hours, minutes, seconds >=0 seconds Interval of Duration Lower: Allowed values: days, hours, minutes, seconds >=0 seconds Upper: Allowed values: days, hours, minutes, seconds >=0 seconds , extendedValues=null], ResourceSimplifiedHierarchyItem [path=/items[at0176], code=at0176, itemType=ELEMENT, level=1, text=Alternate dose, description=An alternate representation of the amount of medication administered at one time., comment=For example, can be used to represent a unit-dose based value such as 'tabs', when the Dose amount is expressed as an SI unit such as 'mg', or where it is required to express the total volume of an infusion as well as the amount of the active ingredient., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of: Quantity Interval of Quantity , extendedValues=null]], minIndents={}, termBindingRetrievalErrorMessage=null]