FHIR Release 3 (STU) CI-Build

This page is part of the FHIR Specification (v3.0.2: STU 3). The current version which supercedes this version is 5.0.0 . For a full list Continuous Integration Build of available versions, see FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions icon . Page versions: R5 R4B R4 R3 R2

14.6 14.16 Resource MeasureReport - Content

Responsible Owner: Clinical Quality Information icon Work Group   Normative Maturity Level : 2   Trial Use Security Category : Business Compartments : Group , Patient

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

14.6.1 14.16.1 Scope and Usage

This resource is an event resource from a FHIR workflow perspective - see Workflow , specifically Event . The MeasureReport resource represents the results of evaluating calculating a measure for a specific patient subject or group of patients. subjects. The $evaluate-measure $evaluate operation of the Measure resource is defined to return a MeasureReport. The resource is capable of representing can represent three different levels of report: patient-level, patient-list, 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 1 STU5.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.

Note that this resource is An individual MeasureReport contains information about a special case of specific subject and typically includes references to the more general notion relevant data used to generate the report. A subject-list MeasureReport reports on a list of subjects and provides a query evaluation result. However, because the general case requires the ability to represent arbitrary content, this List resource uses a simple indicator structure that contains references to describe population sizes individual-level reports for each subject being reported. A summary MeasureReport reports on a group of subjects and contains population type counts and the calculated score as defined in by the measure. The intent is to be able Measure. Finally, data-collection reports are used to represent communicate the more general case as well, either by generalizing this resource, data of interest, so no scoring or by making this structure other calculated information is expected.

For a profile detailed discussion of a more general resource, how to use the Measure and we are actively seeking comments about what approaches might be taken MeasureReport resources, refer to achieve that aim. the Quality Reporting topic.

14.6.2 14.16.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 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.

Mappings from the V3 to the FHIR terminologies can be found in the Quality Measure IG icon.

14.16.3 References to this Resource

  • Resource References: itself

14.6.3 14.16.4 Resource Content

Structure

0..1 Reference 1..1 Identifier Identifier BackboneElement Σ Σ
Name Flags Card. Type Description & Constraints      Filter: Filters doco
. . MeasureReport N 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 element 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 (example codes include deqm, ra, vbp)
Binding: Measure Report Category VS ( Extensible )
. . . messages 0..1 Reference ( OperationOutcome ) Evaluation messages
. . . type Σ C 1..1 code individual | patient-list subject-list | summary | data-exchange
MeasureReportType Binding: Measure Report Type ( Required )
. . measure . dataUpdateType ?! Σ 0..1 code 1..1 incremental | snapshot
Binding: Submit Data Update Type ( Required )
. . . measure Σ 0..1 canonical ( Measure ) What measure was evaluated calculated
. . . patient subject Σ 0..1 Reference ( CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson ) What patient individual(s) the report is for
. . . date Σ 0..1 dateTime When the measure report was generated
. . . reportingOrganization reporter Σ 0..1 Reference ( Practitioner | PractitionerRole | Organization ) Who is reporting the data
. . period . 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
... group C 0..* BackboneElement Measure results for each group

. . . identifier . linkId 0..1 string 1..1 Pointer to specific group from Measure
. . . . title What group 0..1 string Title of a group. Note- this value is copied from this element in Measure
.... calculatedDate 0..1 dateTime The date the measure Measure Report was calculated
. . . . code Σ 0..1 CodeableConcept Meaning of the group
Binding: Measure Group Example ( Example )
.... description 0..1 markdown Summary description
.... type Σ 0..1 CodeableConcept process | outcome | structure | patient-reported-outcome
Binding: MeasureType icon ( Extensible )
.... subject Σ 0..1 Reference ( CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson ) What individual(s) the report is for
.... scoring ?! Σ 0..1 CodeableConcept What scoring method (e.g. proportion, ratio, continuous-variable)
Binding: Measure Scoring icon ( Extensible )
. . . . improvementNotation ?! Σ 0..1 CodeableConcept increase | decrease
Binding: MeasureImprovementNotation icon ( Extensible )
.... improvementNotationGuidance Σ 0..1 markdown Explanation of improvement notation
... . population C 0..* BackboneElement The populations in the group
+ Rule: The count and countQuantity elements SHALL be mutually exclusive

. . . . identifier . linkId 0..1 Σ string Pointer to specific population from Measure
0..1
. . . . . title Population identifier as defined 0..1 string Title of a group. Note- this value is copied from this element in the measure Measure
. . . . . code Σ 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score measure-observation
Binding: MeasurePopulationType icon ( Extensible )
. . . . . description 0..1 markdown The human readable description of this population criteria
..... count C 0..1 integer Size of the population
. . . . patients . countQuantity C 0..1 Quantity Size of the population as a quantity
..... subjectResults 0..1 Reference ( List ) For patient-list subject-list reports, the patients subject results in this population
. . . . measureScore . 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
decimal
. . . . measureScore[x] Σ 0..1 What score this group achieved
. . . . . measureScoreQuantity Quantity
..... measureScoreDateTime dateTime
..... measureScoreCodeableConcept CodeableConcept
..... measureScorePeriod Period
..... measureScoreRange Range
..... measureScoreDuration Duration
. . . . . measureScoreBoolean boolean
... . . measureScoreRatio Ratio
.... stratifier C 0..* BackboneElement Stratification results

. . . . identifier . linkId 0..1 string Pointer to specific stratifier from Measure
..... title 0..1 string Identifier Title of a group's stratifier. Note- this value is copied from this element in Measure
..... code 0..1 CodeableConcept What stratifier of the group
Binding: Measure Stratifier Example ( Example )
. . . . . description 0..1 markdown The human readable description of this stratifier
.... . stratum C 0..* BackboneElement Stratum results, one for each unique value 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 )
..... . value . valueCodeableConcept CodeableConcept
. . . . . . . valueBoolean boolean
. . . . . . . valueQuantity 1..1 Quantity
....... valueRange Range
....... valueReference Reference ()
...... component C 0..* BackboneElement Stratifier component values

....... linkId 0..1 string Pointer to specific stratifier component from Measure
The stratum value, e.g. male
. . . . . . population . code 1..1 CodeableConcept 0..* What stratifier component of the group
Binding: Measure Stratifier Example ( Example )
. . . . . . . description Population results in 0..1 markdown The human readable description of this stratifier component
....... value[x] 1..1 The stratum component value, e.g. male
Binding: Measure Report Stratifier Value Example ( Example )
. . . . . . . . identifier valueCodeableConcept CodeableConcept
. . . . . . . . valueBoolean 0..1 Identifier boolean Population identifier as defined in the measure
. . . . . . . . code valueQuantity Quantity
. . . . . . . . valueRange Range
. . . . . . . . valueReference Reference ()
...... population C 0..* BackboneElement Population results in this stratum
+ Rule: The count and countQuantity elements for a statum population SHALL be mutually exclusive

. . . . . . . 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-score measure-observation
Binding: MeasurePopulationType icon ( Extensible )
. . . . . . . count C 0..1 integer Size of the population
. . . . . . patients . countQuantity C 0..1 Quantity Size of the population as a quantity
....... subjectResults 0..1 Reference ( List ) For patient-list subject-list reports, the patients subject results in this population
. . . . . measureScore . . 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
decimal
. . . . . . measureScore[x] 0..1 What score this stratum achieved
. . . . . . . measureScoreQuantity Quantity
....... measureScoreDateTime dateTime
....... measureScoreCodeableConcept CodeableConcept
....... measureScorePeriod Period
....... measureScoreRange Range
....... measureScoreDuration Duration
. . . . . . . measureScoreBoolean boolean
..... . . measureScoreRatio Ratio
.. . evaluatedResources supplementalData 0..* 0..1 Reference ( Any ) Additional information collected for the report

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


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

