This page is part of the Canonical Resource Management Infrastructure Implementation Guide (v1.0.0-snapshot: STU1 Draft) based on FHIR (HL7® FHIR® Standard) R4. . For a full list of available versions, see the Directory of published versions

• Content
• Detailed Descriptions
• Mappings
• Examples
• XML
• JSON

Resource Profile: CRMI Publishable Measure

Supports declaration of the Measure metadata required by HL7 and other organizations that share and publish measures with a focus on the aspects of that metadata that are important for post-publication activities including distribution, inclusion in repositories, consumption, and implementation.

Usage:

• Examples for this Resource Profile: ANCIND01Publishable

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 Measure

Name	Flags	Card.	Type	Description & Constraints
Measure		1..1	Measure	A quality measure definition
copyrightLabel	S	0..1	string	Copyright holder and year(s) URL: http://hl7.org/fhir/StructureDefinition/artifact-copyrightLabel
identifier	S	0..*	Identifier	Additional identifier for the measure
date	S	1..1	dateTime	Date last changed
contact	S	0..*	ContactDetail	Contact details for the publisher
useContext	S	0..*	UsageContext	The context that the content is intended to support
jurisdiction	S	0..*	CodeableConcept	Intended jurisdiction for measure (if applicable)
purpose	S	0..1	markdown	Why this measure is defined
usage	S	0..1	string	Describes the clinical usage of the measure
copyright	S	0..1	markdown	Use and/or publishing restrictions
approvalDate	S	0..1	date	When the measure was approved by publisher
lastReviewDate	S	0..1	date	When the measure was last reviewed
effectivePeriod	S	0..1	Period	When the measure is expected to be used
topic	S	0..*	CodeableConcept	The category of the measure, such as Education, Treatment, Assessment, etc.
author	S	0..*	ContactDetail	Who authored the content
editor	S	0..*	ContactDetail	Who edited the content
reviewer	S	0..*	ContactDetail	Who reviewed the content
endorser	S	0..*	ContactDetail	Who endorsed the content
relatedArtifact	S	0..*	RelatedArtifact	Additional documentation, citations, etc.
display	S	0..1	string	Brief description of the related artifact
document	S	0..1	Attachment	What document is being referenced
resource	S	0..1	canonical(Resource)	What resource is being referenced
Documentation for this format

Name	Flags	Card.	Type	Description & Constraints
Measure	C	1..1	Measure	A 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
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
copyrightLabel	S	0..1	string	Copyright holder and year(s) URL: http://hl7.org/fhir/StructureDefinition/artifact-copyrightLabel
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	SΣ	0..*	Identifier	Additional identifier for the measure
status	?!Σ	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
date	SΣ	1..1	dateTime	Date last changed
contact	SΣ	0..*	ContactDetail	Contact details for the publisher
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.
purpose	S	0..1	markdown	Why this measure is defined
usage	S	0..1	string	Describes the clinical usage of the measure
copyright	S	0..1	markdown	Use and/or publishing restrictions
approvalDate	S	0..1	date	When the measure was approved by publisher
lastReviewDate	S	0..1	date	When the measure was last reviewed
effectivePeriod	SΣ	0..1	Period	When the measure is expected to be used
topic	S	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	S	0..*	ContactDetail	Who authored the content
editor	S	0..*	ContactDetail	Who edited the content
reviewer	S	0..*	ContactDetail	Who reviewed the content
endorser	S	0..*	ContactDetail	Who endorsed the content
relatedArtifact	S	0..*	RelatedArtifact	Additional documentation, citations, etc.
type	Σ	1..1	code	documentation | justification | citation | predecessor | successor | derived-from | depends-on | composed-of Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
display	SΣ	0..1	string	Brief description of the related artifact
document	SΣ	0..1	Attachment	What document is being referenced
resource	SΣ	0..1	canonical(Resource)	What resource is being referenced
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Measure.status	required	PublicationStatus http://hl7.org/fhir/ValueSet/publication-status|4.0.1 from the FHIR Standard
Measure.jurisdiction	extensible	Jurisdiction ValueSet http://hl7.org/fhir/ValueSet/jurisdiction from the FHIR Standard
Measure.topic	example	DefinitionTopic http://hl7.org/fhir/ValueSet/definition-topic from the FHIR Standard
Measure.relatedArtifact.type	required	RelatedArtifactType http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1 from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
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())

