MII-Initiative

Medizininformatik Initiative - Modul Laborbefund - ImplementationGuide

ObservationLab

ObservationLab bildet das Ergebnis einer einzelnen Laboruntersuchung ab.

Canonical: https://www.medizininformatik-initiative.de/fhir/core/modul-labor/StructureDefinition/ObservationLab

Differential

idS Σ0..1string
id0..1string
extensionI0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceS Σ0..1uri
profileS Σ0..*canonical(StructureDefinition)
securityΣ0..*CodingBinding
tagΣ0..*Coding
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uriFixed Value
versionΣ0..1string
codeS Σ1..1codeFixed Value
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
systemS Σ1..1uri
valueS Σ1..1string
periodΣ I0..1Period
assignerS Σ I1..1MII-Reference(Organization)
basedOnΣ I0..*Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)
partOfΣ I0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)
statusS Σ ?!1..1codeBinding
id0..1string
extensionI0..*Extension
loinc-observationS Σ1..1CodingPattern
observation-categoryS Σ1..1CodingPattern
textΣ0..1string
codeS Σ1..1CodeableConceptBinding
subjectS Σ I1..1MII-Reference(Patient | Group | Device | Location)
focusΣ I0..*Reference(Resource)
encounterS Σ I0..1Reference(Encounter)
id0..1string
QuelleKlinischesBezugsdatumS I0..1Extension(Coding)
value0..1System.DateTime
issuedS Σ0..1instant
performerΣ I0..*Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)
valueRangeRange
valueRatioRatio
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..1codeBinding
unitS Σ1..1string
systemS Σ I1..1uriFixed Value
codeS Σ1..1code
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uri
versionΣ0..1string
codeS Σ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
dataAbsentReasonS I0..1CodeableConceptBinding
interpretationS0..*CodeableConceptBinding
noteS0..*Annotation
bodySite0..0CodeableConcept
methodS0..1CodeableConcept
id0..1string
extensionI0..*Extension
referenceS Σ I0..1string
typeΣ0..1uriBinding
identifierS Σ0..1Identifier
displayΣ0..1string
deviceS I0..1Reference(Device | DeviceMetric)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
lowI0..1SimpleQuantity
highI0..1SimpleQuantity
type0..1CodeableConceptBinding
appliesTo0..*CodeableConcept
ageI0..1Range
text0..1string
hasMemberΣ I0..*Reference(Observation | QuestionnaireResponse | MolecularSequence)
derivedFromΣ I0..*Reference(DocumentReference | ImagingStudy | Media | QuestionnaireResponse | Observation | MolecularSequence)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
codeΣ1..1CodeableConcept
valueQuantityQuantity
valueCodeableConceptCodeableConcept
valueStringstring
valueBooleanboolean
valueIntegerinteger
valueRangeRange
valueRatioRatio
valueSampledDataSampledData
valueTimetime
valueDateTimedateTime
valuePeriodPeriod
dataAbsentReasonI0..1CodeableConceptBinding
interpretation0..*CodeableConceptBinding
referenceRange0..*see (referenceRange)