MeasureReport ( DomainResource ) A formal identifier that is used to identify this report MeasureReport when it is represented in other formats, formats or referenced in a specification, model, design or an instance identifier : Identifier [0..1] [0..*] The category of measure report instance this is such as Data Exchange for Quality Measures (DEQM), Risk Adjustment, or Value-Based Performance category : CodeableConcept [0..1] « null (Strength=Extensible) MeasureReportCategory + » A reference to an OperationOutcome that contains any information, warning, and/or error messages that were generated while processing an operation such as $evaluate messages : Reference [0..1] « OperationOutcome » The MeasureReport status. No data will be available until the report MeasureReport status is complete (this element modifies the meaning of other elements) status : code [1..1] « The status of the measure report report. (Strength=Required) MeasureReportStatus ! » The type of measure report. This may be an individual report, which provides a single patient's the score for the measure; measure for an individual member of the population; a patient listing, subject-listing, which returns the list of patients members that meet the various criteria in the measure; or a summary report, which returns a population count for each of the criteria in the measure; or a data-collection, which enables the MeasureReport to be used to exchange the data-of-interest for a quality measure type : code [1..1] « The type of the measure report report. (Strength=Required) MeasureReportType ! » « This element has or is affected by some invariants C » Indicates whether the data submitted in a data-exchange report represents a snapshot or incremental update. A snapshot update replaces all previously submitted data for the receiver, whereas an incremental update represents only updated and/or changed data and should be applied as a differential update to the existing submitted data for the receiver (this element modifies the meaning of other elements) dataUpdateType : code [0..1] « null (Strength=Required) SubmitDataUpdateType ! » A reference to the Measure that was evaluated calculated to produce this report measure : Reference canonical [1..1] [0..1] « Measure » Optional Patient if subject identifying the individual or individuals the report was requested is for a single patient patient subject : Reference [0..1] « CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson » The date this measure report was generated date : dateTime [0..1] Reporting The individual or organization that is reporting the data reporter : Reference [0..1] « Practitioner | PractitionerRole | Organization » A reference to the vendor who queried the data, calculated results and/or generated the report. The ‘reporting vendor’ is intended to represent the submitting entity when it is not the same as the reporting entity. This extension is used when the Receiver is interested in getting vendor information in the report reportingOrganization reportingVendor : Reference [0..1] « Organization » A reference to the location for which the data is being reported location : Reference [0..*] « Location » The reporting period for which the report was calculated period : Period [1..1] A reference to a Bundle containing the Resources Parameters resource (typically represented using a contained resource) that represents any input parameters that were provided to the operation that generated the report. If the input parameter includes stratifiers, then the MeasureReport SHALL include the input parameters inputParameters : Reference [0..1] « Parameters » A reference to a Resource that represents additional information collected for the report. If the value of the supplemental data is not a Resource (i.e. evaluating the supplementalData expression for this case in the measure results in a value that is not a FHIR Resource), it is reported as a reference to a contained Observation resource supplementalData : Reference [0..*] « Any » Evaluated resources are used to capture what data was involved in the evaluation calculation of this report a measure. This usage is only allowed for individual reports to ensure that the size of the MeasureReport resource is bounded evaluatedResources evaluatedResource : Reference [0..1] Bundle [0..*] « Any » Group The identifier group from the Measure that corresponds to this group in the MeasureReport resource. This element SHALL be populated based on the corresponding element in the Measure being reported linkId : string [0..1] Indicates the title for of the group title : string [0..1] The date the Measure Report was calculated calculatedDate : dateTime [0..1] The meaning of the population group as defined in the measure definition definition. This element SHALL be populated with at least the codings in the code of the corresponding group in the Measure being reported identifier code : Identifier CodeableConcept [1..1] [0..1] « null (Strength=Example) MeasureGroupExample ?? » The human readable description of this population group. This element SHOULD be populated based on the description of the corresponding group in the Measure being reported description : markdown [0..1] Indicates whether the measure is used to examine a process, an outcome over time, a patient-reported outcome, or a structure measure such as utilization type : CodeableConcept [0..1] « null (Strength=Extensible) MeasureType + » Optional subject identifying the individual or individuals the report is for subject : Reference [0..1] « CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson » Indicates how the calculation is performed for the measure, including proportion, ratio, continuous-variable, and cohort. The value set is extensible, allowing additional measure scoring types to be represented. It is expected to be the same as the scoring element on the referenced Measure (this element modifies the meaning of other elements) scoring : CodeableConcept [0..1] « null (Strength=Extensible) MeasureScoring + » Whether improvement in the measure is noted by an increase or decrease in the measure score. Exercise caution when using any values besides increase or decrease for improvementNotation (this element modifies the meaning of other elements) improvementNotation : CodeableConcept [0..1] « Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue. (Strength=Extensible) MeasureImprovementNotation + » Narrative text to explain the improvement notation and how to interpret it improvementNotationGuidance : markdown [0..1] The measure score for this population group, calculated as appropriate for the measure type and scoring method, and based on the contents of the populations defined in the group measureScore measureScore[x] : decimal DataType [0..1] « Quantity | dateTime | CodeableConcept | Period | Range | Duration | boolean | Ratio » Population The identifier of the population being reported, as defined by from the Measure that corresponds to this population in the MeasureReport resource. This element SHALL be populated based on the corresponding element in the Measure being reported linkId : string [0..1] Indicates the title for of the measure group's population identifier title : Identifier string [0..1] The type of the population. This element SHALL be populated with at least the codings in the code element of the corresponding population in the Measure group being reported code : CodeableConcept [0..1] « null (Strength=Extensible) MeasurePopulationType + » The type human readable description of this population (e.g. initial, numerator, denominator, etc.) (Strength=Extensible) criteria. This element SHOULD be populated based on the description element of the corresponding population in the Measure group being reported MeasurePopulationType description + : markdown [0..1] The number of members of the population count : integer [0..1] « This element has or is affected by some invariants C » The number of members of the population, specified as a quantity to support identifying units, as well as to support some composite measure calculation use cases where the resulting count of the population is a decimal value countQuantity : Quantity [0..1] « This element has or is affected by some invariants C » This element refers to a List of patient individual level MeasureReport resources, one for each patient subject in this population patients subjectResults : Reference [0..1] « List » A reference to an individual level MeasureReport resource for a member of the population subjectReport : Reference [0..*] « MeasureReport » Optional Group identifying the individuals that make up the population subjects : Reference [0..1] « Group » Stratifier The identifier stratifier from the Measure that corresponds to this stratifier in the MeasureReport resource. This element SHALL be populated based on the corresponding element in the Measure being reported linkId : string [0..1] Indicates the title for of the group's stratifier title : string [0..1] The meaning of this stratifier, as defined in the measure definition definition. This element SHALL be populated with at least the codings in the code element of the corresponding stratifier in the Measure group being reported identifier code : Identifier CodeableConcept [0..1] « null (Strength=Example) MeasureStratifierExample ?? » The human readable description of this stratifier criteria. This element SHOULD be populated with the description element of the corresponding stratifier in the Measure group being reported description : markdown [0..1] StratifierGroup The value for this stratum, expressed as a string. CodeableConcept. When defining stratifiers on complex values, the value must be rendered such that the value for each stratum within the stratifier is unique value value[x] : string DataType [1..1] [0..1] « CodeableConcept | boolean | Quantity | Range | Reference ; null (Strength=Example) MeasureReportStratifierValueE... ?? » « This element has or is affected by some invariants C » The measure score for this stratum, calculated as appropriate for the measure type and scoring method, and based on only the members of this stratum measureScore measureScore[x] : decimal DataType [0..1] « Quantity | dateTime | CodeableConcept | Period | Range | Duration | boolean | Ratio » StratifierGroupPopulation Component The identifier of stratifier component from the population being reported, as defined by Measure that corresponds to this stratifier component in the population MeasureReport resource. This element of SHALL be populated based on the measure corresponding element in the Measure being reported identifier linkId : Identifier string [0..1] The type code for the stratum component value. This element SHALL be populated with at least the codings in the code element of the population corresponding component of the stratifier being reported code : CodeableConcept [1..1] « null (Strength=Example) MeasureStratifierExample ?? » The human readable description of this stratifier criteria component. This element MAY be populated with the description of the corresponding component of the stratifier being reported description : markdown [0..1] The stratum component value value[x] : DataType [1..1] « CodeableConcept | boolean | Quantity | Range | Reference ; null (Strength=Example) MeasureReportStratifierValueE... ?? » StratifierGroupPopulation The population from the Measure that corresponds to this population in the MeasureReport resource. This element SHALL be populated with the linkId corresponding to the population being reported linkId : string [0..1] The type of the population. This element SHALL be populated with at least the codings in the code element of the corresponding population (e.g. initial, numerator, denominator, etc.) being reported code : CodeableConcept [0..1] « null (Strength=Extensible) MeasurePopulationType + » The number of members of the population in this stratum count : integer [0..1] « This element has or is affected by some invariants C » The number of members of the population in this stratum, specified as a quantity to support identifying units, as well as to support some composite measure calculation use cases where the resulting count of the population is a decimal value countQuantity : Quantity [0..1] « This element has or is affected by some invariants C » This element refers to a List of patient individual level MeasureReport resources, one for each patient subject in this population in this stratum patients subjectResults : Reference [0..1] « List » A reference to an individual level MeasureReport resource for a member of the population subjectReport : Reference [0..*] « MeasureReport » Optional Group identifying the individuals that make up the population subjects : Reference [0..1] « Group » The populations that make up the population group, one for each type of population appropriate for the measure measure. Each group in the MeasureReport SHALL have populations as defined in the corresponding group of the Measure being reported population [0..*] A stratifier component value component [0..*] The populations that make up the stratum, one for each type of population appropriate to the measure measure. For each stratifier, systems MAY provide population breakdowns in addition to the stratified scores population [0..*] This element contains the results for a single stratum within the stratifier. For example, when stratifying on administrative gender, there will be four strata, one for each possible gender value stratum [0..*] When a measure includes multiple stratifiers, there will be a stratifier group The stratification results for each stratifier this measure group, calculated as defined by the stratifier element of the measure being reported. Each group in the MeasureReport SHALL have stratifiers as defined in the corresponding group of the Measure being reported stratifier [0..*] The results of the calculation, one for each population group in the measure measure. A MeasureReport SHALL have a group element corresponding to each group element defined in the Measure being reported group [0..*]

XML Template 

<