Name	Flags	Card.	Type	Description & Constraints
Measure	C	1..1	Measure	A 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
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 Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
copyrightLabel	S	0..1	string	Copyright holder and year(s) URL: http://hl7.org/fhir/StructureDefinition/artifact-copyrightLabel
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
url	Σ	0..1	uri	Canonical identifier for this measure, represented as a URI (globally unique)
identifier	SΣ	0..*	Identifier	Additional identifier for the measure
version	Σ	0..1	string	Business version of the measure
name	ΣC	0..1	string	Name for this measure (computer friendly)
title	Σ	0..1	string	Name for this measure (human friendly)
subtitle		0..1	string	Subordinate title of the measure
status	?!Σ	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
experimental	Σ	0..1	boolean	For testing purposes, not real usage
subject[x]		0..1		E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
subjectCodeableConcept			CodeableConcept
subjectReference			Reference(Group)
date	SΣ	1..1	dateTime	Date last changed
publisher	Σ	0..1	string	Name of the publisher (organization or individual)
contact	SΣ	0..*	ContactDetail	Contact details for the publisher
description	Σ	0..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.
purpose	S	0..1	markdown	Why this measure is defined
usage	S	0..1	string	Describes the clinical usage of the measure
copyright	S	0..1	markdown	Use and/or publishing restrictions
approvalDate	S	0..1	date	When the measure was approved by publisher
lastReviewDate	S	0..1	date	When the measure was last reviewed
effectivePeriod	SΣ	0..1	Period	When the measure is expected to be used
topic	S	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	S	0..*	ContactDetail	Who authored the content
editor	S	0..*	ContactDetail	Who edited the content
reviewer	S	0..*	ContactDetail	Who reviewed the content
endorser	S	0..*	ContactDetail	Who endorsed the content
relatedArtifact	S	0..*	RelatedArtifact	Additional documentation, citations, 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
type	Σ	1..1	code	documentation | justification | citation | predecessor | successor | derived-from | depends-on | composed-of Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
label	Σ	0..1	string	Short label
display	SΣ	0..1	string	Brief description of the related artifact
citation	Σ	0..1	markdown	Bibliographic citation for the artifact
url	Σ	0..1	url	Where the artifact can be accessed
document	SΣ	0..1	Attachment	What document is being referenced
resource	SΣ	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	Σ	0..1	CodeableConcept	increase | decrease Binding: MeasureImprovementNotation (required): Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue.
definition	Σ	0..*	markdown	Defined terms used in the measure documentation
guidance	Σ	0..1	markdown	Additional guidance for implementers
group		0..*	BackboneElement	Population criteria group
id		0..1	string	Unique id for inter-element referencing
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 group
description		0..1	string	Summary description
population		0..*	BackboneElement	Population criteria
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code		0..1	CodeableConcept	initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible): The type of population.
description		0..1	string	The human readable description of this population criteria
criteria		1..1	Expression	The criteria that defines this population
stratifier		0..*	BackboneElement	Stratifier criteria for the measure
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code		0..1	CodeableConcept	Meaning of the stratifier
description		0..1	string	The human readable description of this stratifier
criteria		0..1	Expression	How the measure should be stratified
component		0..*	BackboneElement	Stratifier criteria component for the measure
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code		0..1	CodeableConcept	Meaning of the stratifier component
description		0..1	string	The human readable description of this stratifier component
criteria		1..1	Expression	Component of how the measure should be stratified
supplementalData		0..*	BackboneElement	What other data should be reported with the measure
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code		0..1	CodeableConcept	Meaning of the supplemental data
usage		0..*	CodeableConcept	supplemental-data | risk-adjustment-factor Binding: MeasureDataUsage (extensible): The intended usage for supplemental data elements in the measure.
description		0..1	string	The human readable description of this supplemental data
criteria		1..1	Expression	Expression describing additional data to be reported
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Measure.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Measure.status	required	PublicationStatus http://hl7.org/fhir/ValueSet/publication-status|4.0.1 from the FHIR Standard
Measure.subject[x]	extensible	SubjectType http://hl7.org/fhir/ValueSet/subject-type from the FHIR Standard
Measure.jurisdiction	extensible	Jurisdiction ValueSet http://hl7.org/fhir/ValueSet/jurisdiction from the FHIR Standard
Measure.topic	example	DefinitionTopic http://hl7.org/fhir/ValueSet/definition-topic from the FHIR Standard
Measure.relatedArtifact.type	required	RelatedArtifactType http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1 from the FHIR Standard
Measure.scoring	extensible	MeasureScoring http://hl7.org/fhir/ValueSet/measure-scoring from the FHIR Standard
Measure.compositeScoring	extensible	CompositeMeasureScoring http://hl7.org/fhir/ValueSet/composite-measure-scoring from the FHIR Standard
Measure.type	extensible	MeasureType http://hl7.org/fhir/ValueSet/measure-type from the FHIR Standard
Measure.improvementNotation	required	MeasureImprovementNotation http://hl7.org/fhir/ValueSet/measure-improvement-notation|4.0.1 from the FHIR Standard
Measure.group.population.code	extensible	MeasurePopulationType http://hl7.org/fhir/ValueSet/measure-population from the FHIR Standard
Measure.supplementalData.usage	extensible	MeasureDataUsage http://hl7.org/fhir/ValueSet/measure-data-usage from the FHIR Standard

