Quality Measure Implementation Guide (STU5)
5.0.0-ballot2 - ballot United States of America flag

Quality Measure Implementation Guide (STU5), published by HL7 International / Clinical Quality Information. This guide is not an authorized publication; it is the continuous build for version 5.0.0-ballot2 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/cqf-measures/ and changes regularly. See the Directory of published versions

Resource Profile: CQFM Cohort Measure

Official URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cohort-measure-cqfm Version: 4.0.0
Active as of 2024-03-29 Computable Name: CQFMCohortMeasure

The CQFM Cohort Measure Profile describes a cohort scoring measure

Usage:

Formal Views of Profile Content

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

This structure is derived from CQFMComputableMeasure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Measure 0..*CQFMComputableMeasureA quality measure definition
... scoring S0..1CodeableConceptproportion | ratio | continuous-variable | cohort
Required Pattern: At least the following
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-scoring
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: cohort
... group S1..*BackboneElementPopulation criteria group
.... Slices for population S1..1BackboneElementPopulation criteria
Slice: Unordered, Open by value:code
..... population:initialPopulation S1..1BackboneElementInitial Population
...... code S1..1CodeableConceptinitial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
Required Pattern: At least the following
....... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
........ system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-population
........ code1..1codeSymbol in syntax defined by the system
Fixed Value: initial-population

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Measure SC0..*CQFMComputableMeasureA quality measure definition
mea-0: Name should be usable as an identifier for the module by machine processing applications such as code generation
mea-1: Stratifier SHALL be either a single criteria or a set of criteria components
cmp-1: Population basis must be specified at the root, or on each group
cmp-2: Scoring must be specified at the root, or on each group
cmp-3: Scoring unit may only be specified at the root if the scoring is also specified at the root
cmp-4: Improvement notation must be specified for scoring types other than cohort
cmp-5: If type is specified at the root, it may not be specified on any group
cmp-6: If riskAdjustment is specified at the root, it may not be specified on any group
cmp-7: If rateAggregation is specified at the root, it may not be specified on any group
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... populationBasis SC0..1codeWhat type of population
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis
Binding: FHIRAllTypes (required): The type of elements in the population


... scoringUnit SC0..1CodeableConceptWhat units?
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit
... scoringPrecision 0..1positiveIntNumber of decimal places
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringPrecision
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... status ?!Σ1..1codedraft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... subject[x] S0..1E.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.).

.... subjectCodeableConceptCodeableConcept
.... subjectReferenceReference(Group)
... library S0..*canonical(CRMI Computable Library)Logic used by the measure
... scoring SΣC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
Binding: MeasureScoring (extensible)
Required Pattern: At least the following
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-scoring
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: cohort
... type SΣC0..*CodeableConceptprocess | outcome | structure | patient-reported-outcome | composite
Binding: MeasureType (extensible): The type of measure (includes codes from 2.16.840.1.113883.1.11.20368).


... improvementNotation SΣC0..1CodeableConceptincrease | decrease
Binding: MeasureImprovementNotation (required)
... group SC1..*BackboneElementPopulation criteria group
cmp-8: Scoring unit may only be specified at the root if the scoring is also specified at the root
cmp-9: Improvement notation must be specified for scoring types other than cohort
.... populationBasis SC0..1codeWhat type of population
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis
Binding: FHIRAllTypes (required): The type of elements in the population


.... scoring SC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring
Binding: MeasureScoring (extensible): How the measure calculation is performed


.... scoringUnit SC0..1CodeableConceptWhat units?
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit
.... scoringPrecision 0..1positiveIntNumber of decimal places
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringPrecision
.... compositeScoring SC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-compositeScoring
Binding: CompositeMeasureScoring (extensible): How the composite measure calculation is performed


.... component SC0..*RelatedArtifactWhat artifact
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-component
.... type C0..*CodeableConceptprocess | outcome | structure | patient-reported-outcome
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-type
Binding: MeasureType (extensible): Indicates whether the measure is used to examine a process, an outcome over time, a patient-reported outcome, or a structure measure such as utilization.


.... riskAdjustment C0..1stringHow risk adjustment is applied for this measure
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-riskAdjustment
.... rateAggregation C0..1stringHow is rate aggregation performed for this measure
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-rateAggregation
.... improvementNotation SC0..1CodeableConceptincrease | decrease
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-improvementNotation
Binding: MeasureImprovementNotation (required): Indicates how to interpret the calculated score of the measure


.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... Slices for population SC1..1BackboneElementPopulation criteria
Slice: Unordered, Open by value:code
cmp-32: Computable measures must use text/cql-expression or text/cql-identifier for all criteria
..... population:All Slices Content/Rules for all slices
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... criteria 1..1ExpressionThe criteria that defines this population
..... population:initialPopulation SC1..1BackboneElementInitial Population
cmp-32: Computable measures must use text/cql-expression or text/cql-identifier for all criteria
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code S1..1CodeableConceptinitial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
Binding: MeasurePopulationType (extensible): The type of population.


