This page is part of the Da Vinci Data Exchange for Quality Measures (DEQM) FHIR IG (v2.1.0: STU 3) based on FHIR R4. The current version which supercedes this version is 3.1.0. For a full list of available versions, see the Directory of published versions
MeasureReport is used as an organizer for both data exchange for measure and for measure reporting. Three profiles on the MeasureReport resource are defined in this guide to delineate these different uses.
When a data producer needs to send data to a data consumer, they use the DEQM Data-Exchange MeasureReport Profile defined here. The type
element in this profile is set to “data-collection”. Along with the MeasureReport profile, the data producer sends the Organization, Patient and any relevant resources for the measure they have produced data on. When a data producer sends a MeasureReport and the associated data, they may not have all the data that is required to calculate the measure report. Additional data may need to be collected later or there may be additional data used in the measure that the aggregator owns such as a continuous coverage period requirement.
The official URL for this profile is:
http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/datax-measurereport-deqm
The following data-elements are mandatory (i.e data MUST be present).
Each MeasureReport must have:
Each MeasureReport should have (Must Support):
Additional Profile specific implementation guidance:
*For a detailed discussion of incremental and snapshot updates see these sections on Submit Data and Collect Data
The Producer may not have all the data that is required to calculate the measure report at that time it is transmitted. It that case the MeasureReport may not have any evaluatedResources (in other words, no measure data). The missing data may be transmitted in a subsequent update or the additional data used in the measure is owned by an aggregator (such as a continuous coverage period requirement).
The reporter
should be consistent with the X-Provenance header data if present.
A data producer
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from MeasureReport
Summary
Mandatory: 7 elements
Must-Support: 12 elements
Fixed Value: 1 element
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
This structure is derived from MeasureReport
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MeasureReport | 0..* | MeasureReport | Results of a measure evaluation | |
extension-submitDataUpdateType | S | 1..1 | code | Extension URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-submitDataUpdateType |
cqfm-softwaresystem | S | 0..* | Reference(CQFMDevice) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem |
status | S | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required) |
type | S | 1..1 | code | individual | subject-list | summary | data-collection Fixed Value: data-collection |
measure | S | 1..1 | canonical(Measure) | What measure was calculated |
subject | S | 1..1 | Reference(QICorePatient) | What individual(s) the report is for |
date | S | 1..1 | dateTime | When the report was generated |
reporter | S | 1..1 | Reference(DEQM Organization Profile) | The organization where the measure was completed |
period | SI | 1..1 | Period | What period the report covers deqm-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) |
start | S | 1..1 | dateTime | Starting time with inclusive boundary |
end | S | 1..1 | dateTime | End time with inclusive boundary, if not ongoing |
evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score |
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MeasureReport | I | 0..* | MeasureReport | Results of a measure evaluation |
id | Σ | 0..1 | string | Logical id of this artifact |
meta | ΣI | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!ΣI | 0..1 | uri | A set of rules under which this content was created |
language | I | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred) Max Binding: AllLanguages |
text | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
contained | 0..* | Resource | Contained, inline Resources | |
extension | I | 0..* | Extension | Extension Slice: Unordered, Open by value:url |
extension-submitDataUpdateType | SI | 1..1 | code | Optional Extensions Element URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-submitDataUpdateType |
cqfm-softwaresystem | SI | 0..* | Reference(CQFMDevice) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem |
modifierExtension | ?!I | 0..* | Extension | Extensions that cannot be ignored |
identifier | ΣI | 0..* | Identifier | Additional identifier for the MeasureReport |
status | ?!SΣI | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required) |
type | SΣI | 1..1 | code | individual | subject-list | summary | data-collection Binding: MeasureReportType (required) Fixed Value: data-collection |
measure | SΣI | 1..1 | canonical(Measure) | What measure was calculated |
subject | SΣI | 1..1 | Reference(QICorePatient) | What individual(s) the report is for |
date | SΣI | 1..1 | dateTime | When the report was generated |
reporter | SΣI | 1..1 | Reference(DEQM Organization Profile) | The organization where the measure was completed |
period | SΣI | 1..1 | Period | What period the report covers deqm-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url |
start | SΣI | 1..1 | dateTime | Starting time with inclusive boundary |
end | SΣI | 1..1 | dateTime | End time with inclusive boundary, if not ongoing |
improvementNotation | ?!ΣI | 0..1 | CodeableConcept | increase | decrease Binding: MeasureImprovementNotation (required) |
group | I | 0..* | BackboneElement | Measure results for each group |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | ΣI | 0..1 | CodeableConcept | Meaning of the group |
population | I | 0..* | BackboneElement | The populations in the group |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | ΣI | 0..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible) |
count | I | 0..1 | integer | Size of the population |
subjectResults | I | 0..1 | Reference(List) | For subject-list reports, the subject results in this population |
measureScore | ΣI | 0..1 | Quantity | What score this group achieved |
stratifier | I | 0..* | BackboneElement | Stratification results |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | I | 0..* | CodeableConcept | What stratifier of the group |
stratum | I | 0..* | BackboneElement | Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
value | I | 0..1 | CodeableConcept | The stratum value, e.g. male |
component | I | 0..* | BackboneElement | Stratifier component values |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | I | 1..1 | CodeableConcept | What stratifier component of the group |
value | I | 1..1 | CodeableConcept | The stratum component value, e.g. male |
population | I | 0..* | BackboneElement | Population results in this stratum |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | I | 0..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible) |
count | I | 0..1 | integer | Size of the population |
subjectResults | I | 0..1 | Reference(List) | For subject-list reports, the subject results in this population |
measureScore | I | 0..1 | Quantity | What score this stratum achieved |
evaluatedResource | SI | 0..* | Reference(Resource) | What data was used to calculate the measure score |
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MeasureReport | I | 0..* | MeasureReport | Results of a measure evaluation |
extension-submitDataUpdateType | I | 1..1 | code | Optional Extensions Element URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-submitDataUpdateType |
cqfm-softwaresystem | I | 0..* | Reference(CQFMDevice) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem |
status | ?!ΣI | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required) |
type | ΣI | 1..1 | code | individual | subject-list | summary | data-collection Binding: MeasureReportType (required) Fixed Value: data-collection |
measure | ΣI | 1..1 | canonical(Measure) | What measure was calculated |
subject | ΣI | 1..1 | Reference(QICorePatient) | What individual(s) the report is for |
date | ΣI | 1..1 | dateTime | When the report was generated |
reporter | ΣI | 1..1 | Reference(DEQM Organization Profile) | The organization where the measure was completed |
period | ΣI | 1..1 | Period | What period the report covers deqm-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) |
start | ΣI | 1..1 | dateTime | Starting time with inclusive boundary |
end | ΣI | 1..1 | dateTime | End time with inclusive boundary, if not ongoing |
evaluatedResource | I | 0..* | Reference(Resource) | What data was used to calculate the measure score |
Documentation for this format |
This structure is derived from MeasureReport
Summary
Mandatory: 7 elements
Must-Support: 12 elements
Fixed Value: 1 element
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Differential View
This structure is derived from MeasureReport
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MeasureReport | 0..* | MeasureReport | Results of a measure evaluation | |
extension-submitDataUpdateType | S | 1..1 | code | Extension URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-submitDataUpdateType |
cqfm-softwaresystem | S | 0..* | Reference(CQFMDevice) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem |
status | S | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required) |
type | S | 1..1 | code | individual | subject-list | summary | data-collection Fixed Value: data-collection |
measure | S | 1..1 | canonical(Measure) | What measure was calculated |
subject | S | 1..1 | Reference(QICorePatient) | What individual(s) the report is for |
date | S | 1..1 | dateTime | When the report was generated |
reporter | S | 1..1 | Reference(DEQM Organization Profile) | The organization where the measure was completed |
period | SI | 1..1 | Period | What period the report covers deqm-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) |
start | S | 1..1 | dateTime | Starting time with inclusive boundary |
end | S | 1..1 | dateTime | End time with inclusive boundary, if not ongoing |
evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score |
Documentation for this format |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MeasureReport | I | 0..* | MeasureReport | Results of a measure evaluation |
id | Σ | 0..1 | string | Logical id of this artifact |
meta | ΣI | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!ΣI | 0..1 | uri | A set of rules under which this content was created |
language | I | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred) Max Binding: AllLanguages |
text | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
contained | 0..* | Resource | Contained, inline Resources | |
extension | I | 0..* | Extension | Extension Slice: Unordered, Open by value:url |
extension-submitDataUpdateType | SI | 1..1 | code | Optional Extensions Element URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-submitDataUpdateType |
cqfm-softwaresystem | SI | 0..* | Reference(CQFMDevice) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem |
modifierExtension | ?!I | 0..* | Extension | Extensions that cannot be ignored |
identifier | ΣI | 0..* | Identifier | Additional identifier for the MeasureReport |
status | ?!SΣI | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required) |
type | SΣI | 1..1 | code | individual | subject-list | summary | data-collection Binding: MeasureReportType (required) Fixed Value: data-collection |
measure | SΣI | 1..1 | canonical(Measure) | What measure was calculated |
subject | SΣI | 1..1 | Reference(QICorePatient) | What individual(s) the report is for |
date | SΣI | 1..1 | dateTime | When the report was generated |
reporter | SΣI | 1..1 | Reference(DEQM Organization Profile) | The organization where the measure was completed |
period | SΣI | 1..1 | Period | What period the report covers deqm-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url |
start | SΣI | 1..1 | dateTime | Starting time with inclusive boundary |
end | SΣI | 1..1 | dateTime | End time with inclusive boundary, if not ongoing |
improvementNotation | ?!ΣI | 0..1 | CodeableConcept | increase | decrease Binding: MeasureImprovementNotation (required) |
group | I | 0..* | BackboneElement | Measure results for each group |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | ΣI | 0..1 | CodeableConcept | Meaning of the group |
population | I | 0..* | BackboneElement | The populations in the group |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | ΣI | 0..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible) |
count | I | 0..1 | integer | Size of the population |
subjectResults | I | 0..1 | Reference(List) | For subject-list reports, the subject results in this population |
measureScore | ΣI | 0..1 | Quantity | What score this group achieved |
stratifier | I | 0..* | BackboneElement | Stratification results |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | I | 0..* | CodeableConcept | What stratifier of the group |
stratum | I | 0..* | BackboneElement | Stratum results, one for each unique value, or set of values, in the stratifier, or stratifier components |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
value | I | 0..1 | CodeableConcept | The stratum value, e.g. male |
component | I | 0..* | BackboneElement | Stratifier component values |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | I | 1..1 | CodeableConcept | What stratifier component of the group |
value | I | 1..1 | CodeableConcept | The stratum component value, e.g. male |
population | I | 0..* | BackboneElement | Population results in this stratum |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | I | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!ΣI | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | I | 0..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible) |
count | I | 0..1 | integer | Size of the population |
subjectResults | I | 0..1 | Reference(List) | For subject-list reports, the subject results in this population |
measureScore | I | 0..1 | Quantity | What score this stratum achieved |
evaluatedResource | SI | 0..* | Reference(Resource) | What data was used to calculate the measure score |
Documentation for this format |
Other representations of profile: Schematron
Path | Conformance | ValueSet / Code |
MeasureReport.language | preferred | CommonLanguages Max Binding: AllLanguages |
MeasureReport.status | required | MeasureReportStatus |
MeasureReport.type | required | Fixed Value: data-collection |
MeasureReport.improvementNotation | required | MeasureImprovementNotation |
MeasureReport.group.population.code | extensible | MeasurePopulationType |
MeasureReport.group.stratifier.stratum.population.code | extensible | MeasurePopulationType |
Id | Path | Details | Requirements |
deqm-1 | MeasureReport.period | Date precision SHALL be at least to day ( YYYY-MM-DD ) : start.matches('^([0-9]{4})(-)(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9]).*') and end.matches('^([0-9]{4})(-)(1[0-2]|0[1-9])-(3[01]|0[1-9]|[12][0-9]).*') |