CMS FHIR Quality Measure Development IG
0.8.0-cibuild - CI Build International flag

CMS FHIR Quality Measure Development IG, published by Centers for Medicare & Medicaid Services (CMS). This guide is not an authorized publication; it is the continuous build for version 0.8.0-cibuild built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/cqframework/cms-qmd/ and changes regularly. See the Directory of published versions

Resource Profile: CMS Publishable Measure

Official URL: http://ecqi.healthit.gov/fhir/qmd/StructureDefinition/cms-publishable-measure Version: 0.8.0-cibuild
Active as of 2026-10-09 Computable Name: CMSPublishableMeasure

The MADiE Measure Profile supports development of measures within the tool.

Usages:

  • This Profile is not used by any profiles in this Specification

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from MADiEMeasure

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Measure 0..* MADiEMeasure A quality measure definition
Measure.Slices for identifier Content/Rules for all slices
Measure.Slices for identifier.identifier:publisherIdentifier 1..1 Identifier CMS identifier assigned to the measure
Measure.Slices for identifier.identifier:publisherIdentifier.system 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
Measure.Slices for identifier.identifier:publisherIdentifier.value 1..1 string CMS identifier assigned to the measure.

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: doco
Measure C 0..* MADiEMeasure A quality measure definition
Constraints: mea-0, mea-1
Measure.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Measure.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Measure.Slices for identifier This element is included in summaries. 2..* Identifier Additional identifier for the measure
Slice: Unordered, Open by value:type

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Measure.Slices for identifier.identifier:shortName This element is included in summaries. 1..1 Identifier 'eCQM Abbreviated Title' (measure short name) in MADiE.
Measure.Slices for identifier.identifier:shortName.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:shortName.system This element is included in summaries. 1..1 uri CMS Short Name identifier namespace
Fixed Value: https://madie.cms.gov/measure/shortNameId
Measure.Slices for identifier.identifier:shortName.value This element is included in summaries. 1..1 string 'eCQM Abbreviated Title' (measure short name) in MADiE.
Example General: 123456
Measure.Slices for identifier.identifier:cbeIdentifier This element must be supported. This element is included in summaries. 0..1 Identifier CBE endorsement identifier
Measure.Slices for identifier.identifier:cbeIdentifier.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:cbeIdentifier.system This element must be supported. This element is included in summaries. 1..1 uri CBE identifier namespace
Fixed Value: https://madie.cms.gov/measure/cbeId
Measure.Slices for identifier.identifier:cbeIdentifier.value This element must be supported. This element is included in summaries. 1..1 string CBE endorsement identifier value
Example General: 123456
Measure.Slices for identifier.identifier:publisherIdentifier This element is included in summaries. 1..1 Identifier CMS identifier assigned to the measure
Measure.Slices for identifier.identifier:publisherIdentifier.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:publisherIdentifier.system This element is included in summaries. 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
Measure.Slices for identifier.identifier:publisherIdentifier.value This element is included in summaries. 1..1 string CMS identifier assigned to the measure.
Example General: 123456
Measure.status This element is a modifier element. This element is included in summaries. 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
Measure.description This element is included in summaries. 1..1 markdown 'Measure Description' in MADiE.
Measure.effectivePeriod This element is included in summaries. 1..1 Period CMS dQMs must have an effective period.
Measure.author 1..1 ContactDetail 'Measure Developer' in MADiE.
Measure.library 1..1 canonical(CRMI Computable Library(2.0.0)) Logic used by the measure

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Measure.identifier:shortName.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.identifier:cbeIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.identifier:publisherIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.status Base required PublicationStatus 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Measure If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Measure If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Measure If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Measure If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Measure A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
mea-0 warning Measure Name should be usable as an identifier for the module by machine processing applications such as code generation name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
mea-1 error Measure Stratifier SHALL be either a single criteria or a set of criteria components group.stratifier.all((code | description | criteria).exists() xor component.exists())
NameFlagsCard.TypeDescription & Constraints    Filter: doco
Measure C 0..* MADiEMeasure A quality measure definition
Constraints: mea-0, mea-1
Measure.id This element is included in summaries. 0..1 id Logical id of this artifact
Measure.meta This element is included in summaries. 0..1 Meta Metadata about the resource
Measure.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Measure.language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
Measure.text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Measure.contained 0..* Resource Contained, inline Resources
Measure.extension 0..* Extension Additional content defined by implementations
Measure.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Measure.url This element is included in summaries. 0..1 uri Canonical identifier for this measure, represented as a URI (globally unique)
Measure.Slices for identifier This element is included in summaries. 2..* Identifier Additional identifier for the measure
Slice: Unordered, Open by value:type

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Measure.Slices for identifier.identifier:shortName This element is included in summaries. 1..1 Identifier 'eCQM Abbreviated Title' (measure short name) in MADiE.
Measure.Slices for identifier.identifier:shortName.id 0..1 string Unique id for inter-element referencing
Measure.Slices for identifier.identifier:shortName.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
Measure.Slices for identifier.identifier:shortName.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:shortName.type This element is included in summaries. 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
Measure.Slices for identifier.identifier:shortName.system This element is included in summaries. 1..1 uri CMS Short Name identifier namespace
Fixed Value: https://madie.cms.gov/measure/shortNameId
Measure.Slices for identifier.identifier:shortName.value This element is included in summaries. 1..1 string 'eCQM Abbreviated Title' (measure short name) in MADiE.
Example General: 123456
Measure.Slices for identifier.identifier:shortName.period This element is included in summaries. 0..1 Period Time period when id is/was valid for use
Measure.Slices for identifier.identifier:shortName.assigner This element is included in summaries. 0..1 Reference(Organization) Organization that issued id (may be just text)
Measure.Slices for identifier.identifier:cbeIdentifier This element must be supported. This element is included in summaries. 0..1 Identifier CBE endorsement identifier
Measure.Slices for identifier.identifier:cbeIdentifier.id 0..1 string Unique id for inter-element referencing
Measure.Slices for identifier.identifier:cbeIdentifier.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
Measure.Slices for identifier.identifier:cbeIdentifier.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:cbeIdentifier.type This element is included in summaries. 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
Measure.Slices for identifier.identifier:cbeIdentifier.system This element must be supported. This element is included in summaries. 1..1 uri CBE identifier namespace
Fixed Value: https://madie.cms.gov/measure/cbeId
Measure.Slices for identifier.identifier:cbeIdentifier.value This element must be supported. This element is included in summaries. 1..1 string CBE endorsement identifier value
Example General: 123456
Measure.Slices for identifier.identifier:cbeIdentifier.period This element is included in summaries. 0..1 Period Time period when id is/was valid for use
Measure.Slices for identifier.identifier:cbeIdentifier.assigner This element is included in summaries. 0..1 Reference(Organization) Organization that issued id (may be just text)
Measure.Slices for identifier.identifier:publisherIdentifier This element is included in summaries. 1..1 Identifier CMS identifier assigned to the measure
Measure.Slices for identifier.identifier:publisherIdentifier.id 0..1 string Unique id for inter-element referencing
Measure.Slices for identifier.identifier:publisherIdentifier.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
Measure.Slices for identifier.identifier:publisherIdentifier.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:publisherIdentifier.type This element is included in summaries. 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
Measure.Slices for identifier.identifier:publisherIdentifier.system This element is included in summaries. 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
Measure.Slices for identifier.identifier:publisherIdentifier.value This element is included in summaries. 1..1 string CMS identifier assigned to the measure.
Example General: 123456
Measure.Slices for identifier.identifier:publisherIdentifier.period This element is included in summaries. 0..1 Period Time period when id is/was valid for use
Measure.Slices for identifier.identifier:publisherIdentifier.assigner This element is included in summaries. 0..1 Reference(Organization) Organization that issued id (may be just text)
Measure.version This element is included in summaries. 0..1 string Business version of the measure
Measure.name This element is included in summaries. C 0..1 string Name for this measure (computer friendly)
Measure.title This element is included in summaries. 0..1 string Name for this measure (human friendly)
Measure.subtitle 0..1 string Subordinate title of the measure
Measure.status This element is a modifier element. This element is included in summaries. 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
Measure.experimental This element is included in summaries. 0..1 boolean For testing purposes, not real usage
Measure.subject[x] 0..1 E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
Measure.subject[x].subjectCodeableConcept CodeableConcept
Measure.subject[x].subjectReference Reference(Group)
Measure.date This element is included in summaries. 0..1 dateTime Date last changed
Measure.publisher This element is included in summaries. 0..1 string Name of the publisher (organization or individual)
Measure.contact This element is included in summaries. 0..* ContactDetail Contact details for the publisher
Measure.description This element is included in summaries. 1..1 markdown 'Measure Description' in MADiE.
Measure.useContext This element is included in summaries. 0..* UsageContext The context that the content is intended to support
Measure.jurisdiction This element is included in summaries. 0..* CodeableConcept Intended jurisdiction for measure (if applicable)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.
Measure.purpose 0..1 markdown Why this measure is defined
Measure.usage 0..1 string Describes the clinical usage of the measure
Measure.copyright 0..1 markdown Use and/or publishing restrictions
Measure.approvalDate 0..1 date When the measure was approved by publisher
Measure.lastReviewDate 0..1 date When the measure was last reviewed
Measure.effectivePeriod This element is included in summaries. 1..1 Period CMS dQMs must have an effective period.
Measure.topic 0..* CodeableConcept The category of the measure, such as Education, Treatment, Assessment, etc.
Binding: DefinitionTopic (example): High-level categorization of the definition, used for searching, sorting, and filtering.
Measure.author 1..1 ContactDetail 'Measure Developer' in MADiE.
Measure.editor 0..* ContactDetail Who edited the content
Measure.reviewer 0..* ContactDetail Who reviewed the content
Measure.endorser 0..* ContactDetail Who endorsed the content
Measure.relatedArtifact 0..* RelatedArtifact Additional documentation, citations, etc.
Measure.library 1..1 canonical(CRMI Computable Library(2.0.0)) Logic used by the measure
Measure.disclaimer This element is included in summaries. 0..1 markdown Disclaimer for use of the measure or its referenced content
Measure.scoring This element is included in summaries. 0..1 CodeableConcept proportion | ratio | continuous-variable | cohort
Binding: MeasureScoring (extensible): The scoring type of the measure.
Measure.compositeScoring This element is included in summaries. 0..1 CodeableConcept opportunity | all-or-nothing | linear | weighted
Binding: CompositeMeasureScoring (extensible): The composite scoring method of the measure.
Measure.type This element is included in summaries. 0..* CodeableConcept process | outcome | structure | patient-reported-outcome | composite
Binding: MeasureType (extensible): The type of measure (includes codes from 2.16.840.1.113883.1.11.20368).
Measure.riskAdjustment This element is included in summaries. 0..1 string How risk adjustment is applied for this measure
Measure.rateAggregation This element is included in summaries. 0..1 string How is rate aggregation performed for this measure
Measure.rationale This element is included in summaries. 0..1 markdown Detailed description of why the measure exists
Measure.clinicalRecommendationStatement This element is included in summaries. 0..1 markdown Summary of clinical guidelines
Measure.improvementNotation This element is included in summaries. 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.
Measure.definition This element is included in summaries. 0..* markdown Defined terms used in the measure documentation
Measure.guidance This element is included in summaries. 0..1 markdown Additional guidance for implementers
Measure.group 0..* BackboneElement Population criteria group
Measure.group.id 0..1 string Unique id for inter-element referencing
Measure.group.Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url
Measure.group.Slices for extension.extension:type 1..1 CodeableConcept Extension
URL: http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-type
Binding: ObservationMeasureType (extensible): Indicates the type of quality measure based on the observation value.
Measure.group.Slices for extension.extension:scoring 1..1 CodeableConcept Extension
URL: http://ecqi.healthit.gov/fhir/uv/cqm/StructureDefinition/cms-scoring
Binding: CMS Measure Scoring (required): Indicates the scoring of a quality measure group.
Measure.group.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Measure.group.code 0..1 CodeableConcept Meaning of the group
Measure.group.description 0..1 string Summary description
Measure.group.population 0..* BackboneElement Population criteria
Measure.group.population.id 0..1 string Unique id for inter-element referencing
Measure.group.population.extension 0..* Extension Additional content defined by implementations
Measure.group.population.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Measure.group.population.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.
Measure.group.population.description 0..1 string The human readable description of this population criteria
Measure.group.population.criteria 1..1 Expression The criteria that defines this population
Measure.group.stratifier 0..* BackboneElement Stratifier criteria for the measure
Measure.group.stratifier.id 0..1 string Unique id for inter-element referencing
Measure.group.stratifier.extension 0..* Extension Additional content defined by implementations
Measure.group.stratifier.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Measure.group.stratifier.code 0..1 CodeableConcept Meaning of the stratifier
Measure.group.stratifier.description 0..1 string The human readable description of this stratifier
Measure.group.stratifier.criteria 0..1 Expression How the measure should be stratified
Measure.group.stratifier.component 0..* BackboneElement Stratifier criteria component for the measure
Measure.group.stratifier.component.id 0..1 string Unique id for inter-element referencing
Measure.group.stratifier.component.extension 0..* Extension Additional content defined by implementations
Measure.group.stratifier.component.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Measure.group.stratifier.component.code 0..1 CodeableConcept Meaning of the stratifier component
Measure.group.stratifier.component.description 0..1 string The human readable description of this stratifier component
Measure.group.stratifier.component.criteria 1..1 Expression Component of how the measure should be stratified
Measure.supplementalData 0..* BackboneElement What other data should be reported with the measure
Measure.supplementalData.id 0..1 string Unique id for inter-element referencing
Measure.supplementalData.extension 0..* Extension Additional content defined by implementations
Measure.supplementalData.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Measure.supplementalData.code 0..1 CodeableConcept Meaning of the supplemental data
Measure.supplementalData.usage 0..* CodeableConcept supplemental-data | risk-adjustment-factor
Binding: MeasureDataUsage (extensible): The intended usage for supplemental data elements in the measure.
Measure.supplementalData.description 0..1 string The human readable description of this supplemental data
Measure.supplementalData.criteria 1..1 Expression Expression describing additional data to be reported

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Measure.language Base preferred Common Languages 📍4.0.1 FHIR Std.
Measure.identifier:shortName.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.identifier:shortName.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
Measure.identifier:cbeIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.identifier:cbeIdentifier.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
Measure.identifier:publisherIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.identifier:publisherIdentifier.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
Measure.status Base required PublicationStatus 📍4.0.1 FHIR Std.
Measure.subject[x] Base extensible Subject type 📍4.0.1 FHIR Std.
Measure.jurisdiction Base extensible Jurisdiction 📍4.0.1 FHIR Std.
Measure.topic Base example DefinitionTopic 📍4.0.1 FHIR Std.
Measure.scoring Base extensible MeasureScoring 📍4.0.1 FHIR Std.
Measure.compositeScoring Base extensible CompositeMeasureScoring 📍4.0.1 FHIR Std.
Measure.type Base extensible MeasureType 📍4.0.1 FHIR Std.
Measure.improvementNotation Base required MeasureImprovementNotation 📍4.0.1 FHIR Std.
Measure.group.population.​code Base extensible MeasurePopulationType 📍4.0.1 FHIR Std.
Measure.supplementalData.​usage Base extensible MeasureDataUsage 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Measure If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Measure If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Measure If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Measure If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Measure A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
mea-0 warning Measure Name should be usable as an identifier for the module by machine processing applications such as code generation name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
mea-1 error Measure Stratifier SHALL be either a single criteria or a set of criteria components group.stratifier.all((code | description | criteria).exists() xor component.exists())