Required Pattern: At least the following
....... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
........ system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-population
........ code1..1codeSymbol in syntax defined by the system
Fixed Value: initial-population
...... criteria 1..1ExpressionThe criteria that defines this population
.... stratifier SC0..*BackboneElementStratifier criteria for the measure
cmp-33: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier criteria
..... appliesTo 0..*CodeableConceptWhich population should this stratification apply to? If none is specified, the stratification applies to all populations in the group.
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-appliesTo
Binding: MeasurePopulationType (extensible): Indicates the population


..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... component SC0..*BackboneElementStratifier criteria component for the measure
cmp-34: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier component criteria
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... criteria 1..1ExpressionComponent of how the measure should be stratified
... supplementalData SC0..*BackboneElementWhat other data should be reported with the measure
cmp-35: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all supplemental data criteria
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... criteria 1..1ExpressionExpression describing additional data to be reported

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Measure.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
from the FHIR Standard
Measure.subject[x]extensibleSubjectType
http://hl7.org/fhir/ValueSet/subject-type
from the FHIR Standard
Measure.scoringextensiblePattern: cohort
http://terminology.hl7.org/ValueSet/measure-scoring
Measure.typeextensibleMeasureType
http://hl7.org/fhir/ValueSet/measure-type
from the FHIR Standard
Measure.improvementNotationrequiredMeasureImprovementNotation
http://terminology.hl7.org/ValueSet/measure-improvement-notation
Measure.group.population:initialPopulation.codeextensiblePattern: initial-population
http://hl7.org/fhir/ValueSet/measure-population
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
cmp-1errorMeasurePopulation basis must be specified at the root, or on each group
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis').exists() xor group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis').exists()).allTrue()
cmp-2errorMeasureScoring must be specified at the root, or on each group
: scoring.exists() xor group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists()).allTrue()
cmp-3errorMeasureScoring unit may only be specified at the root if the scoring is also specified at the root
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit').exists() implies scoring.exists()
cmp-4errorMeasureImprovement notation must be specified for scoring types other than cohort
: scoring.exists() and scoring in ('proportion' | 'ratio' | 'continuous-variable') implies improvementNotation.exists()
cmp-5errorMeasureIf type is specified at the root, it may not be specified on any group
: type.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-type').exists()).allFalse()
cmp-6errorMeasureIf riskAdjustment is specified at the root, it may not be specified on any group
: riskAdjustment.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-riskAdjustment').exists()).allFalse()
cmp-7errorMeasureIf rateAggregation is specified at the root, it may not be specified on any group
: rateAggregation.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-rateAggregation').exists()).allFalse()
cmp-8errorMeasure.groupScoring unit may only be specified at the root if the scoring is also specified at the root
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit').exists() implies extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists()
cmp-9errorMeasure.groupImprovement notation must be specified for scoring types other than cohort
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists() and extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').value in ('proportion' | 'ratio' | 'continuous-variable') implies extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-improvementNotation').exists()
cmp-32errorMeasure.group.population, Measure.group.population:initialPopulationComputable measures must use text/cql-expression or text/cql-identifier for all criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier')
cmp-33errorMeasure.group.stratifierComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
cmp-34errorMeasure.group.stratifier.componentComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier component criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
cmp-35errorMeasure.supplementalDataComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all supplemental data criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
dom-2errorMeasureIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMeasureIf 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-4errorMeasureIf 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-5errorMeasureIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMeasureA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
mea-0warningMeasureName 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-1errorMeasureStratifier SHALL be either a single criteria or a set of criteria components
: group.stratifier.all((code | description | criteria).exists() xor component.exists())
NameFlagsCard.TypeDescription & Constraintsdoco
.. Measure SC0..*CQFMComputableMeasureA quality measure definition
mea-0: Name should be usable as an identifier for the module by machine processing applications such as code generation
mea-1: Stratifier SHALL be either a single criteria or a set of criteria components
cmp-1: Population basis must be specified at the root, or on each group
cmp-2: Scoring must be specified at the root, or on each group
cmp-3: Scoring unit may only be specified at the root if the scoring is also specified at the root
cmp-4: Improvement notation must be specified for scoring types other than cohort
cmp-5: If type is specified at the root, it may not be specified on any group
cmp-6: If riskAdjustment is specified at the root, it may not be specified on any group
cmp-7: If rateAggregation is specified at the root, it may not be specified on any group
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... populationBasis SC0..1codeWhat type of population
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis
Binding: FHIRAllTypes (required): The type of elements in the population


... scoringUnit SC0..1CodeableConceptWhat units?
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit
... effectiveDataRequirements S0..1canonical(CRMI Module Definition Library)Effective required data for evaluation
URL: http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-effectiveDataRequirements
... scoringPrecision 0..1positiveIntNumber of decimal places
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringPrecision
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url Σ0..1uriCanonical identifier for this measure, represented as a URI (globally unique)
... identifier Σ0..*IdentifierAdditional identifier for the measure
... version Σ0..1stringBusiness version of the measure
... name ΣC0..1stringName for this measure (computer friendly)
... title Σ0..1stringName for this measure (human friendly)
... subtitle 0..1stringSubordinate title of the measure
... status ?!Σ1..1codedraft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental Σ0..1booleanFor testing purposes, not real usage
... subject[x] S0..1E.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.).

