Requirements - Data Group 3b
Data Points
The following data points are covered in data group 3b
Note: If all the columns of the table are not visible, please reduce the zoom % of the browser
| mySugr Data Point | mySugr Unit | mySugr Description | FHIR Resource & Element | Integrated with RDCP | FHIR Sample |
|---|---|---|---|---|---|
| recommended_total_bolus | IU | The total amount of bolus recommended by the bolus calculator. This is the sum of meal and correction components of recommended bolus | MedicationRequest extension advice-total-component-recommended (sent only when bolus calculator was used) | Yes | Recommended bolus |
| recommended_meal_bolus | IU | The meal component of bolus recommended by the bolus calculator | MedicationRequest extension advice-meal-component-recommended (sent only when bolus calculator was used) | Yes | Recommended bolus |
| recommended_correction_bolus | IU | The correction component of bolus recommended by the bolus calculator | MedicationRequest extension advice-bg-component-recommended (sent only when bolus calculator was used) | Yes | Recommended bolus |
| selected_total_bolus | IU | The total amount of bolus selected by the user. This is the sum of meal and correction components of selected bolus | MedicationRequest extension advice-total-component-selected (if Bolus calculator was used) | Yes | Selected bolus |
| selected_meal_bolus | IU | The meal component of bolus selected by the user. | MedicationRequest extension advice-meal-component-selected (if Bolus calculator was used) | Yes | Selected bolus |
| selected_correction_bolus | IU | The correction component of bolus selected by the user. | MedicationRequest extension advice-bg-component-selected (if Bolus calculator was used) | Yes | Selected bolus |
| confirmed_total_bolus | IU | The total amount of bolus already delivered and confirmed by a pump. This is the sum of meal and correction bolus | MedicationRequest extension advice-total-component-confirmed (if Bolus calculator was used) + MedicationRequest.dosageInstruction (if Bolus calculator was used) + MedicationAdministration.dose (medicationCodeableConcept.code = 411531001) |
Yes | Confirmed bolus |
| confirmed_meal_bolus | IU | The amount of meal bolus already delivered and confirmed by a pump | MedicationRequest extension advice-meal-component-confirmed (if Bolus calculator was used) + MedicationAdministration.extension bolus-food-insulin-units (medicationCodeableConcept.code = 411531001) |
Yes | Confirmed bolus |
| confirmed_correction_bolus | IU | The amount of correction bolus already delivered and confirmed by a pump | MedicationRequest extension advice-bg-component-confirmed (if Bolus calculator was used) + MedicationAdministration.extension bolus-correction-insulin-units (medicationCodeableConcept.code = 411531001) |
Yes | Confirmed bolus |
| bolus_delivery_type | enum on client [PUMP_STANDARD(0), PUMP_EXTENDED(1), PUMP_MULTIWAVE(2), int on backend | The way of the bolus delivery | MedicationRequest extension advicedBolusType (if Bolus calculator was used) + MedicationAdministration.extension admin-type (medicationCodeableConcept.code = 411531001) (if bolus is confirmed by the pump) |
Yes | Bolus delivery type |
| immediate_insulin | 1 insulin unit on backend (decimal (10,2)) | The amount of insulin to be delivered as early and as quick as the device allows | MedicationRequest extension immediate-bolus-insulin-amount (if Bolus calculator was used) + MedicationAdministration.extension immediate-bolus-insulin-amount (medicationCodeableConcept.code = 411531001) (if bolus is confirmed by the pump) |
Yes | Immediate insulin |
| delayed_insulin | 1 insulin unit on backend (decimal (10,2)) | The amount of insulin set to be delivered over a long period of time | MedicationRequest extension extended-bolus-insulin-amount (if Bolus calculator was used) + MedicationAdministration.extension extended-bolus-insulin-amount (medicationCodeableConcept.code = 411531001) (if bolus is confirmed by the pump) |
Yes | Delayed insulin |
| delayed_duration | millisecond | The amount of time in which the delayed insulin amount is to be delivered | MedicationRequest extension extended-bolus-duration (if Bolus calculator was used) + MedicationAdministration.extension extended-bolus-duration (medicationCodeableConcept.code = 411531001) (if bolus is confirmed by the pump) |
Yes | Delayed duration |
| bolus_id | string | The delivery-device-specific identifier of a bolus delivery | MedicationRequest.identifier.value (if Bolus calculator was used) + MedicationAdministration.identifier.value (not to be used directly as value, needs to be built. Details in the sample) |
Yes | Samples |
| bolus_activation_type | enum on client, [MANUAL_BOLUS(0), MANUALLY_CHANGED_RECOMMENDED_BOLUS(1), RECOMMENDED_BOLUS(2), COMMANDED_BOLUS(3), BLIND_BOLUS(4)]; |
The cause of the bolus delivery | MedicationRequest extension bolus-activation-type (if Bolus calculator was used) + MedicationAdministration.extension bolus-activation-type(medicationCodeableConcept.code = 411531001) (if bolus is confirmed by the pump) |
Yes (partially. not all the codes are available in ACSPIX) | Bolus activation type |
| therapy setting - mysugr.therapy.insulin.activeduration | seconds | Insulin active duration | extension careplan-therapy-insulin-active-duration on CarePlan (category = 81334-5) | No | Therapy settings |
| therapy setting - mysugr.therapy.insulinpump.type | string | Name of the insulin pump | extension careplan-therapy-insulin-pump-type on CarePlan (category = 81334-5) | No | Therapy settings |
| therapy setting -mysugr.boluscalculator.calculationcount | integer | Number of times boluscalculator was used | extension careplan-therapy-bolus-calculator-count on CarePlan (category = 81334-5) | No | Therapy settings |
| therapy setting - mysugr.boluscalculator.enabled | boolean | boluscalculator status is enabled/disabled by the user | extension device-component-bolus-advice-enabled on CarePlan (category = 81334-5) | No | Therapy settings |
Important details:
- lagDuration or lag is not considered for modelling because bolus should be sent with the exact time of delivery after considering the lag)
- Delivery from pump will always be standard, extended, or multiwave bolus. Manual value present in the shared values will be replaced with the standard bolus.
- Pump extended and multiwave are composed of other fields -> see below:
- Standard Bolus:
- immediateInsulin
- lagDuration (not relevant for FHIR as the bolus should be sent with the exact time of delivery after considering the lag)
- Extended Bolus:
- extendedInsulin
- extendedDuration
- Multiwave (Combination of standard + extended):
- immediateInsulin
- lagDuration (not relevant for FHIR as the bolus should be sent with the exact time of delivery after considering the lag)
- extendedInsulin
- extendedDuration
- Standard Bolus:
- recommended_bolus fields (meal, correction and total) are sent only when a user uses the Bolus Calculator to get a bolus recommendation
- Since editing is possible the identifier of resources plays a very important role. The identifier for MedicationRequest and MedicationAdministration should be built such that they are unique. Meaning, BOLUS ID alone cannot be used as identifier for both resources. We may have to consider building the identifier like for instance MedicationRequest/[BOLUS ID] and MedicationAdmiistration/[BOLUS ID]
- Since editing is possible the extension registeredTimestamp should also be sent with all resources
- Some previously modelled data points BG (DG01), Carb (DG01), pen_bolus_injection_units (DG01), bolus_correction_insulin_units (DG03) and bolus_food_insulin_units (DG03) apply again here (in some cases with additional details to be sent). Please see the section Secnarios in detail.