FHIR Release 3 (STU)

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 of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

14.6 Resource MeasureReport - Content

Clinical Quality Information Work GroupMaturity Level: 2 Trial UseCompartments: Patient

The MeasureReport resource contains the results of evaluating a measure.

This resource is an event resource from a FHIR workflow perspective - see Workflow, specifically Event.

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

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

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

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

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

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. MeasureReport DomainResourceResults of a measure evaluation
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..1IdentifierAdditional identifier for the Report
... status ?!Σ1..1codecomplete | pending | error
MeasureReportStatus (Required)
... type Σ1..1codeindividual | patient-list | summary
MeasureReportType (Required)
... measure Σ1..1Reference(Measure)What measure was evaluated
... patient Σ0..1Reference(Patient)What patient the report is for
... date Σ0..1dateTimeWhen the report was generated
... reportingOrganization Σ0..1Reference(Organization)Who is reporting the data
... period Σ1..1PeriodWhat period the report covers
... group 0..*BackboneElementMeasure results for each group
.... identifier 1..1IdentifierWhat group of the measure
.... population 0..*BackboneElementThe populations in the group
..... identifier Σ0..1IdentifierPopulation identifier as defined in the measure
..... code Σ0..1CodeableConceptinitial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
MeasurePopulationType (Extensible)
..... count 0..1integerSize of the population
..... patients 0..1Reference(List)For patient-list reports, the patients in this population
.... measureScore Σ0..1decimalWhat score this group achieved
.... stratifier 0..*BackboneElementStratification results
..... identifier 0..1IdentifierWhat stratifier of the group
..... stratum 0..*BackboneElementStratum results, one for each unique value in the stratifier
...... value 1..1stringThe stratum value, e.g. male
...... population 0..*BackboneElementPopulation results in this stratum
....... identifier Σ0..1IdentifierPopulation identifier as defined in the measure
....... code Σ0..1CodeableConceptinitial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
MeasurePopulationType (Extensible)
....... count 0..1integerSize of the population
....... patients 0..1Reference(List)For patient-list reports, the patients in this population
...... measureScore Σ0..1decimalWhat score this stratum achieved
... evaluatedResources 0..1Reference(Bundle)What data was evaluated to produce the measure score

doco Documentation for this format

UML Diagram (Legend)