.... subjectCodeableConceptCodeableConcept
.... subjectReferenceReference(Group)
... date Σ0..1dateTimeDate last changed
... publisher Σ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... description Σ0..1markdownNatural language description of the measure
... useContext Σ0..*UsageContextThe context that the content is intended to support
... jurisdiction Σ0..*CodeableConceptIntended jurisdiction for measure (if applicable)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.


... purpose 0..1markdownWhy this measure is defined
... usage 0..1stringDescribes the clinical usage of the measure
... copyright 0..1markdownUse and/or publishing restrictions
... approvalDate 0..1dateWhen the measure was approved by publisher
... lastReviewDate 0..1dateWhen the measure was last reviewed
... effectivePeriod Σ0..1PeriodWhen the measure is expected to be used
... topic 0..*CodeableConceptThe 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 0..*ContactDetailWho authored the content
... editor 0..*ContactDetailWho edited the content
... reviewer 0..*ContactDetailWho reviewed the content
... endorser 0..*ContactDetailWho endorsed the content
... relatedArtifact 0..*RelatedArtifactAdditional documentation, citations, etc.
... library S0..*canonical(CRMI Computable Library)Logic used by the measure
... disclaimer Σ0..1markdownDisclaimer for use of the measure or its referenced content
... scoring SΣC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
Binding: MeasureScoring (extensible)
Required Pattern: At least the following
.... id0..1stringUnique id for inter-element referencing
.... extension0..*ExtensionAdditional content defined by implementations
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... id0..1stringUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-scoring
..... version0..1stringVersion of the system - if relevant
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: cohort
..... display0..1stringRepresentation defined by the system
..... userSelected0..1booleanIf this coding was chosen directly by the user
.... text0..1stringPlain text representation of the concept
... compositeScoring Σ0..1CodeableConceptopportunity | all-or-nothing | linear | weighted
Binding: CompositeMeasureScoring (extensible): The composite scoring method of the measure.

... type SΣC0..*CodeableConceptprocess | 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 ΣC0..1stringHow risk adjustment is applied for this measure
... rateAggregation ΣC0..1stringHow is rate aggregation performed for this measure
... rationale Σ0..1markdownDetailed description of why the measure exists
... clinicalRecommendationStatement Σ0..1markdownSummary of clinical guidelines
... improvementNotation SΣC0..1CodeableConceptincrease | decrease
Binding: MeasureImprovementNotation (required)
... definition Σ0..*markdownDefined terms used in the measure documentation
... guidance Σ0..1markdownAdditional guidance for implementers
... group SC1..*BackboneElementPopulation criteria group
cmp-8: Scoring unit may only be specified at the root if the scoring is also specified at the root
cmp-9: Improvement notation must be specified for scoring types other than cohort
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... populationBasis SC0..1codeWhat type of population
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis
Binding: FHIRAllTypes (required): The type of elements in the population


.... scoring SC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring
Binding: MeasureScoring (extensible): How the measure calculation is performed


.... scoringUnit SC0..1CodeableConceptWhat units?
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit
.... scoringPrecision 0..1positiveIntNumber of decimal places
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringPrecision
.... compositeScoring SC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-compositeScoring
Binding: CompositeMeasureScoring (extensible): How the composite measure calculation is performed


.... component SC0..*RelatedArtifactWhat artifact
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-component
.... type C0..*CodeableConceptprocess | outcome | structure | patient-reported-outcome
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-type
Binding: MeasureType (extensible): Indicates whether the measure is used to examine a process, an outcome over time, a patient-reported outcome, or a structure measure such as utilization.


.... riskAdjustment C0..1stringHow risk adjustment is applied for this measure
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-riskAdjustment
.... rateAggregation C0..1stringHow is rate aggregation performed for this measure
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-rateAggregation
.... improvementNotation SC0..1CodeableConceptincrease | decrease
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-improvementNotation
Binding: MeasureImprovementNotation (required): Indicates how to interpret the calculated score of the measure


.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code 0..1CodeableConceptMeaning of the group
.... description 0..1stringSummary description
.... Slices for population SC1..1BackboneElementPopulation criteria
Slice: Unordered, Open by value:code
cmp-32: Computable measures must use text/cql-expression or text/cql-identifier for all criteria
..... population:All Slices Content/Rules for all slices
...... id 0..1stringUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code 0..1CodeableConceptinitial-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..1stringThe human readable description of this population criteria
...... criteria 1..1ExpressionThe criteria that defines this population
..... population:initialPopulation SC1..1BackboneElementInitial Population
cmp-32: Computable measures must use text/cql-expression or text/cql-identifier for all criteria
...... id 0..1stringUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code S1..1CodeableConceptinitial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
Binding: MeasurePopulationType (extensible): The type of population.


