This page is part of the Da Vinci Data Exchange for Quality Measures (DEQM) FHIR IG (v0.1.0: STU 1 Ballot 1) based on FHIR R3. The current version which supercedes this version is 3.1.0. For a full list of available versions, see the Directory of published versions
StructureDefinition-measure-deqm
added bryn’s deqm library and measure profiles. cleaned up terminology topofpage
The DEQM Measure Profile describes a shareable, published measure resource that can be used to define an electronic clinical quality measure
Mandatory Data Elements and Terminology
The following data-elements are mandatory (i.e data MUST be present).
Each Measure must have:
- A canonical url
- At least one identifier
- A content version
- A valid, machine-friendly name
- A human-friendly title
- The measure type
- At least one population group with at least one population within it
- The type of population criteria
- A date the measure content was last changed
- Publisher and contact information
- Concise description of the measure content
- A date the measure content was approved by the publisher
- A date when the measure content was last reviewed
- At least one library containing population criteria definitions for the measure
- The scoring method used for the measure
- The meaning of a higher score
Each Measure should have (Must Support):
- A clear description of the purpose of the measure
- Clinical usage notes for the measure
- The period during which the measure content can be effectively applied
- Clear indication of the expected contexts of use for the measure content
- Intended jurisdictions for the measure content
- Contributors to the measure content
- Relevant topics for the measure content
- Information on contributors to the measure content
- Copyright information
- Provide related information such as supporting evidence, citations, and documentation
- A legal disclaimer relating to the use of the measure content
- Stratification information if appropriate
- Supplemental data where appropriate
Additional Profile specific implementation guidance:
None
Examples
Formal Views of Profile Content
Description of Profiles, Differentials, and Snapshots.
The official URL for this profile is: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/measure-deqm
Published on Tue Jun 19 00:00:00 AEST 2018 as a active by Da Vinci Project.
This profile builds on Measure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Measure | 0..* | |||
url | S | 1..1 | uri | |
identifier | S | 1..* | Identifier | |
version | S | 1..1 | string | |
name | S | 1..1 | string | |
title | S | 1..1 | string | |
date | S | 1..1 | dateTime | |
publisher | S | 1..1 | string | |
contact | S | 1..* | ContactDetail | |
description | S | 1..1 | markdown | |
useContext | S | 0..* | UsageContext | |
jurisdiction | S | 0..* | CodeableConcept | |
purpose | S | 0..1 | markdown | |
usage | S | 0..1 | string | |
copyright | S | 0..1 | markdown | |
approvalDate | S | 1..1 | date | |
lastReviewDate | S | 1..1 | date | |
effectivePeriod | S | 0..1 | Period | |
topic | S | 0..* | CodeableConcept | |
author | S | 0..* | ContactDetail | |
editor | S | 0..* | ContactDetail | |
reviewer | S | 0..* | ContactDetail | |
endorser | S | 0..* | ContactDetail | |
relatedArtifact | S | 0..* | RelatedArtifact | |
library | S | 1..* | canonical(profile-library-deqm) | |
disclaimer | S | 0..1 | markdown | |
scoring | S | 1..1 | CodeableConcept | |
type | S | 1..* | CodeableConcept | |
improvementNotation | S | 1..1 | code | |
group | S | 1..* | BackboneElement | |
population | S | 1..* | BackboneElement | |
code | S | 1..1 | CodeableConcept | |
stratifier | S | 0..* | BackboneElement | |
supplementalData | S | 0..* | BackboneElement | |
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Measure | I | 0..* | A quality measure definition | |
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: Common Languages (preferred) | |
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
url | SΣ | 1..1 | uri | Canonical identifier for this measure, represented as a URI (globally unique) |
identifier | SΣ | 1..* | Identifier | Additional identifier for the measure |
version | SΣ | 1..1 | string | Business version of the measure |
name | SΣI | 1..1 | string | Name for this measure (computer friendly) |
title | SΣ | 1..1 | string | Name for this measure (human friendly) |
subtitle | 0..1 | string | Subordinate title of the measure | |
status | ?!Σ | 1..1 | code | draft | active | retired | unknown Binding: PublicationStatus (required) |
experimental | Σ | 0..1 | boolean | For testing purposes, not real usage |
subject[x] | 0..1 | CodeableConcept, Reference(Group) | E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device Binding: SubjectType (extensible) | |
date | SΣ | 1..1 | dateTime | Date last changed |
publisher | SΣ | 1..1 | string | Name of the publisher (organization or individual) |
contact | SΣ | 1..* | ContactDetail | Contact details for the publisher |
description | SΣ | 1..1 | markdown | Natural language description of the measure |
useContext | SΣ | 0..* | UsageContext | The context that the content is intended to support |
jurisdiction | SΣ | 0..* | CodeableConcept | Intended jurisdiction for measure (if applicable) Binding: Jurisdiction ValueSet (extensible) |
purpose | S | 0..1 | markdown | Why this measure is defined |
usage | S | 0..1 | string | Describes the clinical usage of the measure |
copyright | S | 0..1 | markdown | Use and/or publishing restrictions |
approvalDate | S | 1..1 | date | When the measure was approved by publisher |
lastReviewDate | S | 1..1 | date | When the measure was last reviewed |
effectivePeriod | SΣ | 0..1 | Period | When the measure is expected to be used |
topic | S | 0..* | CodeableConcept | The category of the measure, such as Education, Treatment, Assessment, etc. Binding: DefinitionTopic (example) |
author | S | 0..* | ContactDetail | Who authored the content |
editor | S | 0..* | ContactDetail | Who edited the content |
reviewer | S | 0..* | ContactDetail | Who reviewed the content |
endorser | S | 0..* | ContactDetail | Who endorsed the content |
relatedArtifact | S | 0..* | RelatedArtifact | Additional documentation, citations, etc. |
library | S | 1..* | canonical(profile-library-deqm) | Logic used by the measure |
disclaimer | SΣ | 0..1 | markdown | Disclaimer for use of the measure or its referenced content |
scoring | SΣ | 1..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort Binding: MeasureScoring (extensible) |
compositeScoring | Σ | 0..1 | CodeableConcept | opportunity | all-or-nothing | linear | weighted Binding: CompositeMeasureScoring (extensible) |
type | SΣ | 1..* | CodeableConcept | process | outcome | structure | patient-reported-outcome | composite Binding: MeasureType (extensible) |
riskAdjustment | Σ | 0..1 | string | How risk adjustment is applied for this measure |
rateAggregation | Σ | 0..1 | string | How is rate aggregation performed for this measure |
rationale | Σ | 0..1 | markdown | Detailed description of why the measure exists |
clinicalRecommendationStatement | Σ | 0..1 | markdown | Summary of clinical guidelines |
improvementNotation | SΣ | 1..1 | code | increase | decrease Binding: MeasureImprovementNotation (required) |
definition | Σ | 0..* | markdown | Defined terms used in the measure documentation |
guidance | Σ | 0..1 | markdown | Additional guidance for implementers |
group | SI | 1..* | BackboneElement | Population criteria group |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored if unrecognized |
code | 0..1 | CodeableConcept | Meaning of the group | |
description | 0..1 | string | Summary description | |
population | SI | 1..* | BackboneElement | Population criteria |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored 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) |
description | 0..1 | string | The human readable description of this population criteria | |
criteria | 1..1 | Expression | The criteria that defines this population | |
stratifier | SI | 0..* | BackboneElement | Stratifier criteria for the measure |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored if unrecognized |
code | 0..1 | CodeableConcept | Meaning of the stratifier | |
description | 0..1 | string | The human readable description of this stratifier | |
criteria | 1..1 | Expression | How the measure should be stratified | |
supplementalData | SI | 0..* | BackboneElement | What other data should be reported with the measure |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored if unrecognized |
code | 0..1 | CodeableConcept | Meaning of the supplemental data | |
usage | 0..* | CodeableConcept | supplemental-data | risk-adjustment-factor Binding: MeasureDataUsage (extensible) | |
description | 0..1 | string | The human readable description of this supplemental data | |
criteria | 1..1 | Expression | Expression describing additional data to be reported | |
Documentation for this format |
Differential View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Measure | 0..* | |||
url | S | 1..1 | uri | |
identifier | S | 1..* | Identifier | |
version | S | 1..1 | string | |
name | S | 1..1 | string | |
title | S | 1..1 | string | |
date | S | 1..1 | dateTime | |
publisher | S | 1..1 | string | |
contact | S | 1..* | ContactDetail | |
description | S | 1..1 | markdown | |
useContext | S | 0..* | UsageContext | |
jurisdiction | S | 0..* | CodeableConcept | |
purpose | S | 0..1 | markdown | |
usage | S | 0..1 | string | |
copyright | S | 0..1 | markdown | |
approvalDate | S | 1..1 | date | |
lastReviewDate | S | 1..1 | date | |
effectivePeriod | S | 0..1 | Period | |
topic | S | 0..* | CodeableConcept | |
author | S | 0..* | ContactDetail | |
editor | S | 0..* | ContactDetail | |
reviewer | S | 0..* | ContactDetail | |
endorser | S | 0..* | ContactDetail | |
relatedArtifact | S | 0..* | RelatedArtifact | |
library | S | 1..* | canonical(profile-library-deqm) | |
disclaimer | S | 0..1 | markdown | |
scoring | S | 1..1 | CodeableConcept | |
type | S | 1..* | CodeableConcept | |
improvementNotation | S | 1..1 | code | |
group | S | 1..* | BackboneElement | |
population | S | 1..* | BackboneElement | |
code | S | 1..1 | CodeableConcept | |
stratifier | S | 0..* | BackboneElement | |
supplementalData | S | 0..* | BackboneElement | |
Documentation for this format |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Measure | I | 0..* | A quality measure definition | |
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: Common Languages (preferred) | |
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
url | SΣ | 1..1 | uri | Canonical identifier for this measure, represented as a URI (globally unique) |
identifier | SΣ | 1..* | Identifier | Additional identifier for the measure |
version | SΣ | 1..1 | string | Business version of the measure |
name | SΣI | 1..1 | string | Name for this measure (computer friendly) |
title | SΣ | 1..1 | string | Name for this measure (human friendly) |
subtitle | 0..1 | string | Subordinate title of the measure | |
status | ?!Σ | 1..1 | code | draft | active | retired | unknown Binding: PublicationStatus (required) |
experimental | Σ | 0..1 | boolean | For testing purposes, not real usage |
subject[x] | 0..1 | CodeableConcept, Reference(Group) | E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device Binding: SubjectType (extensible) | |
date | SΣ | 1..1 | dateTime | Date last changed |
publisher | SΣ | 1..1 | string | Name of the publisher (organization or individual) |
contact | SΣ | 1..* | ContactDetail | Contact details for the publisher |
description | SΣ | 1..1 | markdown | Natural language description of the measure |
useContext | SΣ | 0..* | UsageContext | The context that the content is intended to support |
jurisdiction | SΣ | 0..* | CodeableConcept | Intended jurisdiction for measure (if applicable) Binding: Jurisdiction ValueSet (extensible) |
purpose | S | 0..1 | markdown | Why this measure is defined |
usage | S | 0..1 | string | Describes the clinical usage of the measure |
copyright | S | 0..1 | markdown | Use and/or publishing restrictions |
approvalDate | S | 1..1 | date | When the measure was approved by publisher |
lastReviewDate | S | 1..1 | date | When the measure was last reviewed |
effectivePeriod | SΣ | 0..1 | Period | When the measure is expected to be used |
topic | S | 0..* | CodeableConcept | The category of the measure, such as Education, Treatment, Assessment, etc. Binding: DefinitionTopic (example) |
author | S | 0..* | ContactDetail | Who authored the content |
editor | S | 0..* | ContactDetail | Who edited the content |
reviewer | S | 0..* | ContactDetail | Who reviewed the content |
endorser | S | 0..* | ContactDetail | Who endorsed the content |
relatedArtifact | S | 0..* | RelatedArtifact | Additional documentation, citations, etc. |
library | S | 1..* | canonical(profile-library-deqm) | Logic used by the measure |
disclaimer | SΣ | 0..1 | markdown | Disclaimer for use of the measure or its referenced content |
scoring | SΣ | 1..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort Binding: MeasureScoring (extensible) |
compositeScoring | Σ | 0..1 | CodeableConcept | opportunity | all-or-nothing | linear | weighted Binding: CompositeMeasureScoring (extensible) |
type | SΣ | 1..* | CodeableConcept | process | outcome | structure | patient-reported-outcome | composite Binding: MeasureType (extensible) |
riskAdjustment | Σ | 0..1 | string | How risk adjustment is applied for this measure |
rateAggregation | Σ | 0..1 | string | How is rate aggregation performed for this measure |
rationale | Σ | 0..1 | markdown | Detailed description of why the measure exists |
clinicalRecommendationStatement | Σ | 0..1 | markdown | Summary of clinical guidelines |
improvementNotation | SΣ | 1..1 | code | increase | decrease Binding: MeasureImprovementNotation (required) |
definition | Σ | 0..* | markdown | Defined terms used in the measure documentation |
guidance | Σ | 0..1 | markdown | Additional guidance for implementers |
group | SI | 1..* | BackboneElement | Population criteria group |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored if unrecognized |
code | 0..1 | CodeableConcept | Meaning of the group | |
description | 0..1 | string | Summary description | |
population | SI | 1..* | BackboneElement | Population criteria |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored 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) |
description | 0..1 | string | The human readable description of this population criteria | |
criteria | 1..1 | Expression | The criteria that defines this population | |
stratifier | SI | 0..* | BackboneElement | Stratifier criteria for the measure |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored if unrecognized |
code | 0..1 | CodeableConcept | Meaning of the stratifier | |
description | 0..1 | string | The human readable description of this stratifier | |
criteria | 1..1 | Expression | How the measure should be stratified | |
supplementalData | SI | 0..* | BackboneElement | What other data should be reported with the measure |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored if unrecognized |
code | 0..1 | CodeableConcept | Meaning of the supplemental data | |
usage | 0..* | CodeableConcept | supplemental-data | risk-adjustment-factor Binding: MeasureDataUsage (extensible) | |
description | 0..1 | string | The human readable description of this supplemental data | |
criteria | 1..1 | Expression | Expression describing additional data to be reported | |
Documentation for this format |
Downloads: StructureDefinition: (XML, JSON), Schema: XML Schematron
Quick Start
Below is an overview of the required set of RESTful FHIR interactions - for example, search and read operations - for this profile. See the Conformance requirements for a complete list of supported RESTful interactions for this IG.
Use cases: