Lab
Class LaboratoryObservation

This class represents a test result or observation that may be reported. Some tests, such as an microbiology identification may have multiple results reported over time, for example a preliminary gram stain result might be initially reported, followed by the identification and relative number of organisms, followed by an antibiotic senstivity test results. Each one of these results would manifest as a separate instance of this class, each with their own date/times, performers, etc.

"The OBX segment is used to transmit a single observation or observation fragment. It represents the smallest indivisible unit of a report." - HL7 Version 2.8, OBX

Attributes
«TS» PointInTime dateDeemedReportable dateDeemedReportable

"Specifies the date/time when the results were reported or status changed. This conditional field is required whenever [Report Status] is valued. This field is used to indicate the date and time that the results are composed into a report and released, or that [Healthcare Order status] is entered or changed." - HL7 Version 2.8, OBR-22.

«TS» PointInTime dateTimeOfAnalysis dateTimeOfAnalysis

"The time stamp associated with generation of the analytical result by the instrument specified in [the deviceInstance]" - HL7 Version 2.8, OBX.19

PractitionerParticipation laboratoryDirector laboratoryDirector

This is the director of the laboratory that is reporting the result to the Orderer. This person may or may not be the director of the organization that actually performed the analysis, rather of the reporting organization.

«REAL» Decimal probability probability

"Contains the probability of a result being true for results with categorical values. It mainly applies to discrete coded results. It is a decimal number ... between 0 and 1, inclusive." - HL7 Version 2.8, OBX-9.

«TS» PointInTime reportDate reportDate

"Specifies the date/time when the results were reported or status changed. This conditional field is required whenever [Report Status] is valued. This field is used to indicate the date and time that the results are composed into a report and released, or that [Healthcare Order status] is entered or changed." - HL7 Version 2.8, OBR-22.

«CS» Code reReleaseReason reReleaseReason

"Indicates the root cause for the reissue of a previously released lab report. This element is used in conjunction with OBX-11 Observation Result Status to define the root cause for a reissued laboratory report in the case of a corrected, amended, appended, or revised report." - HL7 Version 2.8, OBX-27.

String subId subId

"This field is used to distinguish between multiple OBX segments with the same observation ID organized under one OBR." - HL7 Version 2.8, OBX-4.

«CS» Code topicCode topicCode

This property exists to show that the Lab Test that has been observed (aka resulted) is handled using the topicCode property inherited from ClinicalStatement. This property is marked as derived in that it will generally not be implemented, or if it is, it would be re-defined such that the allowable set of values that this property can reference is limited to Lab observations. Generally these will be LOINC codes, but will be a SNOMED code in the case of microbe identification. Note that VA's VistA system uses the VA National Laboratory Test code via File 64.

"Contains a unique identifier for the observation.... In most systems the identifier will point to a master observation table that will provide other attributes of the observation that may be used by the receiving system to process the observations it receives". - HL7 Version 2.8, OBX-3.

Attribution transcription transcription

If the laboratory observation report was dictated, this property identifies the person who converted the spoken words into written form.

String userDefinedAccessCheck userDefinedAccessCheck

"This field permits the producer to record results-dependent codes for classifying the observation at the receiving system. This field should be needed only rarely..." - HL7 Version 2.8, OBX-13.

Attributes inherited from FHIM::ClinicalObservation::ObservationStatement FHIM::ClinicalObservation::ObservationStatement
basedOn basedOn, bodySite bodySite, category category, componentObservation componentObservation, dataAbsentReason dataAbsentReason, dateTime dateTime, dateTimeIssued dateTimeIssued, deltaFlag deltaFlag, description description, deviceInstance deviceInstance, evaluationProcedure evaluationProcedure, exceptionValue exceptionValue, interpretationEvent interpretationEvent, method method, multimedia multimedia, observed observed, observedCharacteristic observedCharacteristic, referenceRange referenceRange, reliability reliability, resultStatus resultStatus, specimen specimen, value value, derivedFrom derivedFrom, hasMember hasMember, partOf partOf