Required Pattern: At least the following
....... id0..1stringUnique id for inter-element referencing
....... extension0..*ExtensionAdditional content defined by implementations
....... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
........ id0..1stringUnique id for inter-element referencing
........ extension0..*ExtensionAdditional content defined by implementations
........ system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-population
........ version0..1stringVersion of the system - if relevant
........ code1..1codeSymbol in syntax defined by the system
Fixed Value: initial-population
........ display0..1stringRepresentation defined by the system
........ userSelected0..1booleanIf this coding was chosen directly by the user
....... text0..1stringPlain text representation of the concept
...... description 0..1stringThe human readable description of this population criteria
...... criteria 1..1ExpressionThe criteria that defines this population
.... stratifier SC0..*BackboneElementStratifier criteria for the measure
cmp-33: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier criteria
..... id 0..1stringUnique id for inter-element referencing
..... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
..... appliesTo 0..*CodeableConceptWhich population should this stratification apply to? If none is specified, the stratification applies to all populations in the group.
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-appliesTo
Binding: MeasurePopulationType (extensible): Indicates the population


..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code 0..1CodeableConceptMeaning of the stratifier
..... description 0..1stringThe human readable description of this stratifier
..... criteria 0..1ExpressionHow the measure should be stratified
..... component SC0..*BackboneElementStratifier criteria component for the measure
cmp-34: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier component criteria
...... id 0..1stringUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code 0..1CodeableConceptMeaning of the stratifier component
...... description 0..1stringThe human readable description of this stratifier component
...... criteria 1..1ExpressionComponent of how the measure should be stratified
... supplementalData SC0..*BackboneElementWhat other data should be reported with the measure
cmp-35: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all supplemental data criteria
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code 0..1CodeableConceptMeaning of the supplemental data
.... usage 0..*CodeableConceptsupplemental-data | risk-adjustment-factor
Binding: MeasureDataUsage (extensible): The intended usage for supplemental data elements in the measure.


.... description 0..1stringThe human readable description of this supplemental data
.... criteria 1..1ExpressionExpression describing additional data to be reported

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Measure.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
Measure.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
from the FHIR Standard
Measure.subject[x]extensibleSubjectType
http://hl7.org/fhir/ValueSet/subject-type
from the FHIR Standard
Measure.jurisdictionextensibleJurisdiction ValueSet
http://hl7.org/fhir/ValueSet/jurisdiction
from the FHIR Standard
Measure.topicexampleDefinitionTopic
http://hl7.org/fhir/ValueSet/definition-topic
from the FHIR Standard
Measure.scoringextensiblePattern: cohort
http://terminology.hl7.org/ValueSet/measure-scoring
Measure.compositeScoringextensibleCompositeMeasureScoring
http://hl7.org/fhir/ValueSet/composite-measure-scoring
from the FHIR Standard
Measure.typeextensibleMeasureType
http://hl7.org/fhir/ValueSet/measure-type
from the FHIR Standard
Measure.improvementNotationrequiredMeasureImprovementNotation
http://terminology.hl7.org/ValueSet/measure-improvement-notation
Measure.group.population.codeextensibleMeasurePopulationType
http://hl7.org/fhir/ValueSet/measure-population
from the FHIR Standard
Measure.group.population:initialPopulation.codeextensiblePattern: initial-population
http://hl7.org/fhir/ValueSet/measure-population
from the FHIR Standard
Measure.supplementalData.usageextensibleMeasureDataUsage
http://hl7.org/fhir/ValueSet/measure-data-usage
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
cmp-1errorMeasurePopulation basis must be specified at the root, or on each group
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis').exists() xor group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis').exists()).allTrue()
cmp-2errorMeasureScoring must be specified at the root, or on each group
: scoring.exists() xor group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists()).allTrue()
cmp-3errorMeasureScoring unit may only be specified at the root if the scoring is also specified at the root
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit').exists() implies scoring.exists()
cmp-4errorMeasureImprovement notation must be specified for scoring types other than cohort
: scoring.exists() and scoring in ('proportion' | 'ratio' | 'continuous-variable') implies improvementNotation.exists()
cmp-5errorMeasureIf type is specified at the root, it may not be specified on any group
: type.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-type').exists()).allFalse()
cmp-6errorMeasureIf riskAdjustment is specified at the root, it may not be specified on any group
: riskAdjustment.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-riskAdjustment').exists()).allFalse()
cmp-7errorMeasureIf rateAggregation is specified at the root, it may not be specified on any group
: rateAggregation.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-rateAggregation').exists()).allFalse()
cmp-8errorMeasure.groupScoring unit may only be specified at the root if the scoring is also specified at the root
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit').exists() implies extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists()
cmp-9errorMeasure.groupImprovement notation must be specified for scoring types other than cohort
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists() and extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').value in ('proportion' | 'ratio' | 'continuous-variable') implies extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-improvementNotation').exists()
cmp-32errorMeasure.group.population, Measure.group.population:initialPopulationComputable measures must use text/cql-expression or text/cql-identifier for all criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier')
cmp-33errorMeasure.group.stratifierComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
cmp-34errorMeasure.group.stratifier.componentComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier component criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
cmp-35errorMeasure.supplementalDataComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all supplemental data criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
dom-2errorMeasureIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMeasureIf 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-4errorMeasureIf 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-5errorMeasureIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMeasureA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
mea-0warningMeasureName 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-1errorMeasureStratifier 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 CQFMComputableMeasure

Summary

Mandatory: 4 elements
Must-Support: 5 elements

Slices

