HL7 FHIR Implementation Guide: Transversal Clinical Core
1.2.0 - STU1 Belgium flag

HL7 FHIR Implementation Guide: Transversal Clinical Core, published by eHealth Platform. This guide is not an authorized publication; it is the continuous build for version 1.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-be/core-clinical/ and changes regularly. See the Directory of published versions

Logical Model: BeModelObservationDiabetes - Detailed Descriptions

Draft as of 2024-11-22

Definitions for the BeModelObservationDiabetes logical model.

Guidance on how to interpret the contents of this table can be found here

0. BeModelObservationDiabetes
Definition

BeModelObservationDiabetes

ShortBeModelObservationDiabetes
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. BeModelObservationDiabetes.UniqueIdentifier
Definition

Unique observation business identifier.

ShortUnique observation business identifier.
Control1..1
TypeIdentifier
4. BeModelObservationDiabetes.RecordedDate
Definition

Date of encoding of the observation by the Recorder. (DateTime format) See management rule 13.

ShortDate of encoding of the observation by the Recorder. (DateTime format) See management rule 13.
Control1..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
6. BeModelObservationDiabetes.ObservationPeriod
Definition

Date or observation period (e.g. 27/11/2023) (DateTime format)

ShortDate or observation period (e.g. 27/11/2023) (DateTime format)
Control1..1
TypePeriod
8. BeModelObservationDiabetes.Patient
Definition

Is the unique identifier of the patient. The unique identifier must be the National Patient Register Number (NISS) [1].

ShortIs the unique identifier of the patient. The unique identifier must be the National Patient Register Number (NISS) [1].
Control1..1
TypeIdentifier
10. BeModelObservationDiabetes.Recorder
Definition

Is the unique identifier (national register number)[1] of the health professional or organization (company number) which encodes the information and takes responsibility for its content.

Short Is the unique identifier (national register number)[1] of the health professional or organization (company number) which encodes the information and takes responsibility for its content.
Control1..1
TypeIdentifier
12. BeModelObservationDiabetes.Category
Definition

698472009 “Glucose monitoring” (FR) (invariant)See VS_Obs_Dia_Category

Short698472009 “Glucose monitoring” (FR) (invariant)See VS_Obs_Dia_Category
Control1..*
TypeCodeableConcept
14. BeModelObservationDiabetes.Status
Definition

445665009 “Final report” - invariant. See VS_Obs_Diab_Status Status

Short445665009 “Final report” - invariant. See VS_Obs_Diab_Status Status
Control0..1
Typecode
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
16. BeModelObservationDiabetes.Code
Definition

Code corresponding to the derived value (coding to be established by SNOMED CT). Ex: AGP-PGATAR Time Above Range, TIR Time In Range…See VS_Obs_Diab_Code

ShortCode corresponding to the derived value (coding to be established by SNOMED CT). Ex: AGP-PGATAR Time Above Range, TIR Time In Range…See VS_Obs_Diab_Code
Control1..1
TypeCodeableConcept
18. BeModelObservationDiabetes.Value
Definition

Derived value. Value[x]

ShortDerived value. Value[x]
Control1..1
TypeQuantity
20. BeModelObservationDiabetes.ReferenceRange
Definition

