Skip to main content

Observation Definition

Summary

ObservationDefinition is used to define the structure and expectations of a clinical observation or lab result, such as "Hemoglobin level" or "Blood glucose." These definitions describe the unit, valid value range, data type, and measurement method — forming a template for the actual Observation instances recorded during diagnostics.

In CARE, this ensures consistency across lab results and helps maintain standards for how observations are displayed, interpreted, and validated.

Core Relationships

Related ResourcePurpose
ActivityDefinitionLinks expected observations for a test
ObservationActual instance of a result captured using this definition
SpecimenDefinitionMay define specimen type required for this observation

Supported Fields

Field NameDescriptionExample
titleHuman-readable name of the observationHemoglobin
slugUnique internal reference namehb-level
descriptionClinical context or explanation"Hemoglobin concentration in blood"
statusLifecycle status (draft, active, etc.)active
categoryClinical categorylaboratory
data_typeType of result valuestring
Loinc_CodeLOINC or internal code"LOINCCode"
Body SiteLocation on the body for sample collection"Right Arm"
MethodMeasurement technique (e.g., Spectrophotometry)"Automatic"
unitMeasurement unit"mmHg"
ComponentsTo record multiple related valuesCBC

Functional Workflow

  1. Admin defines the observation format for a test (e.g., Hemoglobin).
  2. Links this definition to the appropriate ActivityDefinition.
  3. When test results are recorded, the system:
    • Enforces data type (e.g., Quantity)
    • Validates result range
    • Uses the preferred_report_name for display