Data Exchange For Quality Measures Implementation Guide
4.0.0 - STU4
United States of America
Data Exchange For Quality Measures Implementation Guide
4.0.0 - STU4
United States of America
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 in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions
| Official URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/indv-measurereport-deqm | Version: 4.0.0 | |||
| Active as of 2021-04-23 | Computable Name: DEQMIndividualMeasureReportProfile | |||
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. The DEQM Individual MeasureReport Profile defined here is used when a measure is reported to an aggregator for one specific patient. It contains all of the data that is relevant to generate the report including the measure outcome and is similar to a QRDA Category 1 report. In addition to the MeasureReport, the report would be collected in a Bundle with the Organization, Patient and any other resources that were used to calculate this measure.
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:
The MeasureReport.group.population.id is a must support element because it is used to link across the Measure and is equal to the Measure.population.group.id. This is needed because the MeasureReport.group.population.code is insufficient when the measure types have multiple populations with the same code.
If the measure scoring type is ‘proportion’, ‘ratio’, or ‘continuous-variable’ then the improvementNotation element is required.
If the measure scoring type is ‘proportion’ then the MeasureReport.group.measureScore.value SHALL be a numerical value between 0 and 1.
The reporter should be consistent with the X-Provenance header data if present.
the DEQM Reporting Vendor Extension is intended to represent the submitting entity when it is not the same as the reporting entity.
There are some elements like scoring and improvementNotation that can be specified either at the measure level or at the group level. If it is reported at the measure level it should not be specified for any group and if it is specified for any group it should be specified for every group and not at the measure level.
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from MeasureReport
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
  MeasureReport | C | 0..* | MeasureReport | Results of a measure evaluation deqm-2: If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required deqm-3: ensures scoring is either specified only at the root, or on all groups deqm-5: If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 deqm-6: If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting |
  reportingProgram | S | 0..1 | CodeableConcept, canonical(CQFM Library) | Reporting program URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingProgram Binding: Quality Programs (extensible) |
| supplementalData | S | 0..1 | Reference(QICore Observation | Resource) | Supplemental Data URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-supplementalData |
  criteriaReference | S | 0..1 | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference |
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) |
| vendor | S | 0..1 | Reference(QICore Organization) | Vendor information URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingVendor |
| cehrt | S | 0..1 | Identifier | CMS EHR Certifciation ID URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-certificationIdentifier |
 valueIdentifier | S | 1..1 | Identifier | Value of extension Required Pattern: At least the following |
   system | 1..1 | uri | The namespace for the identifier value Fixed Value: urn:oid:2.16.840.1.113883.3.2074.1 | |
| software | S | 0..* | Reference(CQFM Device) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem |
| location | 0..* | Reference(QICore Location) | Location(s) from which reported data was gathered URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-dataLocation | |
 status | S | 1..1 | code | complete | pending | error |
 type | S | 1..1 | code | individual | subject-list | summary | data-collection Fixed Value: individual |