Structure composed of reference elements allowing the interpretation of measurements:·        ReferenceRange.Low (0...1)·        ReferenceRange.High (0...1)·        ReferenceRange.AppliesTo (0...*)We automatically work according to the ADA standards which define target value intervals for the following derived observations: Coded1 Coefficient of Variation2 Days Sensor Worn3% Data Captured4 TAR % (Time above range - very high)5 TAR % (Time above range - high)6 SHOOTING % (Time in Range)7 TBR % (Time below range - low)8 TBR % (Time below range - very low)By observation code derived from this list, we will potentially find:A) Target - reference interval to indicate the target lower limit (“Low”) and upper limit (“High”).Note that these limits do not depend on the diabetes category.For example: for TIR, it is recommended that the blood glucose value be at least 70% of the time in the “normal” range.So for ReferenceRange “TIR_REF”→ TIR_REF.Low = 70%→ TIR_REF.High = 100%B) filter - application interval with a lower limit and an upper limit to filter the measurement observations considered in the calculation of the derived value. This defines the range of counted values. These ranges may vary by diabetes category.For example: the “normal” range is between 70 mg/dL and 180 mg/dL for category 1 and 3, and between 63 mg/dL and 140 mg/dL for category 2.So for ReferenceRange “TIR_REF”→ TIR_REF.AppliesTo(CAT1, ≥70 mg/dL, ≤180 mg/dL)→ TIR_REF.AppliesTo(CAT2, ≥63 mg/dL, ≤140 mg/dL)→ TIR_REF.AppliesTo(CAT3, ≥70 mg/dL, ≤180 mg/dL)As we base ourselves on ADA standards, there is little point in passing all this information for each observation.If, however, a doctor changes values ​​(target and/or filter) for a specific patient AND you want to communicate these changes outside of your patient file, this mechanism provides the means.See VS_Obs_Diab_Ref

ShortStructure composed of reference elements allowing the interpretation of measurements:·        ReferenceRange.Low (0...1)·        ReferenceRange.High (0...1)·        ReferenceRange.AppliesTo (0...*)We automatically work according to the ADA standards which define target value intervals for the following derived observations: Coded1 Coefficient of Variation2 Days Sensor Worn3% Data Captured4 TAR % (Time above range - very high)5 TAR % (Time above range - high)6 SHOOTING % (Time in Range)7 TBR % (Time below range - low)8 TBR % (Time below range - very low)By observation code derived from this list, we will potentially find:A) Target - reference interval to indicate the target lower limit (“Low”) and upper limit (“High”).Note that these limits do not depend on the diabetes category.For example: for TIR, it is recommended that the blood glucose value be at least 70% of the time in the “normal” range.So for ReferenceRange “TIR_REF”→ TIR_REF.Low = 70%→ TIR_REF.High = 100%B) filter - application interval with a lower limit and an upper limit to filter the measurement observations considered in the calculation of the derived value. This defines the range of counted values. These ranges may vary by diabetes category.For example: the “normal” range is between 70 mg/dL and 180 mg/dL for category 1 and 3, and between 63 mg/dL and 140 mg/dL for category 2.So for ReferenceRange “TIR_REF”→ TIR_REF.AppliesTo(CAT1, ≥70 mg/dL, ≤180 mg/dL)→ TIR_REF.AppliesTo(CAT2, ≥63 mg/dL, ≤140 mg/dL)→ TIR_REF.AppliesTo(CAT3, ≥70 mg/dL, ≤180 mg/dL)As we base ourselves on ADA standards, there is little point in passing all this information for each observation.If, however, a doctor changes values ​​(target and/or filter) for a specific patient AND you want to communicate these changes outside of your patient file, this mechanism provides the means.See VS_Obs_Diab_Ref
Control0..*
TypeRange

Guidance on how to interpret the contents of this table can be found here

0. BeModelObservationDiabetes
Definition

BeModelObservationDiabetes

ShortBeModelObservationDiabetes
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. BeModelObservationDiabetes.UniqueIdentifier
Definition

Unique observation business identifier.

ShortUnique observation business identifier.
Control1..1
TypeIdentifier
4. BeModelObservationDiabetes.RecordedDate
Definition

Date of encoding of the observation by the Recorder. (DateTime format) See management rule 13.

ShortDate of encoding of the observation by the Recorder. (DateTime format) See management rule 13.
Control1..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
6. BeModelObservationDiabetes.ObservationPeriod
Definition

Date or observation period (e.g. 27/11/2023) (DateTime format)

ShortDate or observation period (e.g. 27/11/2023) (DateTime format)
Control1..1
TypePeriod
8. BeModelObservationDiabetes.Patient
Definition

Is the unique identifier of the patient. The unique identifier must be the National Patient Register Number (NISS) [1].