Attributes inherited from FHIM::Common::ClinicalStatement FHIM::Common::ClinicalStatement
clinicalDataSource clinicalDataSource, contentVersion contentVersion, contextCode contextCode, encounter encounter, note note, recordStatus recordStatus, relatedClinicalInformation relatedClinicalInformation, sourceRecordType sourceRecordType, sourceSystem sourceSystem, subjectGroup subjectGroup, subjectOfInformation subjectOfInformation, subjectOfRecord subjectOfRecord, temporalContext temporalContext, topicCode topicCode, cosigned cosigned, recorded recorded, signed signed, verified verified

Attributes inherited from FHIM::Common::InformationEntry FHIM::Common::InformationEntry
identifier identifier

Properties:

Alias
Classifier Behavior
Is Abstracttrue
Is Activefalse
Is Leaffalse
Keywords
NameLaboratoryObservation
Name Expression
NamespaceLab
Owned Template Signature
OwnerLab
Owning Template Parameter
PackageLab
Qualified NameFHIM::Lab::LaboratoryObservation
Representation
Stereotype
Template Parameter
VisibilityPublic

Attribute Details

 dateDeemedReportable
Public «TS» PointInTime dateDeemedReportable

"Specifies the date/time when the results were reported or status changed. This conditional field is required whenever [Report Status] is valued. This field is used to indicate the date and time that the results are composed into a report and released, or that [Healthcare Order status] is entered or changed." - HL7 Version 2.8, OBR-22.

Constraints:
Properties:

AggregationNone
Alias
Association
Association End
ClassLaboratoryObservation
Datatype
Default
Default Value
Is Compositefalse
Is Derivedfalse
Is Derived Unionfalse
Is Leaffalse
Is Orderedfalse
Is Read Onlyfalse
Is Staticfalse
Is Uniquetrue
Keywords
Lower1
Lower Value(1)
Multiplicity1
NamedateDeemedReportable
Name Expression
NamespaceLaboratoryObservation
Opposite
OwnerLaboratoryObservation
Owning Association
Owning Template Parameter
Qualified NameFHIM::Lab::LaboratoryObservation::dateDeemedReportable
Stereotype
Template Parameter
Type«TS» PointInTime
Upper1
Upper Value(1)
VisibilityPublic


 dateTimeOfAnalysis
Public «TS» PointInTime dateTimeOfAnalysis

"The time stamp associated with generation of the analytical result by the instrument specified in [the deviceInstance]" - HL7 Version 2.8, OBX.19

Constraints:
Properties:

AggregationNone
Alias
Association
Association End
ClassLaboratoryObservation
Datatype
Default
Default Value
Is Compositefalse
Is Derivedfalse
Is Derived Unionfalse
Is Leaffalse
Is Orderedfalse
Is Read Onlyfalse
Is Staticfalse
Is Uniquefalse
Keywords
Lower1
Lower Value(1)
Multiplicity1
NamedateTimeOfAnalysis
Name Expression
NamespaceLaboratoryObservation
Opposite
OwnerLaboratoryObservation
Owning Association
Owning Template Parameter
Qualified NameFHIM::Lab::LaboratoryObservation::dateTimeOfAnalysis
Stereotype
Template Parameter
Type«TS» PointInTime
Upper1
Upper Value(1)
VisibilityPublic


 laboratoryDirector
Public PractitionerParticipation laboratoryDirector

This is the director of the laboratory that is reporting the result to the Orderer. This person may or may not be the director of the organization that actually performed the analysis, rather of the reporting organization.

Constraints:
Properties:

AggregationNone
Alias
Association
Association End
ClassLaboratoryObservation
Datatype
Default
Default Value
Is Compositefalse
Is Derivedfalse
Is Derived Unionfalse
Is Leaffalse
Is Orderedfalse
Is Read Onlyfalse
Is Staticfalse
Is Uniquetrue
Keywords
Lower0
Lower Value(0)
Multiplicity0..1
NamelaboratoryDirector
Name Expression
NamespaceLaboratoryObservation
Opposite
OwnerLaboratoryObservation
Owning Association
Owning Template Parameter
Qualified NameFHIM::Lab::LaboratoryObservation::laboratoryDirector
Stereotype
Template Parameter
TypePractitionerParticipation
Upper1
Upper Value(1)
VisibilityPublic


 probability