| measure | S | 1..1 | canonical(CQFM 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. Note: The language in R5 was changed to calculated. We are clarifying that intent. |
| reporter | S | 1..1 | Reference(QICore Organization) | Organization that generated the MeasureReport |
| 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 | SC | 1..1 | Period | The period for which the report was calculated. For the gaps in care use case, this is referred to as the gaps through period. 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 |
| improvementNotation | SC | 0..1 | CodeableConcept | increase | decrease |
| group | SC | 0..* | BackboneElement | Measure results for each group deqm-4: If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. |
| id | S | 0..1 | string | Unique id for inter-element referencing |
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) |
| calculatedDate | S | 0..1 | dateTime | The date the score was calculated URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-calculatedDate |
| groupImprovementNotation | SC | 0..1 | CodeableConcept | increase | decrease URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation Binding: MeasureImprovementNotation (extensible) |
| code | S | 0..1 | CodeableConcept | Meaning of the group |
| population | SC | 0..* | BackboneElement | The populations in the group |
| code | S | 1..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation |
| count | S | 1..1 | integer | Size of the population |
| subjectResults | 0..0 | |||
| measureScore | SC | 0..1 | Quantity | What score this group achieved |
| altscoretype | S | 0..1 | dateTime, CodeableConcept, Period, Range, Duration | Possible additional measureScore value types URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-alternateScoreType |
| stratifier | ||||
| code | S | 0..1 | CodeableConcept | What stratifier of the group |
| evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score |
| popref | S | 0..* | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference |
| Documentation for this format | ||||
| 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 | |
| deqm-2 | error | MeasureReport | If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable') implies improvementNotation.exists() | |
| deqm-3 | error | MeasureReport | ensures scoring is either specified only at the root, or on all groups : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() xor (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').count() = group.count()) | |
| deqm-4 | error | MeasureReport.group | If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable')) implies extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation').exists() | |
| deqm-5 | error | MeasureReport | If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() or (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() implies group.population.count()>=1 | |
| deqm-6 | error | MeasureReport | If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion' or group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion') implies group.all(measureScore.value >= 0.0 and measureScore.value <=1.0) |
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| MeasureReport | C | 0..* | MeasureReport | Results of a measure evaluation deqm-2: If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required deqm-3: ensures scoring is either specified only at the root, or on all groups deqm-5: If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 deqm-6: If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting |
| implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
| reportingProgram | S | 0..1 | CodeableConcept, canonical(CQFM Library) | Reporting program URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingProgram Binding: Quality Programs (extensible) |
| supplementalData | S | 0..1 | Reference(QICore Observation | Resource) | Supplemental Data URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-supplementalData |
 criteriaReference | S | 0..1 | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference |
| url | 1..1 | uri | "http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-supplementalData" | |
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) |
| vendor | S | 0..1 | Reference(QICore Organization) | Vendor information URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingVendor |
| cehrt | S | 0..1 | Identifier | CMS EHR Certifciation ID URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-certificationIdentifier |
| url | 1..1 | uri | "http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-certificationIdentifier" | |
 Slices for value[x] | 1..1 | Identifier | Value of extension Slice: Unordered, Closed by type:$this | |
 value[x]:valueIdentifier | S | 1..1 | Identifier | Value of extension Required Pattern: At least the following |