ShortIs the unique identifier of the patient. The unique identifier must be the National Patient Register Number (NISS) [1].
Control1..1
TypeIdentifier
10. BeModelObservationDiabetes.Recorder
Definition

Is the unique identifier (national register number)[1] of the health professional or organization (company number) which encodes the information and takes responsibility for its content.

Short Is the unique identifier (national register number)[1] of the health professional or organization (company number) which encodes the information and takes responsibility for its content.
Control1..1
TypeIdentifier
12. BeModelObservationDiabetes.Category
Definition

698472009 “Glucose monitoring” (FR) (invariant)See VS_Obs_Dia_Category

Short698472009 “Glucose monitoring” (FR) (invariant)See VS_Obs_Dia_Category
Control1..*
TypeCodeableConcept
14. BeModelObservationDiabetes.Status
Definition

445665009 “Final report” - invariant. See VS_Obs_Diab_Status Status

Short445665009 “Final report” - invariant. See VS_Obs_Diab_Status Status
Control0..1
Typecode
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
16. BeModelObservationDiabetes.Code
Definition

Code corresponding to the derived value (coding to be established by SNOMED CT). Ex: AGP-PGATAR Time Above Range, TIR Time In Range…See VS_Obs_Diab_Code

ShortCode corresponding to the derived value (coding to be established by SNOMED CT). Ex: AGP-PGATAR Time Above Range, TIR Time In Range…See VS_Obs_Diab_Code
Control1..1
TypeCodeableConcept
18. BeModelObservationDiabetes.Value
Definition

Derived value. Value[x]

ShortDerived value. Value[x]
Control1..1
TypeQuantity
20. BeModelObservationDiabetes.ReferenceRange
Definition

Structure composed of reference elements allowing the interpretation of measurements:·        ReferenceRange.Low (0...1)·        ReferenceRange.High (0...1)·        ReferenceRange.AppliesTo (0...*)We automatically work according to the ADA standards which define target value intervals for the following derived observations: Coded1 Coefficient of Variation2 Days Sensor Worn3% Data Captured4 TAR % (Time above range - very high)5 TAR % (Time above range - high)6 SHOOTING % (Time in Range)7 TBR % (Time below range - low)8 TBR % (Time below range - very low)By observation code derived from this list, we will potentially find:A) Target - reference interval to indicate the target lower limit (“Low”) and upper limit (“High”).Note that these limits do not depend on the diabetes category.For example: for TIR, it is recommended that the blood glucose value be at least 70% of the time in the “normal” range.So for ReferenceRange “TIR_REF”→ TIR_REF.Low = 70%→ TIR_REF.High = 100%B) filter - application interval with a lower limit and an upper limit to filter the measurement observations considered in the calculation of the derived value. This defines the range of counted values. These ranges may vary by diabetes category.For example: the “normal” range is between 70 mg/dL and 180 mg/dL for category 1 and 3, and between 63 mg/dL and 140 mg/dL for category 2.So for ReferenceRange “TIR_REF”→ TIR_REF.AppliesTo(CAT1, ≥70 mg/dL, ≤180 mg/dL)→ TIR_REF.AppliesTo(CAT2, ≥63 mg/dL, ≤140 mg/dL)→ TIR_REF.AppliesTo(CAT3, ≥70 mg/dL, ≤180 mg/dL)As we base ourselves on ADA standards, there is little point in passing all this information for each observation.If, however, a doctor changes values ​​(target and/or filter) for a specific patient AND you want to communicate these changes outside of your patient file, this mechanism provides the means.See VS_Obs_Diab_Ref