This structure defines the following Slices:

  • The element Measure.group.population is sliced based on the value of value:code

Differential View

This structure is derived from CQFMComputableMeasure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Measure 0..*CQFMComputableMeasureA quality measure definition
... scoring S0..1CodeableConceptproportion | ratio | continuous-variable | cohort
Required Pattern: At least the following
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-scoring
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: cohort
... group S1..*BackboneElementPopulation criteria group
.... Slices for population S1..1BackboneElementPopulation criteria
Slice: Unordered, Open by value:code
..... population:initialPopulation S1..1BackboneElementInitial Population
...... code S1..1CodeableConceptinitial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
Required Pattern: At least the following
....... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
........ system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-population
........ code1..1codeSymbol in syntax defined by the system
Fixed Value: initial-population

doco Documentation for this format

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Measure SC0..*CQFMComputableMeasureA quality measure definition
mea-0: Name should be usable as an identifier for the module by machine processing applications such as code generation
mea-1: Stratifier SHALL be either a single criteria or a set of criteria components
cmp-1: Population basis must be specified at the root, or on each group
cmp-2: Scoring must be specified at the root, or on each group
cmp-3: Scoring unit may only be specified at the root if the scoring is also specified at the root
cmp-4: Improvement notation must be specified for scoring types other than cohort
cmp-5: If type is specified at the root, it may not be specified on any group
cmp-6: If riskAdjustment is specified at the root, it may not be specified on any group
cmp-7: If rateAggregation is specified at the root, it may not be specified on any group
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... populationBasis SC0..1codeWhat type of population
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis
Binding: FHIRAllTypes (required): The type of elements in the population


... scoringUnit SC0..1CodeableConceptWhat units?
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit
... scoringPrecision 0..1positiveIntNumber of decimal places
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringPrecision
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... status ?!Σ1..1codedraft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... subject[x] S0..1E.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.).

.... subjectCodeableConceptCodeableConcept
.... subjectReferenceReference(Group)
... library S0..*canonical(CRMI Computable Library)Logic used by the measure
... scoring SΣC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
Binding: MeasureScoring (extensible)
Required Pattern: At least the following
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-scoring
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: cohort
... type SΣC0..*CodeableConceptprocess | outcome | structure | patient-reported-outcome | composite
Binding: MeasureType (extensible): The type of measure (includes codes from 2.16.840.1.113883.1.11.20368).


... improvementNotation SΣC0..1CodeableConceptincrease | decrease
Binding: MeasureImprovementNotation (required)
... group SC1..*BackboneElementPopulation criteria group
cmp-8: Scoring unit may only be specified at the root if the scoring is also specified at the root
cmp-9: Improvement notation must be specified for scoring types other than cohort
.... populationBasis SC0..1codeWhat type of population
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis
Binding: FHIRAllTypes (required): The type of elements in the population


.... scoring SC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring
Binding: MeasureScoring (extensible): How the measure calculation is performed


.... scoringUnit SC0..1CodeableConceptWhat units?
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit
.... scoringPrecision 0..1positiveIntNumber of decimal places
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringPrecision
.... compositeScoring SC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-compositeScoring
Binding: CompositeMeasureScoring (extensible): How the composite measure calculation is performed


.... component SC0..*RelatedArtifactWhat artifact
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-component
.... type C0..*CodeableConceptprocess | outcome | structure | patient-reported-outcome
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-type
Binding: MeasureType (extensible): Indicates whether the measure is used to examine a process, an outcome over time, a patient-reported outcome, or a structure measure such as utilization.


.... riskAdjustment C0..1stringHow risk adjustment is applied for this measure
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-riskAdjustment
.... rateAggregation C0..1stringHow is rate aggregation performed for this measure
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-rateAggregation
.... improvementNotation SC0..1CodeableConceptincrease | decrease
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-improvementNotation
Binding: MeasureImprovementNotation (required): Indicates how to interpret the calculated score of the measure


.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... Slices for population SC1..1BackboneElementPopulation criteria
Slice: Unordered, Open by value:code
cmp-32: Computable measures must use text/cql-expression or text/cql-identifier for all criteria
..... population:All Slices Content/Rules for all slices
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... criteria 1..1ExpressionThe criteria that defines this population
..... population:initialPopulation SC1..1BackboneElementInitial Population
cmp-32: Computable measures must use text/cql-expression or text/cql-identifier for all criteria
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code S1..1CodeableConceptinitial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
Binding: MeasurePopulationType (extensible): The type of population.


Required Pattern: At least the following
....... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
........ system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-population
........ code1..1codeSymbol in syntax defined by the system
Fixed Value: initial-population
...... criteria 1..1ExpressionThe criteria that defines this population
.... stratifier SC0..*BackboneElementStratifier criteria for the measure
cmp-33: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier criteria
..... appliesTo 0..*CodeableConceptWhich population should this stratification apply to? If none is specified, the stratification applies to all populations in the group.
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-appliesTo
Binding: MeasurePopulationType (extensible): Indicates the population


