FHIR CI-Build

This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions icon

14.18 Resource MeasureReport - Content

Clinical Quality Information icon Work GroupMaturity Level: 4 Trial UseSecurity Category: Business Compartments: Group, Patient

The MeasureReport resource contains the results of the calculation of a measure; and optionally a reference to the resources involved in that calculation.

14.18.1 Scope and Usage

The MeasureReport resource represents the results of calculating a measure for a specific subject or group of subjects. The $evaluate-measure operation of the Measure resource is defined to return a MeasureReport. The resource is capable of representing three different levels of report: individual, subject-list, and summary.

The resource draws requirements from the HL7 CDA R2 Implementation Guide: Quality Reporting Document Architecture - Category 1 (QRDA I) DSTU Release 3 (US Realm) and the HL7 Implementation Guide for CDA Release 2: Quality Reporting Document Architecture - Category III (QRDA III), DSTU Release 1 implementation guides.

For a detailed discussion of how to use the Measure and MeasureReport resources, refer to the Quality Reporting topic.

Note that this resource is a special case of the more general notion of a query evaluation result. However, because the general case requires the ability to represent arbitrary content, this resource uses a simple indicator structure to describe population sizes for each population type defined in the measure. The intent is to be able to represent the more general case as well, either by generalizing this resource, or by making this structure a profile of a more general resource, and we are actively seeking comments about what approaches might be taken to achieve that aim.

14.18.2 Boundaries and Relationships

Although the MeasureReport is conceptually an Observation, there is enough specific information required to support the quality reporting use case to warrant a separate resource.

The resource is differentiated from a general purpose query result because it communicates specific information related to quality measurement evaluation that would be difficult to convey generally without imposing some other structure on top of the general results.

14.18.3 References to this Resource

  • Resource References: itself

14.18.4 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. MeasureReport TU DomainResource Results of a measure evaluation
+ Rule: Measure Reports used for data collection SHALL NOT communicate group and score information
+ Rule: Stratifiers SHALL be either a single criteria or a set of criteria components

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ 0..* Identifier Additional identifier for the MeasureReport

... category 0..1 CodeableConcept The category of measure report instance this is (e.g. deqm, ra, vbp)
Binding: Measure Report Category VS (Extensible)
... messages 0..1 Reference(OperationOutcome) Evaluation messages
... type ΣC 1..1 code individual | subject-list | summary | data-exchange
Binding: Measure Report Type (Required)
... dataUpdateType ?!Σ 0..1 code incremental | snapshot
Binding: Submit Data Update Type (Required)
... measure Σ 0..1 canonical(Measure) What measure was calculated
... subject Σ 0..1 Reference(CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson) What individual(s) the report is for
... date Σ 0..1 dateTime When the measure report was generated
... reporter Σ 0..1 Reference(Practitioner | PractitionerRole | Organization | Group) Who is reporting the data
... reportingVendor 0..1 Reference(Organization) What vendor prepared the data
... location 0..* Reference(Location) Where the reported data is from

... period Σ 1..1 Period What period the report covers
... inputParameters 0..1 Reference(Parameters) What parameters were provided to the report
... scoring ?!Σ 0..1 CodeableConcept What scoring method (e.g. proportion, ratio, continuous-variable)
Binding: Measure Scoring icon (Extensible)
... improvementNotation ?!ΣXD 0..1 CodeableConcept increase | decrease
Binding: Measure Improvement Notation (Required)
... group C 0..* BackboneElement Measure results for each group

.... linkId 0..1 string Pointer to specific group from Measure
.... calculatedDate 0..1 dateTime The date the Measure Report was calculated
.... code Σ 0..1 CodeableConcept Meaning of the group
Binding: Measure Group Example (Example)
.... subject Σ 0..1 Reference(CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson) What individual(s) the report is for
.... improvementNotation ?!Σ 0..1 CodeableConcept increase | decrease
Binding: Measure Improvement Notation (Extensible)
.... improvementNotationGuidance Σ 0..1 markdown Explanation of improvement notation
.... population 0..* BackboneElement The populations in the group

..... linkId 0..1 string Pointer to specific population from Measure
..... code Σ 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
Binding: Measure Population Type (Extensible)
..... count 0..1 integer Size of the population
..... subjectResults 0..1 Reference(List) For subject-list reports, the subject results in this population
..... subjectReport 0..* Reference(MeasureReport) For subject-list reports, references to the individual reports for subjects in this population

..... subjects 0..1 Reference(Group) What individual(s) in the population
.... measureScore[x] Σ 0..1 What score this group achieved
..... measureScoreQuantity Quantity
..... measureScoreDateTime dateTime
..... measureScoreCodeableConcept CodeableConcept
..... measureScorePeriod Period
..... measureScoreRange Range
..... measureScoreDuration Duration
..... measureScoreBoolean boolean
.... stratifier C 0..* BackboneElement Stratification results

..... linkId 0..1 string Pointer to specific stratifier from Measure
..... code 0..1 CodeableConcept What stratifier of the group
Binding: Measure Stratifier Example (Example)
..... stratum C 0..* BackboneElement Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components