ShortStructure composed of reference elements allowing the interpretation of measurements:·        ReferenceRange.Low (0...1)·        ReferenceRange.High (0...1)·        ReferenceRange.AppliesTo (0...*)We automatically work according to the ADA standards which define target value intervals for the following derived observations: Coded1 Coefficient of Variation2 Days Sensor Worn3% Data Captured4 TAR % (Time above range - very high)5 TAR % (Time above range - high)6 SHOOTING % (Time in Range)7 TBR % (Time below range - low)8 TBR % (Time below range - very low)By observation code derived from this list, we will potentially find:A) Target - reference interval to indicate the target lower limit (“Low”) and upper limit (“High”).Note that these limits do not depend on the diabetes category.For example: for TIR, it is recommended that the blood glucose value be at least 70% of the time in the “normal” range.So for ReferenceRange “TIR_REF”→ TIR_REF.Low = 70%→ TIR_REF.High = 100%B) filter - application interval with a lower limit and an upper limit to filter the measurement observations considered in the calculation of the derived value. This defines the range of counted values. These ranges may vary by diabetes category.For example: the “normal” range is between 70 mg/dL and 180 mg/dL for category 1 and 3, and between 63 mg/dL and 140 mg/dL for category 2.So for ReferenceRange “TIR_REF”→ TIR_REF.AppliesTo(CAT1, ≥70 mg/dL, ≤180 mg/dL)→ TIR_REF.AppliesTo(CAT2, ≥63 mg/dL, ≤140 mg/dL)→ TIR_REF.AppliesTo(CAT3, ≥70 mg/dL, ≤180 mg/dL)As we base ourselves on ADA standards, there is little point in passing all this information for each observation.If, however, a doctor changes values ​​(target and/or filter) for a specific patient AND you want to communicate these changes outside of your patient file, this mechanism provides the means.See VS_Obs_Diab_Ref
Control0..*
TypeRange

Guidance on how to interpret the contents of this table can be found here

0. BeModelObservationDiabetes
Definition

BeModelObservationDiabetes

ShortBeModelObservationDiabetes
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. BeModelObservationDiabetes.UniqueIdentifier
Definition

Unique observation business identifier.

ShortUnique observation business identifier.
Control1..1
TypeIdentifier
4. BeModelObservationDiabetes.RecordedDate
Definition

Date of encoding of the observation by the Recorder. (DateTime format) See management rule 13.

ShortDate of encoding of the observation by the Recorder. (DateTime format) See management rule 13.
Control1..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
6. BeModelObservationDiabetes.ObservationPeriod
Definition

Date or observation period (e.g. 27/11/2023) (DateTime format)

ShortDate or observation period (e.g. 27/11/2023) (DateTime format)
Control1..1
TypePeriod
8. BeModelObservationDiabetes.Patient
Definition

Is the unique identifier of the patient. The unique identifier must be the National Patient Register Number (NISS) [1].

ShortIs the unique identifier of the patient. The unique identifier must be the National Patient Register Number (NISS) [1].
Control1..1
TypeIdentifier
10. BeModelObservationDiabetes.Recorder
Definition

Is the unique identifier (national register number)[1] of the health professional or organization (company number) which encodes the information and takes responsibility for its content.

Short Is the unique identifier (national register number)[1] of the health professional or organization (company number) which encodes the information and takes responsibility for its content.
Control1..1
TypeIdentifier
12. BeModelObservationDiabetes.Category
Definition

698472009 “Glucose monitoring” (FR) (invariant)See VS_Obs_Dia_Category

Short698472009 “Glucose monitoring” (FR) (invariant)See VS_Obs_Dia_Category
Control1..*
TypeCodeableConcept
14. BeModelObservationDiabetes.Status
Definition

445665009 “Final report” - invariant. See VS_Obs_Diab_Status Status

Short445665009 “Final report” - invariant. See VS_Obs_Diab_Status Status
Control0..1
Typecode
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
16. BeModelObservationDiabetes.Code
Definition

Code corresponding to the derived value (coding to be established by SNOMED CT). Ex: AGP-PGATAR Time Above Range, TIR Time In Range…See VS_Obs_Diab_Code

ShortCode corresponding to the derived value (coding to be established by SNOMED CT). Ex: AGP-PGATAR Time Above Range, TIR Time In Range…See VS_Obs_Diab_Code
Control1..1
TypeCodeableConcept
18. BeModelObservationDiabetes.Value
Definition

