HL7.FHIR.US.CQFMEASURES\CQFM Measure

Quality Measure Implementation Guide (STU4)
4.0.0-ballot - ballot US

This page is part of the Quality Measure STU2 for FHIR R4 Implementation Guide (v4.0.0-ballot: STU 4 Ballot 1) based on FHIR R4. The current version which supercedes this version is 3.0.0. For a full list of available versions, see the Directory of published versions

Resource Profile: CQFM Measure

Official URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/measure-cqfm				Version: 4.0.0-ballot
Active as of 2019-02-13				Computable Name: CQFMMeasure

The CQFM Measure Profile describes minimum expectations for defining an electronic Clinical Quality Measure (eCQM)

Usage:

Derived from this Resource Profile: CQFM Cohort Measure, CQFM Composite Measure, CQFM Computable Measure, CQFM Continuous Variable Measure, CQFM Executable Measure, CQFM Proportion Measure, CQFM Publishable Measure, CQFM Ratio Measure
Examples for this Resource Profile: VTE_1_FHIR

Formal Views of Profile Content

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

Differential Table
Key Elements Table
Snapshot Table
Statistics/References
All

This structure is derived from Shareable Measure

Name	Flags	Card.	Type	Description & Constraints
Measure		1..1	Shareable Measure	A quality measure definition
meta	S	1..1	Meta	Metadata about the resource
profile	S	1..*	canonical(StructureDefinition)	Profiles this resource claims to conform to
comment	S	0..*	(Complex)	Additional documentation, review, or usage guidance URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-artifactComment
allocation	S	0..1	markdown	Allocation guidance URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-allocation
softwaresystem	S	0..*	Reference(CQFM Device)	Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem
library	SC	0..1	canonical(CQFM Library)	CQFMMeasures are not required to use a Library, but if they do, it SHALL be a CQFMLibrary. cqm-2: Measures utilizing CQL SHALL reference one and only one CQL library (and that referenced library MUST be the primary library for the measure)
type	S	0..*	CodeableConcept	process \| outcome \| structure \| patient-reported-outcome \| composite Binding: MeasureType (extensible)
group	S	0..*	BackboneElement	Population criteria group
id	SC	0..1	string	Unique id for inter-element referencing cqm-3: Group identifiers SHOULD use the convention: "group-[group number]", where [group number] corresponds with the group naming convention for the criteria within the group
population	S	0..*	BackboneElement	Population criteria
id	S	1..1	string	Unique id for inter-element referencing
code	S	1..1	CodeableConcept	initial-population \| numerator \| numerator-exclusion \| denominator \| denominator-exclusion \| denominator-exception \| measure-population \| measure-population-exclusion \| measure-observation Binding: MeasurePopulationType (extensible)
criteria	SC	1..1	Expression	The criteria that defines this population cqm-4: Group population criteria SHOULD be simple expression names found within the primary library for the measure. The criteria SHOULD NOT include a namespace.
stratifier	S	0..*	BackboneElement	Stratifier criteria for the measure
id	S	1..1	string	Unique id for inter-element referencing
criteria	SC	0..1	Expression	How the measure should be stratified cqm-5: Group stratifier criteria SHOULD be simple expression names found within the primary library for the measure. The criteria SHOULD NOT include a namespace.
supplementalData	SC	0..*	BackboneElement	What other data should be reported with the measure cqm-6: Supplemental data SHALL use either criteria or path
id	S	1..1	string	Unique id for inter-element referencing
code	S	0..1	CodeableConcept	Meaning of the supplemental data Binding: MeasureDataUsage (extensible)
Documentation for this format

Terminology Bindings (Differential)

Path	Conformance	ValueSet
Measure.type	extensible	MeasureType
Measure.group.population.code	extensible	MeasurePopulationType
Measure.supplementalData.code	extensible	MeasureDataUsage

Constraints

Id	Grade	Path(s)	Details	Requirements
cqm-2	warning	Measure.library	Measures utilizing CQL SHALL reference one and only one CQL library (and that referenced library MUST be the primary library for the measure) : exists()
cqm-3	warning	Measure.group.id	Group identifiers SHOULD use the convention: "group-[group number]", where [group number] corresponds with the group naming convention for the criteria within the group : value.startsWith('group-')
cqm-4	warning	Measure.group.population.criteria	Group population criteria SHOULD be simple expression names found within the primary library for the measure. The criteria SHOULD NOT include a namespace. : expression.contains('.').not()
cqm-5	warning	Measure.group.stratifier.criteria	Group stratifier criteria SHOULD be simple expression names found within the primary library for the measure. The criteria SHOULD NOT include a namespace. : expression.contains('.').not()
cqm-6	warning	Measure.supplementalData	Supplemental data SHALL use either criteria or path : criteria.exists() or path.exists()