Constraints

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

This structure is derived from Measure

Summary

Mandatory: 1 element
Must-Support: 21 elements

Extensions

This structure refers to these extensions:

• http://hl7.org/fhir/StructureDefinition/artifact-copyrightLabel

Maturity: 3

Differential View

This structure is derived from Measure

Name	Flags	Card.	Type	Description & Constraints
Measure		1..1	Measure	A quality measure definition
copyrightLabel	S	0..1	string	Copyright holder and year(s) URL: http://hl7.org/fhir/StructureDefinition/artifact-copyrightLabel
identifier	S	0..*	Identifier	Additional identifier for the measure
date	S	1..1	dateTime	Date last changed
contact	S	0..*	ContactDetail	Contact details for the publisher
useContext	S	0..*	UsageContext	The context that the content is intended to support
jurisdiction	S	0..*	CodeableConcept	Intended jurisdiction for measure (if applicable)
purpose	S	0..1	markdown	Why this measure is defined
usage	S	0..1	string	Describes the clinical usage of the measure
copyright	S	0..1	markdown	Use and/or publishing restrictions
approvalDate	S	0..1	date	When the measure was approved by publisher
lastReviewDate	S	0..1	date	When the measure was last reviewed
effectivePeriod	S	0..1	Period	When the measure is expected to be used
topic	S	0..*	CodeableConcept	The category of the measure, such as Education, Treatment, Assessment, etc.
author	S	0..*	ContactDetail	Who authored the content
editor	S	0..*	ContactDetail	Who edited the content
reviewer	S	0..*	ContactDetail	Who reviewed the content
endorser	S	0..*	ContactDetail	Who endorsed the content
relatedArtifact	S	0..*	RelatedArtifact	Additional documentation, citations, etc.
display	S	0..1	string	Brief description of the related artifact
document	S	0..1	Attachment	What document is being referenced
resource	S	0..1	canonical(Resource)	What resource is being referenced
Documentation for this format

Key Elements View