Derived value. Value[x]

ShortDerived value. Value[x]
Control1..1
TypeQuantity
20. BeModelObservationDiabetes.ReferenceRange
Definition

Structure composed of reference elements allowing the interpretation of measurements:·        ReferenceRange.Low (0...1)·        ReferenceRange.High (0...1)·        ReferenceRange.AppliesTo (0...*)We automatically work according to the ADA standards which define target value intervals for the following derived observations: Coded1 Coefficient of Variation2 Days Sensor Worn3% Data Captured4 TAR % (Time above range - very high)5 TAR % (Time above range - high)6 SHOOTING % (Time in Range)7 TBR % (Time below range - low)8 TBR % (Time below range - very low)By observation code derived from this list, we will potentially find:A) Target - reference interval to indicate the target lower limit (“Low”) and upper limit (“High”).Note that these limits do not depend on the diabetes category.For example: for TIR, it is recommended that the blood glucose value be at least 70% of the time in the “normal” range.So for ReferenceRange “TIR_REF”→ TIR_REF.Low = 70%→ TIR_REF.High = 100%B) filter - application interval with a lower limit and an upper limit to filter the measurement observations considered in the calculation of the derived value. This defines the range of counted values. These ranges may vary by diabetes category.For example: the “normal” range is between 70 mg/dL and 180 mg/dL for category 1 and 3, and between 63 mg/dL and 140 mg/dL for category 2.So for ReferenceRange “TIR_REF”→ TIR_REF.AppliesTo(CAT1, ≥70 mg/dL, ≤180 mg/dL)→ TIR_REF.AppliesTo(CAT2, ≥63 mg/dL, ≤140 mg/dL)→ TIR_REF.AppliesTo(CAT3, ≥70 mg/dL, ≤180 mg/dL)As we base ourselves on ADA standards, there is little point in passing all this information for each observation.If, however, a doctor changes values ​​(target and/or filter) for a specific patient AND you want to communicate these changes outside of your patient file, this mechanism provides the means.See VS_Obs_Diab_Ref

ShortStructure composed of reference elements allowing the interpretation of measurements:·        ReferenceRange.Low (0...1)·        ReferenceRange.High (0...1)·        ReferenceRange.AppliesTo (0...*)We automatically work according to the ADA standards which define target value intervals for the following derived observations: Coded1 Coefficient of Variation2 Days Sensor Worn3% Data Captured4 TAR % (Time above range - very high)5 TAR % (Time above range - high)6 SHOOTING % (Time in Range)7 TBR % (Time below range - low)8 TBR % (Time below range - very low)By observation code derived from this list, we will potentially find:A) Target - reference interval to indicate the target lower limit (“Low”) and upper limit (“High”).Note that these limits do not depend on the diabetes category.For example: for TIR, it is recommended that the blood glucose value be at least 70% of the time in the “normal” range.So for ReferenceRange “TIR_REF”→ TIR_REF.Low = 70%→ TIR_REF.High = 100%B) filter - application interval with a lower limit and an upper limit to filter the measurement observations considered in the calculation of the derived value. This defines the range of counted values. These ranges may vary by diabetes category.For example: the “normal” range is between 70 mg/dL and 180 mg/dL for category 1 and 3, and between 63 mg/dL and 140 mg/dL for category 2.So for ReferenceRange “TIR_REF”→ TIR_REF.AppliesTo(CAT1, ≥70 mg/dL, ≤180 mg/dL)→ TIR_REF.AppliesTo(CAT2, ≥63 mg/dL, ≤140 mg/dL)→ TIR_REF.AppliesTo(CAT3, ≥70 mg/dL, ≤180 mg/dL)As we base ourselves on ADA standards, there is little point in passing all this information for each observation.If, however, a doctor changes values ​​(target and/or filter) for a specific patient AND you want to communicate these changes outside of your patient file, this mechanism provides the means.See VS_Obs_Diab_Ref
Control0..*
TypeRange