Name	Flags	Card.	Type	Description & Constraints
Measure	C	1..1	Shareable Measure	A quality measure definition
meta	SΣ	1..1	Meta	Metadata about the resource
profile	SΣ	1..*	canonical(StructureDefinition)	Profiles this resource claims to conform to
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
comment	S	0..*	(Complex)	Additional documentation, review, or usage guidance URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-artifactComment
allocation	S	0..1	markdown	Allocation guidance URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-allocation
softwaresystem	S	0..*	Reference(CQFM Device)	Extension URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-softwaresystem
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
url	Σ	1..1	uri	Canonical identifier for this measure, represented as a URI (globally unique)
identifier	SΣ	0..*	Identifier	Additional identifier for the measure
version	Σ	1..1	string	Business version of the measure
name	ΣC	1..1	string	Name for this measure (computer friendly)
title	SΣ	0..1	string	Name for this measure (human friendly)
status	?!Σ	1..1	code	draft \| active \| retired \| unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
experimental	Σ	1..1	boolean	For testing purposes, not real usage
date	SΣ	0..1	dateTime	Date last changed
publisher	Σ	1..1	string	Name of the publisher (organization or individual)
contact	SΣ	0..*	ContactDetail	Contact details for the publisher
description	Σ	1..1	markdown	Natural language description of the measure
useContext	SΣ	0..*	UsageContext	The context that the content is intended to support
jurisdiction	SΣ	0..*	CodeableConcept	Intended jurisdiction for measure (if applicable) Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.
library	SC	0..1	canonical(CQFM Library)	CQFMMeasures are not required to use a Library, but if they do, it SHALL be a CQFMLibrary. cqm-2: Measures utilizing CQL SHALL reference one and only one CQL library (and that referenced library MUST be the primary library for the measure)
type	SΣ	0..*	CodeableConcept	process \| outcome \| structure \| patient-reported-outcome \| composite Binding: MeasureType (extensible)
group	S	0..*	BackboneElement	Population criteria group
id	SC	0..1	string	Unique id for inter-element referencing cqm-3: Group identifiers SHOULD use the convention: "group-[group number]", where [group number] corresponds with the group naming convention for the criteria within the group
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
population	S	0..*	BackboneElement	Population criteria
id	S	1..1	string	Unique id for inter-element referencing
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code	S	1..1	CodeableConcept	initial-population \| numerator \| numerator-exclusion \| denominator \| denominator-exclusion \| denominator-exception \| measure-population \| measure-population-exclusion \| measure-observation Binding: MeasurePopulationType (extensible)
criteria	SC	1..1	Expression	The criteria that defines this population cqm-4: Group population criteria SHOULD be simple expression names found within the primary library for the measure. The criteria SHOULD NOT include a namespace.
stratifier	S	0..*	BackboneElement	Stratifier criteria for the measure
id	S	1..1	string	Unique id for inter-element referencing
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
criteria	SC	0..1	Expression	How the measure should be stratified cqm-5: Group stratifier criteria SHOULD be simple expression names found within the primary library for the measure. The criteria SHOULD NOT include a namespace.
supplementalData	SC	0..*	BackboneElement	What other data should be reported with the measure cqm-6: Supplemental data SHALL use either criteria or path
id	S	1..1	string	Unique id for inter-element referencing
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code	S	0..1	CodeableConcept	Meaning of the supplemental data Binding: MeasureDataUsage (extensible)
criteria		1..1	Expression	Expression describing additional data to be reported
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet
Measure.status	required	PublicationStatus
Measure.jurisdiction	extensible	Jurisdiction ValueSet
Measure.type	extensible	MeasureType
Measure.group.population.code	extensible	MeasurePopulationType
Measure.supplementalData.code	extensible	MeasureDataUsage

Constraints

Id	Grade	Path(s)	Details	Requirements
cqm-2	warning	Measure.library	Measures utilizing CQL SHALL reference one and only one CQL library (and that referenced library MUST be the primary library for the measure) : exists()
cqm-3	warning	Measure.group.id	Group identifiers SHOULD use the convention: "group-[group number]", where [group number] corresponds with the group naming convention for the criteria within the group : value.startsWith('group-')
cqm-4	warning	Measure.group.population.criteria	Group population criteria SHOULD be simple expression names found within the primary library for the measure. The criteria SHOULD NOT include a namespace. : expression.contains('.').not()
cqm-5	warning	Measure.group.stratifier.criteria	Group stratifier criteria SHOULD be simple expression names found within the primary library for the measure. The criteria SHOULD NOT include a namespace. : expression.contains('.').not()
cqm-6	warning	Measure.supplementalData	Supplemental data SHALL use either criteria or path : criteria.exists() or path.exists()
dom-2	error	Measure	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Measure	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference \| %resource.descendants().as(canonical) \| %resource.descendants().as(uri) \| %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Measure	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Measure	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Measure	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	ALL elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	ALL extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()
mea-0	warning	Measure	Name should be usable as an identifier for the module by machine processing applications such as code generation : name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
mea-1	error	Measure	Stratifier SHALL be either a single criteria or a set of criteria components : group.stratifier.all((code \| description \| criteria).exists() xor component.exists())