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-08-07 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: Filtersdoco
.. Measure 0..* MADiEMeasure A quality measure definition
... Slices for identifier Content/Rules for all slices
.... identifier:publisherIdentifier 1..1 Identifier CMS identifier assigned to the measure
..... system 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
..... value 1..1 string CMS identifier assigned to the measure.

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure C 0..* MADiEMeasure A quality measure definition
Constraints: mea-0, mea-1
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... Slices for identifier Σ 2..* Identifier Additional identifier for the measure
Slice: Unordered, Open by value:type
.... identifier:shortName Σ 1..1 Identifier 'eCQM Abbreviated Title' (measure short name) in MADiE.
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system Σ 1..1 uri CMS Short Name identifier namespace
Fixed Value: https://madie.cms.gov/measure/shortNameId
..... value Σ 1..1 string 'eCQM Abbreviated Title' (measure short name) in MADiE.
Example General: 123456
.... identifier:cbeIdentifier SΣ 0..1 Identifier CBE endorsement identifier
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system SΣ 1..1 uri CBE identifier namespace
Fixed Value: https://madie.cms.gov/measure/cbeId
..... value SΣ 1..1 string CBE endorsement identifier value
Example General: 123456
.... identifier:publisherIdentifier Σ 1..1 Identifier CMS identifier assigned to the measure
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system Σ 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
..... value Σ 1..1 string CMS identifier assigned to the measure.
Example General: 123456
... description Σ 1..1 markdown 'Measure Description' in MADiE.
... effectivePeriod Σ 1..1 Period CMS dQMs must have an effective period.
... author 1..1 ContactDetail 'Measure Developer' in MADiE.
... library 1..1 canonical(CRMI Computable Library) 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: Filtersdoco
.. Measure C 0..* MADiEMeasure A quality measure definition
Constraints: mea-0, mea-1
... 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.
Additional BindingsPurpose
AllLanguages Max Binding
... 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
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url Σ 0..1 uri Canonical identifier for this measure, represented as a URI (globally unique)
... Slices for identifier Σ 2..* Identifier Additional identifier for the measure
Slice: Unordered, Open by value:type
.... identifier:shortName Σ 1..1 Identifier 'eCQM Abbreviated Title' (measure short name) in MADiE.
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 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.
..... system Σ 1..1 uri CMS Short Name identifier namespace
Fixed Value: https://madie.cms.gov/measure/shortNameId
..... value Σ 1..1 string 'eCQM Abbreviated Title' (measure short name) in MADiE.
Example General: 123456
..... 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)
.... identifier:cbeIdentifier SΣ 0..1 Identifier CBE endorsement identifier
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 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.
..... system SΣ 1..1 uri CBE identifier namespace
Fixed Value: https://madie.cms.gov/measure/cbeId
..... value SΣ 1..1 string CBE endorsement identifier value
Example General: 123456
..... 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)
.... identifier:publisherIdentifier Σ 1..1 Identifier CMS identifier assigned to the measure
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 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.
..... system Σ 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
..... value Σ 1..1 string CMS identifier assigned to the measure.
Example General: 123456
..... 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)
... version Σ 0..1 string Business version of the measure
... name ΣC 0..1 string Name for this measure (computer friendly)
... title Σ 0..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): The lifecycle status of an artifact.
... experimental Σ 0..1 boolean For testing purposes, not real usage
... 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.).
.... subjectCodeableConcept CodeableConcept
.... subjectReference Reference(Group)
... date Σ 0..1 dateTime Date last changed
... publisher Σ 0..1 string Name of the publisher (organization or individual)
... contact Σ 0..* ContactDetail Contact details for the publisher
... description Σ 1..1 markdown 'Measure Description' in MADiE.
... useContext Σ 0..* UsageContext The context that the content is intended to support
... jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for measure (if applicable)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.
... purpose 0..1 markdown Why this measure is defined
... usage 0..1 string Describes the clinical usage of the measure
... copyright 0..1 markdown Use and/or publishing restrictions
... approvalDate 0..1 date When the measure was approved by publisher
... lastReviewDate 0..1 date When the measure was last reviewed
... effectivePeriod Σ 1..1 Period CMS dQMs must have an effective period.
... 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.
... author 1..1 ContactDetail 'Measure Developer' in MADiE.
... editor 0..* ContactDetail Who edited the content
... reviewer 0..* ContactDetail Who reviewed the content
... endorser 0..* ContactDetail Who endorsed the content
... relatedArtifact 0..* RelatedArtifact Additional documentation, citations, etc.
... library 1..1 canonical(CRMI Computable Library) Logic used by the measure
... disclaimer Σ 0..1 markdown Disclaimer for use of the measure or its referenced content
... scoring Σ 0..1 CodeableConcept proportion | ratio | continuous-variable | cohort
Binding: MeasureScoring (extensible): The scoring type of the measure.
... compositeScoring Σ 0..1 CodeableConcept opportunity | all-or-nothing | linear | weighted
Binding: CompositeMeasureScoring (extensible): The composite scoring method of the measure.
... type Σ 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).
... 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 Σ 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.
... definition Σ 0..* markdown Defined terms used in the measure documentation
... guidance Σ 0..1 markdown Additional guidance for implementers
... group 0..* BackboneElement Population criteria group
.... id 0..1 string Unique id for inter-element referencing
.... Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url
..... 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.
..... 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.
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code 0..1 CodeableConcept Meaning of the group
.... description 0..1 string Summary description
.... population 0..* BackboneElement Population criteria
..... 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.
..... description 0..1 string The human readable description of this population criteria
..... criteria 1..1 Expression The criteria that defines this population
.... stratifier 0..* BackboneElement Stratifier criteria for the measure
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 0..1 CodeableConcept Meaning of the stratifier
..... description 0..1 string The human readable description of this stratifier
..... criteria 0..1 Expression How the measure should be stratified
..... component 0..* BackboneElement Stratifier criteria component for the measure
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... code 0..1 CodeableConcept Meaning of the stratifier component
...... description 0..1 string The human readable description of this stratifier component
...... criteria 1..1 Expression Component of how the measure should be stratified
... supplementalData 0..* BackboneElement What other data should be reported with the measure
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code 0..1 CodeableConcept Meaning of the supplemental data
.... usage 0..* CodeableConcept supplemental-data | risk-adjustment-factor
Binding: MeasureDataUsage (extensible): The intended usage for supplemental data elements in the measure.
.... description 0..1 string The human readable description of this supplemental data
.... 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: Filtersdoco
.. Measure 0..* MADiEMeasure A quality measure definition
... Slices for identifier Content/Rules for all slices
.... identifier:publisherIdentifier 1..1 Identifier CMS identifier assigned to the measure
..... system 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
..... value 1..1 string CMS identifier assigned to the measure.