FHIR Element Erklärung
Patient.id Must-support, jedoch optional
Patient.meta Must-support, jedoch optional
Observation.identifier Observation muss eindeutig identifizierbar sein, keine Vorgaben zur Kodierung, Präferenz: 'LOINC CODE_Befundnummer'
Observation.status Finale & vorläufige Ergebnisse sind zulässig.
Observation.category LOINC & HL7 Code, weitere Codings erlaubt.
Keine Vorgabe für Laborgruppen/-bereiche, da hier keine standortübergreifende Abstimmung erfolgt.
Für Laborgruppen wird auf das ValueSet Laborgruppe verwiesen. Dieses kann optional verwendet werden.
Observation.code IPS LOINC ValueSet
Observation.subject Patientenbezug muss stets gegeben sein.
Observation.effective[x] Zeitpunkt des Beginns der Untersuchung/Messung. Zeitpunkt sollte als dateTime kodiert werden, siehe mii-lab-1 Constraint. Der klinische Bezugszeitpunkt sollte jedoch entweder auf Basis von Specimen.collection.collected[x] oder DiagnosticReport.effective[x] ermittelt werden. Nur diese Werte entsprechen dem Zeitpunkt zumde die gemessene Eigenschaft im Probenmaterial (e.g. Analytkonzentration) mutmaßlich der Eigenschaft im Patienten entsprach.
Observation.valueQuantity UCUM Quantity - verpflichtend, keine abweichende Kodierung zugelassen.
Observation.valueCodeableConcept Für die Kodierung von semi-quantitativen (0 - +++) Ergebnissen, siehe ValueSet 'Semi_quantitative_Laborergebnisse'
Observation.note Optionaler Text
Observation.method Kodierte Methode zur welche verwendet wurde zur Messung von Observation.value. Nur zu befüllen falls Methode nicht implizit in Observation.code enthalten ist (z.B. im LOINC Code). Es wird keine Codierungsempfehlung angegeben, da diese Information meist nicht strukturiert vorliegt in den Quellsystemen.
Observation.specimen Optionale Referenz, zukünftige Spezifikationen weiterer Kerndatensatzmodule können diesbezüglich Vorgaben ausgestalten.
Observation.referenceRange Sollte - falls vorhanden - als high, low (SimpleQuantity) kodiert werden. Abweichend ansonsten per referenceRange.text.
Observation.component Observation.hasMember ist im Bereich der klinischen Chemie zu bevorzugen (passendere Semantik). Element ist für die Harmonisierung mit Genetischen Befunden erlaubt.

FHIR Element Logischer Datensatz
Observation.identifier Laborbefund.Laboruntersuchung.Identifikation
Observation.status Laborbefund.Laboruntersuchung.Status
Observation.category Laborbefund.Laboruntersuchung.Bereich
Observation.category Laborbefund.Laboruntersuchung.Gruppe
Observation.code Laborbefund.Laboruntersuchung.Laborparameter
Observation.code Laborbefund.Laboruntersuchung.Laborparameter
Observation.effective[x] Laborbefund.Laboruntersuchung.Untersuchungszeitpunkt
Observation.issued Laborbefund.Laboruntersuchung.Dokumentationsdatum
Observation.valueQuantity Laborbefund.Laboruntersuchung.Messwert
Observation.interpretation Laborbefund.Laboruntersuchung.Interpretation
Observation.note Laborbefund.Laboruntersuchung.Kommentar
Observation.method Laborbefund.Laboruntersuchung.Untersuchungsmethode
Observation.referenceRange Laborbefund.Laboruntersuchung.Referenzbereich

Invarianten Beschreibung Expression
mii-lab-1 Datetime must be at least to day ($this as dateTime).toString().length() >= 8

Snapshot