MeasureReport (DomainResource)A formal identifier that is used to identify this report when it is represented in other formats, or referenced in a specification, model, design or an instanceidentifier : Identifier [0..1]The report status. No data will be available until the report status is complete (this element modifies the meaning of other elements)status : code [1..1] The status of the measure report (Strength=Required)MeasureReportStatus! The type of measure report. This may be an individual report, which provides a single patient's score for the measure; a patient listing, which returns the list of patients that meet the various criteria in the measure; or a summary report, which returns a population count for each of the criteria in the measuretype : code [1..1] The type of the measure report (Strength=Required)MeasureReportType! A reference to the Measure that was evaluated to produce this reportmeasure : Reference [1..1] Measure Optional Patient if the report was requested for a single patientpatient : Reference [0..1] Patient The date this measure report was generateddate : dateTime [0..1]Reporting OrganizationreportingOrganization : Reference [0..1] Organization The reporting period for which the report was calculatedperiod : Period [1..1]A reference to a Bundle containing the Resources that were used in the evaluation of this reportevaluatedResources : Reference [0..1] Bundle GroupThe identifier of the population group as defined in the measure definitionidentifier : Identifier [1..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 groupmeasureScore : decimal [0..1]PopulationThe identifier of the population being reported, as defined by the population element of the measureidentifier : Identifier [0..1]The type of the populationcode : CodeableConcept [0..1] The type of population (e.g. initial, numerator, denominator, etc.) (Strength=Extensible)MeasurePopulationType+ The number of members of the populationcount : integer [0..1]This element refers to a List of patient level MeasureReport resources, one for each patient in this populationpatients : Reference [0..1] List StratifierThe identifier of this stratifier, as defined in the measure definitionidentifier : Identifier [0..1]StratifierGroupThe value for this stratum, expressed as a string. When defining stratifiers on complex values, the value must be rendered such that the value for each stratum within the stratifier is uniquevalue : string [1..1]The measure score for this stratum, calculated as appropriate for the measure type and scoring method, and based on only the members of this stratummeasureScore : decimal [0..1]StratifierGroupPopulationThe identifier of the population being reported, as defined by the population element of the measureidentifier : Identifier [0..1]The type of the populationcode : CodeableConcept [0..1] The type of population (e.g. initial, numerator, denominator, etc.) (Strength=Extensible)MeasurePopulationType+ The number of members of the population in this stratumcount : integer [0..1]This element refers to a List of patient level MeasureReport resources, one for each patient in this population in this stratumpatients : Reference [0..1] List The populations that make up the population group, one for each type of population appropriate for the measurepopulation[0..*]The populations that make up the stratum, one for each type of population appropriate to the measurepopulation[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 valuestratum[0..*]When a measure includes multiple stratifiers, there will be a stratifier group for each stratifier defined by the measurestratifier[0..*]The results of the calculation, one for each population group in the measuregroup[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><!-- 0..1 Identifier Additional identifier for the Report --></identifier>
 <status value="[code]"/><!-- 1..1 complete | pending | error -->
 <type value="[code]"/><!-- 1..1 individual | patient-list | summary -->
 <measure><!-- 1..1 Reference(Measure) What measure was evaluated --></measure>
 <patient><!-- 0..1 Reference(Patient) What patient the report is for --></patient>
 <date value="[dateTime]"/><!-- 0..1 When the report was generated -->
 <reportingOrganization><!-- 0..1 Reference(Organization) Who is reporting the data --></reportingOrganization>
 <period><!-- 1..1 Period What period the report covers --></period>
 <group>  <!-- 0..* Measure results for each group -->
  <identifier><!-- 1..1 Identifier What group of the measure --></identifier>
  <population>  <!-- 0..* The populations in the group -->
   <identifier><!-- 0..1 Identifier Population identifier as defined in the measure --></identifier>
   <code><!-- 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score --></code>
   <count value="[integer]"/><!-- 0..1 Size of the population -->
   <patients><!-- 0..1 Reference(List) For patient-list reports, the patients in this population --></patients>
  </population>
  <measureScore value="[decimal]"/><!-- 0..1 What score this group achieved -->
  <stratifier>  <!-- 0..* Stratification results -->
   <identifier><!-- 0..1 Identifier What stratifier of the group --></identifier>
   <stratum>  <!-- 0..* Stratum results, one for each unique value in the stratifier -->
    <value value="[string]"/><!-- 1..1 The stratum value, e.g. male -->
    <population>  <!-- 0..* Population results in this stratum -->
     <identifier><!-- 0..1 Identifier Population identifier as defined in the measure --></identifier>
     <code><!-- 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score --></code>
     <count value="[integer]"/><!-- 0..1 Size of the population -->
     <patients><!-- 0..1 Reference(List) For patient-list reports, the patients in this population --></patients>
    </population>
    <measureScore value="[decimal]"/><!-- 0..1 What score this stratum achieved -->
   </stratum>
  </stratifier>
 </group>
 <evaluatedResources><!-- 0..1 Reference(Bundle) What data was evaluated to produce the measure score --></evaluatedResources>
</MeasureReport>

JSON Template

{doco
  "resourceType" : "MeasureReport",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : { Identifier }, // Additional identifier for the Report
  "status" : "<code>", // R!  complete | pending | error
  "type" : "<code>", // R!  individual | patient-list | summary
  "measure" : { Reference(Measure) }, // R!  What measure was evaluated
  "patient" : { Reference(Patient) }, // What patient the report is for
  "date" : "<dateTime>", // When the report was generated
  "reportingOrganization" : { Reference(Organization) }, // Who is reporting the data
  "period" : { Period }, // R!  What period the report covers
  "group" : [{ // Measure results for each group
    "identifier" : { Identifier }, // R!  What group of the measure
    "population" : [{ // The populations in the group
      "identifier" : { Identifier }, // Population identifier as defined in the measure
      "code" : { CodeableConcept }, // initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
      "count" : <integer>, // Size of the population
      "patients" : { Reference(List) } // For patient-list reports, the patients in this population
    }],
    "measureScore" : <decimal>, // What score this group achieved
    "stratifier" : [{ // Stratification results
      "identifier" : { Identifier }, // What stratifier of the group
      "stratum" : [{ // Stratum results, one for each unique value in the stratifier
        "value" : "<string>", // R!  The stratum value, e.g. male
        "population" : [{ // Population results in this stratum
          "identifier" : { Identifier }, // Population identifier as defined in the measure
          "code" : { CodeableConcept }, // initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
          "count" : <integer>, // Size of the population
          "patients" : { Reference(List) } // For patient-list reports, the patients in this population
        }],
        "measureScore" : <decimal> // What score this stratum achieved
      }]
    }]
  }],
  "evaluatedResources" : { Reference(Bundle) } // What data was evaluated to produce the measure score
}

