This page is part of the FHIR Specification (v4.6.0: R5 Draft Ballot - see ballot notes). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4
Clinical Quality Information Work Group | Maturity Level: 0 | Trial Use | Use Context: Any |
The official URL for this profile is:
http://hl7.org/fhir/StructureDefinition/shareablemeasure
Enforces the minimum information set for the measure metadata required by HL7 and other organizations that share and publish measures
This profile was published on Thu, Jan 1, 1970 00:00+1000 as a draft by HL7.
Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.
This structure is derived from Measure.
This structure is derived from Measure.
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Measure | 1..1 | Measure | A quality measure definition | |
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 | 1..1 | string | Name for this measure (computer friendly) | |
title | S | 0..1 | string | Name for this measure (human friendly) |
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) |
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Measure | I | 1..1 | Measure | A quality measure definition |
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: Common Languages (preferred) Max Binding: All Languages: IETF language tag | |
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional content defined by implementations | |
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 | ΣI | 1..1 | string | Name for this measure (computer friendly) |
title | SΣ | 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 | Σ | 1..1 | boolean | For testing purposes, not real usage |
subject[x] | 0..1 | E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device Binding: Subject type (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.). | ||
subjectCodeableConcept | CodeableConcept | |||
subjectReference | Reference(Group) | |||
basis | Σ | 0..1 | code | Population basis Binding: FHIRAllTypes (required) |
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 (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 | 0..* | RelatedArtifact | Additional documentation, citations, etc. | |
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. |
scoringUnit | Σ | 0..1 | CodeableConcept | What units? Binding: Measure Scoring Unit (example) |
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 | id | 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 Binding: MeasureGroupExample (example): Example of measure groups. | |
description | 0..1 | string | Summary description | |
type | Σ | 0..* | CodeableConcept | process | outcome | structure | patient-reported-outcome | composite Binding: MeasureType (extensible) |
basis | Σ | 0..1 | code | Population basis Binding: FHIRAllTypes (required) |
scoring | Σ | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort Binding: MeasureScoring (extensible) |
scoringUnit | Σ | 0..1 | CodeableConcept | What units? Binding: Measure Scoring Unit (example) |
improvementNotation | Σ | 0..1 | CodeableConcept | increase | decrease Binding: MeasureImprovementNotation (required) |
population | 0..* | BackboneElement | Population criteria | |
id | 0..1 | id | 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 | |
inputPopulationId | 0..1 | string | Which population | |
aggregateMethod | 0..1 | CodeableConcept | Aggregation method for a measure score (e.g. sum, average, median, minimum, maximum, count) Binding: Measure Aggregate Method (extensible) | |
stratifier | 0..* | BackboneElement | Stratifier criteria for the measure | |
id | 0..1 | id | 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 Binding: MeasureStratifierExample (example): 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 | id | 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 Binding: MeasureStratifierExample (example): Meaning of the stratifier. | |
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 | id | 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 Binding: MeasureSupplementalDataExample (example): 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 |
<!-- Shareable Measure --> <Measure xmlns="http://hl7.org/fhir" > <!-- from Element: extension --> <id value="[id]"/><!-- 0..1 Logical id of this artifact --> <meta><!-- 0..1 Meta Metadata about the resource --></meta> <implicitRules value="[uri]"/><!-- 0..1 A set of rules under which this content was created --> <language value="[code]"/><!-- 0..1 Language of the resource content --> <text><!-- 0..1 Narrative Text summary of the resource, for human interpretation --></text> <contained><!-- 0..* Resource Contained, inline Resources --></contained> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored --></modifierExtension> <url value="[uri]"/><!-- 1..1 Canonical identifier for this measure, represented as a URI (globally unique) --> <identifier><!-- 0..* Identifier Additional identifier for the measure --></identifier> <version value="[string]"/><!-- 1..1 Business version of the measure --> <name value="[string]"/><!-- 1..1 Name for this measure (computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this measure (human friendly) --> <subtitle value="[string]"/><!-- 0..1 Subordinate title of the measure --> <status value="[code]"/><!-- 1..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- 1..1 For testing purposes, not real usage --> <subject[x]><!-- 0..1 CodeableConcept|Reference(Group) E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device --></subject[x]> <basis value="[code]"/><!-- 0..1 Population basis --> <date value="[dateTime]"/><!-- 0..1 Date last changed --> <publisher value="[string]"/><!-- 1..1 Name of the publisher (organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- 1..1 Natural language description of the measure --> <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for measure (if applicable) --></jurisdiction> <purpose value="[markdown]"/><!-- 0..1 Why this measure is defined --> <usage value="[string]"/><!-- 0..1 Describes the clinical usage of the measure --> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <approvalDate value="[date]"/><!-- 0..1 When the measure was approved by publisher --> <lastReviewDate value="[date]"/><!-- 0..1 When the measure was last reviewed --> <effectivePeriod><!-- 0..1 Period When the measure is expected to be used --></effectivePeriod> <topic><!-- 0..* CodeableConcept The category of the measure, such as Education, Treatment, Assessment, etc. --></topic> <author><!-- 0..* ContactDetail Who authored the content --></author> <editor><!-- 0..* ContactDetail Who edited the content --></editor> <reviewer><!-- 0..* ContactDetail Who reviewed the content --></reviewer> <endorser><!-- 0..* ContactDetail Who endorsed the content --></endorser> <relatedArtifact><!-- 0..* RelatedArtifact Additional documentation, citations, etc. --></relatedArtifact> <library value="[canonical]"/><!-- 0..* Logic used by the measure --> <disclaimer value="[markdown]"/><!-- 0..1 Disclaimer for use of the measure or its referenced content --> <scoring><!-- 0..1 CodeableConcept proportion | ratio | continuous-variable | cohort --></scoring> <scoringUnit><!-- 0..1 CodeableConcept What units? --></scoringUnit> <compositeScoring><!-- 0..1 CodeableConcept opportunity | all-or-nothing | linear | weighted --></compositeScoring> <type><!-- 0..* CodeableConcept process | outcome | structure | patient-reported-outcome | composite --></type> <riskAdjustment value="[string]"/><!-- 0..1 How risk adjustment is applied for this measure --> <rateAggregation value="[string]"/><!-- 0..1 How is rate aggregation performed for this measure --> <rationale value="[markdown]"/><!-- 0..1 Detailed description of why the measure exists --> <clinicalRecommendationStatement value="[markdown]"/><!-- 0..1 Summary of clinical guidelines --> <improvementNotation><!-- 0..1 CodeableConcept increase | decrease --></improvementNotation> <definition value="[markdown]"/><!-- 0..* Defined terms used in the measure documentation --> <guidance value="[markdown]"/><!-- 0..1 Additional guidance for implementers --> <group> 0..* BackboneElement <!-- 0..* Population criteria group --> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code><!-- 0..1 CodeableConcept Meaning of the group --></code> <description value="[string]"/><!-- 0..1 Summary description --> <type><!-- 0..* CodeableConcept process | outcome | structure | patient-reported-outcome | composite --></type> <basis value="[code]"/><!-- 0..1 Population basis --> <scoring><!-- 0..1 CodeableConcept proportion | ratio | continuous-variable | cohort --></scoring> <scoringUnit><!-- 0..1 CodeableConcept What units? --></scoringUnit> <improvementNotation><!-- 0..1 CodeableConcept increase | decrease --></improvementNotation> <population> 0..* BackboneElement <!-- 0..* Population criteria --> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code><!-- 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation --></code> <description value="[string]"/><!-- 0..1 The human readable description of this population criteria --> <criteria><!-- 1..1 Expression The criteria that defines this population --></criteria> <inputPopulationId value="[string]"/><!-- 0..1 Which population --> <aggregateMethod><!-- 0..1 CodeableConcept Aggregation method for a measure score (e.g. sum, average, median, minimum, maximum, count) --></aggregateMethod> </population> <stratifier> 0..* BackboneElement <!-- 0..* Stratifier criteria for the measure --> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code><!-- 0..1 CodeableConcept Meaning of the stratifier --></code> <description value="[string]"/><!-- 0..1 The human readable description of this stratifier --> <criteria><!-- 0..1 Expression How the measure should be stratified --></criteria> <component> 0..* BackboneElement <!-- 0..* Stratifier criteria component for the measure --> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code><!-- 0..1 CodeableConcept Meaning of the stratifier component --></code> <description value="[string]"/><!-- 0..1 The human readable description of this stratifier component --> <criteria><!-- 1..1 Expression Component of how the measure should be stratified --></criteria> </component> </stratifier> </group> <supplementalData> 0..* BackboneElement <!-- 0..* What other data should be reported with the measure --> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code><!-- 0..1 CodeableConcept Meaning of the supplemental data --></code> <usage><!-- 0..* CodeableConcept supplemental-data | risk-adjustment-factor --></usage> <description value="[string]"/><!-- 0..1 The human readable description of this supplemental data --> <criteria><!-- 1..1 Expression Expression describing additional data to be reported --></criteria> </supplementalData> </Measure>
{ // Shareable Measure // from Element: extension "meta" : { Meta }, // C?Metadata about the resource "implicitRules" : "<uri>", // C?A set of rules under which this content was created "language" : "<code>", // C?Language of the resource content "text" : { Narrative }, // C?Text summary of the resource, for human interpretation "contained" : [{ Resource }], //Contained, inline Resources "modifierExtension" : [{ Extension }], // C?Extensions that cannot be ignored "url" : "<uri>", // C? R! Canonical identifier for this measure, represented as a URI (globally unique) "identifier" : [{ Identifier }], // C?Additional identifier for the measure "version" : "<string>", // C? R! Business version of the measure "name" : "<string>", // C? R! Name for this measure (computer friendly) "title" : "<string>", // C?Name for this measure (human friendly) "subtitle" : "<string>", // C?Subordinate title of the measure "status" : "<code>", // C? R! draft | active | retired | unknown "experimental" : <boolean>, // C? R! For testing purposes, not real usage // value[x]: E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device. One of these 2: "subjectCodeableConcept" : { CodeableConcept }, // C?E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device "subjectReference" : { Reference(Group) }, // C?E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device "basis" : "<code>", // C?Population basis "date" : "<dateTime>", // C?Date last changed "publisher" : "<string>", // C? R! Name of the publisher (organization or individual) "contact" : [{ ContactDetail }], // C?Contact details for the publisher "description" : "<markdown>", // C? R! Natural language description of the measure "useContext" : [{ UsageContext }], // C?The context that the content is intended to support "jurisdiction" : [{ CodeableConcept }], // C?Intended jurisdiction for measure (if applicable) "purpose" : "<markdown>", // C?Why this measure is defined "usage" : "<string>", // C?Describes the clinical usage of the measure "copyright" : "<markdown>", // C?Use and/or publishing restrictions "approvalDate" : "<date>", // C?When the measure was approved by publisher "lastReviewDate" : "<date>", // C?When the measure was last reviewed "effectivePeriod" : { Period }, // C?When the measure is expected to be used "topic" : [{ CodeableConcept }], // C?The category of the measure, such as Education, Treatment, Assessment, etc. "author" : [{ ContactDetail }], // C?Who authored the content "editor" : [{ ContactDetail }], // C?Who edited the content "reviewer" : [{ ContactDetail }], // C?Who reviewed the content "endorser" : [{ ContactDetail }], // C?Who endorsed the content "relatedArtifact" : [{ RelatedArtifact }], // C?Additional documentation, citations, etc. "library" : ["<canonical>"], // C?Logic used by the measure "disclaimer" : "<markdown>", // C?Disclaimer for use of the measure or its referenced content "scoring" : { CodeableConcept }, // C?proportion | ratio | continuous-variable | cohort "scoringUnit" : { CodeableConcept }, // C?What units? "compositeScoring" : { CodeableConcept }, // C?opportunity | all-or-nothing | linear | weighted "type" : [{ CodeableConcept }], // C?process | outcome | structure | patient-reported-outcome | composite "riskAdjustment" : "<string>", // C?How risk adjustment is applied for this measure "rateAggregation" : "<string>", // C?How is rate aggregation performed for this measure "rationale" : "<markdown>", // C?Detailed description of why the measure exists "clinicalRecommendationStatement" : "<markdown>", // C?Summary of clinical guidelines "improvementNotation" : { CodeableConcept }, // C?increase | decrease "definition" : ["<markdown>"], // C?Defined terms used in the measure documentation "guidance" : "<markdown>", // C?Additional guidance for implementers "group" : [{ BackboneElement }] // C?Population criteria group "supplementalData" : [{ BackboneElement }], // C?What other data should be reported with the measure }
This structure is derived from Measure.
Differential View
This structure is derived from Measure.
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Measure | 1..1 | Measure | A quality measure definition | |
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 | 1..1 | string | Name for this measure (computer friendly) | |
title | S | 0..1 | string | Name for this measure (human friendly) |
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) |
Documentation for this format |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Measure | I | 1..1 | Measure | A quality measure definition |
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: Common Languages (preferred) Max Binding: All Languages: IETF language tag | |
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional content defined by implementations | |
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 | ΣI | 1..1 | string | Name for this measure (computer friendly) |
title | SΣ | 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 | Σ | 1..1 | boolean | For testing purposes, not real usage |
subject[x] | 0..1 | E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device Binding: Subject type (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.). | ||
subjectCodeableConcept | CodeableConcept | |||
subjectReference | Reference(Group) | |||
basis | Σ | 0..1 | code | Population basis Binding: FHIRAllTypes (required) |
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 (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 | 0..* | RelatedArtifact | Additional documentation, citations, etc. | |
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. |
scoringUnit | Σ | 0..1 | CodeableConcept | What units? Binding: Measure Scoring Unit (example) |
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 | id | 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 Binding: MeasureGroupExample (example): Example of measure groups. | |
description | 0..1 | string | Summary description | |
type | Σ | 0..* | CodeableConcept | process | outcome | structure | patient-reported-outcome | composite Binding: MeasureType (extensible) |
basis | Σ | 0..1 | code | Population basis Binding: FHIRAllTypes (required) |
scoring | Σ | 0..1 | CodeableConcept | proportion | ratio | continuous-variable | cohort Binding: MeasureScoring (extensible) |
scoringUnit | Σ | 0..1 | CodeableConcept | What units? Binding: Measure Scoring Unit (example) |
improvementNotation | Σ | 0..1 | CodeableConcept | increase | decrease Binding: MeasureImprovementNotation (required) |
population | 0..* | BackboneElement | Population criteria | |
id | 0..1 | id | 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 | |
inputPopulationId | 0..1 | string | Which population | |
aggregateMethod | 0..1 | CodeableConcept | Aggregation method for a measure score (e.g. sum, average, median, minimum, maximum, count) Binding: Measure Aggregate Method (extensible) | |
stratifier | 0..* | BackboneElement | Stratifier criteria for the measure | |
id | 0..1 | id | 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 Binding: MeasureStratifierExample (example): 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 | id | 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 Binding: MeasureStratifierExample (example): Meaning of the stratifier. | |
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 | id | 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 Binding: MeasureSupplementalDataExample (example): 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 |
XML Template
<!-- Shareable Measure --> <Measure xmlns="http://hl7.org/fhir" > <!-- from Element: extension --> <id value="[id]"/><!-- 0..1 Logical id of this artifact --> <meta><!-- 0..1 Meta Metadata about the resource --></meta> <implicitRules value="[uri]"/><!-- 0..1 A set of rules under which this content was created --> <language value="[code]"/><!-- 0..1 Language of the resource content --> <text><!-- 0..1 Narrative Text summary of the resource, for human interpretation --></text> <contained><!-- 0..* Resource Contained, inline Resources --></contained> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored --></modifierExtension> <url value="[uri]"/><!-- 1..1 Canonical identifier for this measure, represented as a URI (globally unique) --> <identifier><!-- 0..* Identifier Additional identifier for the measure --></identifier> <version value="[string]"/><!-- 1..1 Business version of the measure --> <name value="[string]"/><!-- 1..1 Name for this measure (computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this measure (human friendly) --> <subtitle value="[string]"/><!-- 0..1 Subordinate title of the measure --> <status value="[code]"/><!-- 1..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- 1..1 For testing purposes, not real usage --> <subject[x]><!-- 0..1 CodeableConcept|Reference(Group) E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device --></subject[x]> <basis value="[code]"/><!-- 0..1 Population basis --> <date value="[dateTime]"/><!-- 0..1 Date last changed --> <publisher value="[string]"/><!-- 1..1 Name of the publisher (organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- 1..1 Natural language description of the measure --> <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for measure (if applicable) --></jurisdiction> <purpose value="[markdown]"/><!-- 0..1 Why this measure is defined --> <usage value="[string]"/><!-- 0..1 Describes the clinical usage of the measure --> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <approvalDate value="[date]"/><!-- 0..1 When the measure was approved by publisher --> <lastReviewDate value="[date]"/><!-- 0..1 When the measure was last reviewed --> <effectivePeriod><!-- 0..1 Period When the measure is expected to be used --></effectivePeriod> <topic><!-- 0..* CodeableConcept The category of the measure, such as Education, Treatment, Assessment, etc. --></topic> <author><!-- 0..* ContactDetail Who authored the content --></author> <editor><!-- 0..* ContactDetail Who edited the content --></editor> <reviewer><!-- 0..* ContactDetail Who reviewed the content --></reviewer> <endorser><!-- 0..* ContactDetail Who endorsed the content --></endorser> <relatedArtifact><!-- 0..* RelatedArtifact Additional documentation, citations, etc. --></relatedArtifact> <library value="[canonical]"/><!-- 0..* Logic used by the measure --> <disclaimer value="[markdown]"/><!-- 0..1 Disclaimer for use of the measure or its referenced content --> <scoring><!-- 0..1 CodeableConcept proportion | ratio | continuous-variable | cohort --></scoring> <scoringUnit><!-- 0..1 CodeableConcept What units? --></scoringUnit> <compositeScoring><!-- 0..1 CodeableConcept opportunity | all-or-nothing | linear | weighted --></compositeScoring> <type><!-- 0..* CodeableConcept process | outcome | structure | patient-reported-outcome | composite --></type> <riskAdjustment value="[string]"/><!-- 0..1 How risk adjustment is applied for this measure --> <rateAggregation value="[string]"/><!-- 0..1 How is rate aggregation performed for this measure --> <rationale value="[markdown]"/><!-- 0..1 Detailed description of why the measure exists --> <clinicalRecommendationStatement value="[markdown]"/><!-- 0..1 Summary of clinical guidelines --> <improvementNotation><!-- 0..1 CodeableConcept increase | decrease --></improvementNotation> <definition value="[markdown]"/><!-- 0..* Defined terms used in the measure documentation --> <guidance value="[markdown]"/><!-- 0..1 Additional guidance for implementers --> <group> 0..* BackboneElement <!-- 0..* Population criteria group --> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code><!-- 0..1 CodeableConcept Meaning of the group --></code> <description value="[string]"/><!-- 0..1 Summary description --> <type><!-- 0..* CodeableConcept process | outcome | structure | patient-reported-outcome | composite --></type> <basis value="[code]"/><!-- 0..1 Population basis --> <scoring><!-- 0..1 CodeableConcept proportion | ratio | continuous-variable | cohort --></scoring> <scoringUnit><!-- 0..1 CodeableConcept What units? --></scoringUnit> <improvementNotation><!-- 0..1 CodeableConcept increase | decrease --></improvementNotation> <population> 0..* BackboneElement <!-- 0..* Population criteria --> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code><!-- 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation --></code> <description value="[string]"/><!-- 0..1 The human readable description of this population criteria --> <criteria><!-- 1..1 Expression The criteria that defines this population --></criteria> <inputPopulationId value="[string]"/><!-- 0..1 Which population --> <aggregateMethod><!-- 0..1 CodeableConcept Aggregation method for a measure score (e.g. sum, average, median, minimum, maximum, count) --></aggregateMethod> </population> <stratifier> 0..* BackboneElement <!-- 0..* Stratifier criteria for the measure --> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code><!-- 0..1 CodeableConcept Meaning of the stratifier --></code> <description value="[string]"/><!-- 0..1 The human readable description of this stratifier --> <criteria><!-- 0..1 Expression How the measure should be stratified --></criteria> <component> 0..* BackboneElement <!-- 0..* Stratifier criteria component for the measure --> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code><!-- 0..1 CodeableConcept Meaning of the stratifier component --></code> <description value="[string]"/><!-- 0..1 The human readable description of this stratifier component --> <criteria><!-- 1..1 Expression Component of how the measure should be stratified --></criteria> </component> </stratifier> </group> <supplementalData> 0..* BackboneElement <!-- 0..* What other data should be reported with the measure --> <modifierExtension><!-- 0..* Extension Extensions that cannot be ignored even if unrecognized --></modifierExtension> <code><!-- 0..1 CodeableConcept Meaning of the supplemental data --></code> <usage><!-- 0..* CodeableConcept supplemental-data | risk-adjustment-factor --></usage> <description value="[string]"/><!-- 0..1 The human readable description of this supplemental data --> <criteria><!-- 1..1 Expression Expression describing additional data to be reported --></criteria> </supplementalData> </Measure>
JSON Template
{ // Shareable Measure // from Element: extension "meta" : { Meta }, // C?Metadata about the resource "implicitRules" : "<uri>", // C?A set of rules under which this content was created "language" : "<code>", // C?Language of the resource content "text" : { Narrative }, // C?Text summary of the resource, for human interpretation "contained" : [{ Resource }], //Contained, inline Resources "modifierExtension" : [{ Extension }], // C?Extensions that cannot be ignored "url" : "<uri>", // C? R! Canonical identifier for this measure, represented as a URI (globally unique) "identifier" : [{ Identifier }], // C?Additional identifier for the measure "version" : "<string>", // C? R! Business version of the measure "name" : "<string>", // C? R! Name for this measure (computer friendly) "title" : "<string>", // C?Name for this measure (human friendly) "subtitle" : "<string>", // C?Subordinate title of the measure "status" : "<code>", // C? R! draft | active | retired | unknown "experimental" : <boolean>, // C? R! For testing purposes, not real usage // value[x]: E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device. One of these 2: "subjectCodeableConcept" : { CodeableConcept }, // C?E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device "subjectReference" : { Reference(Group) }, // C?E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device "basis" : "<code>", // C?Population basis "date" : "<dateTime>", // C?Date last changed "publisher" : "<string>", // C? R! Name of the publisher (organization or individual) "contact" : [{ ContactDetail }], // C?Contact details for the publisher "description" : "<markdown>", // C? R! Natural language description of the measure "useContext" : [{ UsageContext }], // C?The context that the content is intended to support "jurisdiction" : [{ CodeableConcept }], // C?Intended jurisdiction for measure (if applicable) "purpose" : "<markdown>", // C?Why this measure is defined "usage" : "<string>", // C?Describes the clinical usage of the measure "copyright" : "<markdown>", // C?Use and/or publishing restrictions "approvalDate" : "<date>", // C?When the measure was approved by publisher "lastReviewDate" : "<date>", // C?When the measure was last reviewed "effectivePeriod" : { Period }, // C?When the measure is expected to be used "topic" : [{ CodeableConcept }], // C?The category of the measure, such as Education, Treatment, Assessment, etc. "author" : [{ ContactDetail }], // C?Who authored the content "editor" : [{ ContactDetail }], // C?Who edited the content "reviewer" : [{ ContactDetail }], // C?Who reviewed the content "endorser" : [{ ContactDetail }], // C?Who endorsed the content "relatedArtifact" : [{ RelatedArtifact }], // C?Additional documentation, citations, etc. "library" : ["<canonical>"], // C?Logic used by the measure "disclaimer" : "<markdown>", // C?Disclaimer for use of the measure or its referenced content "scoring" : { CodeableConcept }, // C?proportion | ratio | continuous-variable | cohort "scoringUnit" : { CodeableConcept }, // C?What units? "compositeScoring" : { CodeableConcept }, // C?opportunity | all-or-nothing | linear | weighted "type" : [{ CodeableConcept }], // C?process | outcome | structure | patient-reported-outcome | composite "riskAdjustment" : "<string>", // C?How risk adjustment is applied for this measure "rateAggregation" : "<string>", // C?How is rate aggregation performed for this measure "rationale" : "<markdown>", // C?Detailed description of why the measure exists "clinicalRecommendationStatement" : "<markdown>", // C?Summary of clinical guidelines "improvementNotation" : { CodeableConcept }, // C?increase | decrease "definition" : ["<markdown>"], // C?Defined terms used in the measure documentation "guidance" : "<markdown>", // C?Additional guidance for implementers "group" : [{ BackboneElement }] // C?Population criteria group "supplementalData" : [{ BackboneElement }], // C?What other data should be reported with the measure }
Alternate definitions: Master Definition (XML, JSON), Schematron
Path | Name | Conformance | ValueSet |
Measure.language | Common Languages | preferred | Common Languages |
Measure.status | PublicationStatus | required | PublicationStatus |
Measure.subject[x] | Subject type | extensible | Subject type |
Measure.basis | FHIRAllTypes | required | FHIRAllTypes |
Measure.jurisdiction | Jurisdiction | extensible | Jurisdiction |
Measure.topic | DefinitionTopic | example | DefinitionTopic |
Measure.scoring | MeasureScoring | extensible | MeasureScoring |
Measure.scoringUnit | Measure Scoring Unit | example | Measure Scoring Unit |
Measure.compositeScoring | CompositeMeasureScoring | extensible | CompositeMeasureScoring |
Measure.type | MeasureType | extensible | MeasureType |
Measure.improvementNotation | MeasureImprovementNotation | required | MeasureImprovementNotation |
Measure.group.code | MeasureGroupExample | example | MeasureGroupExample |
Measure.group.type | MeasureType | extensible | MeasureType |
Measure.group.basis | FHIRAllTypes | required | FHIRAllTypes |
Measure.group.scoring | MeasureScoring | extensible | MeasureScoring |
Measure.group.scoringUnit | Measure Scoring Unit | example | Measure Scoring Unit |
Measure.group.improvementNotation | MeasureImprovementNotation | required | MeasureImprovementNotation |
Measure.group.population.code | MeasurePopulationType | extensible | MeasurePopulationType |
Measure.group.population.aggregateMethod | Measure Aggregate Method | extensible | Measure Aggregate Method |
Measure.group.stratifier.code | MeasureStratifierExample | example | MeasureStratifierExample |
Measure.group.stratifier.component.code | MeasureStratifierExample | example | MeasureStratifierExample |
Measure.supplementalData.code | MeasureSupplementalDataExample | example | MeasureSupplementalDataExample |
Measure.supplementalData.usage | MeasureDataUsage | extensible | MeasureDataUsage |