...... value[x] C 0..1 The stratum value, e.g. male
Binding: Measure Report Stratifier Value Example (Example)
....... valueCodeableConcept CodeableConcept
....... valueBoolean boolean
....... valueQuantity Quantity
....... valueRange Range
....... valueReference Reference()
...... component C 0..* BackboneElement Stratifier component values

....... linkId 0..1 string Pointer to specific stratifier component from Measure
....... code 1..1 CodeableConcept What stratifier component of the group
Binding: Measure Stratifier Example (Example)
....... value[x] 1..1 The stratum component value, e.g. male
Binding: Measure Report Stratifier Value Example (Example)
........ valueCodeableConcept CodeableConcept
........ valueBoolean boolean
........ valueQuantity Quantity
........ valueRange Range
........ valueReference Reference()
...... population 0..* BackboneElement Population results in this stratum

....... linkId 0..1 string Pointer to specific population from Measure
....... code 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
Binding: Measure Population Type (Extensible)
....... count 0..1 integer Size of the population
....... subjectResults 0..1 Reference(List) For subject-list reports, the subject results in this population
....... subjectReport 0..* Reference(MeasureReport) For subject-list reports, a subject result in this population

....... subjects 0..1 Reference(Group) What individual(s) in the population
...... measureScore[x] 0..1 What score this stratum achieved
....... measureScoreQuantity Quantity
....... measureScoreDateTime dateTime
....... measureScoreCodeableConcept CodeableConcept
....... measureScorePeriod Period
....... measureScoreRange Range
....... measureScoreDuration Duration
....... measureScoreBoolean boolean
... supplementalData 0..* Reference(Any) Additional information collected for the report

... evaluatedResource 0..* Reference(Any) What data was used to calculate the measure score


doco Documentation for this format icon

See the Extensions for this resource

 

Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis

14.18.4.1 Terminology Bindings

Path ValueSet Type Documentation
MeasureReport.category MeasureReportCategory (a valid code from Measure Report Category CS) Extensible

Measure report categories
MeasureReport.status MeasureReportStatus Required

The status of the measure report.
MeasureReport.type MeasureReportType Required

The type of the measure report.
MeasureReport.dataUpdateType SubmitDataUpdateType Required

Concepts for how a measure report consumer and receiver coordinate data exchange updates. The choices are snapshot or incremental updates
MeasureReport.scoring MeasureScoring icon Extensible

The scoring type of the measure.
MeasureReport.improvementNotation MeasureImprovementNotation Required

Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue.
MeasureReport.group.code MeasureGroupExample Example

Example Measure Groups for the Measure Resource.
MeasureReport.group.improvementNotation MeasureImprovementNotation Extensible

Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue.
MeasureReport.group.population.code MeasurePopulationType Extensible

The type of population.
MeasureReport.group.stratifier.code MeasureStratifierExample Example

Identifier subgroups in a population for measuring purposes.
MeasureReport.group.stratifier.stratum.value[x] MeasureReportStratifierValueExample Example

Example Measure Stratification Value for MeasureReports Resource.
MeasureReport.group.stratifier.stratum.component.code MeasureStratifierExample Example

Identifier subgroups in a population for measuring purposes.
MeasureReport.group.stratifier.stratum.component.value[x] MeasureReportStratifierValueExample Example

Example Measure Stratification Value for MeasureReports Resource.
MeasureReport.group.stratifier.stratum.population.code MeasurePopulationType Extensible

The type of population.

14.18.4.2 Constraints

UniqueKeyLevelLocationDescriptionExpression
img mrp-1Rule (base)Measure Reports used for data collection SHALL NOT communicate group and score information(type != 'data-exchange') or group.exists().not()
img mrp-2Rule (base)Stratifiers SHALL be either a single criteria or a set of criteria componentsgroup.stratifier.stratum.all(value.exists() xor component.exists())

14.18.5 MeasureReport Search

Although the MeasureReport resource does define search parameters, it is up to the individual measure evaluation service whether or not historical records of measure evaluation requests are preserved. A service might not support searching on MeasureReports at all, or it may support searching only for a pre-defined expiration period. The search parameters are defined to provide consumers with a consistent interface to searching if it is available for a specific service implementation. In any case, services should detail the support they do provide using a CapabilityStatement.

14.18.6 Search Parameters

Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name Type Description Expression In Common
date date The date of the measure report MeasureReport.date 26 Resources
evaluated-resource reference An evaluated resource referenced by the measure report MeasureReport.evaluatedResource
(Any)
identifier token External identifier of the measure report to be returned MeasureReport.identifier 65 Resources
location reference The location to return measure report results for MeasureReport.location
(Location)
measure reference The measure to return measure report results for MeasureReport.measure
(Measure)
patient reference The identity of a patient to search for individual measure report results for MeasureReport.subject.where(resolve() is Patient)
(Patient)		 65 Resources
period date The period of the measure report MeasureReport.period
reporter reference The reporter to return measure report results for MeasureReport.reporter
(Practitioner, Group, Organization, PractitionerRole)
status token The status of the measure report MeasureReport.status
subject reference The identity of a subject to search for individual measure report results for MeasureReport.subject
(Practitioner, Group, Organization, CareTeam, Device, Patient, HealthcareService, PractitionerRole, RelatedPerson, Location)