Turtle Template

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


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

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:MeasureReport.identifier [ Identifier ]; # 0..1 Additional identifier for the Report
  fhir:MeasureReport.status [ code ]; # 1..1 complete | pending | error
  fhir:MeasureReport.type [ code ]; # 1..1 individual | patient-list | summary
  fhir:MeasureReport.measure [ Reference(Measure) ]; # 1..1 What measure was evaluated
  fhir:MeasureReport.patient [ Reference(Patient) ]; # 0..1 What patient the report is for
  fhir:MeasureReport.date [ dateTime ]; # 0..1 When the report was generated
  fhir:MeasureReport.reportingOrganization [ Reference(Organization) ]; # 0..1 Who is reporting the data
  fhir:MeasureReport.period [ Period ]; # 1..1 What period the report covers
  fhir:MeasureReport.group [ # 0..* Measure results for each group
    fhir:MeasureReport.group.identifier [ Identifier ]; # 1..1 What group of the measure
    fhir:MeasureReport.group.population [ # 0..* The populations in the group
      fhir:MeasureReport.group.population.identifier [ Identifier ]; # 0..1 Population identifier as defined in the measure
      fhir:MeasureReport.group.population.code [ CodeableConcept ]; # 0..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
      fhir:MeasureReport.group.population.count [ integer ]; # 0..1 Size of the population
      fhir:MeasureReport.group.population.patients [ Reference(List) ]; # 0..1 For patient-list reports, the patients in this population
    ], ...;
    fhir:MeasureReport.group.measureScore [ decimal ]; # 0..1 What score this group achieved
    fhir:MeasureReport.group.stratifier [ # 0..* Stratification results
      fhir:MeasureReport.group.stratifier.identifier [ Identifier ]; # 0..1 What stratifier of the group
      fhir:MeasureReport.group.stratifier.stratum [ # 0..* Stratum results, one for each unique value in the stratifier
        fhir:MeasureReport.group.stratifier.stratum.value [ string ]; # 1..1 The stratum value, e.g. male
        fhir:MeasureReport.group.stratifier.stratum.population [ # 0..* Population results in this stratum
          fhir:MeasureReport.group.stratifier.stratum.population.identifier [ Identifier ]; # 0..1 Population identifier as defined in the measure
          fhir:MeasureReport.group.stratifier.stratum.population.code [ CodeableConcept ]; # 0..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
          fhir:MeasureReport.group.stratifier.stratum.population.count [ integer ]; # 0..1 Size of the population
          fhir:MeasureReport.group.stratifier.stratum.population.patients [ Reference(List) ]; # 0..1 For patient-list reports, the patients in this population
        ], ...;
        fhir:MeasureReport.group.stratifier.stratum.measureScore [ decimal ]; # 0..1 What score this stratum achieved
      ], ...;
    ], ...;
  ], ...;
  fhir:MeasureReport.evaluatedResources [ Reference(Bundle) ]; # 0..1 What data was evaluated to produce the measure score
]

Changes since DSTU2

This resource did not exist in Release 2

