ARCHETYPE ID | openEHR-EHR-ACTION.laboratory_test.v0 |
Concept | Laboratory test |
Description | A clinical laboratory or point-of-care test carried out on a biological sample for screening or diagnostic purposes. |
Use | Use to record information about the activities required to carry out a laboratory test, including the planning, scheduling, performance, suspension, cancellation, documentation and completion. This is done by the recording of data against specific activities, as defined by the 'Pathway' careflow steps in this archetype. The scope of this archetype encompasses activities for a broad range of clinical laboratory tests performed for screening or diagnostic purposes. Additional structured and detailed information about the laboratory test can be captured using purpose-specific archetypes inserted into the 'Test detail' slot, where required. Timings related to a laboratory test can be managed in one of two ways: - Using the reference model - the time for performance of any pathway step will use the ACTION time attribute for each step. - Archetyped data elements: --- the 'Scheduled date/time' data element is intended to record the precise time when the laboratory test is planned. Note: the corresponding ACTION time attribute for the Scheduled pathway step will record the time that the laboratory test was scheduled into a system, not the intended date/time on which the laboratory test is intended to be carried out; and --- the 'Final end date/time' is intended to record the precise time when the entire testing process was completed. It can be used to document the complex laboratory tests with multiple components such as a Glucose challenge test. Note: the corresponding ACTION time attribute for the 'Test performed' will document the time each component performed was commenced. This 'Final end date/time' data element will record the date/time of the final active component of the test process. This will enable a full duration of the active laboratory test to be calculated, if required. In practice, many test specimens (for example, in ambulatory care) will be collected without a corresponding order (using an INSTRUCTION archetype) once and not be ordered in advance. The details about the laboratory test will be added against the pathway step, 'Specimen collected'. In point of care testing, the specimen may be collected and the test recorded as completed against the 'Test completed' pathway step without an order or recording of data against any other pathway steps. In some cases a recurring laboratory test will be ordered, and in this situation data against the 'Test performed' step will be recorded on each occasion, leaving the instruction in the active state. When the last occurrence is recorded the 'laboratory test completed' action is recorded showing that this order is now in the completed state. In other situations, such as secondary care, there may be a formal order for a laboratory test using a corresponding INSTRUCTION archetype. This ACTION archetype can then be used to record the workflow of when and how the order has been carried out. Recording information using this ACTION archetype indicates that some sort of activity has actually occurred; this will usually be the laboratory test itself but may be a failed attempt or another activity such as postponing the laboratory test. If there is a formal order for the laboratory test, the state of this order is represented by the Pathway step against which the data is recorded. For example, using this archetype the progressing state of a pre-operative blood test order may be recorded through separate entries in the EHR progress notes at each 'Pathway' step: - record the scheduled Start date/time for the test (Test scheduled); and - record that the laboratory test has been completed, including information about the laboratory test details (Test completed). Please note that in the openEHR Reference Model there is a 'Time' attribute, which is intended to record the date and time at which each pathway step of the Action was performed. This is the attribute to use to record the start of the laboratory test (using the 'Test performed' pathway step) or the time that the laboratory test was aborted (using the 'Test aborted' pathway step). |
Misuse | Not to be used to record details about the test result - use the OBSERVATION.laboratory_test_result archetype for this purpose. Not to be used to record details about administrative activities - use specific ADMIN archetypes for this purpose. Not to be used to record details about related activities such as medication administered as part of the laboratory test or when imaging guidance is used during the laboratory test - use separate and specific ACTION archetypes within the same template for this purpose. |
Purpose | To record information about the activities required to carry out a laboratory test, including the planning, scheduling, performance, suspension, cancellation, documentation and completion. |
References | |
Copyright | © openEHR Foundation |
Authors | Author name: Heather Leslie Organisation: Atomica Informatics, Australia Email: heather.leslie@atomicainformatics.com Date originally authored: 2007-03-12 |
Other Details Language | Author name: Heather Leslie Organisation: Atomica Informatics, Australia Email: heather.leslie@atomicainformatics.com Date originally authored: 2007-03-12 |
OtherDetails Language Independent | {licence=This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/4.0/., custodian_organisation=openEHR Foundation, current_contact=Heather Leslie, Atomica Informatics, heather.leslie@atomicainformatics.com, original_namespace=org.openehr, original_publisher=openEHR Foundation, custodian_namespace=org.openehr, MD5-CAM-1.0.1=B57A070B23A6181E288B899E79EE6F39, build_uid=0bfd9d44-0788-4933-87c3-0bd9631c12fd, revision=0.0.1-alpha} |
Keywords | laboratory, test, diagnostic, evaluation, investigation, screening |
Lifecycle | in_development |
UID | 7ca6804b-966d-469d-b21f-7246ad739fb0 |
Language used | en |
Citeable Identifier | 1013.1.6558 |
Revision Number | 0.0.1-alpha |
All | Archetype [runtimeNameConstraintForConceptName=null, archetypeConceptBinding=null, archetypeConceptDescription=A clinical laboratory or point-of-care test carried out on a biological sample for screening or diagnostic purposes., archetypeConceptComment=null, otherContributors=, originalLanguage=en, translators=, subjectOfData=unconstrained, archetypeTranslationTree=null, topLevelToAshis={identities=[], other_participations=[], events=[], details=[], provider=[], items=[], description=[ResourceSimplifiedHierarchyItem [path=/description[at0001]/items[at0002], code=at0002, itemType=ELEMENT, level=2, text=Test name, description=Identification of the laboratory test by name., comment=Coding of the specific laboratory test with a terminology is preferred, where possible., uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/description[at0001]/items[at0071], code=at0071, itemType=SLOT, level=2, text=Specimen, description=, comment=null, uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Include: openEHR-EHR-CLUSTER.specimen.v1, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/description[at0001]/items[at0049], code=at0049, itemType=ELEMENT, level=2, text=Description, description=Narrative description about the laboratory test, as appropriate for the pathway step., comment=For example: description about the performance and findings from the the laboratory test, the aborted attempt or the cancellation of the laboratory test., 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=/description[at0001]/items[at0070], code=at0070, itemType=ELEMENT, level=2, text=Indication, description=The clinical or process-related reason for the laboratory test., comment=Coding of the indication with a terminology is preferred, where possible. This data element allows multiple occurrences. For example: 'Failed bowel preparation' or 'Bowel cancer screening'., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/description[at0001]/items[at0065], code=at0065, itemType=ELEMENT, level=2, text=Method, description=Identification of specific method or technique for the laboratory test., comment=Use this data element to record simple terms or a narrative description. If the requirements for recording the method require more complex modelling then this can be represented by additional archetypes within the 'laboratory test detail' SLOT in this archetype. If the method is included in the 'laboratory test name' via precoordinated codes, this data element becomes redundant., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/description[at0001]/items[at0058], code=at0058, itemType=ELEMENT, level=2, text=Urgency, description=Urgency of the laboratory test., comment=Coding with a terminology is preferred, where possible., 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=/description[at0001]/items[at0063], code=at0063, itemType=ELEMENT, level=2, text=Body site, description=Identification of the body site for the laboratory test., comment=Occurrences for this data element are unbounded to allow for clinical scenarios such as removing multiple skin lesions in different places, but where all of the other attributes are identical. Use this data element to record simple terms or precoordinated anatomical locations. If the requirements for recording the anatomical location are determined at run-time by the application or require more complex modelling such as relative locations then use the CLUSTER.anatomical_location or CLUSTER.relative_location within the 'laboratory test detail' SLOT in this archetype. If the anatomical location is included in the 'laboratory test name' via precoordinated codes, this data element becomes redundant., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=DV_TEXT, bindings=null, values=, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/description[at0001]/items[at0003], code=at0003, itemType=SLOT, level=2, text=Laboratory test detail, description=Structured information about the laboratory test., comment=Use to capture detailed, structured information about anatomical location, method & technique, equipment used, devices implanted, results, findings etc., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Include: openEHR-EHR-CLUSTER.device.v1 and specialisations or openEHR-EHR-CLUSTER.anatomical_ openEHR-EHR-CLUSTER.anatomical_ openEHR-EHR-CLUSTER.anatomical_
All not explicitly excluded archetypes, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0053]/items[at0056], code=at0056, itemType=ELEMENT, level=2, text=Receiver order identifier, description=The ID assigned to the order by the healthcare provider or organisation receiving the request for the test. This is also referred to as Filler Order Identifier., comment=This is equivalent to Filler Order Number in HL7 v2 specifications., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of:
All not explicitly excluded archetypes, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0053]/items[at0064], code=at0064, itemType=SLOT, level=2, text=Extension, description=Additional information required to capture local content or to align with other reference models/formalisms., comment=For example: local information requirements or additional metadata to align with FHIR or CIMI equivalents., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Include: All not explicitly excluded archetypes, extendedValues=null]], ism_transition=[ResourceSimplifiedHierarchyItem [path=/ism_transition[at0004]_526_at0004, code=at0004, itemType=ISM_TRANSITION, level=1, text=Test planned, description=The laboratory test to be undertaken is planned., comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: planned, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0007]_524_at0007, code=at0007, itemType=ISM_TRANSITION, level=1, text=Test request sent, description=Request for laboratory test sent., comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: initial, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0038]_527_at0038, code=at0038, itemType=ISM_TRANSITION, level=1, text=Test postponed, description=The laboratory test has been postponed., comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: postponed, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0039]_528_at0039, code=at0039, itemType=ISM_TRANSITION, level=1, text=Test cancelled, description=The planned laboratory test has been cancelled prior to commencement., comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: cancelled, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0036]_529_at0036, code=at0036, itemType=ISM_TRANSITION, level=1, text=Test scheduled, description=The laboratory test has been scheduled., comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: scheduled, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0068]_245_at0068, code=at0068, itemType=ISM_TRANSITION, level=1, text=Test commenced, description=The laboratory test, or sublaboratory test in a multicomponent laboratory test, has been commenced., comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: active, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0072]_245_at0072, code=at0072, itemType=ISM_TRANSITION, level=1, text=Specimen collected, description=The laboratory test is identified as a future activity., comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: active, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0073]_245_at0073, code=at0073, itemType=ISM_TRANSITION, level=1, text=Specimen received by laboratory, description=, comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: active, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0074]_245_at0074, code=at0074, itemType=ISM_TRANSITION, level=1, text=Specimen processed, description=, comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: active, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0047]_245_at0047, code=at0047, itemType=ISM_TRANSITION, level=1, text=Test performed, description=The laboratory test, or sublaboratory test in a multicomponent laboratory test, has been performed., comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: active, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0043]_532_at0043, code=at0043, itemType=ISM_TRANSITION, level=1, text=Test completed, description=The laboratory test has been performed and all associated clinical activities completed., comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: completed, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0040]_530_at0040, code=at0040, itemType=ISM_TRANSITION, level=1, text=Test suspended, description=The laboratory test has been suspended., comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: suspended, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/ism_transition[at0041]_531_at0041, code=at0041, itemType=ISM_TRANSITION, level=1, text=Test abandoned, description=The laboratory test has been aborted., comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=Current state: aborted, extendedValues=null]], context=[], data=[], activities=[], relationships=[], credentials=[], target=[], source=[], state=[], content=[], contacts=[], capabilities=[]}, topLevelItems={protocol=ResourceSimplifiedHierarchyItem [path=ROOT_/protocol[at0053], code=at0053, itemType=ITEM_TREE, level=0, text=null, description=null, comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=0..1, cardinalityText=optional, subCardinalityFormal=0..*, subCardinalityText=Minimum of 0 items , dataType=ITEM_TREE, bindings=null, values=null, extendedValues=null], ism_transition=ResourceSimplifiedHierarchyItem [path=ROOT_/ism_transition[at0004], code=at0004, itemType=ISM_TRANSITION, level=0, text=null, description=null, comment=null, uncommonOntologyItems=null, occurencesFormal=null, occurencesText=null, cardinalityFormal=0..1, cardinalityText=optional, subCardinalityFormal=null, subCardinalityText=null, dataType=ISM_TRANSITION, bindings=null, values=null, extendedValues=null], description=ResourceSimplifiedHierarchyItem [path=ROOT_/description[at0001], code=at0001, itemType=ITEM_TREE, level=0, text=null, description=null, comment=null, uncommonOntologyItems=null, occurencesFormal=1..1, occurencesText=Mandatory, cardinalityFormal=0..1, cardinalityText=optional, subCardinalityFormal=1..*, subCardinalityText= , dataType=ITEM_TREE, bindings=null, values=null, extendedValues=null]}, addHierarchyItemsTo=protocol, currentHierarchyItemsForAdding=[ResourceSimplifiedHierarchyItem [path=/protocol[at0053]/items[at0054], code=at0054, itemType=ELEMENT, level=2, text=Requestor order identifier, description=The local ID assigned to the order by the healthcare provider or organisation requesting the test., comment=This is equivalent to Placer Order Number in HL7 v2 specifications., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of:
All not explicitly excluded archetypes, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0053]/items[at0056], code=at0056, itemType=ELEMENT, level=2, text=Receiver order identifier, description=The ID assigned to the order by the healthcare provider or organisation receiving the request for the test. This is also referred to as Filler Order Identifier., comment=This is equivalent to Filler Order Number in HL7 v2 specifications., uncommonOntologyItems=null, occurencesFormal=0..1, occurencesText=Optional, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CHOICE, bindings=null, values=Choice of:
All not explicitly excluded archetypes, extendedValues=null], ResourceSimplifiedHierarchyItem [path=/protocol[at0053]/items[at0064], code=at0064, itemType=SLOT, level=2, text=Extension, description=Additional information required to capture local content or to align with other reference models/formalisms., comment=For example: local information requirements or additional metadata to align with FHIR or CIMI equivalents., uncommonOntologyItems=null, occurencesFormal=0..*, occurencesText=Optional, repeating, cardinalityFormal=null, cardinalityText=null, subCardinalityFormal=null, subCardinalityText=null, dataType=CLUSTER, bindings=null, values=Include: All not explicitly excluded archetypes, extendedValues=null]], minIndents={}, termBindingRetrievalErrorMessage=null] |