Mobile Aggregate Data Exchange
3.0.0 - trial-use International flag

Mobile Aggregate Data Exchange, published by IHE QRPH Technical Committee. This guide is not an authorized publication; it is the continuous build for version 3.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IHE/QRPH.mADX/ and changes regularly. See the Directory of published versions

Resource Profile: IHE mADX Measure profile

Official URL: https://profiles.ihe.net/QRPH/mADX/StructureDefinition/mADX-Measure Version: 3.0.0
Active as of 2025-08-21 Computable Name: IHEmADXMeasure

IHE mADX profile based on HL7 FHIR Measure R4

Usages:

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 CRMIShareableMeasure

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure 1..1 CRMIShareableMeasure A quality measure definition
... Slices for subject[x] 1..1 CodeableConcept E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Slice: Unordered, Open by type:$this
.... subject[x]:subjectCodeableConcept 1..1 CodeableConcept Indicates the base resource in which the indicator is intended to run
..... coding
...... code 1..1 code Symbol in syntax defined by the system
... publisher 1..1 string Name of the publisher (organization or individual)
... relatedArtifact S 0..* RelatedArtifact There should be a related artifact for each dissagregation set defined under group[].stratifier[].component[].code
.... type S 1..1 code Should be set to 'depends-on' when referencing a disaggregating value set
.... label S 0..1 string The label should match one of the values of group[].stratifier[].component[].code for a disaggregation value set
.... url S 0..1 url The URL of a FHIR value set that defines the valid values reported in this disaggregation criterion as cross-referenced by relatedArtifact[].label
... improvementNotation S 0..1 CodeableConcept The change in measured values that is indicative of an improvement for the indicator
... group 1..* BackboneElement There should be a group element for each indicator that can be calculated in the Measure. Each group member should have a unique code defined, relative to the Measure
.... code 1..1 CodeableConcept The code should be a unique code distinguishing the indicator within the Measure
..... coding 1..* Coding Code defined by a terminology system
.... description 1..1 string A narrative description of an indicator
.... population 1..* BackboneElement Population criteria
..... code 1..1 CodeableConcept A required population code for a valid indicator.
.... stratifier S 0..* BackboneElement Contains the disaggregating value sets needed for an indicator
..... component S 0..* BackboneElement There should be a 'component' for each set of disaggregators which is linked to a FHIR value set
...... code S 0..1 CodeableConcept There should be a code used to reference this disaggregating valueset. There must be a relatedArtifact for each disaggregation set which is a reference to a FHIR value set. The relatedArtifact.type should be set to 'depends-on'

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure C 1..1 CRMIShareableMeasure A quality measure definition
Constraints: mea-0, mea-1
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension Content/Rules for all slices
.... extension:knowledgeCapability S 0..* code shareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapability (required)
.... extension:artifactComment S 0..* (Complex) Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
.... extension:versionAlgorithm S 0..1 Coding How to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: version-algorithm (??) (extensible)
.... extension:versionPolicy S 0..1 CodeableConcept metadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url SΣ 1..1 uri Canonical identifier for this measure, represented as a URI (globally unique)
... version SΣ 1..1 string Business version of the measure
... name SΣC 0..1 string Name for this measure (computer friendly)
... title SΣ 1..1 string Name for this measure (human friendly)
... status ?!SΣ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... experimental SΣ 0..1 boolean For testing purposes, not real usage
... Slices for subject[x] 1..1 CodeableConcept E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Slice: Unordered, Closed by type:$this
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
.... subject[x]:subjectCodeableConcept 1..1 CodeableConcept Indicates the base resource in which the indicator is intended to run
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
... publisher SΣ 1..1 string Name of the publisher (organization or individual)
... description SΣ 1..1 markdown Natural language description of the measure
... relatedArtifact S 0..* RelatedArtifact There should be a related artifact for each dissagregation set defined under group[].stratifier[].component[].code
.... type SΣ 1..1 code Should be set to 'depends-on' when referencing a disaggregating value set
Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
.... label SΣ 0..1 string The label should match one of the values of group[].stratifier[].component[].code for a disaggregation value set
.... url SΣ 0..1 url The URL of a FHIR value set that defines the valid values reported in this disaggregation criterion as cross-referenced by relatedArtifact[].label
... improvementNotation SΣ 0..1 CodeableConcept The change in measured values that is indicative of an improvement for the indicator
Binding: MeasureImprovementNotation (required): Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue.
... group 1..* BackboneElement There should be a group element for each indicator that can be calculated in the Measure. Each group member should have a unique code defined, relative to the Measure
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code 1..1 CodeableConcept The code should be a unique code distinguishing the indicator within the Measure
..... coding Σ 1..* Coding Code defined by a terminology system
.... description 1..1 string A narrative description of an indicator
.... population 1..* BackboneElement Population criteria
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 1..1 CodeableConcept A required population code for a valid indicator.
Binding: MeasurePopulationType (extensible): The type of population.
..... criteria 1..1 Expression The criteria that defines this population
.... stratifier S 0..* BackboneElement Contains the disaggregating value sets needed for an indicator
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... component S 0..* BackboneElement There should be a 'component' for each set of disaggregators which is linked to a FHIR value set
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... code S 0..1 CodeableConcept There should be a code used to reference this disaggregating valueset. There must be a relatedArtifact for each disaggregation set which is a reference to a FHIR value set. The relatedArtifact.type should be set to 'depends-on'
...... criteria 1..1 Expression Component of how the measure should be stratified

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
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.subject[x]:subjectCodeableConceptextensibleSubjectType
http://hl7.org/fhir/ValueSet/subject-type
From the FHIR Standard
Measure.relatedArtifact.typerequiredRelatedArtifactType
http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1
From the FHIR Standard
Measure.improvementNotationrequiredMeasureImprovementNotation
http://hl7.org/fhir/ValueSet/measure-improvement-notation|4.0.1
From the FHIR Standard
Measure.group.population.codeextensibleMeasurePopulationType
http://hl7.org/fhir/ValueSet/measure-population
From the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
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 & Constraints    Filter: Filtersdoco
.. Measure C 1..1 CRMIShareableMeasure 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
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:knowledgeCapability S 0..* code shareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapability (required)
.... extension:artifactComment S 0..* (Complex) Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
.... extension:versionAlgorithm S 0..1 Coding How to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: version-algorithm (??) (extensible)
.... extension:versionPolicy S 0..1 CodeableConcept metadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url SΣ 1..1 uri Canonical identifier for this measure, represented as a URI (globally unique)
... identifier Σ 0..* Identifier Additional identifier for the measure
... version SΣ 1..1 string Business version of the measure
... name SΣC 0..1 string Name for this measure (computer friendly)
... title SΣ 1..1 string Name for this measure (human friendly)
... subtitle 0..1 string Subordinate title of the measure
... status ?!SΣ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... experimental SΣ 0..1 boolean For testing purposes, not real usage
... Slices for subject[x] 1..1 CodeableConcept E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Slice: Unordered, Closed by type:$this
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
.... subject[x]:subjectCodeableConcept 1..1 CodeableConcept Indicates the base resource in which the indicator is intended to run
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... coding Σ 0..* Coding Code defined by a terminology system
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... system Σ 0..1 uri Identity of the terminology system
...... version Σ 0..1 string Version of the system - if relevant
...... code Σ 1..1 code Symbol in syntax defined by the system
...... display Σ 0..1 string Representation defined by the system
...... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
..... text Σ 0..1 string Plain text representation of the concept
... date Σ 0..1 dateTime Date last changed
... publisher SΣ 1..1 string Name of the publisher (organization or individual)
... contact Σ 0..* ContactDetail Contact details for the publisher
... description SΣ 1..1 markdown Natural language description of the measure
... 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 Σ 0..1 Period When the measure is expected to be used
... 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 0..* ContactDetail Who authored the content
... editor 0..* ContactDetail Who edited the content
... reviewer 0..* ContactDetail Who reviewed the content
... endorser 0..* ContactDetail Who endorsed the content
... relatedArtifact S 0..* RelatedArtifact There should be a related artifact for each dissagregation set defined under group[].stratifier[].component[].code
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... type SΣ 1..1 code Should be set to 'depends-on' when referencing a disaggregating value set
Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
.... label SΣ 0..1 string The label should match one of the values of group[].stratifier[].component[].code for a disaggregation value set
.... display Σ 0..1 string Brief description of the related artifact
.... citation Σ 0..1 markdown Bibliographic citation for the artifact
.... url SΣ 0..1 url The URL of a FHIR value set that defines the valid values reported in this disaggregation criterion as cross-referenced by relatedArtifact[].label
.... document Σ 0..1 Attachment What document is being referenced
.... resource Σ 0..1 canonical(Resource) What resource is being referenced
... library 0..* canonical(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 SΣ 0..1 CodeableConcept The change in measured values that is indicative of an improvement for the indicator
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 1..* BackboneElement There should be a group element for each indicator that can be calculated in the Measure. Each group member should have a unique code defined, relative to 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 1..1 CodeableConcept The code should be a unique code distinguishing the indicator within 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
..... coding Σ 1..* Coding Code defined by a terminology system
..... text Σ 0..1 string Plain text representation of the concept
.... description 1..1 string A narrative description of an indicator
.... population 1..* 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 1..1 CodeableConcept A required population code for a valid indicator.
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 S 0..* BackboneElement Contains the disaggregating value sets needed for an indicator
..... 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 S 0..* BackboneElement There should be a 'component' for each set of disaggregators which is linked to a FHIR value set
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... code S 0..1 CodeableConcept There should be a code used to reference this disaggregating valueset. There must be a relatedArtifact for each disaggregation set which is a reference to a FHIR value set. The relatedArtifact.type should be set to 'depends-on'
...... 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

PathConformanceValueSetURI
Measure.languagepreferredCommonLanguages
http://hl7.org/fhir/ValueSet/languages
From the FHIR Standard
Additional Bindings Purpose
AllLanguages Max Binding
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.subject[x]:subjectCodeableConceptextensibleSubjectType
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.relatedArtifact.typerequiredRelatedArtifactType
http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1
From the FHIR Standard
Measure.scoringextensibleMeasureScoring
http://hl7.org/fhir/ValueSet/measure-scoring
From the FHIR Standard
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://hl7.org/fhir/ValueSet/measure-improvement-notation|4.0.1
From the FHIR Standard
Measure.group.population.codeextensibleMeasurePopulationType
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
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 CRMIShareableMeasure

Summary

Mandatory: 9 elements(1 nested mandatory element)
Must-Support: 8 elements

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of Measure.subject[x]

Differential View

This structure is derived from CRMIShareableMeasure

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure 1..1 CRMIShareableMeasure A quality measure definition
... Slices for subject[x] 1..1 CodeableConcept E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Slice: Unordered, Open by type:$this
.... subject[x]:subjectCodeableConcept 1..1 CodeableConcept Indicates the base resource in which the indicator is intended to run
..... coding
...... code 1..1 code Symbol in syntax defined by the system
... publisher 1..1 string Name of the publisher (organization or individual)
... relatedArtifact S 0..* RelatedArtifact There should be a related artifact for each dissagregation set defined under group[].stratifier[].component[].code
.... type S 1..1 code Should be set to 'depends-on' when referencing a disaggregating value set
.... label S 0..1 string The label should match one of the values of group[].stratifier[].component[].code for a disaggregation value set
.... url S 0..1 url The URL of a FHIR value set that defines the valid values reported in this disaggregation criterion as cross-referenced by relatedArtifact[].label
... improvementNotation S 0..1 CodeableConcept The change in measured values that is indicative of an improvement for the indicator
... group 1..* BackboneElement There should be a group element for each indicator that can be calculated in the Measure. Each group member should have a unique code defined, relative to the Measure
.... code 1..1 CodeableConcept The code should be a unique code distinguishing the indicator within the Measure
..... coding 1..* Coding Code defined by a terminology system
.... description 1..1 string A narrative description of an indicator
.... population 1..* BackboneElement Population criteria
..... code 1..1 CodeableConcept A required population code for a valid indicator.
.... stratifier S 0..* BackboneElement Contains the disaggregating value sets needed for an indicator
..... component S 0..* BackboneElement There should be a 'component' for each set of disaggregators which is linked to a FHIR value set
...... code S 0..1 CodeableConcept There should be a code used to reference this disaggregating valueset. There must be a relatedArtifact for each disaggregation set which is a reference to a FHIR value set. The relatedArtifact.type should be set to 'depends-on'

doco Documentation for this format

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure C 1..1 CRMIShareableMeasure A quality measure definition
Constraints: mea-0, mea-1
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension Content/Rules for all slices
.... extension:knowledgeCapability S 0..* code shareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapability (required)
.... extension:artifactComment S 0..* (Complex) Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
.... extension:versionAlgorithm S 0..1 Coding How to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: version-algorithm (??) (extensible)
.... extension:versionPolicy S 0..1 CodeableConcept metadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url SΣ 1..1 uri Canonical identifier for this measure, represented as a URI (globally unique)
... version SΣ 1..1 string Business version of the measure
... name SΣC 0..1 string Name for this measure (computer friendly)
... title SΣ 1..1 string Name for this measure (human friendly)
... status ?!SΣ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... experimental SΣ 0..1 boolean For testing purposes, not real usage
... Slices for subject[x] 1..1 CodeableConcept E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Slice: Unordered, Closed by type:$this
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
.... subject[x]:subjectCodeableConcept 1..1 CodeableConcept Indicates the base resource in which the indicator is intended to run
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
... publisher SΣ 1..1 string Name of the publisher (organization or individual)
... description SΣ 1..1 markdown Natural language description of the measure
... relatedArtifact S 0..* RelatedArtifact There should be a related artifact for each dissagregation set defined under group[].stratifier[].component[].code
.... type SΣ 1..1 code Should be set to 'depends-on' when referencing a disaggregating value set
Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
.... label SΣ 0..1 string The label should match one of the values of group[].stratifier[].component[].code for a disaggregation value set
.... url SΣ 0..1 url The URL of a FHIR value set that defines the valid values reported in this disaggregation criterion as cross-referenced by relatedArtifact[].label
... improvementNotation SΣ 0..1 CodeableConcept The change in measured values that is indicative of an improvement for the indicator
Binding: MeasureImprovementNotation (required): Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue.
... group 1..* BackboneElement There should be a group element for each indicator that can be calculated in the Measure. Each group member should have a unique code defined, relative to the Measure
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code 1..1 CodeableConcept The code should be a unique code distinguishing the indicator within the Measure
..... coding Σ 1..* Coding Code defined by a terminology system
.... description 1..1 string A narrative description of an indicator
.... population 1..* BackboneElement Population criteria
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 1..1 CodeableConcept A required population code for a valid indicator.
Binding: MeasurePopulationType (extensible): The type of population.
..... criteria 1..1 Expression The criteria that defines this population
.... stratifier S 0..* BackboneElement Contains the disaggregating value sets needed for an indicator
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... component S 0..* BackboneElement There should be a 'component' for each set of disaggregators which is linked to a FHIR value set
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... code S 0..1 CodeableConcept There should be a code used to reference this disaggregating valueset. There must be a relatedArtifact for each disaggregation set which is a reference to a FHIR value set. The relatedArtifact.type should be set to 'depends-on'
...... criteria 1..1 Expression Component of how the measure should be stratified

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
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.subject[x]:subjectCodeableConceptextensibleSubjectType
http://hl7.org/fhir/ValueSet/subject-type
From the FHIR Standard
Measure.relatedArtifact.typerequiredRelatedArtifactType
http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1
From the FHIR Standard
Measure.improvementNotationrequiredMeasureImprovementNotation
http://hl7.org/fhir/ValueSet/measure-improvement-notation|4.0.1
From the FHIR Standard
Measure.group.population.codeextensibleMeasurePopulationType
http://hl7.org/fhir/ValueSet/measure-population
From the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
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 & Constraints    Filter: Filtersdoco
.. Measure C 1..1 CRMIShareableMeasure 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
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:knowledgeCapability S 0..* code shareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapability (required)
.... extension:artifactComment S 0..* (Complex) Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
.... extension:versionAlgorithm S 0..1 Coding How to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: version-algorithm (??) (extensible)
.... extension:versionPolicy S 0..1 CodeableConcept metadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url SΣ 1..1 uri Canonical identifier for this measure, represented as a URI (globally unique)
... identifier Σ 0..* Identifier Additional identifier for the measure
... version SΣ 1..1 string Business version of the measure
... name SΣC 0..1 string Name for this measure (computer friendly)
... title SΣ 1..1 string Name for this measure (human friendly)
... subtitle 0..1 string Subordinate title of the measure
... status ?!SΣ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... experimental SΣ 0..1 boolean For testing purposes, not real usage
... Slices for subject[x] 1..1 CodeableConcept E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Slice: Unordered, Closed by type:$this
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
.... subject[x]:subjectCodeableConcept 1..1 CodeableConcept Indicates the base resource in which the indicator is intended to run
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... coding Σ 0..* Coding Code defined by a terminology system
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... system Σ 0..1 uri Identity of the terminology system
...... version Σ 0..1 string Version of the system - if relevant
...... code Σ 1..1 code Symbol in syntax defined by the system
...... display Σ 0..1 string Representation defined by the system
...... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
..... text Σ 0..1 string Plain text representation of the concept
... date Σ 0..1 dateTime Date last changed
... publisher SΣ 1..1 string Name of the publisher (organization or individual)
... contact Σ 0..* ContactDetail Contact details for the publisher
... description SΣ 1..1 markdown Natural language description of the measure
... 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 Σ 0..1 Period When the measure is expected to be used
... 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 0..* ContactDetail Who authored the content
... editor 0..* ContactDetail Who edited the content
... reviewer 0..* ContactDetail Who reviewed the content
... endorser 0..* ContactDetail Who endorsed the content
... relatedArtifact S 0..* RelatedArtifact There should be a related artifact for each dissagregation set defined under group[].stratifier[].component[].code
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... type SΣ 1..1 code Should be set to 'depends-on' when referencing a disaggregating value set
Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
.... label SΣ 0..1 string The label should match one of the values of group[].stratifier[].component[].code for a disaggregation value set
.... display Σ 0..1 string Brief description of the related artifact
.... citation Σ 0..1 markdown Bibliographic citation for the artifact
.... url SΣ 0..1 url The URL of a FHIR value set that defines the valid values reported in this disaggregation criterion as cross-referenced by relatedArtifact[].label
.... document Σ 0..1 Attachment What document is being referenced
.... resource Σ 0..1 canonical(Resource) What resource is being referenced
... library 0..* canonical(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 SΣ 0..1 CodeableConcept The change in measured values that is indicative of an improvement for the indicator
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 1..* BackboneElement There should be a group element for each indicator that can be calculated in the Measure. Each group member should have a unique code defined, relative to 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 1..1 CodeableConcept The code should be a unique code distinguishing the indicator within 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
..... coding Σ 1..* Coding Code defined by a terminology system
..... text Σ 0..1 string Plain text representation of the concept
.... description 1..1 string A narrative description of an indicator
.... population 1..* 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 1..1 CodeableConcept A required population code for a valid indicator.
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 S 0..* BackboneElement Contains the disaggregating value sets needed for an indicator
..... 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 S 0..* BackboneElement There should be a 'component' for each set of disaggregators which is linked to a FHIR value set
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... code S 0..1 CodeableConcept There should be a code used to reference this disaggregating valueset. There must be a relatedArtifact for each disaggregation set which is a reference to a FHIR value set. The relatedArtifact.type should be set to 'depends-on'
...... 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

PathConformanceValueSetURI
Measure.languagepreferredCommonLanguages
http://hl7.org/fhir/ValueSet/languages
From the FHIR Standard
Additional Bindings Purpose
AllLanguages Max Binding
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.subject[x]:subjectCodeableConceptextensibleSubjectType
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.relatedArtifact.typerequiredRelatedArtifactType
http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1
From the FHIR Standard
Measure.scoringextensibleMeasureScoring
http://hl7.org/fhir/ValueSet/measure-scoring
From the FHIR Standard
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://hl7.org/fhir/ValueSet/measure-improvement-notation|4.0.1
From the FHIR Standard
Measure.group.population.codeextensibleMeasurePopulationType
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
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 CRMIShareableMeasure

Summary

Mandatory: 9 elements(1 nested mandatory element)
Must-Support: 8 elements

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of Measure.subject[x]

 

Other representations of profile: CSV, Excel, Schematron