This analysis is available as XML or JSON.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. MeasureReport DomainResourceResults of a measure evaluation
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ0..1IdentifierAdditional identifier for the Report
... status ?!Σ1..1codecomplete | pending | error
MeasureReportStatus (Required)
... type Σ1..1codeindividual | patient-list | summary
MeasureReportType (Required)
... measure Σ1..1Reference(Measure)What measure was evaluated
... patient Σ0..1Reference(Patient)What patient the report is for
... date Σ0..1dateTimeWhen the report was generated
... reportingOrganization Σ0..1Reference(Organization)Who is reporting the data
... period Σ1..1PeriodWhat period the report covers
... group 0..*BackboneElementMeasure results for each group
.... identifier 1..1IdentifierWhat group of the measure
.... population 0..*BackboneElementThe populations in the group
..... identifier Σ0..1IdentifierPopulation identifier as defined in the measure
..... code Σ0..1CodeableConceptinitial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
MeasurePopulationType (Extensible)
..... count 0..1integerSize of the population
..... patients 0..1Reference(List)For patient-list reports, the patients in this population
.... measureScore Σ0..1decimalWhat score this group achieved
.... stratifier 0..*BackboneElementStratification results
..... identifier 0..1IdentifierWhat stratifier of the group
..... stratum 0..*BackboneElementStratum results, one for each unique value in the stratifier
...... value 1..1stringThe stratum value, e.g. male
...... population 0..*BackboneElementPopulation results in this stratum
....... identifier Σ0..1IdentifierPopulation identifier as defined in the measure
....... code Σ0..1CodeableConceptinitial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
MeasurePopulationType (Extensible)
....... count 0..1integerSize of the population
....... patients 0..1Reference(List)For patient-list reports, the patients in this population
...... measureScore Σ0..1decimalWhat score this stratum achieved
... evaluatedResources 0..1Reference(Bundle)What data was evaluated to produce the measure score

doco Documentation for this format

UML Diagram (Legend)