<MeasureReport xmlns="http://hl7.org/fhir"> doco

 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <</identifier>
 <
 <
 <</measure>
 <</patient>
 <
 <</reportingOrganization>

 <identifier><!-- 0..* Identifier Additional identifier for the MeasureReport --></identifier>
 <category><!-- 0..1 CodeableConcept The category of measure report instance this is (example codes include deqm, ra, vbp) --></category>
 <messages><!-- 0..1 Reference(OperationOutcome) Evaluation messages --></messages>
 <status value="[code]"/><!-- 1..1 complete | pending | error -->
 <type value="[code]"/><!-- I 1..1 individual | subject-list | summary | data-exchange -->
 <dataUpdateType value="[code]"/><!-- 0..1 incremental | snapshot -->
 <measure><!-- 0..1 canonical(Measure) What measure was calculated --></measure>
 <subject><!-- 0..1 Reference(CareTeam|Device|Group|HealthcareService|Location|
   Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) What individual(s) the report is for --></subject>

 <date value="[dateTime]"/><!-- 0..1 When the measure report was generated -->
 <reporter><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole) Who is reporting the data --></reporter>
 <reportingVendor><!-- 0..1 Reference(Organization) What vendor prepared the data --></reportingVendor>
 <location><!-- 0..* Reference(Location) Where the reported data is from --></location>

 <period><!-- 1..1 Period What period the report covers --></period>
 <
  <</identifier>
  <
   <</identifier>
   <</code>
   <
   <</patients>

 <inputParameters><!-- 0..1 Reference(Parameters) What parameters were provided to the report --></inputParameters>
 <group>  <!-- I 0..* Measure results for each group -->
  <linkId value="[string]"/><!-- 0..1 Pointer to specific group from Measure -->
  <title value="[string]"/><!-- 0..1 Title of a group. Note- this value is copied from this element in Measure -->
  <calculatedDate value="[dateTime]"/><!-- 0..1 The date the Measure Report was calculated -->
  <code><!-- 0..1 CodeableConcept Meaning of the group --></code>
  <description value="[markdown]"/><!-- 0..1 Summary description -->
  <type><!-- 0..1 CodeableConcept process | outcome | structure | patient-reported-outcome icon --></type>
  <subject><!-- 0..1 Reference(CareTeam|Device|Group|HealthcareService|Location|
    Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) What individual(s) the report is for --></subject>

  <scoring><!-- 0..1 CodeableConcept What scoring method (e.g. proportion, ratio, continuous-variable) icon --></scoring>
  <improvementNotation><!-- 0..1 CodeableConcept increase | decrease icon --></improvementNotation>
  <improvementNotationGuidance value="[markdown]"/><!-- 0..1 Explanation of improvement notation -->
  <population>  <!-- 0..* The populations in the group -->
   <linkId value="[string]"/><!-- 0..1 Pointer to specific population from Measure -->
   <title value="[string]"/><!-- 0..1 Title of a group. Note- this value is copied from this element in Measure -->
   <code><!-- 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation icon --></code>
   <description value="[markdown]"/><!-- 0..1 The human readable description of this population criteria -->
   <count value="[integer]"/><!-- I 0..1 Size of the population -->
   <countQuantity><!-- I 0..1 Quantity Size of the population as a quantity --></countQuantity>
   <subjectResults><!-- 0..1 Reference(List) For subject-list reports, the subject results in this population --></subjectResults>
   <subjectReport><!-- 0..* Reference(MeasureReport) For subject-list reports, references to the individual reports for subjects in this population --></subjectReport>
   <subjects><!-- 0..1 Reference(Group) What individual(s) in the population --></subjects>

  </population>
  <
  <
   <</identifier>
   <
    <
    <
     <</identifier>
     <</code>
     <
     <</patients>

  <measureScore[x]><!-- 0..1 Quantity|dateTime|CodeableConcept|Period|Range|
    Duration|boolean|Ratio What score this group achieved --></measureScore[x]>

  <stratifier>  <!-- I 0..* Stratification results -->
   <linkId value="[string]"/><!-- 0..1 Pointer to specific stratifier from Measure -->
   <title value="[string]"/><!-- 0..1 Title of a group's stratifier. Note- this value is copied from this element in Measure -->
   <code><!-- 0..1 CodeableConcept What stratifier of the group --></code>
   <description value="[markdown]"/><!-- 0..1 The human readable description of this stratifier -->
   <stratum>  <!-- I 0..* Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components -->
    <value[x]><!-- I 0..1 CodeableConcept|boolean|Quantity|Range|Reference The stratum value, e.g. male --></value[x]>
    <component>  <!-- I 0..* Stratifier component values -->
     <linkId value="[string]"/><!-- 0..1 Pointer to specific stratifier component from Measure -->
     <code><!-- 1..1 CodeableConcept What stratifier component of the group --></code>
     <description value="[markdown]"/><!-- 0..1 The human readable description of this stratifier component -->
     <value[x]><!-- 1..1 CodeableConcept|boolean|Quantity|Range|Reference The stratum component value, e.g. male --></value[x]>
    </component>
    <population>  <!-- 0..* Population results in this stratum -->
     <linkId value="[string]"/><!-- 0..1 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 icon --></code>
     <count value="[integer]"/><!-- I 0..1 Size of the population -->
     <countQuantity><!-- I 0..1 Quantity Size of the population as a quantity --></countQuantity>
     <subjectResults><!-- 0..1 Reference(List) For subject-list reports, the subject results in this population --></subjectResults>
     <subjectReport><!-- 0..* Reference(MeasureReport) For subject-list reports, a subject result in this population --></subjectReport>
     <subjects><!-- 0..1 Reference(Group) What individual(s) in the population --></subjects>

    </population>
    <

    <measureScore[x]><!-- 0..1 Quantity|dateTime|CodeableConcept|Period|Range|
      Duration|boolean|Ratio What score this stratum achieved --></measureScore[x]>
   </stratum>
  </stratifier>
 </group>
 <</evaluatedResources>

 <supplementalData><!-- 0..* Reference(Any) Additional information collected for the report --></supplementalData>
 <evaluatedResource><!-- 0..* Reference(Any) What data was used to calculate the measure score --></evaluatedResource>

</MeasureReport>

JSON Template 

{doco
  "resourceType" : "",

  "resourceType" : "MeasureReport",

  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "
  "
  "
  "
  "
  "
    "
    "
      "
      "
      "
      "

  "identifier" : [{ Identifier }], // Additional identifier for the MeasureReport
  "category" : { CodeableConcept }, // The category of measure report instance this is (example codes include deqm, ra, vbp)
  "messages" : { Reference(OperationOutcome) }, // Evaluation messages
  "status" : "<code>", // R!  complete | pending | error
  "type" : "<code>", // I R!  individual | subject-list | summary | data-exchange
  "dataUpdateType" : "<code>", // incremental | snapshot
  "measure" : "<canonical(Measure)>", // What measure was calculated
  "subject" : { Reference(CareTeam|Device|Group|HealthcareService|Location|
   Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) }, // What individual(s) the report is for

  "date" : "<dateTime>", // When the measure report was generated
  "reporter" : { Reference(Organization|Practitioner|PractitionerRole) }, // Who is reporting the data
  "reportingVendor" : { Reference(Organization) }, // What vendor prepared the data
  "location" : [{ Reference(Location) }], // Where the reported data is from
  "period" : { Period }, // R!  What period the report covers
  "inputParameters" : { Reference(Parameters) }, // What parameters were provided to the report
  "group" : [{ // I Measure results for each group
    "linkId" : "<string>", // Pointer to specific group from Measure
    "title" : "<string>", // Title of a group. Note- this value is copied from this element in Measure
    "calculatedDate" : "<dateTime>", // The date the Measure Report was calculated
    "code" : { CodeableConcept }, // Meaning of the group
    "description" : "<markdown>", // Summary description
    "type" : { CodeableConcept }, // process | outcome | structure | patient-reported-outcome icon
    "subject" : { Reference(CareTeam|Device|Group|HealthcareService|Location|
    Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) }, // What individual(s) the report is for

    "scoring" : { CodeableConcept }, // What scoring method (e.g. proportion, ratio, continuous-variable) icon
    "improvementNotation" : { CodeableConcept }, // increase | decrease icon
    "improvementNotationGuidance" : "<markdown>", // Explanation of improvement notation
    "population" : [{ // The populations in the group
      "linkId" : "<string>", // Pointer to specific population from Measure
      "title" : "<string>", // Title of a group. Note- this value is copied from this element in Measure
      "code" : { CodeableConcept }, // initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation icon
      "description" : "<markdown>", // The human readable description of this population criteria
      "count" : <integer>, // I Size of the population
      "countQuantity" : { Quantity }, // I Size of the population as a quantity
      "subjectResults" : { Reference(List) }, // For subject-list reports, the subject results in this population
      "subjectReport" : [{ Reference(MeasureReport) }], // For subject-list reports, references to the individual reports for subjects in this population
      "subjects" : { Reference(Group) } // What individual(s) in the population

    }],
    "
    "
      "
      "
        "
        "
          "
          "
          "
          "

    // measureScore[x]: What score this group achieved. One of these 8:
    "measureScoreQuantity" : { Quantity },
    "measureScoreDateTime" : "<dateTime>",
    "measureScoreCodeableConcept" : { CodeableConcept },
    "measureScorePeriod" : { Period },
    "measureScoreRange" : { Range },
    "measureScoreDuration" : { Duration },
    "measureScoreBoolean" : <boolean>,
    "measureScoreRatio" : { Ratio },
    "stratifier" : [{ // I Stratification results
      "linkId" : "<string>", // Pointer to specific stratifier from Measure
      "title" : "<string>", // Title of a group's stratifier. Note- this value is copied from this element in Measure
      "code" : { CodeableConcept }, // What stratifier of the group
      "description" : "<markdown>", // The human readable description of this stratifier
      "stratum" : [{ // I Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components
        // value[x]: The stratum value, e.g. male. One of these 5:

        "valueCodeableConcept" : { CodeableConcept },
        "valueBoolean" : <boolean>,
        "valueQuantity" : { Quantity },
        "valueRange" : { Range },
        "valueReference" : { Reference },
        "component" : [{ // I Stratifier component values
          "linkId" : "<string>", // Pointer to specific stratifier component from Measure
          "code" : { CodeableConcept }, // R!  What stratifier component of the group
          "description" : "<markdown>", // The human readable description of this stratifier component
          // value[x]: The stratum component value, e.g. male. One of these 5:

          "valueCodeableConcept" : { CodeableConcept },
          "valueBoolean" : <boolean>,
          "valueQuantity" : { Quantity },
          "valueRange" : { Range },
          "valueReference" : { Reference }

        }],
        "

        "population" : [{ // Population results in this stratum
          "linkId" : "<string>", // Pointer to specific population from Measure
          "code" : { CodeableConcept }, // initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation icon
          "count" : <integer>, // I Size of the population
          "countQuantity" : { Quantity }, // I Size of the population as a quantity
          "subjectResults" : { Reference(List) }, // For subject-list reports, the subject results in this population
          "subjectReport" : [{ Reference(MeasureReport) }], // For subject-list reports, a subject result in this population
          "subjects" : { Reference(Group) } // What individual(s) in the population
        }],
        // measureScore[x]: What score this stratum achieved. One of these 8:

        "measureScoreQuantity" : { Quantity },
        "measureScoreDateTime" : "<dateTime>",
        "measureScoreCodeableConcept" : { CodeableConcept },
        "measureScorePeriod" : { Period },
        "measureScoreRange" : { Range },
        "measureScoreDuration" : { Duration },
        "measureScoreBoolean" : <boolean>,
        "measureScoreRatio" : { Ratio }

      }]
    }]
  }],
  "

  "supplementalData" : [{ Reference(Any) }], // Additional information collected for the report
  "evaluatedResource" : [{ Reference(Any) }] // What data was used to calculate the measure score

}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:;