Name	Flags	Card.	Type	Description & Constraints
Measure	C	1..1	Measure	A 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
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
copyrightLabel	S	0..1	string	Copyright holder and year(s) URL: http://hl7.org/fhir/StructureDefinition/artifact-copyrightLabel
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	SΣ	0..*	Identifier	Additional identifier for the measure
status	?!Σ	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
date	SΣ	1..1	dateTime	Date last changed
contact	SΣ	0..*	ContactDetail	Contact details for the publisher
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.
purpose	S	0..1	markdown	Why this measure is defined
usage	S	0..1	string	Describes the clinical usage of the measure
copyright	S	0..1	markdown	Use and/or publishing restrictions
approvalDate	S	0..1	date	When the measure was approved by publisher
lastReviewDate	S	0..1	date	When the measure was last reviewed
effectivePeriod	SΣ	0..1	Period	When the measure is expected to be used
topic	S	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	S	0..*	ContactDetail	Who authored the content
editor	S	0..*	ContactDetail	Who edited the content
reviewer	S	0..*	ContactDetail	Who reviewed the content
endorser	S	0..*	ContactDetail	Who endorsed the content
relatedArtifact	S	0..*	RelatedArtifact	Additional documentation, citations, etc.
type	Σ	1..1	code	documentation | justification | citation | predecessor | successor | derived-from | depends-on | composed-of Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
display	SΣ	0..1	string	Brief description of the related artifact
document	SΣ	0..1	Attachment	What document is being referenced
resource	SΣ	0..1	canonical(Resource)	What resource is being referenced
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Measure.status	required	PublicationStatus http://hl7.org/fhir/ValueSet/publication-status|4.0.1 from the FHIR Standard
Measure.jurisdiction	extensible	Jurisdiction ValueSet http://hl7.org/fhir/ValueSet/jurisdiction from the FHIR Standard
Measure.topic	example	DefinitionTopic http://hl7.org/fhir/ValueSet/definition-topic from the FHIR Standard
Measure.relatedArtifact.type	required	RelatedArtifactType http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1 from the FHIR Standard

Constraints

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

Snapshot View