..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... component SC0..*BackboneElementStratifier criteria component for the measure
cmp-34: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier component criteria
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... criteria 1..1ExpressionComponent of how the measure should be stratified
... supplementalData SC0..*BackboneElementWhat other data should be reported with the measure
cmp-35: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all supplemental data criteria
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... criteria 1..1ExpressionExpression describing additional data to be reported

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Measure.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
from the FHIR Standard
Measure.subject[x]extensibleSubjectType
http://hl7.org/fhir/ValueSet/subject-type
from the FHIR Standard
Measure.scoringextensiblePattern: cohort
http://terminology.hl7.org/ValueSet/measure-scoring
Measure.typeextensibleMeasureType
http://hl7.org/fhir/ValueSet/measure-type
from the FHIR Standard
Measure.improvementNotationrequiredMeasureImprovementNotation
http://terminology.hl7.org/ValueSet/measure-improvement-notation
Measure.group.population:initialPopulation.codeextensiblePattern: initial-population
http://hl7.org/fhir/ValueSet/measure-population
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
cmp-1errorMeasurePopulation basis must be specified at the root, or on each group
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis').exists() xor group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis').exists()).allTrue()
cmp-2errorMeasureScoring must be specified at the root, or on each group
: scoring.exists() xor group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists()).allTrue()
cmp-3errorMeasureScoring unit may only be specified at the root if the scoring is also specified at the root
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit').exists() implies scoring.exists()
cmp-4errorMeasureImprovement notation must be specified for scoring types other than cohort
: scoring.exists() and scoring in ('proportion' | 'ratio' | 'continuous-variable') implies improvementNotation.exists()
cmp-5errorMeasureIf type is specified at the root, it may not be specified on any group
: type.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-type').exists()).allFalse()
cmp-6errorMeasureIf riskAdjustment is specified at the root, it may not be specified on any group
: riskAdjustment.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-riskAdjustment').exists()).allFalse()
cmp-7errorMeasureIf rateAggregation is specified at the root, it may not be specified on any group
: rateAggregation.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-rateAggregation').exists()).allFalse()
cmp-8errorMeasure.groupScoring unit may only be specified at the root if the scoring is also specified at the root
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit').exists() implies extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists()
cmp-9errorMeasure.groupImprovement notation must be specified for scoring types other than cohort
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists() and extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').value in ('proportion' | 'ratio' | 'continuous-variable') implies extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-improvementNotation').exists()
cmp-32errorMeasure.group.population, Measure.group.population:initialPopulationComputable measures must use text/cql-expression or text/cql-identifier for all criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier')
cmp-33errorMeasure.group.stratifierComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
cmp-34errorMeasure.group.stratifier.componentComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier component criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
cmp-35errorMeasure.supplementalDataComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all supplemental data criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
dom-2errorMeasureIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMeasureIf 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-4errorMeasureIf 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-5errorMeasureIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMeasureA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
mea-0warningMeasureName 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-1errorMeasureStratifier 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 & Constraintsdoco
.. Measure SC0..*CQFMComputableMeasureA quality measure definition
mea-0: Name should be usable as an identifier for the module by machine processing applications such as code generation
mea-1: Stratifier SHALL be either a single criteria or a set of criteria components
cmp-1: Population basis must be specified at the root, or on each group
cmp-2: Scoring must be specified at the root, or on each group
cmp-3: Scoring unit may only be specified at the root if the scoring is also specified at the root
cmp-4: Improvement notation must be specified for scoring types other than cohort
cmp-5: If type is specified at the root, it may not be specified on any group
cmp-6: If riskAdjustment is specified at the root, it may not be specified on any group
cmp-7: If rateAggregation is specified at the root, it may not be specified on any group
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... populationBasis SC0..1codeWhat type of population
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis
Binding: FHIRAllTypes (required): The type of elements in the population


... scoringUnit SC0..1CodeableConceptWhat units?
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit
... effectiveDataRequirements S0..1canonical(CRMI Module Definition Library)Effective required data for evaluation
URL: http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-effectiveDataRequirements
... scoringPrecision 0..1positiveIntNumber of decimal places
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringPrecision
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url Σ0..1uriCanonical identifier for this measure, represented as a URI (globally unique)
... identifier Σ0..*IdentifierAdditional identifier for the measure
... version Σ0..1stringBusiness version of the measure
... name ΣC0..1stringName for this measure (computer friendly)
... title Σ0..1stringName for this measure (human friendly)
... subtitle 0..1stringSubordinate title of the measure
... status ?!Σ1..1codedraft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental Σ0..1booleanFor testing purposes, not real usage
... subject[x] S0..1E.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.).

.... subjectCodeableConceptCodeableConcept
.... subjectReferenceReference(Group)
... date Σ0..1dateTimeDate last changed
... publisher Σ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... description Σ0..1markdownNatural language description of the measure
... useContext Σ0..*UsageContextThe context that the content is intended to support
... jurisdiction Σ0..*CodeableConceptIntended jurisdiction for measure (if applicable)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.