doco Documentation for this format

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure C 0..* MADiEMeasure A quality measure definition
Constraints: mea-0, mea-1
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... Slices for identifier Σ 2..* Identifier Additional identifier for the measure
Slice: Unordered, Open by value:type
.... identifier:shortName Σ 1..1 Identifier 'eCQM Abbreviated Title' (measure short name) in MADiE.
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system Σ 1..1 uri CMS Short Name identifier namespace
Fixed Value: https://madie.cms.gov/measure/shortNameId
..... value Σ 1..1 string 'eCQM Abbreviated Title' (measure short name) in MADiE.
Example General: 123456
.... identifier:cbeIdentifier SΣ 0..1 Identifier CBE endorsement identifier
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system SΣ 1..1 uri CBE identifier namespace
Fixed Value: https://madie.cms.gov/measure/cbeId
..... value SΣ 1..1 string CBE endorsement identifier value
Example General: 123456
.... identifier:publisherIdentifier Σ 1..1 Identifier CMS identifier assigned to the measure
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system Σ 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
..... value Σ 1..1 string CMS identifier assigned to the measure.
Example General: 123456
... description Σ 1..1 markdown 'Measure Description' in MADiE.
... effectivePeriod Σ 1..1 Period CMS dQMs must have an effective period.
... author 1..1 ContactDetail 'Measure Developer' in MADiE.
... library 1..1 canonical(CRMI Computable Library) 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: Filtersdoco
.. Measure C 0..* MADiEMeasure A quality measure definition
Constraints: mea-0, mea-1
... 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.
Additional BindingsPurpose
AllLanguages Max Binding
... 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
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url Σ 0..1 uri Canonical identifier for this measure, represented as a URI (globally unique)
... Slices for identifier Σ 2..* Identifier Additional identifier for the measure
Slice: Unordered, Open by value:type
.... identifier:shortName Σ 1..1 Identifier 'eCQM Abbreviated Title' (measure short name) in MADiE.
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 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.
..... system Σ 1..1 uri CMS Short Name identifier namespace
Fixed Value: https://madie.cms.gov/measure/shortNameId
..... value Σ 1..1 string 'eCQM Abbreviated Title' (measure short name) in MADiE.
Example General: 123456
..... 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)
.... identifier:cbeIdentifier SΣ 0..1 Identifier CBE endorsement identifier
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 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.
..... system SΣ 1..1 uri CBE identifier namespace
Fixed Value: https://madie.cms.gov/measure/cbeId
..... value SΣ 1..1 string CBE endorsement identifier value
Example General: 123456
..... 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)
.... identifier:publisherIdentifier Σ 1..1 Identifier CMS identifier assigned to the measure
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 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.
..... system Σ 1..1 uri CMS identifier namespace
Fixed Value: https://madie.cms.gov/measure/cmsId
..... value Σ 1..1 string CMS identifier assigned to the measure.
Example General: 123456
..... 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)
... version Σ 0..1 string Business version of the measure
... name ΣC 0..1 string Name for this measure (computer friendly)
... title Σ 0..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): The lifecycle status of an artifact.
... experimental Σ 0..1 boolean For testing purposes, not real usage
... 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.).
.... subjectCodeableConcept CodeableConcept
.... subjectReference Reference(Group)
... date Σ 0..1 dateTime Date last changed
... publisher Σ 0..1 string Name of the publisher (organization or individual)
... contact Σ 0..* ContactDetail Contact details for the publisher
... description Σ 1..1 markdown 'Measure Description' in MADiE.
... useContext Σ 0..* UsageContext The context that the content is intended to support
... jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for measure (if applicable)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.
... purpose 0..1 markdown Why this measure is defined
... usage 0..1 string Describes the clinical usage of the measure
... copyright 0..1 markdown Use and/or publishing restrictions
... approvalDate 0..1 date When the measure was approved by publisher
... lastReviewDate 0..1 date When the measure was last reviewed
... effectivePeriod Σ 1..1 Period CMS dQMs must have an effective period.
... 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.
... author 1..1 ContactDetail 'Measure Developer' in MADiE.
... editor 0..* ContactDetail Who edited the content
... reviewer 0..* ContactDetail Who reviewed the content
... endorser 0..* ContactDetail Who endorsed the content
... relatedArtifact 0..* RelatedArtifact Additional documentation, citations, etc.
... library 1..1 canonical(CRMI Computable Library) Logic used by the measure
... disclaimer Σ 0..1 markdown Disclaimer for use of the measure or its referenced content
... scoring Σ 0..1 CodeableConcept proportion | ratio | continuous-variable | cohort
Binding: MeasureScoring (extensible): The scoring type of the measure.
... compositeScoring Σ 0..1 CodeableConcept opportunity | all-or-nothing | linear | weighted
Binding: CompositeMeasureScoring (extensible): The composite scoring method of the measure.
... type Σ 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).
... 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 Σ 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.
... definition Σ 0..* markdown Defined terms used in the measure documentation
... guidance Σ 0..1 markdown Additional guidance for implementers
... group 0..* BackboneElement Population criteria group
.... id 0..1 string Unique id for inter-element referencing
.... Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url
..... 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.
..... 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.
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code 0..1 CodeableConcept Meaning of the group
.... description 0..1 string Summary description
.... population 0..* BackboneElement Population criteria
..... 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.
..... description 0..1 string The human readable description of this population criteria
..... criteria 1..1 Expression The criteria that defines this population
.... stratifier 0..* BackboneElement Stratifier criteria for the measure
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 0..1 CodeableConcept Meaning of the stratifier
..... description 0..1 string The human readable description of this stratifier
..... criteria 0..1 Expression How the measure should be stratified
..... component 0..* BackboneElement Stratifier criteria component for the measure
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... code 0..1 CodeableConcept Meaning of the stratifier component
...... description 0..1 string The human readable description of this stratifier component
...... criteria 1..1 Expression Component of how the measure should be stratified
... supplementalData 0..* BackboneElement What other data should be reported with the measure
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code 0..1 CodeableConcept Meaning of the supplemental data
.... usage 0..* CodeableConcept supplemental-data | risk-adjustment-factor
Binding: MeasureDataUsage (extensible): The intended usage for supplemental data elements in the measure.
.... description 0..1 string The human readable description of this supplemental data
.... 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