Public «REAL» Decimal probability

"Contains the probability of a result being true for results with categorical values. It mainly applies to discrete coded results. It is a decimal number ... between 0 and 1, inclusive." - HL7 Version 2.8, OBX-9.

Constraints:
Properties:

AggregationNone
Alias
Association
Association End
ClassLaboratoryObservation
Datatype
Default
Default Value
Is Compositefalse
Is Derivedfalse
Is Derived Unionfalse
Is Leaffalse
Is Orderedfalse
Is Read Onlyfalse
Is Staticfalse
Is Uniquetrue
Keywords
Lower0
Lower Value(0)
Multiplicity0..1
Nameprobability
Name Expression
NamespaceLaboratoryObservation
Opposite
OwnerLaboratoryObservation
Owning Association
Owning Template Parameter
Qualified NameFHIM::Lab::LaboratoryObservation::probability
Stereotype
Template Parameter
Type«REAL» Decimal
Upper1
Upper Value(1)
VisibilityPublic


 reportDate
Public «TS» PointInTime reportDate

"Specifies the date/time when the results were reported or status changed. This conditional field is required whenever [Report Status] is valued. This field is used to indicate the date and time that the results are composed into a report and released, or that [Healthcare Order status] is entered or changed." - HL7 Version 2.8, OBR-22.

Constraints:
Properties:

AggregationNone
Alias
Association
Association End
ClassLaboratoryObservation
Datatype
Default
Default Value
Is Compositefalse
Is Derivedfalse
Is Derived Unionfalse
Is Leaffalse
Is Orderedfalse
Is Read Onlyfalse
Is Staticfalse
Is Uniquetrue
Keywords
Lower1
Lower Value(1)
Multiplicity1
NamereportDate
Name Expression
NamespaceLaboratoryObservation
Opposite
OwnerLaboratoryObservation
Owning Association
Owning Template Parameter
Qualified NameFHIM::Lab::LaboratoryObservation::reportDate
Stereotype
Template Parameter
Type«TS» PointInTime
Upper1
Upper Value(1)
VisibilityPublic


 reReleaseReason
Public «CS» Code reReleaseReason

"Indicates the root cause for the reissue of a previously released lab report. This element is used in conjunction with OBX-11 Observation Result Status to define the root cause for a reissued laboratory report in the case of a corrected, amended, appended, or revised report." - HL7 Version 2.8, OBX-27.

Constraints:
Properties:

AggregationNone
Alias
Association
Association End
ClassLaboratoryObservation
Datatype
Default
Default Value
Is Compositefalse
Is Derivedfalse
Is Derived Unionfalse
Is Leaffalse
Is Orderedfalse
Is Read Onlyfalse
Is Staticfalse
Is Uniquetrue
Keywords
Lower0
Lower Value(0)
Multiplicity0..1
NamereReleaseReason
Name Expression
NamespaceLaboratoryObservation
Opposite
OwnerLaboratoryObservation
Owning Association
Owning Template Parameter
Qualified NameFHIM::Lab::LaboratoryObservation::reReleaseReason
Stereotype
Template Parameter
Type«CS» Code
Upper1
Upper Value(1)
VisibilityPublic


 subId
Public String subId

"This field is used to distinguish between multiple OBX segments with the same observation ID organized under one OBR." - HL7 Version 2.8, OBX-4.

Constraints:
Properties:

