MeasureReport
Introduction
Scope and Usage
The MeasureReport resource represents the results of calculating a measure for a specific subject or group of subjects. The $evaluate operation of the Measure resource is defined to return a MeasureReport. The resource can represent 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) Release 1 STU5.3 (US Realm) and the HL7 Implementation Guide for CDA Release 2: Quality Reporting Document Architecture - Category III (QRDA III), Release 1 implementation guides.
An individual MeasureReport contains information about a specific subject and typically includes references to the relevant data used to generate the report. A subject-list MeasureReport reports on a list of subjects and provides a List resource that contains references to individual-level reports for each subject being reported. A summary MeasureReport reports on a group of subjects and contains population counts and the calculated score as defined by the Measure. Finally, data-collection reports are used to communicate the data of interest, so no scoring or other calculated information is expected.
For a detailed discussion of how to use the Measure and MeasureReport resources, refer to the Quality Reporting topic.
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.
Background and Context
Provides additional detail on exactly how the resource is to be used
Notes
MeasureReport Search
Although the MeasureReport resource does define search parameters, it is up to the individual measure evaluation service whether 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.
StructureDefinition
Elements (Simplified)
- MeasureReport [0..*]: - Results of a measure evaluation
- MeasureReport.identifier [0..*]: Identifier Additional identifier for the MeasureReport
- MeasureReport.category [0..1]: CodeableConcept extensible:measurereport-category The category of measure report instance this is (example codes include deqm, ra, vbp)
- MeasureReport.messages [0..1]: Reference(OperationOutcome) Evaluation messages
- MeasureReport.status [1..1]: code required:measure-report-status complete | pending | error
- MeasureReport.type [1..1]: code required:measure-report-type individual | subject-list | summary | data-exchange
- MeasureReport.dataUpdateType [0..1]: code required:submit-data-update-type incremental | snapshot
- MeasureReport.measure [0..1]: canonical What measure was calculated
- MeasureReport.subject [0..1]: [Reference(CareTeam](/Reference(CareTeam), Device, Group, HealthcareService, Location, Organization, Patient, Practitioner, PractitionerRole, RelatedPerson)) What individual(s) the report is for
- MeasureReport.date [0..1]: dateTime When the measure report was generated
- MeasureReport.reporter [0..1]: [Reference(Practitioner](/Reference(Practitioner), PractitionerRole, Organization)) Who is reporting the data
- MeasureReport.reportingVendor [0..1]: Reference(Organization) What vendor prepared the data
- MeasureReport.location [0..*]: Reference(Location) Where the reported data is from
- MeasureReport.period [1..1]: Period What period the report covers
- MeasureReport.inputParameters [0..1]: Reference(Parameters) What parameters were provided to the report
- MeasureReport.group [0..*]: BackboneElement Measure results for each group
- MeasureReport.group.linkId [0..1]: string Pointer to specific group from Measure
- MeasureReport.group.title [0..1]: string Title of a group. Note- this value is copied from this element in Measure
- MeasureReport.group.calculatedDate [0..1]: dateTime The date the Measure Report was calculated
- MeasureReport.group.code [0..1]: CodeableConcept example:measure-group-example Meaning of the group
- MeasureReport.group.description [0..1]: markdown Summary description
- MeasureReport.group.type [0..1]: CodeableConcept extensible:measure-type process | outcome | structure | patient-reported-outcome
- MeasureReport.group.subject [0..1]: [Reference(CareTeam](/Reference(CareTeam), Device, Group, HealthcareService, Location, Organization, Patient, Practitioner, PractitionerRole, RelatedPerson)) What individual(s) the report is for
- MeasureReport.group.scoring [0..1]: CodeableConcept extensible:measure-scoring What scoring method (e.g. proportion, ratio, continuous-variable)
- MeasureReport.group.improvementNotation [0..1]: CodeableConcept extensible:measure-improvement-notation increase | decrease
- MeasureReport.group.improvementNotationGuidance [0..1]: markdown Explanation of improvement notation
- MeasureReport.group.population [0..*]: BackboneElement The populations in the group
- MeasureReport.group.population.linkId [0..1]: string Pointer to specific population from Measure
- MeasureReport.group.population.title [0..1]: string Title of a group. Note- this value is copied from this element in Measure
- MeasureReport.group.population.code [0..1]: CodeableConcept extensible:measure-population initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
- MeasureReport.group.population.description [0..1]: markdown The human readable description of this population criteria
- MeasureReport.group.population.count [0..1]: integer Size of the population
- MeasureReport.group.population.countQuantity [0..1]: Quantity Size of the population as a quantity
- MeasureReport.group.population.subjectResults [0..1]: Reference(List) For subject-list reports, the subject results in this population
- MeasureReport.group.population.subjectReport [0..*]: Reference(MeasureReport) For subject-list reports, references to the individual reports for subjects in this population
- MeasureReport.group.population.subjects [0..1]: Reference(Group) What individual(s) in the population
- MeasureReport.group.measureScore[x] [0..1]: Quantity, dateTime, CodeableConcept, Period, Range, Duration, boolean, Ratio What score this group achieved
- MeasureReport.group.stratifier [0..*]: BackboneElement Stratification results
- MeasureReport.group.stratifier.linkId [0..1]: string Pointer to specific stratifier from Measure
- MeasureReport.group.stratifier.title [0..1]: string Title of a group's stratifier. Note- this value is copied from this element in Measure
- MeasureReport.group.stratifier.code [0..1]: CodeableConcept example:measure-stratifier-example What stratifier of the group
- MeasureReport.group.stratifier.description [0..1]: markdown The human readable description of this stratifier
- MeasureReport.group.stratifier.stratum [0..*]: BackboneElement Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components
- MeasureReport.group.stratifier.stratum.value[x] [0..1]: CodeableConcept, boolean, Quantity, Range, Reference example:measurereport-stratifier-value-example The stratum value, e.g. male
- MeasureReport.group.stratifier.stratum.component [0..*]: BackboneElement Stratifier component values
- MeasureReport.group.stratifier.stratum.component.linkId [0..1]: string Pointer to specific stratifier component from Measure
- MeasureReport.group.stratifier.stratum.component.code [1..1]: CodeableConcept example:measure-stratifier-example What stratifier component of the group
- MeasureReport.group.stratifier.stratum.component.description [0..1]: markdown The human readable description of this stratifier component
- MeasureReport.group.stratifier.stratum.component.value[x] [1..1]: CodeableConcept, boolean, Quantity, Range, Reference example:measurereport-stratifier-value-example The stratum component value, e.g. male
- MeasureReport.group.stratifier.stratum.population [0..*]: BackboneElement Population results in this stratum
- MeasureReport.group.stratifier.stratum.population.linkId [0..1]: string Pointer to specific population from Measure
- MeasureReport.group.stratifier.stratum.population.code [0..1]: CodeableConcept extensible:measure-population initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
- MeasureReport.group.stratifier.stratum.population.count [0..1]: integer Size of the population
- MeasureReport.group.stratifier.stratum.population.countQuantity [0..1]: Quantity Size of the population as a quantity
- MeasureReport.group.stratifier.stratum.population.subjectResults [0..1]: Reference(List) For subject-list reports, the subject results in this population
- MeasureReport.group.stratifier.stratum.population.subjectReport [0..*]: Reference(MeasureReport) For subject-list reports, a subject result in this population
- MeasureReport.group.stratifier.stratum.population.subjects [0..1]: Reference(Group) What individual(s) in the population
- MeasureReport.group.stratifier.stratum.measureScore[x] [0..1]: Quantity, dateTime, CodeableConcept, Period, Range, Duration, boolean, Ratio What score this stratum achieved
- MeasureReport.supplementalData [0..*]: Reference(Resource) Additional information collected for the report
- MeasureReport.evaluatedResource [0..*]: Reference(Resource) What data was used to calculate the measure score
Mappings
- MeasureReport Mappings — 67 mapping entries
Resource Packs
list-MeasureReport-packs.xml
<?xml version="1.0" encoding="UTF-8"?>
<List xmlns="http://hl7.org/fhir">
<id value="MeasureReport-packs"/>
<status value="current"/>
<mode value="working"/>
</List>
Search Parameters
- date — date — The date of the measure report —
MeasureReport.date - evaluated-resource — reference — An evaluated resource referenced by the measure report —
MeasureReport.evaluatedResource - identifier — token — External identifier of the measure report to be returned —
MeasureReport.identifier - measure — reference — The measure to return measure report results for —
MeasureReport.measure - patient — reference — The identity of a patient to search for individual measure report results for —
MeasureReport.subject.where(resolve() is Patient) - period — date — The period of the measure report —
MeasureReport.period - reporter — reference — The reporter to return measure report results for —
MeasureReport.reporter - location — reference — The location to return measure report results for —
MeasureReport.location - 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
Examples
- 788ca455-e11b1a59 — measurereport-788ca455-e11b1a59 — Example subject-list
- general-example-of-report — measurereport-general-example — Example MeasureReport for a single patient
- hiv-indicators — measurereport-hiv-indicators — Example MeasureReport for reporting public health data elements
- measurereport-cms146-cat1-example — measurereport-cms146-cat1-example — CMS 146 Individual Report
- measurereport-cms146-cat3-example — measurereport-cms146-cat3-example — CMS 146 Summary Report
- measurereport-example — measurereport-example
- measurereport-examples-header — measurereport-examples-header
Mapping Exceptions
measurereport-fivews-mapping-exceptions.xml
Unmapped Elements
- FiveWs.author — Unknown
- FiveWs.actor — Unknown
- FiveWs.cause — Unknown
- FiveWs.version — Unknown
- FiveWs.witness — Unknown
- FiveWs.where — Unknown
- FiveWs.context — Unknown
- FiveWs.init — Unknown
- FiveWs.why — Unknown
- FiveWs.who — Unknown
- FiveWs.grade — Unknown
- FiveWs.planned — Unknown
- FiveWs.done — Unknown