... purpose 0..1markdownWhy this measure is defined
... usage 0..1stringDescribes the clinical usage of the measure
... copyright 0..1markdownUse and/or publishing restrictions
... approvalDate 0..1dateWhen the measure was approved by publisher
... lastReviewDate 0..1dateWhen the measure was last reviewed
... effectivePeriod Σ0..1PeriodWhen the measure is expected to be used
... topic 0..*CodeableConceptThe 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 0..*ContactDetailWho authored the content
... editor 0..*ContactDetailWho edited the content
... reviewer 0..*ContactDetailWho reviewed the content
... endorser 0..*ContactDetailWho endorsed the content
... relatedArtifact 0..*RelatedArtifactAdditional documentation, citations, etc.
... library S0..*canonical(CRMI Computable Library)Logic used by the measure
... disclaimer Σ0..1markdownDisclaimer for use of the measure or its referenced content
... scoring SΣC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
Binding: MeasureScoring (extensible)
Required Pattern: At least the following
.... id0..1stringUnique id for inter-element referencing
.... extension0..*ExtensionAdditional content defined by implementations
.... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
..... id0..1stringUnique id for inter-element referencing
..... extension0..*ExtensionAdditional content defined by implementations
..... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-scoring
..... version0..1stringVersion of the system - if relevant
..... code1..1codeSymbol in syntax defined by the system
Fixed Value: cohort
..... display0..1stringRepresentation defined by the system
..... userSelected0..1booleanIf this coding was chosen directly by the user
.... text0..1stringPlain text representation of the concept
... compositeScoring Σ0..1CodeableConceptopportunity | all-or-nothing | linear | weighted
Binding: CompositeMeasureScoring (extensible): The composite scoring method of the measure.

... type SΣC0..*CodeableConceptprocess | 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 ΣC0..1stringHow risk adjustment is applied for this measure
... rateAggregation ΣC0..1stringHow is rate aggregation performed for this measure
... rationale Σ0..1markdownDetailed description of why the measure exists
... clinicalRecommendationStatement Σ0..1markdownSummary of clinical guidelines
... improvementNotation SΣC0..1CodeableConceptincrease | decrease
Binding: MeasureImprovementNotation (required)
... definition Σ0..*markdownDefined terms used in the measure documentation
... guidance Σ0..1markdownAdditional guidance for implementers
... group SC1..*BackboneElementPopulation criteria group
cmp-8: Scoring unit may only be specified at the root if the scoring is also specified at the root
cmp-9: Improvement notation must be specified for scoring types other than cohort
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... populationBasis SC0..1codeWhat type of population
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis
Binding: FHIRAllTypes (required): The type of elements in the population


.... scoring SC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring
Binding: MeasureScoring (extensible): How the measure calculation is performed


.... scoringUnit SC0..1CodeableConceptWhat units?
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit
.... scoringPrecision 0..1positiveIntNumber of decimal places
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringPrecision
.... compositeScoring SC0..1CodeableConceptproportion | ratio | continuous-variable | cohort
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-compositeScoring
Binding: CompositeMeasureScoring (extensible): How the composite measure calculation is performed


.... component SC0..*RelatedArtifactWhat artifact
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-component
.... type C0..*CodeableConceptprocess | outcome | structure | patient-reported-outcome
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-type
Binding: MeasureType (extensible): Indicates whether the measure is used to examine a process, an outcome over time, a patient-reported outcome, or a structure measure such as utilization.


.... riskAdjustment C0..1stringHow risk adjustment is applied for this measure
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-riskAdjustment
.... rateAggregation C0..1stringHow is rate aggregation performed for this measure
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-rateAggregation
.... improvementNotation SC0..1CodeableConceptincrease | decrease
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-improvementNotation
Binding: MeasureImprovementNotation (required): Indicates how to interpret the calculated score of the measure


.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code 0..1CodeableConceptMeaning of the group
.... description 0..1stringSummary description
.... Slices for population SC1..1BackboneElementPopulation criteria
Slice: Unordered, Open by value:code
cmp-32: Computable measures must use text/cql-expression or text/cql-identifier for all criteria
..... population:All Slices Content/Rules for all slices
...... id 0..1stringUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code 0..1CodeableConceptinitial-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..1stringThe human readable description of this population criteria
...... criteria 1..1ExpressionThe criteria that defines this population
..... population:initialPopulation SC1..1BackboneElementInitial Population
cmp-32: Computable measures must use text/cql-expression or text/cql-identifier for all criteria
...... id 0..1stringUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code S1..1CodeableConceptinitial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
Binding: MeasurePopulationType (extensible): The type of population.


Required Pattern: At least the following
....... id0..1stringUnique id for inter-element referencing
....... extension0..*ExtensionAdditional content defined by implementations
....... coding1..*CodingCode defined by a terminology system
Fixed Value: (complex)
........ id0..1stringUnique id for inter-element referencing
........ extension0..*ExtensionAdditional content defined by implementations
........ system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/measure-population
........ version0..1stringVersion of the system - if relevant
........ code1..1codeSymbol in syntax defined by the system
Fixed Value: initial-population
........ display0..1stringRepresentation defined by the system
........ userSelected0..1booleanIf this coding was chosen directly by the user
....... text0..1stringPlain text representation of the concept
...... description 0..1stringThe human readable description of this population criteria
...... criteria 1..1ExpressionThe criteria that defines this population
.... stratifier SC0..*BackboneElementStratifier criteria for the measure
cmp-33: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier criteria
..... id 0..1stringUnique id for inter-element referencing
..... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
..... appliesTo 0..*CodeableConceptWhich population should this stratification apply to? If none is specified, the stratification applies to all populations in the group.
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-appliesTo
Binding: MeasurePopulationType (extensible): Indicates the population