AggregationNone
Alias
Association
Association End
ClassLaboratoryObservation
Datatype
Default
Default Value
Is Compositefalse
Is Derivedfalse
Is Derived Unionfalse
Is Leaffalse
Is Orderedfalse
Is Read Onlyfalse
Is Staticfalse
Is Uniquetrue
Keywords
Lower0
Lower Value(0)
Multiplicity0..1
NamesubId
Name Expression
NamespaceLaboratoryObservation
Opposite
OwnerLaboratoryObservation
Owning Association
Owning Template Parameter
Qualified NameFHIM::Lab::LaboratoryObservation::subId
Stereotype
Template Parameter
TypeString
Upper1
Upper Value(1)
VisibilityPublic


 topicCode
Public «CS» Code topicCode

This property exists to show that the Lab Test that has been observed (aka resulted) is handled using the topicCode property inherited from ClinicalStatement. This property is marked as derived in that it will generally not be implemented, or if it is, it would be re-defined such that the allowable set of values that this property can reference is limited to Lab observations. Generally these will be LOINC codes, but will be a SNOMED code in the case of microbe identification. Note that VA's VistA system uses the VA National Laboratory Test code via File 64.

"Contains a unique identifier for the observation.... In most systems the identifier will point to a master observation table that will provide other attributes of the observation that may be used by the receiving system to process the observations it receives". - HL7 Version 2.8, OBX-3.

Constraints:
Properties:

AggregationNone
Alias
Association
Association End
ClassLaboratoryObservation
Terminologies[
C-CDA_2.1 LOINC 2.16.840.1.113883.6.1
,
HL7_FHIR_R4 LOINC Codes http://hl7.org/fhir/ValueSet/observation-codes
,
HL7_V2 Lab Test Result Name 2.16.840.1.114222.4.11.1002
]
Datatype
Default
Default Value
Is Compositefalse
Is Derivedtrue
Is Derived Unionfalse
Is Leaffalse
Is Orderedfalse
Is Read Onlyfalse
Is Staticfalse
Is Uniquetrue
Keywords
Lower1
Lower Value(1)
Multiplicity1
NametopicCode
Name Expression
NamespaceLaboratoryObservation
Opposite
OwnerLaboratoryObservation
Owning Association
Owning Template Parameter
Qualified NameFHIM::Lab::LaboratoryObservation::topicCode
StereotypeValueSetConstraints
Template Parameter
Type«CS» Code
Upper1
Upper Value(1)
VisibilityPublic


 transcription
Public Attribution transcription

If the laboratory observation report was dictated, this property identifies the person who converted the spoken words into written form.

Constraints:
Properties:

AggregationNone
Alias
Association
Association End
ClassLaboratoryObservation
Datatype
Default
Default Value
Is Compositefalse
Is Derivedfalse
Is Derived Unionfalse
Is Leaffalse
Is Orderedfalse
Is Read Onlyfalse
Is Staticfalse
Is Uniquetrue
Keywords
Lower0
Lower Value(0)
Multiplicity0..1
Nametranscription
Name Expression
NamespaceLaboratoryObservation
Opposite
OwnerLaboratoryObservation
Owning Association
Owning Template Parameter
Qualified NameFHIM::Lab::LaboratoryObservation::transcription
Stereotype
Template Parameter
TypeAttribution
Upper1
Upper Value(1)
VisibilityPublic


 userDefinedAccessCheck
Public String userDefinedAccessCheck

"This field permits the producer to record results-dependent codes for classifying the observation at the receiving system. This field should be needed only rarely..." - HL7 Version 2.8, OBX-13.

Constraints:
Properties:

AggregationNone
Alias
Association
Association End
ClassLaboratoryObservation
Datatype
Default
Default Value
Is Compositefalse
Is Derivedfalse
Is Derived Unionfalse
Is Leaffalse
Is Orderedfalse
Is Read Onlyfalse
Is Staticfalse
Is Uniquetrue
Keywords
Lower0
Lower Value(0)
Multiplicity0..1
NameuserDefinedAccessCheck
Name Expression
NamespaceLaboratoryObservation
Opposite
OwnerLaboratoryObservation
Owning Association
Owning Template Parameter
Qualified NameFHIM::Lab::LaboratoryObservation::userDefinedAccessCheck
Stereotype
Template Parameter
TypeString
Upper1
Upper Value(1)
VisibilityPublic