idS Σ0..1string
id0..1string
extensionI0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceS Σ0..1uri
profileS Σ0..*canonical(StructureDefinition)
securityΣ0..*CodingBinding
tagΣ0..*Coding
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uriFixed Value
versionΣ0..1string
codeS Σ1..1codeFixed Value
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
systemS Σ1..1uri
valueS Σ1..1string
periodΣ I0..1Period
assignerS Σ I1..1MII-Reference(Organization)
basedOnΣ I0..*Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)
partOfΣ I0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)
statusS Σ ?!1..1codeBinding
id0..1string
extensionI0..*Extension
loinc-observationS Σ1..1CodingPattern
observation-categoryS Σ1..1CodingPattern
textΣ0..1string
codeS Σ1..1CodeableConceptBinding
subjectS Σ I1..1MII-Reference(Patient | Group | Device | Location)
focusΣ I0..*Reference(Resource)
encounterS Σ I0..1Reference(Encounter)
id0..1string
QuelleKlinischesBezugsdatumS I0..1Extension(Coding)
value0..1System.DateTime
issuedS Σ0..1instant
performerΣ I0..*Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)
valueRangeRange
valueRatioRatio
id0..1string
extensionI0..*Extension
valueS Σ1..1decimal
comparatorΣ ?!0..1codeBinding
unitS Σ1..1string
systemS Σ I1..1uriFixed Value
codeS Σ1..1code
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uri
versionΣ0..1string
codeS Σ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
dataAbsentReasonS I0..1CodeableConceptBinding
interpretationS0..*CodeableConceptBinding
noteS0..*Annotation
bodySite0..0CodeableConcept
methodS0..1CodeableConcept
id0..1string
extensionI0..*Extension
referenceS Σ I0..1string
typeΣ0..1uriBinding
identifierS Σ0..1Identifier
displayΣ0..1string
deviceS I0..1Reference(Device | DeviceMetric)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
lowI0..1SimpleQuantity
highI0..1SimpleQuantity
type0..1CodeableConceptBinding
appliesTo0..*CodeableConcept
ageI0..1Range
text0..1string
hasMemberΣ I0..*Reference(Observation | QuestionnaireResponse | MolecularSequence)
derivedFromΣ I0..*Reference(DocumentReference | ImagingStudy | Media | QuestionnaireResponse | Observation | MolecularSequence)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
codeΣ1..1CodeableConcept
valueQuantityQuantity
valueCodeableConceptCodeableConcept
valueStringstring
valueBooleanboolean
valueIntegerinteger
valueRangeRange
valueRatioRatio
valueSampledDataSampledData
valueTimetime
valueDateTimedateTime
valuePeriodPeriod
dataAbsentReasonI0..1CodeableConceptBinding
interpretation0..*CodeableConceptBinding
referenceRange0..*see (referenceRange)


Beispiele

Beispiel (vollständig):

{
    "resourceType": "Observation",
    "id": "ExampleLaborwerte",
    "meta": {
        "profile":  [
            "https://www.medizininformatik-initiative.de/fhir/core/modul-labor/StructureDefinition/ObservationLab"
        ]
    },
    "identifier":  [
        {
            "type": {
                "coding":  [
                    {
                        "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                        "code": "OBI"
                    }
                ]
            },
            "system": "https://exmaple.org/fhir/sid/test-lab-results",
            "value": "59826-8_1234567890",
            "assigner": {
                "identifier": {
                    "system": "https://www.medizininformatik-initiative.de/fhir/core/CodeSystem/core-location-identifier",
                    "value": "DIZ-ID"
                }
            }
        }
    ],
    "status": "final",
    "category":  [
        {
            "coding":  [
                {
                    "system": "http://terminology.hl7.org/CodeSystem/observation-category",
                    "code": "laboratory",
                    "display": "Laboratory"
                },
                {
                    "system": "http://loinc.org",
                    "code": "26436-6",
                    "display": "Laboratory studies (set)"
                },
                {
                    "system": "http://exmple.org/fhir/sid/Laborgruppe",
                    "code": "Niere/Elektrolyte"
                }
            ]
        }
    ],
    "code": {
        "coding":  [
            {
                "system": "http://loinc.org",
                "code": "59826-8",
                "display": "Creatinine [Moles/volume] in Blood"
            }
        ],
        "text": "Kreatinin"
    },
    "subject": {
        "reference": "Patient/111"
    },
    "encounter": {
        "reference": "Encounter/555"
    },
    "effectiveDateTime": "2018-11-20T12:05:00+01:00",
    "_effectiveDateTime": {
        "extension":  [
            {
                "url": "https://www.medizininformatik-initiative.de/fhir/core/modul-labor/StructureDefinition/QuelleKlinischesBezugsdatum",
                "valueCoding": {
                    "system": "http://snomed.info/sct",
                    "code": "399445004",
                    "display": "Specimen collection date (observable entity)"
                }
            }
        ]
    },
    "issued": "2018-03-11T10:28:00+01:00",
    "performer":  [
        {
            "reference": "Organization/7772",
            "display": "Zentrallabor des IKCL"
        }
    ],
    "valueQuantity": {
        "value": 72,
        "unit": "µmol/l",
        "system": "http://unitsofmeasure.org",
        "code": "umol/L"
    },
    "interpretation":  [
        {
            "coding":  [
                {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation",
                    "code": "N"
                }
            ]
        }
    ],
    "referenceRange":  [
        {
            "low": {
                "value": 72.0
            },
            "high": {
                "value": 127.0
            },
            "type": {
                "coding":  [
                    {
                        "system": "http://terminology.hl7.org/CodeSystem/referencerange-meaning",
                        "code": "normal",
                        "display": "Normal Range"
                    }
                ]
            }
        }
    ]
}