| system | 1..1 | uri | The namespace for the identifier value Fixed Value: urn:oid:2.16.840.1.113883.3.2074.1 | |
| software | S | 0..* | Reference(CQFM Device) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem |
| 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): The status of the measure report. |
| type | SΣC | 1..1 | code | individual | subject-list | summary | data-collection Binding: MeasureReportType (required): The type of the measure report. Fixed Value: individual |
| measure | SΣ | 1..1 | canonical(CQFM 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. Note: The language in R5 was changed to calculated. We are clarifying that intent. |
| reporter | SΣ | 1..1 | Reference(QICore Organization) | Organization that generated the MeasureReport |
| 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 | The period for which the report was calculated. For the gaps in care use case, this is referred to as the gaps through period. 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 | ?!SΣC | 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 | SC | 0..* | BackboneElement | Measure results for each group deqm-4: If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. |
| id | S | 0..1 | string | Unique id for inter-element referencing |
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) |
| calculatedDate | S | 0..1 | dateTime | The date the score was calculated URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-calculatedDate |
| groupImprovementNotation | SC | 0..1 | CodeableConcept | increase | decrease URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation Binding: MeasureImprovementNotation (extensible) |
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| code | SΣ | 0..1 | CodeableConcept | Meaning of the group |
| population | SC | 0..* | BackboneElement | The populations in the group |
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| code | SΣ | 1..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 | S | 1..1 | integer | Size of the population |
| measureScore | SΣC | 0..1 | Quantity | What score this group achieved |
| altscoretype | S | 0..1 | dateTime, CodeableConcept, Period, Range, Duration | Possible additional measureScore value types URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-alternateScoreType |
| comparator | ?!Σ | 0..1 | code | < | <= | >= | > - how to understand the value Binding: QuantityComparator (required): How the Quantity should be understood and represented. |
| stratifier | 0..* | BackboneElement | Stratification results | |
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| code | S | 0..1 | CodeableConcept | What stratifier of the group |
| evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score |
| popref | S | 0..* | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference |
| Documentation for this format | ||||
| Path | Conformance | ValueSet / Code |
| MeasureReport.status | required | MeasureReportStatus |
| MeasureReport.type | required | Fixed Value: individual |
| MeasureReport.improvementNotation | required | MeasureImprovementNotation |
| MeasureReport.group.population.code | extensible | MeasurePopulationType |
| MeasureReport.group.measureScore.comparator | required | QuantityComparator |
| 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 | |
| deqm-2 | error | MeasureReport | If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable') implies improvementNotation.exists() | |
| deqm-3 | error | MeasureReport | ensures scoring is either specified only at the root, or on all groups : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() xor (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').count() = group.count()) | |
| deqm-4 | error | MeasureReport.group | If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable')) implies extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation').exists() | |
| deqm-5 | error | MeasureReport | If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() or (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() implies group.population.count()>=1 | |
| deqm-6 | error | MeasureReport | If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion' or group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion') implies group.all(measureScore.value >= 0.0 and measureScore.value <=1.0) |
| Name | Flags | Card. | Type | Description & Constraints | ||||
|---|---|---|---|---|---|---|---|---|
| MeasureReport | C | 0..* | MeasureReport | Results of a measure evaluation deqm-2: If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required deqm-3: ensures scoring is either specified only at the root, or on all groups deqm-5: If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 deqm-6: If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting | ||||
| 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 | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
| reportingProgram | S | 0..1 | CodeableConcept, canonical(CQFM Library) | Reporting program URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingProgram Binding: Quality Programs (extensible) | ||||
| supplementalData | S | 0..1 | Reference(QICore Observation | Resource) | Supplemental Data URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-supplementalData | ||||
| 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 | |||||
| criteriaReference | S | 0..1 | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference | ||||
| url | 1..1 | uri | "http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-supplementalData" | |||||
| value[x] | 0..1 | Reference(QICore Observation | Resource) | For supplementalData that is a calculation, this will be a reference to an Observation containing the result of the supplementalData calculation. For supplementalData that is a resource, this will be a reference to the supplementalData resource. | |||||
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) | ||||
| vendor | S | 0..1 | Reference(QICore Organization) | Vendor information URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingVendor | ||||
| cehrt | S | 0..1 | Identifier | CMS EHR Certifciation ID URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-certificationIdentifier | ||||
| id | 0..1 | string | Unique id for inter-element referencing | |||||
| extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| url | 1..1 | uri | "http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-certificationIdentifier" | |||||
| Slices for value[x] | 1..1 | Identifier | Value of extension Slice: Unordered, Closed by type:$this | |||||
| value[x]:valueIdentifier | S | 1..1 | Identifier | Value of extension Required Pattern: At least the following | ||||
| id | 0..1 | string | Unique id for inter-element referencing | |||||
| extension | 0..* | Extension | Additional content defined by implementations | |||||
| use | 0..1 | code | usual | official | temp | secondary | old (If known) | |||||
| type | 0..1 | CodeableConcept | Description of identifier | |||||
| system | 1..1 | uri | The namespace for the identifier value Fixed Value: urn:oid:2.16.840.1.113883.3.2074.1 | |||||
| value | 0..1 | string | The value that is unique | |||||
| period | 0..1 | Period | Time period when id is/was valid for use | |||||
| assigner | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | |||||
| software | S | 0..* | Reference(CQFM Device) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem | ||||
| 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): The status of the measure report. | ||||
| type | SΣC | 1..1 | code | individual | subject-list | summary | data-collection Binding: MeasureReportType (required): The type of the measure report. Fixed Value: individual | ||||
| measure | SΣ | 1..1 | canonical(CQFM 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. Note: The language in R5 was changed to calculated. We are clarifying that intent. | ||||
| reporter | SΣ | 1..1 | Reference(QICore Organization) | Organization that generated the MeasureReport | ||||
| 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 | The period for which the report was calculated. For the gaps in care use case, this is referred to as the gaps through period. 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 | ?!SΣC | 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 | SC | 0..* | BackboneElement | Measure results for each group deqm-4: If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. | ||||
| id | S | 0..1 | string | Unique id for inter-element referencing | ||||
| Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) | ||||
| calculatedDate | S | 0..1 | dateTime | The date the score was calculated URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-calculatedDate | ||||
| groupImprovementNotation | SC | 0..1 | CodeableConcept | increase | decrease URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation Binding: MeasureImprovementNotation (extensible) | ||||
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
| code | SΣ | 0..1 | CodeableConcept | Meaning of the group | ||||
| population | SC | 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 | SΣ | 1..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 | S | 1..1 | integer | Size of the population | ||||
| measureScore | SΣC | 0..1 | Quantity | What score this group achieved | ||||
| 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 | |||||
| altscoretype | S | 0..1 | dateTime, CodeableConcept, Period, Range, Duration | Possible additional measureScore value types URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-alternateScoreType | ||||
| value | Σ | 0..1 | decimal | Numerical value (with implicit precision) | ||||
| comparator | ?!Σ | 0..1 | code | < | <= | >= | > - how to understand the value Binding: QuantityComparator (required): How the Quantity should be understood and represented. | ||||
| unit | Σ | 0..1 | string | Unit representation | ||||
| system | ΣC | 0..1 | uri | System that defines coded unit form | ||||
| code | Σ | 0..1 | code | Coded form of the unit | ||||
| stratifier | 0..* | BackboneElement | Stratification results | |||||
| 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 | S | 0..1 | CodeableConcept | What stratifier of the group | ||||
| stratum | 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 | 0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
| value | 0..1 | CodeableConcept | The stratum value, e.g. male | |||||
| component | 0..* | BackboneElement | Stratifier component values | |||||
| 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 | 1..1 | CodeableConcept | What stratifier component of the group | |||||
| value | 1..1 | CodeableConcept | The stratum component value, e.g. male | |||||
| population | 0..* | BackboneElement | Population results in this stratum | |||||
| 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 | |||||
| measureScore | 0..1 | Quantity | What score this stratum achieved | |||||
| evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score | ||||
| 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 | |||||
| popref | S | 0..* | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference | ||||
| 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 | ||||
| Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | ||||
| MeasureReport.language | preferred | CommonLanguages
| ||||
| MeasureReport.status | required | MeasureReportStatus | ||||
| MeasureReport.type | required | Fixed Value: individual | ||||
| MeasureReport.reporter.type | extensible | ResourceType | ||||
| MeasureReport.improvementNotation | required | MeasureImprovementNotation | ||||
| MeasureReport.group.population.code | extensible | MeasurePopulationType | ||||
| MeasureReport.group.measureScore.comparator | required | QuantityComparator | ||||
| MeasureReport.group.stratifier.stratum.population.code | extensible | MeasurePopulationType | ||||
| MeasureReport.evaluatedResource.type | extensible | ResourceType |
| 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 | |
| deqm-2 | error | MeasureReport | If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable') implies improvementNotation.exists() | |
| deqm-3 | error | MeasureReport | ensures scoring is either specified only at the root, or on all groups : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() xor (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').count() = group.count()) | |
| deqm-4 | error | MeasureReport.group | If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable')) implies extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation').exists() | |
| deqm-5 | error | MeasureReport | If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() or (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() implies group.population.count()>=1 | |
| deqm-6 | error | MeasureReport | If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion' or group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion') implies group.all(measureScore.value >= 0.0 and measureScore.value <=1.0) |
This structure is derived from MeasureReport
Summary
Mandatory: 6 elements (3 nested mandatory elements)
Must-Support: 33 elements
Fixed Value: 1 element
Prohibited: 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 | C | 0..* | MeasureReport | Results of a measure evaluation deqm-2: If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required deqm-3: ensures scoring is either specified only at the root, or on all groups deqm-5: If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 deqm-6: If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting |
| reportingProgram | S | 0..1 | CodeableConcept, canonical(CQFM Library) | Reporting program URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingProgram Binding: Quality Programs (extensible) |
| supplementalData | S | 0..1 | Reference(QICore Observation | Resource) | Supplemental Data URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-supplementalData |
| criteriaReference | S | 0..1 | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference |
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) |
| vendor | S | 0..1 | Reference(QICore Organization) | Vendor information URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingVendor |
| cehrt | S | 0..1 | Identifier | CMS EHR Certifciation ID URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-certificationIdentifier |
| valueIdentifier | S | 1..1 | Identifier | Value of extension Required Pattern: At least the following |
| system | 1..1 | uri | The namespace for the identifier value Fixed Value: urn:oid:2.16.840.1.113883.3.2074.1 | |
| software | S | 0..* | Reference(CQFM Device) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem |
| location | 0..* | Reference(QICore Location) | Location(s) from which reported data was gathered URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-dataLocation | |
| status | S | 1..1 | code | complete | pending | error |
| type | S | 1..1 | code | individual | subject-list | summary | data-collection Fixed Value: individual |
| measure | S | 1..1 | canonical(CQFM 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. Note: The language in R5 was changed to calculated. We are clarifying that intent. |
| reporter | S | 1..1 | Reference(QICore Organization) | Organization that generated the MeasureReport |
| 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 | SC | 1..1 | Period | The period for which the report was calculated. For the gaps in care use case, this is referred to as the gaps through period. 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 |
| improvementNotation | SC | 0..1 | CodeableConcept | increase | decrease |
| group | SC | 0..* | BackboneElement | Measure results for each group deqm-4: If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. |
| id | S | 0..1 | string | Unique id for inter-element referencing |
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) |
| calculatedDate | S | 0..1 | dateTime | The date the score was calculated URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-calculatedDate |
| groupImprovementNotation | SC | 0..1 | CodeableConcept | increase | decrease URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation Binding: MeasureImprovementNotation (extensible) |
| code | S | 0..1 | CodeableConcept | Meaning of the group |
| population | SC | 0..* | BackboneElement | The populations in the group |
| code | S | 1..1 | CodeableConcept | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation |
| count | S | 1..1 | integer | Size of the population |
| subjectResults | 0..0 | |||
| measureScore | SC | 0..1 | Quantity | What score this group achieved |
| altscoretype | S | 0..1 | dateTime, CodeableConcept, Period, Range, Duration | Possible additional measureScore value types URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-alternateScoreType |
| stratifier | ||||
| code | S | 0..1 | CodeableConcept | What stratifier of the group |
| evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score |
| popref | S | 0..* | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference |
| Documentation for this format | ||||
| 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 | |
| deqm-2 | error | MeasureReport | If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable') implies improvementNotation.exists() | |
| deqm-3 | error | MeasureReport | ensures scoring is either specified only at the root, or on all groups : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() xor (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').count() = group.count()) | |
| deqm-4 | error | MeasureReport.group | If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable')) implies extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation').exists() | |
| deqm-5 | error | MeasureReport | If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() or (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() implies group.population.count()>=1 | |
| deqm-6 | error | MeasureReport | If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion' or group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion') implies group.all(measureScore.value >= 0.0 and measureScore.value <=1.0) |
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| MeasureReport | C | 0..* | MeasureReport | Results of a measure evaluation deqm-2: If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required deqm-3: ensures scoring is either specified only at the root, or on all groups deqm-5: If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 deqm-6: If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting |
| implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
| reportingProgram | S | 0..1 | CodeableConcept, canonical(CQFM Library) | Reporting program URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingProgram Binding: Quality Programs (extensible) |
| supplementalData | S | 0..1 | Reference(QICore Observation | Resource) | Supplemental Data URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-supplementalData |
| criteriaReference | S | 0..1 | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference |
| url | 1..1 | uri | "http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-supplementalData" | |
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) |
| vendor | S | 0..1 | Reference(QICore Organization) | Vendor information URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingVendor |
| cehrt | S | 0..1 | Identifier | CMS EHR Certifciation ID URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-certificationIdentifier |
| url | 1..1 | uri | "http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-certificationIdentifier" | |
| Slices for value[x] | 1..1 | Identifier | Value of extension Slice: Unordered, Closed by type:$this | |
| value[x]:valueIdentifier | S | 1..1 | Identifier | Value of extension Required Pattern: At least the following |
| system | 1..1 | uri | The namespace for the identifier value Fixed Value: urn:oid:2.16.840.1.113883.3.2074.1 | |
| software | S | 0..* | Reference(CQFM Device) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem |
| 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): The status of the measure report. |
| type | SΣC | 1..1 | code | individual | subject-list | summary | data-collection Binding: MeasureReportType (required): The type of the measure report. Fixed Value: individual |
| measure | SΣ | 1..1 | canonical(CQFM 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. Note: The language in R5 was changed to calculated. We are clarifying that intent. |
| reporter | SΣ | 1..1 | Reference(QICore Organization) | Organization that generated the MeasureReport |
| 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 | The period for which the report was calculated. For the gaps in care use case, this is referred to as the gaps through period. 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 | ?!SΣC | 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 | SC | 0..* | BackboneElement | Measure results for each group deqm-4: If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. |
| id | S | 0..1 | string | Unique id for inter-element referencing |
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) |
| calculatedDate | S | 0..1 | dateTime | The date the score was calculated URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-calculatedDate |
| groupImprovementNotation | SC | 0..1 | CodeableConcept | increase | decrease URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation Binding: MeasureImprovementNotation (extensible) |
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| code | SΣ | 0..1 | CodeableConcept | Meaning of the group |
| population | SC | 0..* | BackboneElement | The populations in the group |
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| code | SΣ | 1..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 | S | 1..1 | integer | Size of the population |
| measureScore | SΣC | 0..1 | Quantity | What score this group achieved |
| altscoretype | S | 0..1 | dateTime, CodeableConcept, Period, Range, Duration | Possible additional measureScore value types URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-alternateScoreType |
| comparator | ?!Σ | 0..1 | code | < | <= | >= | > - how to understand the value Binding: QuantityComparator (required): How the Quantity should be understood and represented. |
| stratifier | 0..* | BackboneElement | Stratification results | |
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| code | S | 0..1 | CodeableConcept | What stratifier of the group |
| evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score |
| popref | S | 0..* | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference |
| Documentation for this format | ||||
| Path | Conformance | ValueSet / Code |
| MeasureReport.status | required | MeasureReportStatus |
| MeasureReport.type | required | Fixed Value: individual |
| MeasureReport.improvementNotation | required | MeasureImprovementNotation |
| MeasureReport.group.population.code | extensible | MeasurePopulationType |
| MeasureReport.group.measureScore.comparator | required | QuantityComparator |
| 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 | |
| deqm-2 | error | MeasureReport | If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable') implies improvementNotation.exists() | |
| deqm-3 | error | MeasureReport | ensures scoring is either specified only at the root, or on all groups : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() xor (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').count() = group.count()) | |
| deqm-4 | error | MeasureReport.group | If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable')) implies extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation').exists() | |
| deqm-5 | error | MeasureReport | If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() or (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() implies group.population.count()>=1 | |
| deqm-6 | error | MeasureReport | If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion' or group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion') implies group.all(measureScore.value >= 0.0 and measureScore.value <=1.0) |
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints | ||||
|---|---|---|---|---|---|---|---|---|
| MeasureReport | C | 0..* | MeasureReport | Results of a measure evaluation deqm-2: If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required deqm-3: ensures scoring is either specified only at the root, or on all groups deqm-5: If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 deqm-6: If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting | ||||
| 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 | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
| reportingProgram | S | 0..1 | CodeableConcept, canonical(CQFM Library) | Reporting program URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingProgram Binding: Quality Programs (extensible) | ||||
| supplementalData | S | 0..1 | Reference(QICore Observation | Resource) | Supplemental Data URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-supplementalData | ||||
| 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 | |||||
| criteriaReference | S | 0..1 | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference | ||||
| url | 1..1 | uri | "http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-supplementalData" | |||||
| value[x] | 0..1 | Reference(QICore Observation | Resource) | For supplementalData that is a calculation, this will be a reference to an Observation containing the result of the supplementalData calculation. For supplementalData that is a resource, this will be a reference to the supplementalData resource. | |||||
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) | ||||
| vendor | S | 0..1 | Reference(QICore Organization) | Vendor information URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-reportingVendor | ||||
| cehrt | S | 0..1 | Identifier | CMS EHR Certifciation ID URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-certificationIdentifier | ||||
| id | 0..1 | string | Unique id for inter-element referencing | |||||
| extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| url | 1..1 | uri | "http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-certificationIdentifier" | |||||
| Slices for value[x] | 1..1 | Identifier | Value of extension Slice: Unordered, Closed by type:$this | |||||
| value[x]:valueIdentifier | S | 1..1 | Identifier | Value of extension Required Pattern: At least the following | ||||
| id | 0..1 | string | Unique id for inter-element referencing | |||||
| extension | 0..* | Extension | Additional content defined by implementations | |||||
| use | 0..1 | code | usual | official | temp | secondary | old (If known) | |||||
| type | 0..1 | CodeableConcept | Description of identifier | |||||
| system | 1..1 | uri | The namespace for the identifier value Fixed Value: urn:oid:2.16.840.1.113883.3.2074.1 | |||||
| value | 0..1 | string | The value that is unique | |||||
| period | 0..1 | Period | Time period when id is/was valid for use | |||||
| assigner | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | |||||
| software | S | 0..* | Reference(CQFM Device) | Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem | ||||
| 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): The status of the measure report. | ||||
| type | SΣC | 1..1 | code | individual | subject-list | summary | data-collection Binding: MeasureReportType (required): The type of the measure report. Fixed Value: individual | ||||
| measure | SΣ | 1..1 | canonical(CQFM 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. Note: The language in R5 was changed to calculated. We are clarifying that intent. | ||||
| reporter | SΣ | 1..1 | Reference(QICore Organization) | Organization that generated the MeasureReport | ||||
| 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 | The period for which the report was calculated. For the gaps in care use case, this is referred to as the gaps through period. 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 | ?!SΣC | 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 | SC | 0..* | BackboneElement | Measure results for each group deqm-4: If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. | ||||
| id | S | 0..1 | string | Unique id for inter-element referencing | ||||
| Slices for extension | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
| scoring | SC | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort | composite URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring Binding: MeasureScoring (extensible) | ||||
| calculatedDate | S | 0..1 | dateTime | The date the score was calculated URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-calculatedDate | ||||
| groupImprovementNotation | SC | 0..1 | CodeableConcept | increase | decrease URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation Binding: MeasureImprovementNotation (extensible) | ||||
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
| code | SΣ | 0..1 | CodeableConcept | Meaning of the group | ||||
| population | SC | 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 | SΣ | 1..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 | S | 1..1 | integer | Size of the population | ||||
| measureScore | SΣC | 0..1 | Quantity | What score this group achieved | ||||
| 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 | |||||
| altscoretype | S | 0..1 | dateTime, CodeableConcept, Period, Range, Duration | Possible additional measureScore value types URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-alternateScoreType | ||||
| value | Σ | 0..1 | decimal | Numerical value (with implicit precision) | ||||
| comparator | ?!Σ | 0..1 | code | < | <= | >= | > - how to understand the value Binding: QuantityComparator (required): How the Quantity should be understood and represented. | ||||
| unit | Σ | 0..1 | string | Unit representation | ||||
| system | ΣC | 0..1 | uri | System that defines coded unit form | ||||
| code | Σ | 0..1 | code | Coded form of the unit | ||||
| stratifier | 0..* | BackboneElement | Stratification results | |||||
| 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 | S | 0..1 | CodeableConcept | What stratifier of the group | ||||
| stratum | 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 | 0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
| value | 0..1 | CodeableConcept | The stratum value, e.g. male | |||||
| component | 0..* | BackboneElement | Stratifier component values | |||||
| 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 | 1..1 | CodeableConcept | What stratifier component of the group | |||||
| value | 1..1 | CodeableConcept | The stratum component value, e.g. male | |||||
| population | 0..* | BackboneElement | Population results in this stratum | |||||
| 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 | |||||
| measureScore | 0..1 | Quantity | What score this stratum achieved | |||||
| evaluatedResource | S | 0..* | Reference(Resource) | What data was used to calculate the measure score | ||||
| 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 | |||||
| popref | S | 0..* | string | Criteria reference URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-criteriaReference | ||||
| 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 | ||||
| Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | ||||
| MeasureReport.language | preferred | CommonLanguages
| ||||
| MeasureReport.status | required | MeasureReportStatus | ||||
| MeasureReport.type | required | Fixed Value: individual | ||||
| MeasureReport.reporter.type | extensible | ResourceType | ||||
| MeasureReport.improvementNotation | required | MeasureImprovementNotation | ||||
| MeasureReport.group.population.code | extensible | MeasurePopulationType | ||||
| MeasureReport.group.measureScore.comparator | required | QuantityComparator | ||||
| MeasureReport.group.stratifier.stratum.population.code | extensible | MeasurePopulationType | ||||
| MeasureReport.evaluatedResource.type | extensible | ResourceType |
| 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 | |
| deqm-2 | error | MeasureReport | If the measure scoring is specified at the root and the scoring type is 'proportion','ratio', or 'continuous-variable' then the improvementNotation element is required : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable') implies improvementNotation.exists() | |
| deqm-3 | error | MeasureReport | ensures scoring is either specified only at the root, or on all groups : extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() xor (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').count() = group.count()) | |
| deqm-4 | error | MeasureReport.group | If the measure scoring is specified on the group and the scoring type is 'proportion', 'ratio', or 'continuous-variable' then the groupImprovementNotation element is required. : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').exists() and extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('proportion' | 'ratio' | 'continuous-variable')) implies extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-groupImprovementNotation').exists() | |
| deqm-5 | error | MeasureReport | If the scoring, at either the root level or the group level, is other than composite then the group.population cardinality is >=1 : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() or (group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains ('composite')).not() implies group.population.count()>=1 | |
| deqm-6 | error | MeasureReport | If the measure scoring type is 'proportion' then the measureScore SHALL be a numerical value between 0 and 1 for summary reporting : (extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion' or group.extension('http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/extension-measureScoring').value.coding.code contains 'proportion') implies group.all(measureScore.value >= 0.0 and measureScore.value <=1.0) |
This structure is derived from MeasureReport
Summary
Mandatory: 6 elements (3 nested mandatory elements)
Must-Support: 33 elements
Fixed Value: 1 element
Prohibited: 1 element
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Other representations of profile: CSV, Excel, Schematron
IG © 2020+ HL7 International / Clinical Quality Information. Package hl7.fhir.us.davinci-deqm#4.0.0 based on FHIR 4.0.1. Generated 2023-10-03
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change