..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code 0..1CodeableConceptMeaning of the stratifier
..... description 0..1stringThe human readable description of this stratifier
..... criteria 0..1ExpressionHow the measure should be stratified
..... component SC0..*BackboneElementStratifier criteria component for the measure
cmp-34: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier component criteria
...... id 0..1stringUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code 0..1CodeableConceptMeaning of the stratifier component
...... description 0..1stringThe human readable description of this stratifier component
...... criteria 1..1ExpressionComponent of how the measure should be stratified
... supplementalData SC0..*BackboneElementWhat other data should be reported with the measure
cmp-35: Computable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all supplemental data criteria
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code 0..1CodeableConceptMeaning of the supplemental data
.... usage 0..*CodeableConceptsupplemental-data | risk-adjustment-factor
Binding: MeasureDataUsage (extensible): The intended usage for supplemental data elements in the measure.


.... description 0..1stringThe human readable description of this supplemental data
.... criteria 1..1ExpressionExpression describing additional data to be reported

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Measure.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
Measure.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
from the FHIR Standard
Measure.subject[x]extensibleSubjectType
http://hl7.org/fhir/ValueSet/subject-type
from the FHIR Standard
Measure.jurisdictionextensibleJurisdiction ValueSet
http://hl7.org/fhir/ValueSet/jurisdiction
from the FHIR Standard
Measure.topicexampleDefinitionTopic
http://hl7.org/fhir/ValueSet/definition-topic
from the FHIR Standard
Measure.scoringextensiblePattern: cohort
http://terminology.hl7.org/ValueSet/measure-scoring
Measure.compositeScoringextensibleCompositeMeasureScoring
http://hl7.org/fhir/ValueSet/composite-measure-scoring
from the FHIR Standard
Measure.typeextensibleMeasureType
http://hl7.org/fhir/ValueSet/measure-type
from the FHIR Standard
Measure.improvementNotationrequiredMeasureImprovementNotation
http://terminology.hl7.org/ValueSet/measure-improvement-notation
Measure.group.population.codeextensibleMeasurePopulationType
http://hl7.org/fhir/ValueSet/measure-population
from the FHIR Standard
Measure.group.population:initialPopulation.codeextensiblePattern: initial-population
http://hl7.org/fhir/ValueSet/measure-population
from the FHIR Standard
Measure.supplementalData.usageextensibleMeasureDataUsage
http://hl7.org/fhir/ValueSet/measure-data-usage
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
cmp-1errorMeasurePopulation basis must be specified at the root, or on each group
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis').exists() xor group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-populationBasis').exists()).allTrue()
cmp-2errorMeasureScoring must be specified at the root, or on each group
: scoring.exists() xor group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists()).allTrue()
cmp-3errorMeasureScoring unit may only be specified at the root if the scoring is also specified at the root
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit').exists() implies scoring.exists()
cmp-4errorMeasureImprovement notation must be specified for scoring types other than cohort
: scoring.exists() and scoring in ('proportion' | 'ratio' | 'continuous-variable') implies improvementNotation.exists()
cmp-5errorMeasureIf type is specified at the root, it may not be specified on any group
: type.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-type').exists()).allFalse()
cmp-6errorMeasureIf riskAdjustment is specified at the root, it may not be specified on any group
: riskAdjustment.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-riskAdjustment').exists()).allFalse()
cmp-7errorMeasureIf rateAggregation is specified at the root, it may not be specified on any group
: rateAggregation.exists() implies group.select(extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-rateAggregation').exists()).allFalse()
cmp-8errorMeasure.groupScoring unit may only be specified at the root if the scoring is also specified at the root
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoringUnit').exists() implies extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists()
cmp-9errorMeasure.groupImprovement notation must be specified for scoring types other than cohort
: extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').exists() and extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-scoring').value in ('proportion' | 'ratio' | 'continuous-variable') implies extension('http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-improvementNotation').exists()
cmp-32errorMeasure.group.population, Measure.group.population:initialPopulationComputable measures must use text/cql-expression or text/cql-identifier for all criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier')
cmp-33errorMeasure.group.stratifierComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
cmp-34errorMeasure.group.stratifier.componentComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all stratifier component criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
cmp-35errorMeasure.supplementalDataComputable measures must use text/cql-expression, text/cql-identifier, or text/fhirpath for all supplemental data criteria
: criteria.language in ('text/cql-expression' | 'text/cql-identifier' | 'text/fhirpath')
dom-2errorMeasureIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMeasureIf 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-4errorMeasureIf 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-5errorMeasureIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMeasureA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
mea-0warningMeasureName 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-1errorMeasureStratifier 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 CQFMComputableMeasure

Summary

Mandatory: 4 elements
Must-Support: 5 elements

Slices

This structure defines the following Slices:

  • The element Measure.group.population is sliced based on the value of value:code

 

Other representations of profile: CSV, Excel, Schematron