Name	Flags	Card.	Type	Description & Constraints
Measure	C	1..1	Measure	A 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
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 Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
copyrightLabel	S	0..1	string	Copyright holder and year(s) URL: http://hl7.org/fhir/StructureDefinition/artifact-copyrightLabel
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
url	Σ	0..1	uri	Canonical identifier for this measure, represented as a URI (globally unique)
identifier	SΣ	0..*	Identifier	Additional identifier for the measure
version	Σ	0..1	string	Business version of the measure
name	ΣC	0..1	string	Name for this measure (computer friendly)
title	Σ	0..1	string	Name for this measure (human friendly)
subtitle		0..1	string	Subordinate title of the measure
status	?!Σ	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
experimental	Σ	0..1	boolean	For testing purposes, not real usage
subject[x]		0..1		E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
subjectCodeableConcept			CodeableConcept
subjectReference			Reference(Group)
date	SΣ	1..1	dateTime	Date last changed
publisher	Σ	0..1	string	Name of the publisher (organization or individual)
contact	SΣ	0..*	ContactDetail	Contact details for the publisher
description	Σ	0..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.
purpose	S	0..1	markdown	Why this measure is defined
usage	S	0..1	string	Describes the clinical usage of the measure
copyright	S	0..1	markdown	Use and/or publishing restrictions
approvalDate	S	0..1	date	When the measure was approved by publisher
lastReviewDate	S	0..1	date	When the measure was last reviewed
effectivePeriod	SΣ	0..1	Period	When the measure is expected to be used
topic	S	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	S	0..*	ContactDetail	Who authored the content
editor	S	0..*	ContactDetail	Who edited the content
reviewer	S	0..*	ContactDetail	Who reviewed the content
endorser	S	0..*	ContactDetail	Who endorsed the content
relatedArtifact	S	0..*	RelatedArtifact	Additional documentation, citations, 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
type	Σ	1..1	code	documentation | justification | citation | predecessor | successor | derived-from | depends-on | composed-of Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
label	Σ	0..1	string	Short label
display	SΣ	0..1	string	Brief description of the related artifact
citation	Σ	0..1	markdown	Bibliographic citation for the artifact
url	Σ	0..1	url	Where the artifact can be accessed
document	SΣ	0..1	Attachment	What document is being referenced
resource	SΣ	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	Σ	0..1	CodeableConcept	increase | decrease Binding: MeasureImprovementNotation (required): Observation values that indicate what change in a measurement value or score is indicative of an improvement in the measured item or scored issue.
definition	Σ	0..*	markdown	Defined terms used in the measure documentation
guidance	Σ	0..1	markdown	Additional guidance for implementers
group		0..*	BackboneElement	Population criteria group
id		0..1	string	Unique id for inter-element referencing
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 group
description		0..1	string	Summary description
population		0..*	BackboneElement	Population criteria
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code		0..1	CodeableConcept	initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation Binding: MeasurePopulationType (extensible): The type of population.
description		0..1	string	The human readable description of this population criteria
criteria		1..1	Expression	The criteria that defines this population
stratifier		0..*	BackboneElement	Stratifier criteria for the measure
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code		0..1	CodeableConcept	Meaning of the stratifier
description		0..1	string	The human readable description of this stratifier
criteria		0..1	Expression	How the measure should be stratified
component		0..*	BackboneElement	Stratifier criteria component for the measure
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code		0..1	CodeableConcept	Meaning of the stratifier component
description		0..1	string	The human readable description of this stratifier component
criteria		1..1	Expression	Component of how the measure should be stratified
supplementalData		0..*	BackboneElement	What other data should be reported with the measure
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code		0..1	CodeableConcept	Meaning of the supplemental data
usage		0..*	CodeableConcept	supplemental-data | risk-adjustment-factor Binding: MeasureDataUsage (extensible): The intended usage for supplemental data elements in the measure.
description		0..1	string	The human readable description of this supplemental data
criteria		1..1	Expression	Expression describing additional data to be reported
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Measure.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Measure.status	required	PublicationStatus http://hl7.org/fhir/ValueSet/publication-status|4.0.1 from the FHIR Standard
Measure.subject[x]	extensible	SubjectType http://hl7.org/fhir/ValueSet/subject-type from the FHIR Standard
Measure.jurisdiction	extensible	Jurisdiction ValueSet http://hl7.org/fhir/ValueSet/jurisdiction from the FHIR Standard
Measure.topic	example	DefinitionTopic http://hl7.org/fhir/ValueSet/definition-topic from the FHIR Standard
Measure.relatedArtifact.type	required	RelatedArtifactType http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1 from the FHIR Standard
Measure.scoring	extensible	MeasureScoring http://hl7.org/fhir/ValueSet/measure-scoring from the FHIR Standard
Measure.compositeScoring	extensible	CompositeMeasureScoring http://hl7.org/fhir/ValueSet/composite-measure-scoring from the FHIR Standard
Measure.type	extensible	MeasureType http://hl7.org/fhir/ValueSet/measure-type from the FHIR Standard
Measure.improvementNotation	required	MeasureImprovementNotation http://hl7.org/fhir/ValueSet/measure-improvement-notation|4.0.1 from the FHIR Standard
Measure.group.population.code	extensible	MeasurePopulationType http://hl7.org/fhir/ValueSet/measure-population from the FHIR Standard
Measure.supplementalData.usage	extensible	MeasureDataUsage http://hl7.org/fhir/ValueSet/measure-data-usage from the FHIR Standard

Constraints

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

This structure is derived from Measure

Summary

Mandatory: 1 element
Must-Support: 21 elements

Extensions

This structure refers to these extensions:

• http://hl7.org/fhir/StructureDefinition/artifact-copyrightLabel

Maturity: 3

Other representations of profile: CSV, Excel, Schematron