Generated Narrative: OperationDefinition hddt-cgm-summary-operation Parameters Use Name Scope Cardinality Type Binding Documentation IN effectivePeriodStart 0..1 dateTime Start of effective period IN effectivePeriodEnd 0..1 dateTime End of effective period IN related 0..1 boolean If true, include related Device and DeviceMetric in the result bundle OUT result 1..1 Reference (Bundle – HDDT CGM Summary Report) Result bundle (HTTP 200 OK) containing summary data of measurements and optionally related resources
Search Operation for summary data measurement
The `$hddt-cgm-summary` operation is defined on the *Observation* resource type. It allows clients to request CGM summary data filtered by effective period, and optionally include related device context (Device, DeviceMetric). **Use cases supported by this operation include:** - Retrieving CGM summary statistics (mean glucose, time-in-range, GMI, etc.) for a patient over a specified interval **Input Parameters:** - `effectivePeriodStart` *(dateTime, optional)*: Lower bound of the observation effective period. - `effectivePeriodEnd` *(dateTime, optional)*: Upper bound of the observation effective period. - `related` *(boolean, optional)*: If true, the response bundle also contains related Device and DeviceMetric resources. **Output Parameter:** - `result` *(Reference, required)*: A Bundle conforming to profile `HddtCgmSummary` profile containing all matching CGM Observations and, if requested, their related devices. **Error handling (OperationOutcome):** - `MSG_PARAM_UNKNOWN`: Returned when an unsupported input parameter is used. - `MSG_PARAM_INVALID`: Returned when a parameter value is invalid (e.g., bad date format). - `MSG_NO_MATCH`: Returned when no matching observations are found. - `MSG_BAD_SYNTAX`: Returned when the request is malformed.
If true, include related Device and DeviceMetric in the result bundle
Result bundle (HTTP 200 OK) containing summary data of measurements and optionally related resources