MeasureReport (DomainResource)A formal identifier that is used to identify this report when it is represented in other formats, or referenced in a specification, model, design or an instanceidentifier : Identifier [0..1]The report status. No data will be available until the report status is complete (this element modifies the meaning of other elements)status : code [1..1] The status of the measure report (Strength=Required)MeasureReportStatus! The type of measure report. This may be an individual report, which provides a single patient's score for the measure; a patient listing, which returns the list of patients that meet the various criteria in the measure; or a summary report, which returns a population count for each of the criteria in the measuretype : code [1..1] The type of the measure report (Strength=Required)MeasureReportType! A reference to the Measure that was evaluated to produce this reportmeasure : Reference [1..1] Measure Optional Patient if the report was requested for a single patientpatient : Reference [0..1] Patient The date this measure report was generateddate : dateTime [0..1]Reporting OrganizationreportingOrganization : Reference [0..1] Organization The reporting period for which the report was calculatedperiod : Period [1..1]A reference to a Bundle containing the Resources that were used in the evaluation of this reportevaluatedResources : Reference [0..1] Bundle GroupThe identifier of the population group as defined in the measure definitionidentifier : Identifier [1..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 groupmeasureScore : decimal [0..1]PopulationThe identifier of the population being reported, as defined by the population element of the measureidentifier : Identifier [0..1]The type of the populationcode : CodeableConcept [0..1] The type of population (e.g. initial, numerator, denominator, etc.) (Strength=Extensible)MeasurePopulationType+ The number of members of the populationcount : integer [0..1]This element refers to a List of patient level MeasureReport resources, one for each patient in this populationpatients : Reference [0..1] List StratifierThe identifier of this stratifier, as defined in the measure definitionidentifier : Identifier [0..1]StratifierGroupThe value for this stratum, expressed as a string. When defining stratifiers on complex values, the value must be rendered such that the value for each stratum within the stratifier is uniquevalue : string [1..1]The measure score for this stratum, calculated as appropriate for the measure type and scoring method, and based on only the members of this stratummeasureScore : decimal [0..1]StratifierGroupPopulationThe identifier of the population being reported, as defined by the population element of the measureidentifier : Identifier [0..1]The type of the populationcode : CodeableConcept [0..1] The type of population (e.g. initial, numerator, denominator, etc.) (Strength=Extensible)MeasurePopulationType+ The number of members of the population in this stratumcount : integer [0..1]This element refers to a List of patient level MeasureReport resources, one for each patient in this population in this stratumpatients : Reference [0..1] List The populations that make up the population group, one for each type of population appropriate for the measurepopulation[0..*]The populations that make up the stratum, one for each type of population appropriate to the measurepopulation[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 valuestratum[0..*]When a measure includes multiple stratifiers, there will be a stratifier group for each stratifier defined by the measurestratifier[0..*]The results of the calculation, one for each population group in the measuregroup[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><!-- 0..1 Identifier Additional identifier for the Report --></identifier>
 <status value="[code]"/><!-- 1..1 complete | pending | error -->
 <type value="[code]"/><!-- 1..1 individual | patient-list | summary -->
 <measure><!-- 1..1 Reference(Measure) What measure was evaluated --></measure>
 <patient><!-- 0..1 Reference(Patient) What patient the report is for --></patient>
 <date value="[dateTime]"/><!-- 0..1 When the report was generated -->
 <reportingOrganization><!-- 0..1 Reference(Organization) Who is reporting the data --></reportingOrganization>
 <period><!-- 1..1 Period What period the report covers --></period>
 <group>  <!-- 0..* Measure results for each group -->
  <identifier><!-- 1..1 Identifier What group of the measure --></identifier>
  <population>  <!-- 0..* The populations in the group -->
   <identifier><!-- 0..1 Identifier Population identifier as defined in the measure --></identifier>
   <code><!-- 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score --></code>
   <count value="[integer]"/><!-- 0..1 Size of the population -->
   <patients><!-- 0..1 Reference(List) For patient-list reports, the patients in this population --></patients>
  </population>
  <measureScore value="[decimal]"/><!-- 0..1 What score this group achieved -->
  <stratifier>  <!-- 0..* Stratification results -->
   <identifier><!-- 0..1 Identifier What stratifier of the group --></identifier>
   <stratum>  <!-- 0..* Stratum results, one for each unique value in the stratifier -->
    <value value="[string]"/><!-- 1..1 The stratum value, e.g. male -->
    <population>  <!-- 0..* Population results in this stratum -->
     <identifier><!-- 0..1 Identifier Population identifier as defined in the measure --></identifier>
     <code><!-- 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score --></code>
     <count value="[integer]"/><!-- 0..1 Size of the population -->
     <patients><!-- 0..1 Reference(List) For patient-list reports, the patients in this population --></patients>
    </population>
    <measureScore value="[decimal]"/><!-- 0..1 What score this stratum achieved -->
   </stratum>
  </stratifier>
 </group>
 <evaluatedResources><!-- 0..1 Reference(Bundle) What data was evaluated to produce the measure score --></evaluatedResources>
</MeasureReport>

JSON Template

{doco
  "resourceType" : "MeasureReport",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : { Identifier }, // Additional identifier for the Report
  "status" : "<code>", // R!  complete | pending | error
  "type" : "<code>", // R!  individual | patient-list | summary
  "measure" : { Reference(Measure) }, // R!  What measure was evaluated
  "patient" : { Reference(Patient) }, // What patient the report is for
  "date" : "<dateTime>", // When the report was generated
  "reportingOrganization" : { Reference(Organization) }, // Who is reporting the data
  "period" : { Period }, // R!  What period the report covers
  "group" : [{ // Measure results for each group
    "identifier" : { Identifier }, // R!  What group of the measure
    "population" : [{ // The populations in the group
      "identifier" : { Identifier }, // Population identifier as defined in the measure
      "code" : { CodeableConcept }, // initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
      "count" : <integer>, // Size of the population
      "patients" : { Reference(List) } // For patient-list reports, the patients in this population
    }],
    "measureScore" : <decimal>, // What score this group achieved
    "stratifier" : [{ // Stratification results
      "identifier" : { Identifier }, // What stratifier of the group
      "stratum" : [{ // Stratum results, one for each unique value in the stratifier
        "value" : "<string>", // R!  The stratum value, e.g. male
        "population" : [{ // Population results in this stratum
          "identifier" : { Identifier }, // Population identifier as defined in the measure
          "code" : { CodeableConcept }, // initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
          "count" : <integer>, // Size of the population
          "patients" : { Reference(List) } // For patient-list reports, the patients in this population
        }],
        "measureScore" : <decimal> // What score this stratum achieved
      }]
    }]
  }],
  "evaluatedResources" : { Reference(Bundle) } // What data was evaluated to produce the measure score
}