[ a fhir:MeasureReport;

  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from 
  # from 
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
    fhir:
    fhir:
      fhir:
      fhir:
      fhir:
      fhir:
    ], ...;
    fhir:
    fhir:
      fhir:
      fhir:
        fhir:
        fhir:
          fhir:
          fhir:
          fhir:
          fhir:
        ], ...;
        fhir:
      ], ...;
    ], ...;
  ], ...;
  fhir:

  # from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language
  # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir:modifierExtension
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Additional identifier for the MeasureReport
  fhir:category [ CodeableConcept ] ; # 0..1 The category of measure report instance this is (example codes include deqm, ra, vbp)
  fhir:messages [ Reference(OperationOutcome) ] ; # 0..1 Evaluation messages
  fhir:status [ code ] ; # 1..1 complete | pending | error
  fhir:type [ code ] ; # 1..1 I individual | subject-list | summary | data-exchange
  fhir:dataUpdateType [ code ] ; # 0..1 incremental | snapshot
  fhir:measure [ canonical(Measure) ] ; # 0..1 What measure was calculated
  fhir:subject [ Reference(CareTeam|Device|Group|HealthcareService|Location|Organization|Patient|
  Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 What individual(s) the report is for

  fhir:date [ dateTime ] ; # 0..1 When the measure report was generated
  fhir:reporter [ Reference(Organization|Practitioner|PractitionerRole) ] ; # 0..1 Who is reporting the data
  fhir:reportingVendor [ Reference(Organization) ] ; # 0..1 What vendor prepared the data
  fhir:location  ( [ Reference(Location) ] ... ) ; # 0..* Where the reported data is from
  fhir:period [ Period ] ; # 1..1 What period the report covers
  fhir:inputParameters [ Reference(Parameters) ] ; # 0..1 What parameters were provided to the report
  fhir:group ( [ # 0..* I Measure results for each group
    fhir:linkId [ string ] ; # 0..1 Pointer to specific group from Measure
    fhir:title [ string ] ; # 0..1 Title of a group. Note- this value is copied from this element in Measure
    fhir:calculatedDate [ dateTime ] ; # 0..1 The date the Measure Report was calculated
    fhir:code [ CodeableConcept ] ; # 0..1 Meaning of the group
    fhir:description [ markdown ] ; # 0..1 Summary description
    fhir:type [ CodeableConcept ] ; # 0..1 process | outcome | structure | patient-reported-outcome
    fhir:subject [ Reference(CareTeam|Device|Group|HealthcareService|Location|Organization|Patient|
  Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 What individual(s) the report is for

    fhir:scoring [ CodeableConcept ] ; # 0..1 What scoring method (e.g. proportion, ratio, continuous-variable)
    fhir:improvementNotation [ CodeableConcept ] ; # 0..1 increase | decrease
    fhir:improvementNotationGuidance [ markdown ] ; # 0..1 Explanation of improvement notation
    fhir:population ( [ # 0..* The populations in the group
      fhir:linkId [ string ] ; # 0..1 Pointer to specific population from Measure
      fhir:title [ string ] ; # 0..1 Title of a group. Note- this value is copied from this element in Measure
      fhir:code [ CodeableConcept ] ; # 0..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
      fhir:description [ markdown ] ; # 0..1 The human readable description of this population criteria
      fhir:count [ integer ] ; # 0..1 I Size of the population
      fhir:countQuantity [ Quantity ] ; # 0..1 I Size of the population as a quantity
      fhir:subjectResults [ Reference(List) ] ; # 0..1 For subject-list reports, the subject results in this population
      fhir:subjectReport  ( [ Reference(MeasureReport) ] ... ) ; # 0..* For subject-list reports, references to the individual reports for subjects in this population
      fhir:subjects [ Reference(Group) ] ; # 0..1 What individual(s) in the population
    ] ... ) ;
    # measureScore[x] : 0..1 What score this group achieved. One of these 8
      fhir:measureScore [  a fhir:Quantity ; Quantity ]
      fhir:measureScore [  a fhir:DateTime ; dateTime ]
      fhir:measureScore [  a fhir:CodeableConcept ; CodeableConcept ]
      fhir:measureScore [  a fhir:Period ; Period ]
      fhir:measureScore [  a fhir:Range ; Range ]
      fhir:measureScore [  a fhir:Duration ; Duration ]
      fhir:measureScore [  a fhir:Boolean ; boolean ]
      fhir:measureScore [  a fhir:Ratio ; Ratio ]
    fhir:stratifier ( [ # 0..* I Stratification results
      fhir:linkId [ string ] ; # 0..1 Pointer to specific stratifier from Measure
      fhir:title [ string ] ; # 0..1 Title of a group's stratifier. Note- this value is copied from this element in Measure
      fhir:code [ CodeableConcept ] ; # 0..1 What stratifier of the group
      fhir:description [ markdown ] ; # 0..1 The human readable description of this stratifier
      fhir:stratum ( [ # 0..* I Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components
        # value[x] : 0..1 I The stratum value, e.g. male. One of these 5
          fhir:value [  a fhir:CodeableConcept ; CodeableConcept ]
          fhir:value [  a fhir:Boolean ; boolean ]
          fhir:value [  a fhir:Quantity ; Quantity ]
          fhir:value [  a fhir:Range ; Range ]
          fhir:value [  a fhir:Reference ; Reference ]
        fhir:component ( [ # 0..* I Stratifier component values
          fhir:linkId [ string ] ; # 0..1 Pointer to specific stratifier component from Measure
          fhir:code [ CodeableConcept ] ; # 1..1 What stratifier component of the group
          fhir:description [ markdown ] ; # 0..1 The human readable description of this stratifier component
          # value[x] : 1..1 The stratum component value, e.g. male. One of these 5
            fhir:value [  a fhir:CodeableConcept ; CodeableConcept ]
            fhir:value [  a fhir:Boolean ; boolean ]
            fhir:value [  a fhir:Quantity ; Quantity ]
            fhir:value [  a fhir:Range ; Range ]
            fhir:value [  a fhir:Reference ; Reference ]
        ] ... ) ;
        fhir:population ( [ # 0..* Population results in this stratum
          fhir:linkId [ string ] ; # 0..1 Pointer to specific population from Measure
          fhir:code [ CodeableConcept ] ; # 0..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
          fhir:count [ integer ] ; # 0..1 I Size of the population
          fhir:countQuantity [ Quantity ] ; # 0..1 I Size of the population as a quantity
          fhir:subjectResults [ Reference(List) ] ; # 0..1 For subject-list reports, the subject results in this population
          fhir:subjectReport  ( [ Reference(MeasureReport) ] ... ) ; # 0..* For subject-list reports, a subject result in this population
          fhir:subjects [ Reference(Group) ] ; # 0..1 What individual(s) in the population
        ] ... ) ;
        # measureScore[x] : 0..1 What score this stratum achieved. One of these 8
          fhir:measureScore [  a fhir:Quantity ; Quantity ]
          fhir:measureScore [  a fhir:DateTime ; dateTime ]
          fhir:measureScore [  a fhir:CodeableConcept ; CodeableConcept ]
          fhir:measureScore [  a fhir:Period ; Period ]
          fhir:measureScore [  a fhir:Range ; Range ]
          fhir:measureScore [  a fhir:Duration ; Duration ]
          fhir:measureScore [  a fhir:Boolean ; boolean ]
          fhir:measureScore [  a fhir:Ratio ; Ratio ]
      ] ... ) ;
    ] ... ) ;
  ] ... ) ;
  fhir:supplementalData  ( [ Reference(Any) ] ... ) ; # 0..* Additional information collected for the report
  fhir:evaluatedResource  ( [ Reference(Any) ] ... ) ; # 0..* What data was used to calculate the measure score

]

Changes since DSTU2 from both R4 and R4B

MeasureReport
MeasureReport.category
  • Added Element
MeasureReport.messages
  • Added Element
MeasureReport.type
  • Remove code data-collection
  • Add code data-exchange
MeasureReport.dataUpdateType
  • Added Element
MeasureReport.measure
  • Min Cardinality changed from 1 to 0
MeasureReport.subject
  • Type Reference: Added Target Types CareTeam, HealthcareService, Organization
MeasureReport.reporter
  • Type Reference: Removed Target Type Location
MeasureReport.reportingVendor
  • Added Element
MeasureReport.location
  • Added Element
MeasureReport.inputParameters
  • Added Element
MeasureReport.group.linkId
  • Added Element
MeasureReport.group.title
  • Added Element
MeasureReport.group.calculatedDate
  • Added Element
MeasureReport.group.description
  • Added Element
MeasureReport.group.type
  • Added Element
MeasureReport.group.subject
  • Added Element
MeasureReport.group.scoring
  • Added Element
MeasureReport.group.improvementNotation
  • Added Element
MeasureReport.group.improvementNotationGuidance
  • Added Element
MeasureReport.group.population.linkId
  • Added Element
MeasureReport.group.population.title
  • Added Element
MeasureReport.group.population.code
MeasureReport.group.population.description
  • Added Element
MeasureReport.group.population.countQuantity
  • Added Element
MeasureReport.group.population.subjectReport
  • Added Element
MeasureReport.group.population.subjects
  • Added Element
MeasureReport.group.measureScore[x]
  • Renamed from measureScore to measureScore[x]
  • Add Types dateTime, CodeableConcept, Period, Range, Duration, boolean, Ratio
MeasureReport.group.stratifier.linkId
  • Added Element
MeasureReport.group.stratifier.title
  • Added Element
MeasureReport.group.stratifier.code
  • Max Cardinality changed from * to 1
MeasureReport.group.stratifier.description
  • Added Element
MeasureReport.group.stratifier.stratum.value[x]
  • Renamed from value to value[x]
  • Add Types boolean, Quantity, Range, Reference
MeasureReport.group.stratifier.stratum.component.linkId
  • Added Element
MeasureReport.group.stratifier.stratum.component.description
  • Added Element
MeasureReport.group.stratifier.stratum.component.value[x]
  • Renamed from value to value[x]
  • Add Types boolean, Quantity, Range, Reference
MeasureReport.group.stratifier.stratum.population.linkId
  • Added Element
MeasureReport.group.stratifier.stratum.population.code
MeasureReport.group.stratifier.stratum.population.countQuantity
  • Added Element
MeasureReport.group.stratifier.stratum.population.subjectReport
  • Added Element
MeasureReport.group.stratifier.stratum.population.subjects
  • Added Element
MeasureReport.group.stratifier.stratum.measureScore[x]
  • Renamed from measureScore to measureScore[x]
  • Add Types dateTime, CodeableConcept, Period, Range, Duration, boolean, Ratio
MeasureReport.supplementalData
  • Added Element
MeasureReport.improvementNotation
  • Deleted

This resource did not exist in Release 2 See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .

Structure

0..1 Reference 1..1 Identifier Identifier BackboneElement Σ Σ
Name Flags Card. Type Description & Constraints      Filter: Filters doco
. . MeasureReport N 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 element 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 (example codes include deqm, ra, vbp)
Binding: Measure Report Category VS ( Extensible )
. . . messages 0..1 Reference ( OperationOutcome ) Evaluation messages
. . . type Σ C 1..1 code individual | patient-list subject-list | summary | data-exchange
MeasureReportType Binding: Measure Report Type ( Required )
. . measure . dataUpdateType ?! Σ 0..1 code 1..1 incremental | snapshot
Binding: Submit Data Update Type ( Required )
. . . measure Σ 0..1 canonical ( Measure ) What measure was evaluated calculated
. . . patient subject Σ 0..1 Reference ( CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson ) What patient individual(s) the report is for
. . . date Σ 0..1 dateTime When the measure report was generated
. . . reportingOrganization reporter Σ 0..1 Reference ( Practitioner | PractitionerRole | Organization ) Who is reporting the data
. . period . 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
... group C 0..* BackboneElement Measure results for each group

. . . identifier . linkId 0..1 string 1..1 Pointer to specific group from Measure
. . . . title What group 0..1 string Title of a group. Note- this value is copied from this element in Measure
.... calculatedDate 0..1 dateTime The date the measure Measure Report was calculated
. . . . code Σ 0..1 CodeableConcept Meaning of the group
Binding: Measure Group Example ( Example )
.... description 0..1 markdown Summary description
.... type Σ 0..1 CodeableConcept process | outcome | structure | patient-reported-outcome
Binding: MeasureType icon ( Extensible )
.... subject Σ 0..1 Reference ( CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson ) What individual(s) the report is for
.... scoring ?! Σ 0..1 CodeableConcept What scoring method (e.g. proportion, ratio, continuous-variable)
Binding: Measure Scoring icon ( Extensible )
. . . . improvementNotation ?! Σ 0..1 CodeableConcept increase | decrease
Binding: MeasureImprovementNotation icon ( Extensible )
.... improvementNotationGuidance Σ 0..1 markdown Explanation of improvement notation
... . population C 0..* BackboneElement The populations in the group
+ Rule: The count and countQuantity elements SHALL be mutually exclusive

. . . . identifier . linkId 0..1 Σ string Pointer to specific population from Measure
0..1
. . . . . title Population identifier as defined 0..1 string Title of a group. Note- this value is copied from this element in the measure Measure
. . . . . code Σ 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score measure-observation
Binding: MeasurePopulationType icon ( Extensible )
. . . . . description 0..1 markdown The human readable description of this population criteria
..... count C 0..1 integer Size of the population
. . . . patients . countQuantity C 0..1 Quantity Size of the population as a quantity
..... subjectResults 0..1 Reference ( List ) For patient-list subject-list reports, the patients subject results in this population
. . . . measureScore . 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
decimal
. . . . measureScore[x] Σ 0..1 What score this group achieved
. . . . . measureScoreQuantity Quantity
..... measureScoreDateTime dateTime
..... measureScoreCodeableConcept CodeableConcept
..... measureScorePeriod Period
..... measureScoreRange Range
..... measureScoreDuration Duration
..... measureScoreBoolean boolean
. . . . . measureScoreRatio Ratio
.... stratifier C 0..* BackboneElement Stratification results

. . . . identifier . linkId 0..1 string Pointer to specific stratifier from Measure
..... title 0..1 string Identifier Title of a group's stratifier. Note- this value is copied from this element in Measure
..... code 0..1 CodeableConcept What stratifier of the group
Binding: Measure Stratifier Example ( Example )
. . . . . description 0..1 markdown The human readable description of this stratifier
.... . stratum C 0..* BackboneElement Stratum results, one for each unique value 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 )
..... . value . valueCodeableConcept CodeableConcept
. . . . . . . valueBoolean boolean
. . . . . . . valueQuantity 1..1 Quantity
....... valueRange Range
....... valueReference Reference ()
...... component C 0..* BackboneElement Stratifier component values

....... linkId 0..1 string Pointer to specific stratifier component from Measure
The stratum value, e.g. male
. . . . . . population . code 1..1 CodeableConcept 0..* What stratifier component of the group
Binding: Measure Stratifier Example ( Example )
. . . . . . . description Population results in 0..1 markdown The human readable description of this stratifier component
....... value[x] 1..1 The stratum component value, e.g. male
Binding: Measure Report Stratifier Value Example ( Example )
. . . . . . . . identifier valueCodeableConcept CodeableConcept
. . . . . . . . valueBoolean 0..1 Identifier boolean Population identifier as defined in the measure
. . . . . . . . code valueQuantity Quantity
. . . . . . . . valueRange Range
. . . . . . . . valueReference Reference ()
...... population C 0..* BackboneElement Population results in this stratum
+ Rule: The count and countQuantity elements for a statum population SHALL be mutually exclusive

. . . . . . . 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-score measure-observation
Binding: MeasurePopulationType icon ( Extensible )
. . . . . . . count C 0..1 integer Size of the population
. . . . . . patients . countQuantity C 0..1 Quantity Size of the population as a quantity
....... subjectResults 0..1 Reference ( List ) For patient-list subject-list reports, the patients subject results in this population
. . . . . measureScore . . 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
decimal
. . . . . . measureScore[x] 0..1 What score this stratum achieved
. . . . . . . measureScoreQuantity Quantity
....... measureScoreDateTime dateTime
....... measureScoreCodeableConcept CodeableConcept
....... measureScorePeriod Period
....... measureScoreRange Range
....... measureScoreDuration Duration
. . . . . . . measureScoreBoolean boolean
..... . . measureScoreRatio Ratio
.. . evaluatedResources supplementalData 0..* 0..1 Reference ( Any ) Additional information collected for the report

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


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

MeasureReport ( DomainResource ) A formal identifier that is used to identify this report MeasureReport when it is represented in other formats, formats or referenced in a specification, model, design or an instance identifier : Identifier [0..1] [0..*] The category of measure report instance this is such as Data Exchange for Quality Measures (DEQM), Risk Adjustment, or Value-Based Performance category : CodeableConcept [0..1] « null (Strength=Extensible) MeasureReportCategory + » A reference to an OperationOutcome that contains any information, warning, and/or error messages that were generated while processing an operation such as $evaluate messages : Reference [0..1] « OperationOutcome » The MeasureReport status. No data will be available until the report MeasureReport status is complete (this element modifies the meaning of other elements) status : code [1..1] « The status of the measure report report. (Strength=Required) MeasureReportStatus ! » The type of measure report. This may be an individual report, which provides a single patient's the score for the measure; measure for an individual member of the population; a patient listing, subject-listing, which returns the list of patients members that meet the various criteria in the measure; or a summary report, which returns a population count for each of the criteria in the measure; or a data-collection, which enables the MeasureReport to be used to exchange the data-of-interest for a quality measure type : code [1..1] « The type of the measure report report. (Strength=Required) MeasureReportType ! » « This element has or is affected by some invariants C » Indicates whether the data submitted in a data-exchange report represents a snapshot or incremental update. A snapshot update replaces all previously submitted data for the receiver, whereas an incremental update represents only updated and/or changed data and should be applied as a differential update to the existing submitted data for the receiver (this element modifies the meaning of other elements) dataUpdateType : code [0..1] « null (Strength=Required) SubmitDataUpdateType ! » A reference to the Measure that was evaluated calculated to produce this report measure : Reference canonical [1..1] [0..1] « Measure » Optional Patient if subject identifying the individual or individuals the report was requested is for a single patient patient subject : Reference [0..1] « CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson » The date this measure report was generated date : dateTime [0..1] Reporting The individual or organization that is reporting the data reporter : Reference [0..1] « Practitioner | PractitionerRole | Organization » A reference to the vendor who queried the data, calculated results and/or generated the report. The ‘reporting vendor’ is intended to represent the submitting entity when it is not the same as the reporting entity. This extension is used when the Receiver is interested in getting vendor information in the report reportingOrganization reportingVendor : Reference [0..1] « Organization » A reference to the location for which the data is being reported location : Reference [0..*] « Location » The reporting period for which the report was calculated period : Period [1..1] A reference to a Bundle containing the Resources Parameters resource (typically represented using a contained resource) that represents any input parameters that were provided to the operation that generated the report. If the input parameter includes stratifiers, then the MeasureReport SHALL include the input parameters inputParameters : Reference [0..1] « Parameters » A reference to a Resource that represents additional information collected for the report. If the value of the supplemental data is not a Resource (i.e. evaluating the supplementalData expression for this case in the measure results in a value that is not a FHIR Resource), it is reported as a reference to a contained Observation resource supplementalData : Reference [0..*] « Any » Evaluated resources are used to capture what data was involved in the evaluation calculation of this report a measure. This usage is only allowed for individual reports to ensure that the size of the MeasureReport resource is bounded evaluatedResources evaluatedResource : Reference [0..1] Bundle [0..*] « Any » Group The identifier group from the Measure that corresponds to this group in the MeasureReport resource. This element SHALL be populated based on the corresponding element in the Measure being reported linkId : string [0..1] Indicates the title for of the group title : string [0..1] The date the Measure Report was calculated calculatedDate : dateTime [0..1] The meaning of the population group as defined in the measure definition definition. This element SHALL be populated with at least the codings in the code of the corresponding group in the Measure being reported identifier code : Identifier CodeableConcept [1..1] [0..1] « null (Strength=Example) MeasureGroupExample ?? » The human readable description of this population group. This element SHOULD be populated based on the description of the corresponding group in the Measure being reported description : markdown [0..1] Indicates whether the measure is used to examine a process, an outcome over time, a patient-reported outcome, or a structure measure such as utilization type : CodeableConcept [0..1] « null (Strength=Extensible) MeasureType + » Optional subject identifying the individual or individuals the report is for subject : Reference [0..1] « CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson » Indicates how the calculation is performed for the measure, including proportion, ratio, continuous-variable, and cohort. The value set is extensible, allowing additional measure scoring types to be represented. It is expected to be the same as the scoring element on the referenced Measure (this element modifies the meaning of other elements) scoring : CodeableConcept [0..1] « null (Strength=Extensible) MeasureScoring + » Whether improvement in the measure is noted by an increase or decrease in the measure score. Exercise caution when using any values besides increase or decrease for improvementNotation (this element modifies the meaning of other elements) improvementNotation : CodeableConcept [0..1] « Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue. (Strength=Extensible) MeasureImprovementNotation + » Narrative text to explain the improvement notation and how to interpret it improvementNotationGuidance : markdown [0..1] The measure score for this population group, calculated as appropriate for the measure type and scoring method, and based on the contents of the populations defined in the group measureScore measureScore[x] : decimal DataType [0..1] « Quantity | dateTime | CodeableConcept | Period | Range | Duration | boolean | Ratio » Population The identifier of the population being reported, as defined by from the Measure that corresponds to this population in the MeasureReport resource. This element SHALL be populated based on the corresponding element in the Measure being reported linkId : string [0..1] Indicates the title for of the measure group's population identifier title : Identifier string [0..1] The type of the population. This element SHALL be populated with at least the codings in the code element of the corresponding population in the Measure group being reported code : CodeableConcept [0..1] « null (Strength=Extensible) MeasurePopulationType + » The type human readable description of this population (e.g. initial, numerator, denominator, etc.) (Strength=Extensible) criteria. This element SHOULD be populated based on the description element of the corresponding population in the Measure group being reported MeasurePopulationType description + : markdown [0..1] The number of members of the population count : integer [0..1] « This element has or is affected by some invariants C » The number of members of the population, specified as a quantity to support identifying units, as well as to support some composite measure calculation use cases where the resulting count of the population is a decimal value countQuantity : Quantity [0..1] « This element has or is affected by some invariants C » This element refers to a List of patient individual level MeasureReport resources, one for each patient subject in this population patients subjectResults : Reference [0..1] « List » A reference to an individual level MeasureReport resource for a member of the population subjectReport : Reference [0..*] « MeasureReport » Optional Group identifying the individuals that make up the population subjects : Reference [0..1] « Group » Stratifier The identifier stratifier from the Measure that corresponds to this stratifier in the MeasureReport resource. This element SHALL be populated based on the corresponding element in the Measure being reported linkId : string [0..1] Indicates the title for of the group's stratifier title : string [0..1] The meaning of this stratifier, as defined in the measure definition definition. This element SHALL be populated with at least the codings in the code element of the corresponding stratifier in the Measure group being reported identifier code : Identifier CodeableConcept [0..1] « null (Strength=Example) MeasureStratifierExample ?? » The human readable description of this stratifier criteria. This element SHOULD be populated with the description element of the corresponding stratifier in the Measure group being reported description : markdown [0..1] StratifierGroup The value for this stratum, expressed as a string. CodeableConcept. When defining stratifiers on complex values, the value must be rendered such that the value for each stratum within the stratifier is unique value value[x] : string DataType [1..1] [0..1] « CodeableConcept | boolean | Quantity | Range | Reference ; null (Strength=Example) MeasureReportStratifierValueE... ?? » « This element has or is affected by some invariants C » The measure score for this stratum, calculated as appropriate for the measure type and scoring method, and based on only the members of this stratum measureScore measureScore[x] : decimal DataType [0..1] « Quantity | dateTime | CodeableConcept | Period | Range | Duration | boolean | Ratio » StratifierGroupPopulation Component The identifier of stratifier component from the population being reported, as defined by Measure that corresponds to this stratifier component in the population MeasureReport resource. This element of SHALL be populated based on the measure corresponding element in the Measure being reported identifier linkId : Identifier string [0..1] The type code for the stratum component value. This element SHALL be populated with at least the codings in the code element of the population corresponding component of the stratifier being reported code : CodeableConcept [1..1] « null (Strength=Example) MeasureStratifierExample ?? » The human readable description of this stratifier criteria component. This element MAY be populated with the description of the corresponding component of the stratifier being reported description : markdown [0..1] The stratum component value value[x] : DataType [1..1] « CodeableConcept | boolean | Quantity | Range | Reference ; null (Strength=Example) MeasureReportStratifierValueE... ?? » StratifierGroupPopulation The population from the Measure that corresponds to this population in the MeasureReport resource. This element SHALL be populated with the linkId corresponding to the population being reported linkId : string [0..1] The type of the population. This element SHALL be populated with at least the codings in the code element of the corresponding population (e.g. initial, numerator, denominator, etc.) being reported code : CodeableConcept [0..1] « null (Strength=Extensible) MeasurePopulationType + » The number of members of the population in this stratum count : integer [0..1] « This element has or is affected by some invariants C » The number of members of the population in this stratum, specified as a quantity to support identifying units, as well as to support some composite measure calculation use cases where the resulting count of the population is a decimal value countQuantity : Quantity [0..1] « This element has or is affected by some invariants C » This element refers to a List of patient individual level MeasureReport resources, one for each patient subject in this population in this stratum patients subjectResults : Reference [0..1] « List » A reference to an individual level MeasureReport resource for a member of the population subjectReport : Reference [0..*] « MeasureReport » Optional Group identifying the individuals that make up the population subjects : Reference [0..1] « Group » The populations that make up the population group, one for each type of population appropriate for the measure measure. Each group in the MeasureReport SHALL have populations as defined in the corresponding group of the Measure being reported population [0..*] A stratifier component value component [0..*] The populations that make up the stratum, one for each type of population appropriate to the measure measure. For each stratifier, systems MAY provide population breakdowns in addition to the stratified scores population [0..*] This element contains the results for a single stratum within the stratifier. For example, when stratifying on administrative gender, there will be four strata, one for each possible gender value stratum [0..*] When a measure includes multiple stratifiers, there will be a stratifier group The stratification results for each stratifier this measure group, calculated as defined by the stratifier element of the measure being reported. Each group in the MeasureReport SHALL have stratifiers as defined in the corresponding group of the Measure being reported stratifier [0..*] The results of the calculation, one for each population group in the measure measure. A MeasureReport SHALL have a group element corresponding to each group element defined in the Measure being reported group [0..*]

XML Template 

<

<MeasureReport xmlns="http://hl7.org/fhir"> doco

 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <</identifier>
 <
 <
 <</measure>
 <</patient>
 <
 <</reportingOrganization>

 <identifier><!-- 0..* Identifier Additional identifier for the MeasureReport --></identifier>
 <category><!-- 0..1 CodeableConcept The category of measure report instance this is (example codes include deqm, ra, vbp) --></category>
 <messages><!-- 0..1 Reference(OperationOutcome) Evaluation messages --></messages>
 <status value="[code]"/><!-- 1..1 complete | pending | error -->
 <type value="[code]"/><!-- I 1..1 individual | subject-list | summary | data-exchange -->
 <dataUpdateType value="[code]"/><!-- 0..1 incremental | snapshot -->
 <measure><!-- 0..1 canonical(Measure) What measure was calculated --></measure>
 <subject><!-- 0..1 Reference(CareTeam|Device|Group|HealthcareService|Location|
   Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) What individual(s) the report is for --></subject>

 <date value="[dateTime]"/><!-- 0..1 When the measure report was generated -->
 <reporter><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole) Who is reporting the data --></reporter>
 <reportingVendor><!-- 0..1 Reference(Organization) What vendor prepared the data --></reportingVendor>
 <location><!-- 0..* Reference(Location) Where the reported data is from --></location>

 <period><!-- 1..1 Period What period the report covers --></period>
 <
  <</identifier>
  <
   <</identifier>
   <</code>
   <
   <</patients>

 <inputParameters><!-- 0..1 Reference(Parameters) What parameters were provided to the report --></inputParameters>
 <group>  <!-- I 0..* Measure results for each group -->
  <linkId value="[string]"/><!-- 0..1 Pointer to specific group from Measure -->
  <title value="[string]"/><!-- 0..1 Title of a group. Note- this value is copied from this element in Measure -->
  <calculatedDate value="[dateTime]"/><!-- 0..1 The date the Measure Report was calculated -->
  <code><!-- 0..1 CodeableConcept Meaning of the group --></code>
  <description value="[markdown]"/><!-- 0..1 Summary description -->
  <type><!-- 0..1 CodeableConcept process | outcome | structure | patient-reported-outcome icon --></type>
  <subject><!-- 0..1 Reference(CareTeam|Device|Group|HealthcareService|Location|
    Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) What individual(s) the report is for --></subject>

  <scoring><!-- 0..1 CodeableConcept What scoring method (e.g. proportion, ratio, continuous-variable) icon --></scoring>
  <improvementNotation><!-- 0..1 CodeableConcept increase | decrease icon --></improvementNotation>
  <improvementNotationGuidance value="[markdown]"/><!-- 0..1 Explanation of improvement notation -->
  <population>  <!-- 0..* The populations in the group -->
   <linkId value="[string]"/><!-- 0..1 Pointer to specific population from Measure -->
   <title value="[string]"/><!-- 0..1 Title of a group. Note- this value is copied from this element in Measure -->
   <code><!-- 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation icon --></code>
   <description value="[markdown]"/><!-- 0..1 The human readable description of this population criteria -->
   <count value="[integer]"/><!-- I 0..1 Size of the population -->
   <countQuantity><!-- I 0..1 Quantity Size of the population as a quantity --></countQuantity>
   <subjectResults><!-- 0..1 Reference(List) For subject-list reports, the subject results in this population --></subjectResults>
   <subjectReport><!-- 0..* Reference(MeasureReport) For subject-list reports, references to the individual reports for subjects in this population --></subjectReport>
   <subjects><!-- 0..1 Reference(Group) What individual(s) in the population --></subjects>

  </population>
  <
  <
   <</identifier>
   <
    <
    <
     <</identifier>
     <</code>
     <
     <</patients>

  <measureScore[x]><!-- 0..1 Quantity|dateTime|CodeableConcept|Period|Range|
    Duration|boolean|Ratio What score this group achieved --></measureScore[x]>

  <stratifier>  <!-- I 0..* Stratification results -->
   <linkId value="[string]"/><!-- 0..1 Pointer to specific stratifier from Measure -->
   <title value="[string]"/><!-- 0..1 Title of a group's stratifier. Note- this value is copied from this element in Measure -->
   <code><!-- 0..1 CodeableConcept What stratifier of the group --></code>
   <description value="[markdown]"/><!-- 0..1 The human readable description of this stratifier -->
   <stratum>  <!-- I 0..* Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components -->
    <value[x]><!-- I 0..1 CodeableConcept|boolean|Quantity|Range|Reference The stratum value, e.g. male --></value[x]>
    <component>  <!-- I 0..* Stratifier component values -->
     <linkId value="[string]"/><!-- 0..1 Pointer to specific stratifier component from Measure -->
     <code><!-- 1..1 CodeableConcept What stratifier component of the group --></code>
     <description value="[markdown]"/><!-- 0..1 The human readable description of this stratifier component -->
     <value[x]><!-- 1..1 CodeableConcept|boolean|Quantity|Range|Reference The stratum component value, e.g. male --></value[x]>
    </component>
    <population>  <!-- 0..* Population results in this stratum -->
     <linkId value="[string]"/><!-- 0..1 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 icon --></code>
     <count value="[integer]"/><!-- I 0..1 Size of the population -->
     <countQuantity><!-- I 0..1 Quantity Size of the population as a quantity --></countQuantity>
     <subjectResults><!-- 0..1 Reference(List) For subject-list reports, the subject results in this population --></subjectResults>
     <subjectReport><!-- 0..* Reference(MeasureReport) For subject-list reports, a subject result in this population --></subjectReport>
     <subjects><!-- 0..1 Reference(Group) What individual(s) in the population --></subjects>

    </population>
    <

    <measureScore[x]><!-- 0..1 Quantity|dateTime|CodeableConcept|Period|Range|
      Duration|boolean|Ratio What score this stratum achieved --></measureScore[x]>
   </stratum>
  </stratifier>
 </group>
 <</evaluatedResources>

 <supplementalData><!-- 0..* Reference(Any) Additional information collected for the report --></supplementalData>
 <evaluatedResource><!-- 0..* Reference(Any) What data was used to calculate the measure score --></evaluatedResource>

</MeasureReport>

JSON Template 

{doco
  "resourceType" : "",

  "resourceType" : "MeasureReport",

  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "
  "
  "
  "
  "
  "
    "
    "
      "
      "
      "
      "

  "identifier" : [{ Identifier }], // Additional identifier for the MeasureReport
  "category" : { CodeableConcept }, // The category of measure report instance this is (example codes include deqm, ra, vbp)
  "messages" : { Reference(OperationOutcome) }, // Evaluation messages
  "status" : "<code>", // R!  complete | pending | error
  "type" : "<code>", // I R!  individual | subject-list | summary | data-exchange
  "dataUpdateType" : "<code>", // incremental | snapshot
  "measure" : "<canonical(Measure)>", // What measure was calculated
  "subject" : { Reference(CareTeam|Device|Group|HealthcareService|Location|
   Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) }, // What individual(s) the report is for

  "date" : "<dateTime>", // When the measure report was generated
  "reporter" : { Reference(Organization|Practitioner|PractitionerRole) }, // Who is reporting the data
  "reportingVendor" : { Reference(Organization) }, // What vendor prepared the data
  "location" : [{ Reference(Location) }], // Where the reported data is from
  "period" : { Period }, // R!  What period the report covers
  "inputParameters" : { Reference(Parameters) }, // What parameters were provided to the report
  "group" : [{ // I Measure results for each group
    "linkId" : "<string>", // Pointer to specific group from Measure
    "title" : "<string>", // Title of a group. Note- this value is copied from this element in Measure
    "calculatedDate" : "<dateTime>", // The date the Measure Report was calculated
    "code" : { CodeableConcept }, // Meaning of the group
    "description" : "<markdown>", // Summary description
    "type" : { CodeableConcept }, // process | outcome | structure | patient-reported-outcome icon
    "subject" : { Reference(CareTeam|Device|Group|HealthcareService|Location|
    Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) }, // What individual(s) the report is for

    "scoring" : { CodeableConcept }, // What scoring method (e.g. proportion, ratio, continuous-variable) icon
    "improvementNotation" : { CodeableConcept }, // increase | decrease icon
    "improvementNotationGuidance" : "<markdown>", // Explanation of improvement notation
    "population" : [{ // The populations in the group
      "linkId" : "<string>", // Pointer to specific population from Measure
      "title" : "<string>", // Title of a group. Note- this value is copied from this element in Measure
      "code" : { CodeableConcept }, // initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation icon
      "description" : "<markdown>", // The human readable description of this population criteria
      "count" : <integer>, // I Size of the population
      "countQuantity" : { Quantity }, // I Size of the population as a quantity
      "subjectResults" : { Reference(List) }, // For subject-list reports, the subject results in this population
      "subjectReport" : [{ Reference(MeasureReport) }], // For subject-list reports, references to the individual reports for subjects in this population
      "subjects" : { Reference(Group) } // What individual(s) in the population

    }],
    "
    "
      "
      "
        "
        "
          "
          "
          "
          "

    // measureScore[x]: What score this group achieved. One of these 8:
    "measureScoreQuantity" : { Quantity },
    "measureScoreDateTime" : "<dateTime>",
    "measureScoreCodeableConcept" : { CodeableConcept },
    "measureScorePeriod" : { Period },
    "measureScoreRange" : { Range },
    "measureScoreDuration" : { Duration },
    "measureScoreBoolean" : <boolean>,
    "measureScoreRatio" : { Ratio },
    "stratifier" : [{ // I Stratification results
      "linkId" : "<string>", // Pointer to specific stratifier from Measure
      "title" : "<string>", // Title of a group's stratifier. Note- this value is copied from this element in Measure
      "code" : { CodeableConcept }, // What stratifier of the group
      "description" : "<markdown>", // The human readable description of this stratifier
      "stratum" : [{ // I Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components
        // value[x]: The stratum value, e.g. male. One of these 5:

        "valueCodeableConcept" : { CodeableConcept },
        "valueBoolean" : <boolean>,
        "valueQuantity" : { Quantity },
        "valueRange" : { Range },
        "valueReference" : { Reference },
        "component" : [{ // I Stratifier component values
          "linkId" : "<string>", // Pointer to specific stratifier component from Measure
          "code" : { CodeableConcept }, // R!  What stratifier component of the group
          "description" : "<markdown>", // The human readable description of this stratifier component
          // value[x]: The stratum component value, e.g. male. One of these 5:

          "valueCodeableConcept" : { CodeableConcept },
          "valueBoolean" : <boolean>,
          "valueQuantity" : { Quantity },
          "valueRange" : { Range },
          "valueReference" : { Reference }

        }],
        "

        "population" : [{ // Population results in this stratum
          "linkId" : "<string>", // Pointer to specific population from Measure
          "code" : { CodeableConcept }, // initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation icon
          "count" : <integer>, // I Size of the population
          "countQuantity" : { Quantity }, // I Size of the population as a quantity
          "subjectResults" : { Reference(List) }, // For subject-list reports, the subject results in this population
          "subjectReport" : [{ Reference(MeasureReport) }], // For subject-list reports, a subject result in this population
          "subjects" : { Reference(Group) } // What individual(s) in the population
        }],
        // measureScore[x]: What score this stratum achieved. One of these 8:

        "measureScoreQuantity" : { Quantity },
        "measureScoreDateTime" : "<dateTime>",
        "measureScoreCodeableConcept" : { CodeableConcept },
        "measureScorePeriod" : { Period },
        "measureScoreRange" : { Range },
        "measureScoreDuration" : { Duration },
        "measureScoreBoolean" : <boolean>,
        "measureScoreRatio" : { Ratio }

      }]
    }]
  }],
  "

  "supplementalData" : [{ Reference(Any) }], // Additional information collected for the report
  "evaluatedResource" : [{ Reference(Any) }] // What data was used to calculate the measure score

}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:;

[ a fhir:MeasureReport;

  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from 
  # from 
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
    fhir:
    fhir:
      fhir:
      fhir:
      fhir:
      fhir:
    ], ...;
    fhir:
    fhir:
      fhir:
      fhir:
        fhir:
        fhir:
          fhir:
          fhir:
          fhir:
          fhir:
        ], ...;
        fhir:
      ], ...;
    ], ...;
  ], ...;
  fhir:

  # from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language
  # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir:modifierExtension
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Additional identifier for the MeasureReport
  fhir:category [ CodeableConcept ] ; # 0..1 The category of measure report instance this is (example codes include deqm, ra, vbp)
  fhir:messages [ Reference(OperationOutcome) ] ; # 0..1 Evaluation messages
  fhir:status [ code ] ; # 1..1 complete | pending | error
  fhir:type [ code ] ; # 1..1 I individual | subject-list | summary | data-exchange
  fhir:dataUpdateType [ code ] ; # 0..1 incremental | snapshot
  fhir:measure [ canonical(Measure) ] ; # 0..1 What measure was calculated
  fhir:subject [ Reference(CareTeam|Device|Group|HealthcareService|Location|Organization|Patient|
  Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 What individual(s) the report is for

  fhir:date [ dateTime ] ; # 0..1 When the measure report was generated
  fhir:reporter [ Reference(Organization|Practitioner|PractitionerRole) ] ; # 0..1 Who is reporting the data
  fhir:reportingVendor [ Reference(Organization) ] ; # 0..1 What vendor prepared the data
  fhir:location  ( [ Reference(Location) ] ... ) ; # 0..* Where the reported data is from
  fhir:period [ Period ] ; # 1..1 What period the report covers
  fhir:inputParameters [ Reference(Parameters) ] ; # 0..1 What parameters were provided to the report
  fhir:group ( [ # 0..* I Measure results for each group
    fhir:linkId [ string ] ; # 0..1 Pointer to specific group from Measure
    fhir:title [ string ] ; # 0..1 Title of a group. Note- this value is copied from this element in Measure
    fhir:calculatedDate [ dateTime ] ; # 0..1 The date the Measure Report was calculated
    fhir:code [ CodeableConcept ] ; # 0..1 Meaning of the group
    fhir:description [ markdown ] ; # 0..1 Summary description
    fhir:type [ CodeableConcept ] ; # 0..1 process | outcome | structure | patient-reported-outcome
    fhir:subject [ Reference(CareTeam|Device|Group|HealthcareService|Location|Organization|Patient|
  Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 What individual(s) the report is for

    fhir:scoring [ CodeableConcept ] ; # 0..1 What scoring method (e.g. proportion, ratio, continuous-variable)
    fhir:improvementNotation [ CodeableConcept ] ; # 0..1 increase | decrease
    fhir:improvementNotationGuidance [ markdown ] ; # 0..1 Explanation of improvement notation
    fhir:population ( [ # 0..* The populations in the group
      fhir:linkId [ string ] ; # 0..1 Pointer to specific population from Measure
      fhir:title [ string ] ; # 0..1 Title of a group. Note- this value is copied from this element in Measure
      fhir:code [ CodeableConcept ] ; # 0..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
      fhir:description [ markdown ] ; # 0..1 The human readable description of this population criteria
      fhir:count [ integer ] ; # 0..1 I Size of the population
      fhir:countQuantity [ Quantity ] ; # 0..1 I Size of the population as a quantity
      fhir:subjectResults [ Reference(List) ] ; # 0..1 For subject-list reports, the subject results in this population
      fhir:subjectReport  ( [ Reference(MeasureReport) ] ... ) ; # 0..* For subject-list reports, references to the individual reports for subjects in this population
      fhir:subjects [ Reference(Group) ] ; # 0..1 What individual(s) in the population
    ] ... ) ;
    # measureScore[x] : 0..1 What score this group achieved. One of these 8
      fhir:measureScore [  a fhir:Quantity ; Quantity ]
      fhir:measureScore [  a fhir:DateTime ; dateTime ]
      fhir:measureScore [  a fhir:CodeableConcept ; CodeableConcept ]
      fhir:measureScore [  a fhir:Period ; Period ]
      fhir:measureScore [  a fhir:Range ; Range ]
      fhir:measureScore [  a fhir:Duration ; Duration ]
      fhir:measureScore [  a fhir:Boolean ; boolean ]
      fhir:measureScore [  a fhir:Ratio ; Ratio ]
    fhir:stratifier ( [ # 0..* I Stratification results
      fhir:linkId [ string ] ; # 0..1 Pointer to specific stratifier from Measure
      fhir:title [ string ] ; # 0..1 Title of a group's stratifier. Note- this value is copied from this element in Measure
      fhir:code [ CodeableConcept ] ; # 0..1 What stratifier of the group
      fhir:description [ markdown ] ; # 0..1 The human readable description of this stratifier
      fhir:stratum ( [ # 0..* I Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components
        # value[x] : 0..1 I The stratum value, e.g. male. One of these 5
          fhir:value [  a fhir:CodeableConcept ; CodeableConcept ]
          fhir:value [  a fhir:Boolean ; boolean ]
          fhir:value [  a fhir:Quantity ; Quantity ]
          fhir:value [  a fhir:Range ; Range ]
          fhir:value [  a fhir:Reference ; Reference ]
        fhir:component ( [ # 0..* I Stratifier component values
          fhir:linkId [ string ] ; # 0..1 Pointer to specific stratifier component from Measure
          fhir:code [ CodeableConcept ] ; # 1..1 What stratifier component of the group
          fhir:description [ markdown ] ; # 0..1 The human readable description of this stratifier component
          # value[x] : 1..1 The stratum component value, e.g. male. One of these 5
            fhir:value [  a fhir:CodeableConcept ; CodeableConcept ]
            fhir:value [  a fhir:Boolean ; boolean ]
            fhir:value [  a fhir:Quantity ; Quantity ]
            fhir:value [  a fhir:Range ; Range ]
            fhir:value [  a fhir:Reference ; Reference ]
        ] ... ) ;
        fhir:population ( [ # 0..* Population results in this stratum
          fhir:linkId [ string ] ; # 0..1 Pointer to specific population from Measure
          fhir:code [ CodeableConcept ] ; # 0..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
          fhir:count [ integer ] ; # 0..1 I Size of the population
          fhir:countQuantity [ Quantity ] ; # 0..1 I Size of the population as a quantity
          fhir:subjectResults [ Reference(List) ] ; # 0..1 For subject-list reports, the subject results in this population
          fhir:subjectReport  ( [ Reference(MeasureReport) ] ... ) ; # 0..* For subject-list reports, a subject result in this population
          fhir:subjects [ Reference(Group) ] ; # 0..1 What individual(s) in the population
        ] ... ) ;
        # measureScore[x] : 0..1 What score this stratum achieved. One of these 8
          fhir:measureScore [  a fhir:Quantity ; Quantity ]
          fhir:measureScore [  a fhir:DateTime ; dateTime ]
          fhir:measureScore [  a fhir:CodeableConcept ; CodeableConcept ]
          fhir:measureScore [  a fhir:Period ; Period ]
          fhir:measureScore [  a fhir:Range ; Range ]
          fhir:measureScore [  a fhir:Duration ; Duration ]
          fhir:measureScore [  a fhir:Boolean ; boolean ]
          fhir:measureScore [  a fhir:Ratio ; Ratio ]
      ] ... ) ;
    ] ... ) ;
  ] ... ) ;
  fhir:supplementalData  ( [ Reference(Any) ] ... ) ; # 0..* Additional information collected for the report
  fhir:evaluatedResource  ( [ Reference(Any) ] ... ) ; # 0..* What data was used to calculate the measure score

]

Changes since DSTU2 from both R4 and R4B

MeasureReport
MeasureReport.category
  • Added Element
MeasureReport.messages
  • Added Element
MeasureReport.type
  • Remove code data-collection
  • Add code data-exchange
MeasureReport.dataUpdateType
  • Added Element
MeasureReport.measure
  • Min Cardinality changed from 1 to 0
MeasureReport.subject
  • Type Reference: Added Target Types CareTeam, HealthcareService, Organization
MeasureReport.reporter
  • Type Reference: Removed Target Type Location
MeasureReport.reportingVendor
  • Added Element
MeasureReport.location
  • Added Element
MeasureReport.inputParameters
  • Added Element
MeasureReport.group.linkId
  • Added Element
MeasureReport.group.title
  • Added Element
MeasureReport.group.calculatedDate
  • Added Element
MeasureReport.group.description
  • Added Element
MeasureReport.group.type
  • Added Element
MeasureReport.group.subject
  • Added Element
MeasureReport.group.scoring
  • Added Element
MeasureReport.group.improvementNotation
  • Added Element
MeasureReport.group.improvementNotationGuidance
  • Added Element
MeasureReport.group.population.linkId
  • Added Element
MeasureReport.group.population.title
  • Added Element
MeasureReport.group.population.code
MeasureReport.group.population.description
  • Added Element
MeasureReport.group.population.countQuantity
  • Added Element
MeasureReport.group.population.subjectReport
  • Added Element
MeasureReport.group.population.subjects
  • Added Element
MeasureReport.group.measureScore[x]
  • Renamed from measureScore to measureScore[x]
  • Add Types dateTime, CodeableConcept, Period, Range, Duration, boolean, Ratio
MeasureReport.group.stratifier.linkId
  • Added Element
MeasureReport.group.stratifier.title
  • Added Element
MeasureReport.group.stratifier.code
  • Max Cardinality changed from * to 1
MeasureReport.group.stratifier.description
  • Added Element
MeasureReport.group.stratifier.stratum.value[x]
  • Renamed from value to value[x]
  • Add Types boolean, Quantity, Range, Reference
MeasureReport.group.stratifier.stratum.component.linkId
  • Added Element
MeasureReport.group.stratifier.stratum.component.description
  • Added Element
MeasureReport.group.stratifier.stratum.component.value[x]
  • Renamed from value to value[x]
  • Add Types boolean, Quantity, Range, Reference
MeasureReport.group.stratifier.stratum.population.linkId
  • Added Element
MeasureReport.group.stratifier.stratum.population.code
MeasureReport.group.stratifier.stratum.population.countQuantity
  • Added Element
MeasureReport.group.stratifier.stratum.population.subjectReport
  • Added Element
MeasureReport.group.stratifier.stratum.population.subjects
  • Added Element
MeasureReport.group.stratifier.stratum.measureScore[x]
  • Renamed from measureScore to measureScore[x]
  • Add Types dateTime, CodeableConcept, Period, Range, Duration, boolean, Ratio
MeasureReport.supplementalData
  • Added Element
MeasureReport.improvementNotation
  • Deleted

This resource did not exist in Release 2 See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .

 

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

14.6.3.1 14.16.4.1 Terminology Bindings

MeasureReport.type
Path Definition ValueSet Type Reference 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 report.

MeasureReport.type MeasureReportType Required

The type of the measure report.

MeasureReport.dataUpdateType MeasureReportStatus SubmitDataUpdateType Required

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

MeasureReport.group.code MeasureGroupExample Example

Example Measure Groups for the Measure Resource.

MeasureReport.group.type MeasureType icon Extensible

The type of the measure report (includes codes from 2.16.840.1.113883.1.11.20368).

MeasureReport.group.scoring MeasureScoring icon Required Extensible

The scoring type of the measure.

MeasureReport.group.improvementNotation MeasureReportType MeasureImprovementNotation icon 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 MeasureReport.group.stratifier.stratum.population.code MeasurePopulationType icon Extensible

The type of population.

MeasureReport.group.stratifier.code MeasureStratifierExample Example

Identifier subgroups in a population (e.g. initial, numerator, denominator, etc.) for measuring purposes.

MeasureReport.group.stratifier.stratum.value[x] MeasureReportStratifierValueExample Extensible 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 icon Extensible

The type of population.

14.16.4.2 Constraints

UniqueKey Level Location Description Expression
img  mrp-1 Rule (base) Measure Reports used for data collection SHALL NOT communicate group and score information (type != 'data-exchange') or group.exists().not()
img  mrp-2 Rule (base) Stratifiers SHALL be either a single criteria element or a set of criteria components group.stratifier.stratum.all(value.exists() xor component.exists())
img  mrp-3 Rule MeasureReport.group.population The count and countQuantity elements SHALL be mutually exclusive count.exists() xor countQuantity.exists()
img  mrp-4 Rule MeasureReport.group.stratifier.stratum.population The count and countQuantity elements for a statum population SHALL be mutually exclusive count.exists() xor countQuantity.exists()

14.6.4 14.16.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 may 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.6.5 14.16.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 22 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 58 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.patient MeasureReport.subject.where(resolve() is Patient)
( Patient ) 		60 Resources
period date The period of the measure report MeasureReport.period
reporter reference The reporter to return measure report results for MeasureReport.reporter
( Practitioner , 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 )