This page is part of the Da Vinci Data Exchange for Quality Measures (DEQM) FHIR IG (v4.0.0: STU4 (v4.0.0)) based on FHIR R4. This is the current published version. For a full list of available versions, see the Directory of published versions
Official URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/datax-measurereport-deqm | Version: 4.0.0 | |||
Active as of 2018-06-19 | Computable Name: DEQMDataExchangeMeasureReportProfile |
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 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
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from MeasureReport
Path | Conformance | ValueSet |
MeasureReport.status | required | MeasureReportStatus |
Id | Grade | Path(s) | Details | Requirements |
deqm-1 | error | MeasureReport.period | Date precision SHALL be at least to day ( YYYY-MM-DD ) : start.toString().length()>9 and end.toString().length()>9 |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MeasureReport | C | 0..* | MeasureReport | Results of a measure evaluation |
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
Slices for extension | 1..* | Extension | Extension Slice: Unordered, Open by value:url | |
updatetype | S | 1..1 | code | Optional Extensions Element URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-submitDataUpdateType Binding: DEQM Update Type Value Set (required) |
software | S | 0..* | Reference(CQFM Device) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem |
vendor | S | 0..1 | Reference(QICore Organization) | Vendor information URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingVendor |
location | 0..* | Reference(QICore Location) | Location(s) from which reported data was gathered URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-dataLocation | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
status | ?!SΣ | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required) |
type | SΣC | 1..1 | code | individual | subject-list | summary | data-collection Binding: MeasureReportType (required): The type of the measure report. Fixed Value: data-collection |
measure | SΣ | 1..1 | canonical(Measure) | What measure was calculated |
subject | SΣ | 1..1 | Reference(QICore Patient) | What individual(s) the report is for |
date | SΣ | 1..1 | dateTime | When the report was generated |
reporter | SΣ | 1..1 | Reference(QICore Organization) | The organization where the measure was completed |
group | S | 0..1 | Reference(Group) | Group of practitioners responsible for a report URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reporterGroup |
period | SΣC | 1..1 | Period | What period the report covers deqm-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) |
start | SΣC | 1..1 | dateTime | Starting time with inclusive boundary |
end | SΣC | 1..1 | dateTime | End time with inclusive boundary, if not ongoing |
improvementNotation | ?!Σ | 0..1 | CodeableConcept | increase | decrease Binding: MeasureImprovementNotation (required): Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue. |
evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score |
Documentation for this format |
Path | Conformance | ValueSet / Code |
MeasureReport.status | required | MeasureReportStatus |
MeasureReport.type | required | Fixed Value: data-collection |
MeasureReport.improvementNotation | required | MeasureImprovementNotation |
Id | Grade | Path(s) | Details | Requirements |
deqm-1 | error | MeasureReport.period | Date precision SHALL be at least to day ( YYYY-MM-DD ) : start.toString().length()>9 and end.toString().length()>9 |
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MeasureReport | C | 0..* | MeasureReport | Results of a measure evaluation | ||||
id | Σ | 0..1 | id | Logical id of this artifact | ||||
meta | Σ | 0..1 | Meta | Metadata about the resource | ||||
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | Contained, inline Resources | |||||
Slices for extension | 1..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
updatetype | S | 1..1 | code | Optional Extensions Element URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-submitDataUpdateType Binding: DEQM Update Type Value Set (required) | ||||
software | S | 0..* | Reference(CQFM Device) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem | ||||
vendor | S | 0..1 | Reference(QICore Organization) | Vendor information URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingVendor | ||||
location | 0..* | Reference(QICore Location) | Location(s) from which reported data was gathered URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-dataLocation | |||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
identifier | Σ | 0..* | Identifier | Additional identifier for the MeasureReport | ||||
status | ?!SΣ | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required) | ||||
type | SΣC | 1..1 | code | individual | subject-list | summary | data-collection Binding: MeasureReportType (required): The type of the measure report. Fixed Value: data-collection | ||||
measure | SΣ | 1..1 | canonical(Measure) | What measure was calculated | ||||
subject | SΣ | 1..1 | Reference(QICore Patient) | What individual(s) the report is for | ||||
date | SΣ | 1..1 | dateTime | When the report was generated | ||||
reporter | SΣ | 1..1 | Reference(QICore Organization) | The organization where the measure was completed | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
Slices for extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
group | S | 0..1 | Reference(Group) | Group of practitioners responsible for a report URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reporterGroup | ||||
reference | ΣC | 0..1 | string | Literal reference, Relative, internal or absolute URL | ||||
type | Σ | 0..1 | uri | Type the reference refers to (e.g. "Patient") Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model). | ||||
identifier | Σ | 0..1 | Identifier | Logical reference, when literal reference is not known | ||||
display | Σ | 0..1 | string | Text alternative for the resource | ||||
period | SΣC | 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 | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
start | SΣC | 1..1 | dateTime | Starting time with inclusive boundary | ||||
end | SΣC | 1..1 | dateTime | End time with inclusive boundary, if not ongoing | ||||
improvementNotation | ?!Σ | 0..1 | CodeableConcept | increase | decrease Binding: MeasureImprovementNotation (required): Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue. | ||||
group | C | 0..* | BackboneElement | Measure results for each group | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | Σ | 0..1 | CodeableConcept | Meaning of the group | ||||
population | 0..* | BackboneElement | The populations in the group | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | Σ | 0..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible): The type of population (e.g. initial, numerator, denominator, etc.). | ||||
count | 0..1 | integer | Size of the population | |||||
subjectResults | 0..1 | Reference(List) | For subject-list reports, the subject results in this population | |||||
evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score | ||||
Documentation for this format |
Path | Conformance | ValueSet / Code | ||||
MeasureReport.language | preferred | CommonLanguages
| ||||
MeasureReport.status | required | MeasureReportStatus | ||||
MeasureReport.type | required | Fixed Value: data-collection | ||||
MeasureReport.reporter.type | extensible | ResourceType | ||||
MeasureReport.improvementNotation | required | MeasureImprovementNotation | ||||
MeasureReport.group.population.code | extensible | MeasurePopulationType | ||||
MeasureReport.group.stratifier.stratum.population.code | extensible | MeasurePopulationType |
Id | Grade | Path(s) | Details | Requirements |
deqm-1 | error | MeasureReport.period | Date precision SHALL be at least to day ( YYYY-MM-DD ) : start.toString().length()>9 and end.toString().length()>9 |
This structure is derived from MeasureReport
Summary
Mandatory: 7 elements
Must-Support: 14 elements
Fixed Value: 1 element
Prohibited: 2 elements
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Differential View
This structure is derived from MeasureReport
Path | Conformance | ValueSet |
MeasureReport.status | required | MeasureReportStatus |
Id | Grade | Path(s) | Details | Requirements |
deqm-1 | error | MeasureReport.period | Date precision SHALL be at least to day ( YYYY-MM-DD ) : start.toString().length()>9 and end.toString().length()>9 |
Key Elements View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
MeasureReport | C | 0..* | MeasureReport | Results of a measure evaluation |
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
Slices for extension | 1..* | Extension | Extension Slice: Unordered, Open by value:url | |
updatetype | S | 1..1 | code | Optional Extensions Element URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-submitDataUpdateType Binding: DEQM Update Type Value Set (required) |
software | S | 0..* | Reference(CQFM Device) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem |
vendor | S | 0..1 | Reference(QICore Organization) | Vendor information URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingVendor |
location | 0..* | Reference(QICore Location) | Location(s) from which reported data was gathered URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-dataLocation | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
status | ?!SΣ | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required) |
type | SΣC | 1..1 | code | individual | subject-list | summary | data-collection Binding: MeasureReportType (required): The type of the measure report. Fixed Value: data-collection |
measure | SΣ | 1..1 | canonical(Measure) | What measure was calculated |
subject | SΣ | 1..1 | Reference(QICore Patient) | What individual(s) the report is for |
date | SΣ | 1..1 | dateTime | When the report was generated |
reporter | SΣ | 1..1 | Reference(QICore Organization) | The organization where the measure was completed |
group | S | 0..1 | Reference(Group) | Group of practitioners responsible for a report URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reporterGroup |
period | SΣC | 1..1 | Period | What period the report covers deqm-1: Date precision SHALL be at least to day ( YYYY-MM-DD ) |
start | SΣC | 1..1 | dateTime | Starting time with inclusive boundary |
end | SΣC | 1..1 | dateTime | End time with inclusive boundary, if not ongoing |
improvementNotation | ?!Σ | 0..1 | CodeableConcept | increase | decrease Binding: MeasureImprovementNotation (required): Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue. |
evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score |
Documentation for this format |
Path | Conformance | ValueSet / Code |
MeasureReport.status | required | MeasureReportStatus |
MeasureReport.type | required | Fixed Value: data-collection |
MeasureReport.improvementNotation | required | MeasureImprovementNotation |
Id | Grade | Path(s) | Details | Requirements |
deqm-1 | error | MeasureReport.period | Date precision SHALL be at least to day ( YYYY-MM-DD ) : start.toString().length()>9 and end.toString().length()>9 |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MeasureReport | C | 0..* | MeasureReport | Results of a measure evaluation | ||||
id | Σ | 0..1 | id | Logical id of this artifact | ||||
meta | Σ | 0..1 | Meta | Metadata about the resource | ||||
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
contained | 0..* | Resource | Contained, inline Resources | |||||
Slices for extension | 1..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
updatetype | S | 1..1 | code | Optional Extensions Element URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-submitDataUpdateType Binding: DEQM Update Type Value Set (required) | ||||
software | S | 0..* | Reference(CQFM Device) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem | ||||
vendor | S | 0..1 | Reference(QICore Organization) | Vendor information URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingVendor | ||||
location | 0..* | Reference(QICore Location) | Location(s) from which reported data was gathered URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-dataLocation | |||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
identifier | Σ | 0..* | Identifier | Additional identifier for the MeasureReport | ||||
status | ?!SΣ | 1..1 | code | complete | pending | error Binding: MeasureReportStatus (required) | ||||
type | SΣC | 1..1 | code | individual | subject-list | summary | data-collection Binding: MeasureReportType (required): The type of the measure report. Fixed Value: data-collection | ||||
measure | SΣ | 1..1 | canonical(Measure) | What measure was calculated | ||||
subject | SΣ | 1..1 | Reference(QICore Patient) | What individual(s) the report is for | ||||
date | SΣ | 1..1 | dateTime | When the report was generated | ||||
reporter | SΣ | 1..1 | Reference(QICore Organization) | The organization where the measure was completed | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
Slices for extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
group | S | 0..1 | Reference(Group) | Group of practitioners responsible for a report URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reporterGroup | ||||
reference | ΣC | 0..1 | string | Literal reference, Relative, internal or absolute URL | ||||
type | Σ | 0..1 | uri | Type the reference refers to (e.g. "Patient") Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model). | ||||
identifier | Σ | 0..1 | Identifier | Logical reference, when literal reference is not known | ||||
display | Σ | 0..1 | string | Text alternative for the resource | ||||
period | SΣC | 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 | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
start | SΣC | 1..1 | dateTime | Starting time with inclusive boundary | ||||
end | SΣC | 1..1 | dateTime | End time with inclusive boundary, if not ongoing | ||||
improvementNotation | ?!Σ | 0..1 | CodeableConcept | increase | decrease Binding: MeasureImprovementNotation (required): Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue. | ||||
group | C | 0..* | BackboneElement | Measure results for each group | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | Σ | 0..1 | CodeableConcept | Meaning of the group | ||||
population | 0..* | BackboneElement | The populations in the group | |||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
code | Σ | 0..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible): The type of population (e.g. initial, numerator, denominator, etc.). | ||||
count | 0..1 | integer | Size of the population | |||||
subjectResults | 0..1 | Reference(List) | For subject-list reports, the subject results in this population | |||||
evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score | ||||
Documentation for this format |
Path | Conformance | ValueSet / Code | ||||
MeasureReport.language | preferred | CommonLanguages
| ||||
MeasureReport.status | required | MeasureReportStatus | ||||
MeasureReport.type | required | Fixed Value: data-collection | ||||
MeasureReport.reporter.type | extensible | ResourceType | ||||
MeasureReport.improvementNotation | required | MeasureImprovementNotation | ||||
MeasureReport.group.population.code | extensible | MeasurePopulationType | ||||
MeasureReport.group.stratifier.stratum.population.code | extensible | MeasurePopulationType |
Id | Grade | Path(s) | Details | Requirements |
deqm-1 | error | MeasureReport.period | Date precision SHALL be at least to day ( YYYY-MM-DD ) : start.toString().length()>9 and end.toString().length()>9 |
This structure is derived from MeasureReport
Summary
Mandatory: 7 elements
Must-Support: 14 elements
Fixed Value: 1 element
Prohibited: 2 elements
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Other representations of profile: CSV, Excel, Schematron