This structure is derived from MADiEMeasure

Summary

Mandatory: 3 elements
Fixed: 1 element

Differential View

This structure is derived from MADiEMeasure

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Measure 0..* MADiEMeasure A quality measure definition
Measure.Slices for identifier Content/Rules for all slices
Measure.Slices for identifier.identifier:publisherIdentifier 1..1 Identifier CMS identifier assigned to the measure
Measure.Slices for identifier.identifier:publisherIdentifier.system 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
Measure.Slices for identifier.identifier:publisherIdentifier.value 1..1 string CMS identifier assigned to the measure.

doco Documentation for this format

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Measure C 0..* MADiEMeasure A quality measure definition
Constraints: mea-0, mea-1
Measure.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Measure.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Measure.Slices for identifier This element is included in summaries. 2..* Identifier Additional identifier for the measure
Slice: Unordered, Open by value:type

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Measure.Slices for identifier.identifier:shortName This element is included in summaries. 1..1 Identifier 'eCQM Abbreviated Title' (measure short name) in MADiE.
Measure.Slices for identifier.identifier:shortName.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:shortName.system This element is included in summaries. 1..1 uri CMS Short Name identifier namespace
Fixed Value: https://madie.cms.gov/measure/shortNameId
Measure.Slices for identifier.identifier:shortName.value This element is included in summaries. 1..1 string 'eCQM Abbreviated Title' (measure short name) in MADiE.
Example General: 123456
Measure.Slices for identifier.identifier:cbeIdentifier This element must be supported. This element is included in summaries. 0..1 Identifier CBE endorsement identifier
Measure.Slices for identifier.identifier:cbeIdentifier.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:cbeIdentifier.system This element must be supported. This element is included in summaries. 1..1 uri CBE identifier namespace
Fixed Value: https://madie.cms.gov/measure/cbeId
Measure.Slices for identifier.identifier:cbeIdentifier.value This element must be supported. This element is included in summaries. 1..1 string CBE endorsement identifier value
Example General: 123456
Measure.Slices for identifier.identifier:publisherIdentifier This element is included in summaries. 1..1 Identifier CMS identifier assigned to the measure
Measure.Slices for identifier.identifier:publisherIdentifier.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:publisherIdentifier.system This element is included in summaries. 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
Measure.Slices for identifier.identifier:publisherIdentifier.value This element is included in summaries. 1..1 string CMS identifier assigned to the measure.
Example General: 123456
Measure.status This element is a modifier element. This element is included in summaries. 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
Measure.description This element is included in summaries. 1..1 markdown 'Measure Description' in MADiE.
Measure.effectivePeriod This element is included in summaries. 1..1 Period CMS dQMs must have an effective period.
Measure.author 1..1 ContactDetail 'Measure Developer' in MADiE.
Measure.library 1..1 canonical(CRMI Computable Library(2.0.0)) Logic used by the measure

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Measure.identifier:shortName.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.identifier:cbeIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.identifier:publisherIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.status Base required PublicationStatus 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Measure If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Measure If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Measure If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Measure If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Measure A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
mea-0 warning Measure Name should be usable as an identifier for the module by machine processing applications such as code generation name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
mea-1 error Measure Stratifier SHALL be either a single criteria or a set of criteria components group.stratifier.all((code | description | criteria).exists() xor component.exists())

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Measure C 0..* MADiEMeasure A quality measure definition
Constraints: mea-0, mea-1
Measure.id This element is included in summaries. 0..1 id Logical id of this artifact
Measure.meta This element is included in summaries. 0..1 Meta Metadata about the resource
Measure.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Measure.language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
Measure.text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Measure.contained 0..* Resource Contained, inline Resources
Measure.extension 0..* Extension Additional content defined by implementations
Measure.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Measure.url This element is included in summaries. 0..1 uri Canonical identifier for this measure, represented as a URI (globally unique)
Measure.Slices for identifier This element is included in summaries. 2..* Identifier Additional identifier for the measure
Slice: Unordered, Open by value:type

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Measure.Slices for identifier.identifier:shortName This element is included in summaries. 1..1 Identifier 'eCQM Abbreviated Title' (measure short name) in MADiE.
Measure.Slices for identifier.identifier:shortName.id 0..1 string Unique id for inter-element referencing
Measure.Slices for identifier.identifier:shortName.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
Measure.Slices for identifier.identifier:shortName.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:shortName.type This element is included in summaries. 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
Measure.Slices for identifier.identifier:shortName.system This element is included in summaries. 1..1 uri CMS Short Name identifier namespace
Fixed Value: https://madie.cms.gov/measure/shortNameId
Measure.Slices for identifier.identifier:shortName.value This element is included in summaries. 1..1 string 'eCQM Abbreviated Title' (measure short name) in MADiE.
Example General: 123456
Measure.Slices for identifier.identifier:shortName.period This element is included in summaries. 0..1 Period Time period when id is/was valid for use
Measure.Slices for identifier.identifier:shortName.assigner This element is included in summaries. 0..1 Reference(Organization) Organization that issued id (may be just text)
Measure.Slices for identifier.identifier:cbeIdentifier This element must be supported. This element is included in summaries. 0..1 Identifier CBE endorsement identifier
Measure.Slices for identifier.identifier:cbeIdentifier.id 0..1 string Unique id for inter-element referencing
Measure.Slices for identifier.identifier:cbeIdentifier.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
Measure.Slices for identifier.identifier:cbeIdentifier.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:cbeIdentifier.type This element is included in summaries. 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
Measure.Slices for identifier.identifier:cbeIdentifier.system This element must be supported. This element is included in summaries. 1..1 uri CBE identifier namespace
Fixed Value: https://madie.cms.gov/measure/cbeId
Measure.Slices for identifier.identifier:cbeIdentifier.value This element must be supported. This element is included in summaries. 1..1 string CBE endorsement identifier value
Example General: 123456
Measure.Slices for identifier.identifier:cbeIdentifier.period This element is included in summaries. 0..1 Period Time period when id is/was valid for use
Measure.Slices for identifier.identifier:cbeIdentifier.assigner This element is included in summaries. 0..1 Reference(Organization) Organization that issued id (may be just text)
Measure.Slices for identifier.identifier:publisherIdentifier This element is included in summaries. 1..1 Identifier CMS identifier assigned to the measure
Measure.Slices for identifier.identifier:publisherIdentifier.id 0..1 string Unique id for inter-element referencing
Measure.Slices for identifier.identifier:publisherIdentifier.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
Measure.Slices for identifier.identifier:publisherIdentifier.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Measure.Slices for identifier.identifier:publisherIdentifier.type This element is included in summaries. 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
Measure.Slices for identifier.identifier:publisherIdentifier.system This element is included in summaries. 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
Measure.Slices for identifier.identifier:publisherIdentifier.value This element is included in summaries. 1..1 string CMS identifier assigned to the measure.
Example General: 123456
Measure.Slices for identifier.identifier:publisherIdentifier.period This element is included in summaries. 0..1 Period Time period when id is/was valid for use
Measure.Slices for identifier.identifier:publisherIdentifier.assigner This element is included in summaries. 0..1 Reference(Organization) Organization that issued id (may be just text)
Measure.version This element is included in summaries. 0..1 string Business version of the measure
Measure.name This element is included in summaries. C 0..1 string Name for this measure (computer friendly)
Measure.title This element is included in summaries. 0..1 string Name for this measure (human friendly)
Measure.subtitle 0..1 string Subordinate title of the measure
Measure.status This element is a modifier element. This element is included in summaries. 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
Measure.experimental This element is included in summaries. 0..1 boolean For testing purposes, not real usage
Measure.subject[x] 0..1 E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
Measure.subject[x].subjectCodeableConcept CodeableConcept
Measure.subject[x].subjectReference Reference(Group)
Measure.date This element is included in summaries. 0..1 dateTime Date last changed
Measure.publisher This element is included in summaries. 0..1 string Name of the publisher (organization or individual)
Measure.contact This element is included in summaries. 0..* ContactDetail Contact details for the publisher
Measure.description This element is included in summaries. 1..1 markdown 'Measure Description' in MADiE.
Measure.useContext This element is included in summaries. 0..* UsageContext The context that the content is intended to support
Measure.jurisdiction This element is included in summaries. 0..* CodeableConcept Intended jurisdiction for measure (if applicable)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.
Measure.purpose 0..1 markdown Why this measure is defined
Measure.usage 0..1 string Describes the clinical usage of the measure
Measure.copyright 0..1 markdown Use and/or publishing restrictions
Measure.approvalDate 0..1 date When the measure was approved by publisher
Measure.lastReviewDate 0..1 date When the measure was last reviewed
Measure.effectivePeriod This element is included in summaries. 1..1 Period CMS dQMs must have an effective period.
Measure.topic 0..* CodeableConcept The category of the measure, such as Education, Treatment, Assessment, etc.
Binding: DefinitionTopic (example): High-level categorization of the definition, used for searching, sorting, and filtering.
Measure.author 1..1 ContactDetail 'Measure Developer' in MADiE.
Measure.editor 0..* ContactDetail Who edited the content
Measure.reviewer 0..* ContactDetail Who reviewed the content
Measure.endorser 0..* ContactDetail Who endorsed the content
Measure.relatedArtifact 0..* RelatedArtifact Additional documentation, citations, etc.
Measure.library 1..1 canonical(CRMI Computable Library(2.0.0)) Logic used by the measure
Measure.disclaimer This element is included in summaries. 0..1 markdown Disclaimer for use of the measure or its referenced content
Measure.scoring This element is included in summaries. 0..1 CodeableConcept proportion | ratio | continuous-variable | cohort
Binding: MeasureScoring (extensible): The scoring type of the measure.
Measure.compositeScoring This element is included in summaries. 0..1 CodeableConcept opportunity | all-or-nothing | linear | weighted
Binding: CompositeMeasureScoring (extensible): The composite scoring method of the measure.
Measure.type This element is included in summaries. 0..* CodeableConcept process | outcome | structure | patient-reported-outcome | composite
Binding: MeasureType (extensible): The type of measure (includes codes from 2.16.840.1.113883.1.11.20368).
Measure.riskAdjustment This element is included in summaries. 0..1 string How risk adjustment is applied for this measure
Measure.rateAggregation This element is included in summaries. 0..1 string How is rate aggregation performed for this measure
Measure.rationale This element is included in summaries. 0..1 markdown Detailed description of why the measure exists
Measure.clinicalRecommendationStatement This element is included in summaries. 0..1 markdown Summary of clinical guidelines
Measure.improvementNotation This element is included in summaries. 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.
Measure.definition This element is included in summaries. 0..* markdown Defined terms used in the measure documentation
Measure.guidance This element is included in summaries. 0..1 markdown Additional guidance for implementers
Measure.group 0..* BackboneElement Population criteria group
Measure.group.id 0..1 string Unique id for inter-element referencing
Measure.group.Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url
Measure.group.Slices for extension.extension:type 1..1 CodeableConcept Extension
URL: http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-type
Binding: ObservationMeasureType (extensible): Indicates the type of quality measure based on the observation value.
Measure.group.Slices for extension.extension:scoring 1..1 CodeableConcept Extension
URL: http://ecqi.healthit.gov/fhir/uv/cqm/StructureDefinition/cms-scoring
Binding: CMS Measure Scoring (required): Indicates the scoring of a quality measure group.
Measure.group.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Measure.group.code 0..1 CodeableConcept Meaning of the group
Measure.group.description 0..1 string Summary description
Measure.group.population 0..* BackboneElement Population criteria
Measure.group.population.id 0..1 string Unique id for inter-element referencing
Measure.group.population.extension 0..* Extension Additional content defined by implementations
Measure.group.population.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Measure.group.population.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.
Measure.group.population.description 0..1 string The human readable description of this population criteria
Measure.group.population.criteria 1..1 Expression The criteria that defines this population
Measure.group.stratifier 0..* BackboneElement Stratifier criteria for the measure
Measure.group.stratifier.id 0..1 string Unique id for inter-element referencing
Measure.group.stratifier.extension 0..* Extension Additional content defined by implementations
Measure.group.stratifier.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Measure.group.stratifier.code 0..1 CodeableConcept Meaning of the stratifier
Measure.group.stratifier.description 0..1 string The human readable description of this stratifier
Measure.group.stratifier.criteria 0..1 Expression How the measure should be stratified
Measure.group.stratifier.component 0..* BackboneElement Stratifier criteria component for the measure
Measure.group.stratifier.component.id 0..1 string Unique id for inter-element referencing
Measure.group.stratifier.component.extension 0..* Extension Additional content defined by implementations
Measure.group.stratifier.component.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Measure.group.stratifier.component.code 0..1 CodeableConcept Meaning of the stratifier component
Measure.group.stratifier.component.description 0..1 string The human readable description of this stratifier component
Measure.group.stratifier.component.criteria 1..1 Expression Component of how the measure should be stratified
Measure.supplementalData 0..* BackboneElement What other data should be reported with the measure
Measure.supplementalData.id 0..1 string Unique id for inter-element referencing
Measure.supplementalData.extension 0..* Extension Additional content defined by implementations
Measure.supplementalData.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Measure.supplementalData.code 0..1 CodeableConcept Meaning of the supplemental data
Measure.supplementalData.usage 0..* CodeableConcept supplemental-data | risk-adjustment-factor
Binding: MeasureDataUsage (extensible): The intended usage for supplemental data elements in the measure.
Measure.supplementalData.description 0..1 string The human readable description of this supplemental data
Measure.supplementalData.criteria 1..1 Expression Expression describing additional data to be reported

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Measure.language Base preferred Common Languages 📍4.0.1 FHIR Std.
Measure.identifier:shortName.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.identifier:shortName.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
Measure.identifier:cbeIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.identifier:cbeIdentifier.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
Measure.identifier:publisherIdentifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Measure.identifier:publisherIdentifier.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
Measure.status Base required PublicationStatus 📍4.0.1 FHIR Std.
Measure.subject[x] Base extensible Subject type 📍4.0.1 FHIR Std.
Measure.jurisdiction Base extensible Jurisdiction 📍4.0.1 FHIR Std.
Measure.topic Base example DefinitionTopic 📍4.0.1 FHIR Std.
Measure.scoring Base extensible MeasureScoring 📍4.0.1 FHIR Std.
Measure.compositeScoring Base extensible CompositeMeasureScoring 📍4.0.1 FHIR Std.
Measure.type Base extensible MeasureType 📍4.0.1 FHIR Std.
Measure.improvementNotation Base required MeasureImprovementNotation 📍4.0.1 FHIR Std.
Measure.group.population.​code Base extensible MeasurePopulationType 📍4.0.1 FHIR Std.
Measure.supplementalData.​usage Base extensible MeasureDataUsage 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Measure If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Measure If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Measure If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Measure If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Measure A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
mea-0 warning Measure Name should be usable as an identifier for the module by machine processing applications such as code generation name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
mea-1 error Measure Stratifier SHALL be either a single criteria or a set of criteria components group.stratifier.all((code | description | criteria).exists() xor component.exists())

This structure is derived from MADiEMeasure

Summary

Mandatory: 3 elements
Fixed: 1 element

 

Other representations of profile: CSV, Excel, Schematron