Beispiel mit unbekannten Messergebnis (vollständig):

{
    "resourceType": "Observation",
    "id": "ExampleLaborwerteDataAbsentReason",
    "meta": {
        "profile":  [
            "https://www.medizininformatik-initiative.de/fhir/core/modul-labor/StructureDefinition/ObservationLab"
        ]
    },
    "identifier":  [
        {
            "type": {
                "coding":  [
                    {
                        "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                        "code": "OBI"
                    }
                ]
            },
            "system": "https://exmaple.org/fhir/sid/test-lab-results",
            "value": "59826-8_1234567890",
            "assigner": {
                "identifier": {
                    "system": "https://www.medizininformatik-initiative.de/fhir/core/CodeSystem/core-location-identifier",
                    "value": "DIZ-ID"
                }
            }
        }
    ],
    "status": "final",
    "category":  [
        {
            "coding":  [
                {
                    "system": "http://terminology.hl7.org/CodeSystem/observation-category",
                    "code": "laboratory",
                    "display": "Laboratory"
                },
                {
                    "system": "http://loinc.org",
                    "code": "26436-6",
                    "display": "Laboratory studies (set)"
                },
                {
                    "system": "http://exmple.org/fhir/sid/Laborgruppe",
                    "code": "Niere/Elektrolyte"
                }
            ]
        }
    ],
    "code": {
        "coding":  [
            {
                "system": "http://loinc.org",
                "code": "59826-8",
                "display": "Creatinine [Moles/volume] in Blood"
            }
        ],
        "text": "Kreatinin"
    },
    "subject": {
        "reference": "Patient/111"
    },
    "encounter": {
        "reference": "Encounter/555"
    },
    "effectiveDateTime": "2018-11-20T12:05:00+01:00",
    "_effectiveDateTime": {
        "extension":  [
            {
                "url": "https://www.medizininformatik-initiative.de/fhir/core/modul-labor/StructureDefinition/QuelleKlinischesBezugsdatum",
                "valueCoding": {
                    "system": "http://snomed.info/sct",
                    "code": "399445004",
                    "display": "Specimen collection date (observable entity)"
                }
            }
        ]
    },
    "issued": "2018-03-11T10:28:00+01:00",
    "performer":  [
        {
            "reference": "Organization/7772",
            "display": "Zentrallabor des IKCL"
        }
    ],
    "dataAbsentReason": {
        "coding":  [
            {
                "system": "http://terminology.hl7.org/CodeSystem/data-absent-reason",
                "code": "unknown"
            }
        ]
    },
    "interpretation":  [
        {
            "coding":  [
                {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation",
                    "code": "N"
                }
            ]
        }
    ],
    "referenceRange":  [
        {
            "low": {
                "value": 72.0
            },
            "high": {
                "value": 127.0
            },
            "type": {
                "coding":  [
                    {
                        "system": "http://terminology.hl7.org/CodeSystem/referencerange-meaning",
                        "code": "normal",
                        "display": "Normal Range"
                    }
                ]
            }
        }
    ]
}