Turtle Template

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


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

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:MeasureReport.identifier [ Identifier ]; # 0..1 Additional identifier for the Report
  fhir:MeasureReport.status [ code ]; # 1..1 complete | pending | error
  fhir:MeasureReport.type [ code ]; # 1..1 individual | patient-list | summary
  fhir:MeasureReport.measure [ Reference(Measure) ]; # 1..1 What measure was evaluated
  fhir:MeasureReport.patient [ Reference(Patient) ]; # 0..1 What patient the report is for
  fhir:MeasureReport.date [ dateTime ]; # 0..1 When the report was generated
  fhir:MeasureReport.reportingOrganization [ Reference(Organization) ]; # 0..1 Who is reporting the data
  fhir:MeasureReport.period [ Period ]; # 1..1 What period the report covers
  fhir:MeasureReport.group [ # 0..* Measure results for each group
    fhir:MeasureReport.group.identifier [ Identifier ]; # 1..1 What group of the measure
    fhir:MeasureReport.group.population [ # 0..* The populations in the group
      fhir:MeasureReport.group.population.identifier [ Identifier ]; # 0..1 Population identifier as defined in the measure
      fhir:MeasureReport.group.population.code [ CodeableConcept ]; # 0..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
      fhir:MeasureReport.group.population.count [ integer ]; # 0..1 Size of the population
      fhir:MeasureReport.group.population.patients [ Reference(List) ]; # 0..1 For patient-list reports, the patients in this population
    ], ...;
    fhir:MeasureReport.group.measureScore [ decimal ]; # 0..1 What score this group achieved
    fhir:MeasureReport.group.stratifier [ # 0..* Stratification results
      fhir:MeasureReport.group.stratifier.identifier [ Identifier ]; # 0..1 What stratifier of the group
      fhir:MeasureReport.group.stratifier.stratum [ # 0..* Stratum results, one for each unique value in the stratifier
        fhir:MeasureReport.group.stratifier.stratum.value [ string ]; # 1..1 The stratum value, e.g. male
        fhir:MeasureReport.group.stratifier.stratum.population [ # 0..* Population results in this stratum
          fhir:MeasureReport.group.stratifier.stratum.population.identifier [ Identifier ]; # 0..1 Population identifier as defined in the measure
          fhir:MeasureReport.group.stratifier.stratum.population.code [ CodeableConcept ]; # 0..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-score
          fhir:MeasureReport.group.stratifier.stratum.population.count [ integer ]; # 0..1 Size of the population
          fhir:MeasureReport.group.stratifier.stratum.population.patients [ Reference(List) ]; # 0..1 For patient-list reports, the patients in this population
        ], ...;
        fhir:MeasureReport.group.stratifier.stratum.measureScore [ decimal ]; # 0..1 What score this stratum achieved
      ], ...;
    ], ...;
  ], ...;
  fhir:MeasureReport.evaluatedResources [ Reference(Bundle) ]; # 0..1 What data was evaluated to produce the measure score
]

Changes since DSTU2

This resource did not exist in Release 2

This analysis is available as XML or JSON.

 

Alternate definitions: Master Definition (XML, JSON), XML Schema/Schematron (for ) + JSON Schema, ShEx (for Turtle)

PathDefinitionTypeReference
MeasureReport.status The status of the measure reportRequiredMeasureReportStatus
MeasureReport.type The type of the measure reportRequiredMeasureReportType
MeasureReport.group.population.code
MeasureReport.group.stratifier.stratum.population.code
The type of population (e.g. initial, numerator, denominator, etc.)ExtensibleMeasurePopulationType

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

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionExpressionIn Common
identifiertokenExternal identifier of the measure report to be returnedMeasureReport.identifier
patientreferenceThe identity of a patient to search for individual measure report results forMeasureReport.patient
(Patient)
statustokenThe status of the measure reportMeasureReport.status