This page is part of the FHIR Specification (v1.8.0: STU 3 Draft). 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 R3
Clinical Quality Information Work Group | Maturity Level: 0 | Compartments: Not linked to any defined compartments |
The Measure resource provides the definition of a quality measure.
This resource is a draft proposal for use as part of an approach to Clinical Quality within FHIR, and is documented as part of the Clinical Reasoning module.
The Measure resource represents a structured computable definition of a clinical quality measure. A quality measure is a quantitative tool to assess the performance of an individual or organization with respect to a specified process or outcome via the measurement of actions, processes, or outcomes of clinical care. Quality measures are often derived from clinical quidelines and are designed to determine whether the appropriate care has been provided given a set of clinical criteria and an evidence base.
Note that the Measure itself does not contain any logic; rather a Library resource is referenced that contains the logic required by the measure, and the various expression elements, such as poulation criteria, reference named expressions within that library (or libraries). In addition, if the Measure references multiple libraries, then any expression references within the resource must be qualified with the name of the library that contains the referenced expression.
The Measure resource describes a specific quality measure, providing the structure of the measure in terms of the calculation elements (the populations involved). The Group resource is also capable of describing a population, however, the complexity involved in specifying the criteria in the general case requires the use of a high-level query language such as Clinical Quality Language (CQL). As such, the Measure resource defines only the top-level populations and references CQL expressions for the actual criteria.
A Measure is also similar to an Observation resource, with the exception that the Measure is purely definitional, it contains no actual measurements, only a description of how to calculate a particular measurement.
This resource is referenced by measurereport
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Measure | DomainResource | A quality measure definition | ||
url | Σ | 0..1 | uri | Logical uri to reference this measure (globally unique) |
identifier | Σ | 0..* | Identifier | Additional identifier for the measure |
version | Σ | 0..1 | string | Business version of the measure |
name | Σ | 0..1 | string | Name for this measure (Computer friendly) |
title | Σ | 0..1 | string | Name for this measure (Human friendly) |
status | ?!Σ | 1..1 | code | draft | active | retired PublicationStatus (Required) |
experimental | ?!Σ | 0..1 | boolean | If for testing purposes, not real usage |
date | Σ | 0..1 | dateTime | Date this was last changed |
description | 0..1 | markdown | Natural language description of the measure | |
purpose | 0..1 | markdown | Why this measure is defined | |
usage | 0..1 | string | Describes the clinical usage of the measure | |
approvalDate | 0..1 | date | When measure approved by publisher | |
lastReviewDate | 0..1 | date | Last review date for the measure | |
effectivePeriod | Σ | 0..1 | Period | The effective date range for the measure |
useContext | Σ | 0..* | UsageContext | Content intends to support these contexts |
jurisdiction | Σ | 0..* | CodeableConcept | Intended jurisdiction for measure (if applicable) Jurisdiction ValueSet (Extensible) |
topic | 0..* | CodeableConcept | Descriptional topics for the measure | |
contributor | 0..* | Contributor | A content contributor | |
publisher | Σ | 0..1 | string | Name of the publisher (Organization or individual) |
contact | Σ | 0..* | ContactDetail | Contact details for the publisher |
copyright | 0..1 | markdown | Use and/or publishing restrictions | |
relatedArtifact | 0..* | RelatedArtifact | Related artifacts for the measure | |
library | 0..* | Reference(Library) | Logic used by the measure | |
disclaimer | Σ | 0..1 | markdown | Disclaimer for the measure |
scoring | Σ | 0..1 | code | proportion | ratio | continuous-variable | cohort MeasureScoring (Required) |
compositeScoring | Σ | 0..1 | code | opportunity | all-or-nothing | linear | weighted CompositeMeasureScoring (Required) |
type | Σ | 0..* | code | process | outcome | structure | patient-reported-outcome | composite MeasureType (Required) |
riskAdjustment | Σ | 0..1 | string | How is risk adjustment applied for this measure |
rateAggregation | Σ | 0..1 | string | How is rate aggregation performed for this measure |
rationale | Σ | 0..1 | markdown | Why does this measure exist |
clinicalRecommendationStatement | Σ | 0..1 | markdown | Clinical recommendation |
improvementNotation | Σ | 0..1 | string | Improvement notation for the measure, e.g. higher score indicates better quality |
definition | Σ | 0..1 | markdown | A natural language definition of the measure |
guidance | Σ | 0..1 | markdown | The guidance for the measure |
set | Σ | 0..1 | string | The measure set, e.g. Preventive Care and Screening |
group | 0..* | BackboneElement | Population criteria group | |
identifier | 1..1 | Identifier | Unique identifier | |
name | 0..1 | string | Short name | |
description | 0..1 | string | Summary description | |
population | 0..* | BackboneElement | Population criteria | |
type | 1..1 | code | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation MeasurePopulationType (Required) | |
identifier | 1..1 | Identifier | Unique identifier | |
name | 0..1 | string | Short name | |
description | 0..1 | string | The human readable description of this population criteria | |
criteria | 1..1 | string | The name of a valid referenced CQL expression (may be namespaced) that defines this population criteria | |
stratifier | 0..* | BackboneElement | Stratifier criteria for the measure | |
identifier | 1..1 | Identifier | The identifier for the stratifier used to coordinate the reported data back to this stratifier | |
criteria | 0..1 | string | Stratifier criteria | |
path | 0..1 | string | Path to the stratifier | |
supplementalData | 0..* | BackboneElement | Supplemental data | |
identifier | 1..1 | Identifier | Identifier, unique within the measure | |
usage | 0..* | code | supplemental-data | risk-adjustment-factor MeasureDataUsage (Required) | |
criteria | 0..1 | string | Supplemental data criteria | |
path | 0..1 | string | Path to the supplemental data element | |
Documentation for this format |
UML Diagram (Legend)
XML Template
<Measure xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <url value="[uri]"/><!-- 0..1 Logical uri to reference this measure (globally unique) --> <identifier><!-- 0..* Identifier Additional identifier for the measure --></identifier> <version value="[string]"/><!-- 0..1 Business version of the measure --> <name value="[string]"/><!-- 0..1 Name for this measure (Computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this measure (Human friendly) --> <status value="[code]"/><!-- 1..1 draft | active | retired --> <experimental value="[boolean]"/><!-- 0..1 If for testing purposes, not real usage --> <date value="[dateTime]"/><!-- 0..1 Date this was last changed --> <description value="[markdown]"/><!-- 0..1 Natural language description of the measure --> <purpose value="[markdown]"/><!-- 0..1 Why this measure is defined --> <usage value="[string]"/><!-- 0..1 Describes the clinical usage of the measure --> <approvalDate value="[date]"/><!-- 0..1 When measure approved by publisher --> <lastReviewDate value="[date]"/><!-- 0..1 Last review date for the measure --> <effectivePeriod><!-- 0..1 Period The effective date range for the measure --></effectivePeriod> <useContext><!-- 0..* UsageContext Content intends to support these contexts --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for measure (if applicable) --></jurisdiction> <topic><!-- 0..* CodeableConcept Descriptional topics for the measure --></topic> <contributor><!-- 0..* Contributor A content contributor --></contributor> <publisher value="[string]"/><!-- 0..1 Name of the publisher (Organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <relatedArtifact><!-- 0..* RelatedArtifact Related artifacts for the measure --></relatedArtifact> <library><!-- 0..* Reference(Library) Logic used by the measure --></library> <disclaimer value="[markdown]"/><!-- 0..1 Disclaimer for the measure --> <scoring value="[code]"/><!-- 0..1 proportion | ratio | continuous-variable | cohort --> <compositeScoring value="[code]"/><!-- 0..1 opportunity | all-or-nothing | linear | weighted --> <type value="[code]"/><!-- 0..* process | outcome | structure | patient-reported-outcome | composite --> <riskAdjustment value="[string]"/><!-- 0..1 How is risk adjustment applied for this measure --> <rateAggregation value="[string]"/><!-- 0..1 How is rate aggregation performed for this measure --> <rationale value="[markdown]"/><!-- 0..1 Why does this measure exist --> <clinicalRecommendationStatement value="[markdown]"/><!-- 0..1 Clinical recommendation --> <improvementNotation value="[string]"/><!-- 0..1 Improvement notation for the measure, e.g. higher score indicates better quality --> <definition value="[markdown]"/><!-- 0..1 A natural language definition of the measure --> <guidance value="[markdown]"/><!-- 0..1 The guidance for the measure --> <set value="[string]"/><!-- 0..1 The measure set, e.g. Preventive Care and Screening --> <group> <!-- 0..* Population criteria group --> <identifier><!-- 1..1 Identifier Unique identifier --></identifier> <name value="[string]"/><!-- 0..1 Short name --> <description value="[string]"/><!-- 0..1 Summary description --> <population> <!-- 0..* Population criteria --> <type value="[code]"/><!-- 1..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation --> <identifier><!-- 1..1 Identifier Unique identifier --></identifier> <name value="[string]"/><!-- 0..1 Short name --> <description value="[string]"/><!-- 0..1 The human readable description of this population criteria --> <criteria value="[string]"/><!-- 1..1 The name of a valid referenced CQL expression (may be namespaced) that defines this population criteria --> </population> <stratifier> <!-- 0..* Stratifier criteria for the measure --> <identifier><!-- 1..1 Identifier The identifier for the stratifier used to coordinate the reported data back to this stratifier --></identifier> <criteria value="[string]"/><!-- 0..1 Stratifier criteria --> <path value="[string]"/><!-- 0..1 Path to the stratifier --> </stratifier> </group> <supplementalData> <!-- 0..* Supplemental data --> <identifier><!-- 1..1 Identifier Identifier, unique within the measure --></identifier> <usage value="[code]"/><!-- 0..* supplemental-data | risk-adjustment-factor --> <criteria value="[string]"/><!-- 0..1 Supplemental data criteria --> <path value="[string]"/><!-- 0..1 Path to the supplemental data element --> </supplementalData> </Measure>
JSON Template
{ "resourceType" : "Measure", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "url" : "<uri>", // Logical uri to reference this measure (globally unique) "identifier" : [{ Identifier }], // Additional identifier for the measure "version" : "<string>", // Business version of the measure "name" : "<string>", // Name for this measure (Computer friendly) "title" : "<string>", // Name for this measure (Human friendly) "status" : "<code>", // R! draft | active | retired "experimental" : <boolean>, // If for testing purposes, not real usage "date" : "<dateTime>", // Date this was last changed "description" : "<markdown>", // Natural language description of the measure "purpose" : "<markdown>", // Why this measure is defined "usage" : "<string>", // Describes the clinical usage of the measure "approvalDate" : "<date>", // When measure approved by publisher "lastReviewDate" : "<date>", // Last review date for the measure "effectivePeriod" : { Period }, // The effective date range for the measure "useContext" : [{ UsageContext }], // Content intends to support these contexts "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for measure (if applicable) "topic" : [{ CodeableConcept }], // Descriptional topics for the measure "contributor" : [{ Contributor }], // A content contributor "publisher" : "<string>", // Name of the publisher (Organization or individual) "contact" : [{ ContactDetail }], // Contact details for the publisher "copyright" : "<markdown>", // Use and/or publishing restrictions "relatedArtifact" : [{ RelatedArtifact }], // Related artifacts for the measure "library" : [{ Reference(Library) }], // Logic used by the measure "disclaimer" : "<markdown>", // Disclaimer for the measure "scoring" : "<code>", // proportion | ratio | continuous-variable | cohort "compositeScoring" : "<code>", // opportunity | all-or-nothing | linear | weighted "type" : ["<code>"], // process | outcome | structure | patient-reported-outcome | composite "riskAdjustment" : "<string>", // How is risk adjustment applied for this measure "rateAggregation" : "<string>", // How is rate aggregation performed for this measure "rationale" : "<markdown>", // Why does this measure exist "clinicalRecommendationStatement" : "<markdown>", // Clinical recommendation "improvementNotation" : "<string>", // Improvement notation for the measure, e.g. higher score indicates better quality "definition" : "<markdown>", // A natural language definition of the measure "guidance" : "<markdown>", // The guidance for the measure "set" : "<string>", // The measure set, e.g. Preventive Care and Screening "group" : [{ // Population criteria group "identifier" : { Identifier }, // R! Unique identifier "name" : "<string>", // Short name "description" : "<string>", // Summary description "population" : [{ // Population criteria "type" : "<code>", // R! initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation "identifier" : { Identifier }, // R! Unique identifier "name" : "<string>", // Short name "description" : "<string>", // The human readable description of this population criteria "criteria" : "<string>" // R! The name of a valid referenced CQL expression (may be namespaced) that defines this population criteria }], "stratifier" : [{ // Stratifier criteria for the measure "identifier" : { Identifier }, // R! The identifier for the stratifier used to coordinate the reported data back to this stratifier "criteria" : "<string>", // Stratifier criteria "path" : "<string>" // Path to the stratifier }] }], "supplementalData" : [{ // Supplemental data "identifier" : { Identifier }, // R! Identifier, unique within the measure "usage" : ["<code>"], // supplemental-data | risk-adjustment-factor "criteria" : "<string>", // Supplemental data criteria "path" : "<string>" // Path to the supplemental data element }] }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Measure; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:Measure.url [ uri ]; # 0..1 Logical uri to reference this measure (globally unique) fhir:Measure.identifier [ Identifier ], ... ; # 0..* Additional identifier for the measure fhir:Measure.version [ string ]; # 0..1 Business version of the measure fhir:Measure.name [ string ]; # 0..1 Name for this measure (Computer friendly) fhir:Measure.title [ string ]; # 0..1 Name for this measure (Human friendly) fhir:Measure.status [ code ]; # 1..1 draft | active | retired fhir:Measure.experimental [ boolean ]; # 0..1 If for testing purposes, not real usage fhir:Measure.date [ dateTime ]; # 0..1 Date this was last changed fhir:Measure.description [ markdown ]; # 0..1 Natural language description of the measure fhir:Measure.purpose [ markdown ]; # 0..1 Why this measure is defined fhir:Measure.usage [ string ]; # 0..1 Describes the clinical usage of the measure fhir:Measure.approvalDate [ date ]; # 0..1 When measure approved by publisher fhir:Measure.lastReviewDate [ date ]; # 0..1 Last review date for the measure fhir:Measure.effectivePeriod [ Period ]; # 0..1 The effective date range for the measure fhir:Measure.useContext [ UsageContext ], ... ; # 0..* Content intends to support these contexts fhir:Measure.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for measure (if applicable) fhir:Measure.topic [ CodeableConcept ], ... ; # 0..* Descriptional topics for the measure fhir:Measure.contributor [ Contributor ], ... ; # 0..* A content contributor fhir:Measure.publisher [ string ]; # 0..1 Name of the publisher (Organization or individual) fhir:Measure.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher fhir:Measure.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions fhir:Measure.relatedArtifact [ RelatedArtifact ], ... ; # 0..* Related artifacts for the measure fhir:Measure.library [ Reference(Library) ], ... ; # 0..* Logic used by the measure fhir:Measure.disclaimer [ markdown ]; # 0..1 Disclaimer for the measure fhir:Measure.scoring [ code ]; # 0..1 proportion | ratio | continuous-variable | cohort fhir:Measure.compositeScoring [ code ]; # 0..1 opportunity | all-or-nothing | linear | weighted fhir:Measure.type [ code ], ... ; # 0..* process | outcome | structure | patient-reported-outcome | composite fhir:Measure.riskAdjustment [ string ]; # 0..1 How is risk adjustment applied for this measure fhir:Measure.rateAggregation [ string ]; # 0..1 How is rate aggregation performed for this measure fhir:Measure.rationale [ markdown ]; # 0..1 Why does this measure exist fhir:Measure.clinicalRecommendationStatement [ markdown ]; # 0..1 Clinical recommendation fhir:Measure.improvementNotation [ string ]; # 0..1 Improvement notation for the measure, e.g. higher score indicates better quality fhir:Measure.definition [ markdown ]; # 0..1 A natural language definition of the measure fhir:Measure.guidance [ markdown ]; # 0..1 The guidance for the measure fhir:Measure.set [ string ]; # 0..1 The measure set, e.g. Preventive Care and Screening fhir:Measure.group [ # 0..* Population criteria group fhir:Measure.group.identifier [ Identifier ]; # 1..1 Unique identifier fhir:Measure.group.name [ string ]; # 0..1 Short name fhir:Measure.group.description [ string ]; # 0..1 Summary description fhir:Measure.group.population [ # 0..* Population criteria fhir:Measure.group.population.type [ code ]; # 1..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation fhir:Measure.group.population.identifier [ Identifier ]; # 1..1 Unique identifier fhir:Measure.group.population.name [ string ]; # 0..1 Short name fhir:Measure.group.population.description [ string ]; # 0..1 The human readable description of this population criteria fhir:Measure.group.population.criteria [ string ]; # 1..1 The name of a valid referenced CQL expression (may be namespaced) that defines this population criteria ], ...; fhir:Measure.group.stratifier [ # 0..* Stratifier criteria for the measure fhir:Measure.group.stratifier.identifier [ Identifier ]; # 1..1 The identifier for the stratifier used to coordinate the reported data back to this stratifier fhir:Measure.group.stratifier.criteria [ string ]; # 0..1 Stratifier criteria fhir:Measure.group.stratifier.path [ string ]; # 0..1 Path to the stratifier ], ...; ], ...; fhir:Measure.supplementalData [ # 0..* Supplemental data fhir:Measure.supplementalData.identifier [ Identifier ]; # 1..1 Identifier, unique within the measure fhir:Measure.supplementalData.usage [ code ], ... ; # 0..* supplemental-data | risk-adjustment-factor fhir:Measure.supplementalData.criteria [ string ]; # 0..1 Supplemental data criteria fhir:Measure.supplementalData.path [ string ]; # 0..1 Path to the supplemental data element ], ...; ]
Changes since DSTU2
This resource did not exist in Release 2
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Measure | DomainResource | A quality measure definition | ||
url | Σ | 0..1 | uri | Logical uri to reference this measure (globally unique) |
identifier | Σ | 0..* | Identifier | Additional identifier for the measure |
version | Σ | 0..1 | string | Business version of the measure |
name | Σ | 0..1 | string | Name for this measure (Computer friendly) |
title | Σ | 0..1 | string | Name for this measure (Human friendly) |
status | ?!Σ | 1..1 | code | draft | active | retired PublicationStatus (Required) |
experimental | ?!Σ | 0..1 | boolean | If for testing purposes, not real usage |
date | Σ | 0..1 | dateTime | Date this was last changed |
description | 0..1 | markdown | Natural language description of the measure | |
purpose | 0..1 | markdown | Why this measure is defined | |
usage | 0..1 | string | Describes the clinical usage of the measure | |
approvalDate | 0..1 | date | When measure approved by publisher | |
lastReviewDate | 0..1 | date | Last review date for the measure | |
effectivePeriod | Σ | 0..1 | Period | The effective date range for the measure |
useContext | Σ | 0..* | UsageContext | Content intends to support these contexts |
jurisdiction | Σ | 0..* | CodeableConcept | Intended jurisdiction for measure (if applicable) Jurisdiction ValueSet (Extensible) |
topic | 0..* | CodeableConcept | Descriptional topics for the measure | |
contributor | 0..* | Contributor | A content contributor | |
publisher | Σ | 0..1 | string | Name of the publisher (Organization or individual) |
contact | Σ | 0..* | ContactDetail | Contact details for the publisher |
copyright | 0..1 | markdown | Use and/or publishing restrictions | |
relatedArtifact | 0..* | RelatedArtifact | Related artifacts for the measure | |
library | 0..* | Reference(Library) | Logic used by the measure | |
disclaimer | Σ | 0..1 | markdown | Disclaimer for the measure |
scoring | Σ | 0..1 | code | proportion | ratio | continuous-variable | cohort MeasureScoring (Required) |
compositeScoring | Σ | 0..1 | code | opportunity | all-or-nothing | linear | weighted CompositeMeasureScoring (Required) |
type | Σ | 0..* | code | process | outcome | structure | patient-reported-outcome | composite MeasureType (Required) |
riskAdjustment | Σ | 0..1 | string | How is risk adjustment applied for this measure |
rateAggregation | Σ | 0..1 | string | How is rate aggregation performed for this measure |
rationale | Σ | 0..1 | markdown | Why does this measure exist |
clinicalRecommendationStatement | Σ | 0..1 | markdown | Clinical recommendation |
improvementNotation | Σ | 0..1 | string | Improvement notation for the measure, e.g. higher score indicates better quality |
definition | Σ | 0..1 | markdown | A natural language definition of the measure |
guidance | Σ | 0..1 | markdown | The guidance for the measure |
set | Σ | 0..1 | string | The measure set, e.g. Preventive Care and Screening |
group | 0..* | BackboneElement | Population criteria group | |
identifier | 1..1 | Identifier | Unique identifier | |
name | 0..1 | string | Short name | |
description | 0..1 | string | Summary description | |
population | 0..* | BackboneElement | Population criteria | |
type | 1..1 | code | initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation MeasurePopulationType (Required) | |
identifier | 1..1 | Identifier | Unique identifier | |
name | 0..1 | string | Short name | |
description | 0..1 | string | The human readable description of this population criteria | |
criteria | 1..1 | string | The name of a valid referenced CQL expression (may be namespaced) that defines this population criteria | |
stratifier | 0..* | BackboneElement | Stratifier criteria for the measure | |
identifier | 1..1 | Identifier | The identifier for the stratifier used to coordinate the reported data back to this stratifier | |
criteria | 0..1 | string | Stratifier criteria | |
path | 0..1 | string | Path to the stratifier | |
supplementalData | 0..* | BackboneElement | Supplemental data | |
identifier | 1..1 | Identifier | Identifier, unique within the measure | |
usage | 0..* | code | supplemental-data | risk-adjustment-factor MeasureDataUsage (Required) | |
criteria | 0..1 | string | Supplemental data criteria | |
path | 0..1 | string | Path to the supplemental data element | |
Documentation for this format |
XML Template
<Measure xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <url value="[uri]"/><!-- 0..1 Logical uri to reference this measure (globally unique) --> <identifier><!-- 0..* Identifier Additional identifier for the measure --></identifier> <version value="[string]"/><!-- 0..1 Business version of the measure --> <name value="[string]"/><!-- 0..1 Name for this measure (Computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this measure (Human friendly) --> <status value="[code]"/><!-- 1..1 draft | active | retired --> <experimental value="[boolean]"/><!-- 0..1 If for testing purposes, not real usage --> <date value="[dateTime]"/><!-- 0..1 Date this was last changed --> <description value="[markdown]"/><!-- 0..1 Natural language description of the measure --> <purpose value="[markdown]"/><!-- 0..1 Why this measure is defined --> <usage value="[string]"/><!-- 0..1 Describes the clinical usage of the measure --> <approvalDate value="[date]"/><!-- 0..1 When measure approved by publisher --> <lastReviewDate value="[date]"/><!-- 0..1 Last review date for the measure --> <effectivePeriod><!-- 0..1 Period The effective date range for the measure --></effectivePeriod> <useContext><!-- 0..* UsageContext Content intends to support these contexts --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for measure (if applicable) --></jurisdiction> <topic><!-- 0..* CodeableConcept Descriptional topics for the measure --></topic> <contributor><!-- 0..* Contributor A content contributor --></contributor> <publisher value="[string]"/><!-- 0..1 Name of the publisher (Organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <relatedArtifact><!-- 0..* RelatedArtifact Related artifacts for the measure --></relatedArtifact> <library><!-- 0..* Reference(Library) Logic used by the measure --></library> <disclaimer value="[markdown]"/><!-- 0..1 Disclaimer for the measure --> <scoring value="[code]"/><!-- 0..1 proportion | ratio | continuous-variable | cohort --> <compositeScoring value="[code]"/><!-- 0..1 opportunity | all-or-nothing | linear | weighted --> <type value="[code]"/><!-- 0..* process | outcome | structure | patient-reported-outcome | composite --> <riskAdjustment value="[string]"/><!-- 0..1 How is risk adjustment applied for this measure --> <rateAggregation value="[string]"/><!-- 0..1 How is rate aggregation performed for this measure --> <rationale value="[markdown]"/><!-- 0..1 Why does this measure exist --> <clinicalRecommendationStatement value="[markdown]"/><!-- 0..1 Clinical recommendation --> <improvementNotation value="[string]"/><!-- 0..1 Improvement notation for the measure, e.g. higher score indicates better quality --> <definition value="[markdown]"/><!-- 0..1 A natural language definition of the measure --> <guidance value="[markdown]"/><!-- 0..1 The guidance for the measure --> <set value="[string]"/><!-- 0..1 The measure set, e.g. Preventive Care and Screening --> <group> <!-- 0..* Population criteria group --> <identifier><!-- 1..1 Identifier Unique identifier --></identifier> <name value="[string]"/><!-- 0..1 Short name --> <description value="[string]"/><!-- 0..1 Summary description --> <population> <!-- 0..* Population criteria --> <type value="[code]"/><!-- 1..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation --> <identifier><!-- 1..1 Identifier Unique identifier --></identifier> <name value="[string]"/><!-- 0..1 Short name --> <description value="[string]"/><!-- 0..1 The human readable description of this population criteria --> <criteria value="[string]"/><!-- 1..1 The name of a valid referenced CQL expression (may be namespaced) that defines this population criteria --> </population> <stratifier> <!-- 0..* Stratifier criteria for the measure --> <identifier><!-- 1..1 Identifier The identifier for the stratifier used to coordinate the reported data back to this stratifier --></identifier> <criteria value="[string]"/><!-- 0..1 Stratifier criteria --> <path value="[string]"/><!-- 0..1 Path to the stratifier --> </stratifier> </group> <supplementalData> <!-- 0..* Supplemental data --> <identifier><!-- 1..1 Identifier Identifier, unique within the measure --></identifier> <usage value="[code]"/><!-- 0..* supplemental-data | risk-adjustment-factor --> <criteria value="[string]"/><!-- 0..1 Supplemental data criteria --> <path value="[string]"/><!-- 0..1 Path to the supplemental data element --> </supplementalData> </Measure>
JSON Template
{ "resourceType" : "Measure", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "url" : "<uri>", // Logical uri to reference this measure (globally unique) "identifier" : [{ Identifier }], // Additional identifier for the measure "version" : "<string>", // Business version of the measure "name" : "<string>", // Name for this measure (Computer friendly) "title" : "<string>", // Name for this measure (Human friendly) "status" : "<code>", // R! draft | active | retired "experimental" : <boolean>, // If for testing purposes, not real usage "date" : "<dateTime>", // Date this was last changed "description" : "<markdown>", // Natural language description of the measure "purpose" : "<markdown>", // Why this measure is defined "usage" : "<string>", // Describes the clinical usage of the measure "approvalDate" : "<date>", // When measure approved by publisher "lastReviewDate" : "<date>", // Last review date for the measure "effectivePeriod" : { Period }, // The effective date range for the measure "useContext" : [{ UsageContext }], // Content intends to support these contexts "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for measure (if applicable) "topic" : [{ CodeableConcept }], // Descriptional topics for the measure "contributor" : [{ Contributor }], // A content contributor "publisher" : "<string>", // Name of the publisher (Organization or individual) "contact" : [{ ContactDetail }], // Contact details for the publisher "copyright" : "<markdown>", // Use and/or publishing restrictions "relatedArtifact" : [{ RelatedArtifact }], // Related artifacts for the measure "library" : [{ Reference(Library) }], // Logic used by the measure "disclaimer" : "<markdown>", // Disclaimer for the measure "scoring" : "<code>", // proportion | ratio | continuous-variable | cohort "compositeScoring" : "<code>", // opportunity | all-or-nothing | linear | weighted "type" : ["<code>"], // process | outcome | structure | patient-reported-outcome | composite "riskAdjustment" : "<string>", // How is risk adjustment applied for this measure "rateAggregation" : "<string>", // How is rate aggregation performed for this measure "rationale" : "<markdown>", // Why does this measure exist "clinicalRecommendationStatement" : "<markdown>", // Clinical recommendation "improvementNotation" : "<string>", // Improvement notation for the measure, e.g. higher score indicates better quality "definition" : "<markdown>", // A natural language definition of the measure "guidance" : "<markdown>", // The guidance for the measure "set" : "<string>", // The measure set, e.g. Preventive Care and Screening "group" : [{ // Population criteria group "identifier" : { Identifier }, // R! Unique identifier "name" : "<string>", // Short name "description" : "<string>", // Summary description "population" : [{ // Population criteria "type" : "<code>", // R! initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation "identifier" : { Identifier }, // R! Unique identifier "name" : "<string>", // Short name "description" : "<string>", // The human readable description of this population criteria "criteria" : "<string>" // R! The name of a valid referenced CQL expression (may be namespaced) that defines this population criteria }], "stratifier" : [{ // Stratifier criteria for the measure "identifier" : { Identifier }, // R! The identifier for the stratifier used to coordinate the reported data back to this stratifier "criteria" : "<string>", // Stratifier criteria "path" : "<string>" // Path to the stratifier }] }], "supplementalData" : [{ // Supplemental data "identifier" : { Identifier }, // R! Identifier, unique within the measure "usage" : ["<code>"], // supplemental-data | risk-adjustment-factor "criteria" : "<string>", // Supplemental data criteria "path" : "<string>" // Path to the supplemental data element }] }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Measure; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:Measure.url [ uri ]; # 0..1 Logical uri to reference this measure (globally unique) fhir:Measure.identifier [ Identifier ], ... ; # 0..* Additional identifier for the measure fhir:Measure.version [ string ]; # 0..1 Business version of the measure fhir:Measure.name [ string ]; # 0..1 Name for this measure (Computer friendly) fhir:Measure.title [ string ]; # 0..1 Name for this measure (Human friendly) fhir:Measure.status [ code ]; # 1..1 draft | active | retired fhir:Measure.experimental [ boolean ]; # 0..1 If for testing purposes, not real usage fhir:Measure.date [ dateTime ]; # 0..1 Date this was last changed fhir:Measure.description [ markdown ]; # 0..1 Natural language description of the measure fhir:Measure.purpose [ markdown ]; # 0..1 Why this measure is defined fhir:Measure.usage [ string ]; # 0..1 Describes the clinical usage of the measure fhir:Measure.approvalDate [ date ]; # 0..1 When measure approved by publisher fhir:Measure.lastReviewDate [ date ]; # 0..1 Last review date for the measure fhir:Measure.effectivePeriod [ Period ]; # 0..1 The effective date range for the measure fhir:Measure.useContext [ UsageContext ], ... ; # 0..* Content intends to support these contexts fhir:Measure.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for measure (if applicable) fhir:Measure.topic [ CodeableConcept ], ... ; # 0..* Descriptional topics for the measure fhir:Measure.contributor [ Contributor ], ... ; # 0..* A content contributor fhir:Measure.publisher [ string ]; # 0..1 Name of the publisher (Organization or individual) fhir:Measure.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher fhir:Measure.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions fhir:Measure.relatedArtifact [ RelatedArtifact ], ... ; # 0..* Related artifacts for the measure fhir:Measure.library [ Reference(Library) ], ... ; # 0..* Logic used by the measure fhir:Measure.disclaimer [ markdown ]; # 0..1 Disclaimer for the measure fhir:Measure.scoring [ code ]; # 0..1 proportion | ratio | continuous-variable | cohort fhir:Measure.compositeScoring [ code ]; # 0..1 opportunity | all-or-nothing | linear | weighted fhir:Measure.type [ code ], ... ; # 0..* process | outcome | structure | patient-reported-outcome | composite fhir:Measure.riskAdjustment [ string ]; # 0..1 How is risk adjustment applied for this measure fhir:Measure.rateAggregation [ string ]; # 0..1 How is rate aggregation performed for this measure fhir:Measure.rationale [ markdown ]; # 0..1 Why does this measure exist fhir:Measure.clinicalRecommendationStatement [ markdown ]; # 0..1 Clinical recommendation fhir:Measure.improvementNotation [ string ]; # 0..1 Improvement notation for the measure, e.g. higher score indicates better quality fhir:Measure.definition [ markdown ]; # 0..1 A natural language definition of the measure fhir:Measure.guidance [ markdown ]; # 0..1 The guidance for the measure fhir:Measure.set [ string ]; # 0..1 The measure set, e.g. Preventive Care and Screening fhir:Measure.group [ # 0..* Population criteria group fhir:Measure.group.identifier [ Identifier ]; # 1..1 Unique identifier fhir:Measure.group.name [ string ]; # 0..1 Short name fhir:Measure.group.description [ string ]; # 0..1 Summary description fhir:Measure.group.population [ # 0..* Population criteria fhir:Measure.group.population.type [ code ]; # 1..1 initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation fhir:Measure.group.population.identifier [ Identifier ]; # 1..1 Unique identifier fhir:Measure.group.population.name [ string ]; # 0..1 Short name fhir:Measure.group.population.description [ string ]; # 0..1 The human readable description of this population criteria fhir:Measure.group.population.criteria [ string ]; # 1..1 The name of a valid referenced CQL expression (may be namespaced) that defines this population criteria ], ...; fhir:Measure.group.stratifier [ # 0..* Stratifier criteria for the measure fhir:Measure.group.stratifier.identifier [ Identifier ]; # 1..1 The identifier for the stratifier used to coordinate the reported data back to this stratifier fhir:Measure.group.stratifier.criteria [ string ]; # 0..1 Stratifier criteria fhir:Measure.group.stratifier.path [ string ]; # 0..1 Path to the stratifier ], ...; ], ...; fhir:Measure.supplementalData [ # 0..* Supplemental data fhir:Measure.supplementalData.identifier [ Identifier ]; # 1..1 Identifier, unique within the measure fhir:Measure.supplementalData.usage [ code ], ... ; # 0..* supplemental-data | risk-adjustment-factor fhir:Measure.supplementalData.criteria [ string ]; # 0..1 Supplemental data criteria fhir:Measure.supplementalData.path [ string ]; # 0..1 Path to the supplemental data element ], ...; ]
Changes since DSTU2
This resource did not exist in Release 2
Alternate definitions: Master Definition (XML, JSON), XML Schema/Schematron (for ) + JSON Schema, ShEx (for Turtle), JSON-LD (for RDF as JSON-LD),
Path | Definition | Type | Reference |
---|---|---|---|
Measure.status | The lifecycle status of a Value Set or Concept Map. | Required | PublicationStatus |
Measure.jurisdiction | Countries and regions within which this artifact is targeted for use | Extensible | Jurisdiction ValueSet |
Measure.scoring | The scoring type of the measure | Required | MeasureScoring |
Measure.compositeScoring | The composite scoring method of the measure | Required | CompositeMeasureScoring |
Measure.type | The type of measure (includes codes from 2.16.840.1.113883.1.11.20368) | Required | MeasureType |
Measure.group.population.type | The type of population | Required | MeasurePopulationType |
Measure.supplementalData.usage | The intended usage for supplemental data elements in the measure | Required | MeasureDataUsage |
Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
Name | Type | Description | Paths | In Common |
date | date | The measure publication date | Measure.date | |
description | string | Text search against the description of the measure | Measure.description | |
effective | date | Effective time associated with the measure | Measure.effectivePeriod | |
identifier | token | External identifiers for the measure | Measure.identifier | |
jurisdiction | token | Intended jurisdiction for measure | Measure.jurisdiction | |
name | string | Name of the measure | Measure.name | |
publisher | string | Name of the publisher of the measure | Measure.publisher | |
status | token | The current status of the measure | Measure.status | |
title | string | Text search against the title of the measure | Measure.title | |
topic | token | Topics associated with the module | Measure.topic | |
url | uri | The uri that identifies the measure | Measure.url | |
version | token | The version identifier of the measure | Measure.version |