--- type: "resource" title: "Measure" resource: "Measure" --- # Measure ## Introduction ## Scope and Usage The Measure resource represents a structured, potentially computable, definition of a health-related measure such as a clinical quality measure, public health indicator, or population analytics 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 guidelines 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 typically contain any logic; rather a [Library](library) resource is referenced that contains the logic required by the measure, and the various expression elements, such as population 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. Different measure types will contain different population criteria. Some measures may contain multiple rates. Measures can also specify stratifications to subdivide the measure population and/or supplemental data to communicate additional information about a population. The data of interest for a measure is described as a set of data requirements, and include the specific data type, as well as any constraints. If the measure is specified computably, this information may be inferred by static analysis of the logic used to defined the population criteria. This capability is exposed via the $data-requirements operation. This resource is a definition resource from a FHIR workflow perspective - see [Workflow](workflow), specifically [Definition](workflow#definition). For a detailed discussion of how to use the Measure and MeasureReport resources, refer to the [Quality Reporting](clinicalreasoning-quality-reporting) topic. ## Boundaries and Relationships The Measure resource describes a specific quality measure, or population analytic, providing the structure of the measure in terms of the calculation elements (the _populations_ involved). The [Group](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 expressions for the actual criteria. These expressions are typically provided using a [Library](library) resource containing CQL or ELM expressions. In addition, the individual members of a population may be cases such as encounters or procedures and in these cases, the Group resource would be unable to represent the population characteristics accurately. A Measure is also similar to an [ObservationDefinition](observationdefinition) resource, in that it is purely definitional, it contains no actual measurements, only a description of how to calculate a particular measurement or set of measurements. Measure is different from ObservationDefinition in that Measure is intended to provide a computable specification. A Measure is also similar to a clinical document, however a FHIR [Document](documents) is specific to a particular subject, whereas the Measure resource is definitional. ## Background and Context Provides additional detail on exactly how the resource is to be used ## StructureDefinition ### Elements (Simplified) - **[Measure](/measure-definitions#Measure)** [0..*]: - A quality measure definition - **[Measure.url](/measure-definitions#Measure.url)** [0..1]: [uri](/uri) Canonical identifier for this measure, represented as a URI (globally unique) - **[Measure.identifier](/measure-definitions#Measure.identifier)** [0..*]: [Identifier](/Identifier) Additional identifier for the measure - **[Measure.version](/measure-definitions#Measure.version)** [0..1]: [string](/string) Business version of the measure - **[Measure.versionAlgorithm[x]](/measure-definitions#Measure.versionAlgorithm%5Bx%5D)** [0..1]: [string](/string), [Coding](/Coding) extensible:[version-algorithm](/valueset-version-algorithm) How to compare versions - **[Measure.name](/measure-definitions#Measure.name)** [0..1]: [string](/string) Name for this measure (computer friendly) - **[Measure.title](/measure-definitions#Measure.title)** [0..1]: [string](/string) Name for this measure (human friendly) - **[Measure.subtitle](/measure-definitions#Measure.subtitle)** [0..1]: [string](/string) Subordinate title of the measure - **[Measure.status](/measure-definitions#Measure.status)** [1..1]: [code](/code) required:[publication-status](/valueset-publication-status) draft | active | retired | unknown - **[Measure.experimental](/measure-definitions#Measure.experimental)** [0..1]: [boolean](/boolean) For testing only - never for real usage - **[Measure.subject[x]](/measure-definitions#Measure.subject%5Bx%5D)** [0..1]: [CodeableConcept](/CodeableConcept), Reference([Group](/Group)) extensible:[participant-resource-types](/valueset-participant-resource-types) E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device - **[Measure.date](/measure-definitions#Measure.date)** [0..1]: [dateTime](/dateTime) Date last changed - **[Measure.publisher](/measure-definitions#Measure.publisher)** [0..1]: [string](/string) Name of the publisher/steward (organization or individual) - **[Measure.contact](/measure-definitions#Measure.contact)** [0..*]: [ContactDetail](/ContactDetail) Contact details for the publisher - **[Measure.description](/measure-definitions#Measure.description)** [0..1]: [markdown](/markdown) Natural language description of the measure - **[Measure.useContext](/measure-definitions#Measure.useContext)** [0..*]: [UsageContext](/UsageContext) The context that the content is intended to support - **[Measure.jurisdiction](/measure-definitions#Measure.jurisdiction)** [0..*]: [CodeableConcept](/CodeableConcept) extensible:[jurisdiction](/valueset-jurisdiction) Jurisdiction of the authority that maintains the measure (if applicable) - **[Measure.purpose](/measure-definitions#Measure.purpose)** [0..1]: [markdown](/markdown) Why this measure is defined - **[Measure.usage](/measure-definitions#Measure.usage)** [0..1]: [markdown](/markdown) Describes the clinical usage of the measure - **[Measure.copyright](/measure-definitions#Measure.copyright)** [0..1]: [markdown](/markdown) Notice about intellectual property ownership, can include restrictions on use - **[Measure.copyrightLabel](/measure-definitions#Measure.copyrightLabel)** [0..1]: [string](/string) Copyright holder and year(s) - **[Measure.approvalDate](/measure-definitions#Measure.approvalDate)** [0..1]: [date](/date) When the measure was approved by publisher - **[Measure.lastReviewDate](/measure-definitions#Measure.lastReviewDate)** [0..1]: [date](/date) When the measure was last reviewed by the publisher - **[Measure.effectivePeriod](/measure-definitions#Measure.effectivePeriod)** [0..1]: [Period](/Period) When the measure is expected to be used - **[Measure.reportingFrequency](/measure-definitions#Measure.reportingFrequency)** [0..1]: [Quantity](/Quantity) extensible:[frequency-unit](/valueset-frequency-unit) The frequency in which this measure should be reported (e.g. 1 '/a' - yearly, 4 '/a' - quarterly) - **[Measure.topic](/measure-definitions#Measure.topic)** [0..*]: [CodeableConcept](/CodeableConcept) example:[definition-topic](/valueset-definition-topic) The category of the measure, such as Education, Treatment, Assessment, etc - **[Measure.author](/measure-definitions#Measure.author)** [0..*]: [ContactDetail](/ContactDetail) Who authored the content - **[Measure.editor](/measure-definitions#Measure.editor)** [0..*]: [ContactDetail](/ContactDetail) Who edited the content - **[Measure.reviewer](/measure-definitions#Measure.reviewer)** [0..*]: [ContactDetail](/ContactDetail) Who reviewed the content - **[Measure.endorser](/measure-definitions#Measure.endorser)** [0..*]: [ContactDetail](/ContactDetail) Who endorsed the content - **[Measure.relatedArtifact](/measure-definitions#Measure.relatedArtifact)** [0..*]: [RelatedArtifact](/RelatedArtifact) Additional documentation, citations, etc - **[Measure.library](/measure-definitions#Measure.library)** [0..*]: [canonical](/canonical) Logic used by the measure - **[Measure.disclaimer](/measure-definitions#Measure.disclaimer)** [0..1]: [markdown](/markdown) Disclaimer for use of the measure or its referenced content - **[Measure.riskAdjustment](/measure-definitions#Measure.riskAdjustment)** [0..1]: [markdown](/markdown) How risk adjustment is applied for this measure - **[Measure.rateAggregation](/measure-definitions#Measure.rateAggregation)** [0..1]: [markdown](/markdown) How is rate aggregation performed for this measure - **[Measure.rationale](/measure-definitions#Measure.rationale)** [0..1]: [markdown](/markdown) Justification for the measure in terms of impact, gap in care, and evidence - **[Measure.clinicalRecommendationStatement](/measure-definitions#Measure.clinicalRecommendationStatement)** [0..1]: [markdown](/markdown) Summary of clinical guidelines - **[Measure.term](/measure-definitions#Measure.term)** [0..*]: [BackboneElement](/BackboneElement) Defined terms used in the measure documentation - **[Measure.term.code](/measure-definitions#Measure.term.code)** [0..1]: [CodeableConcept](/CodeableConcept) example:[measure-definition-example](/valueset-measure-definition-example) What term? - **[Measure.term.definition](/measure-definitions#Measure.term.definition)** [0..1]: [markdown](/markdown) Meaning of the term - **[Measure.guidance](/measure-definitions#Measure.guidance)** [0..1]: [markdown](/markdown) Additional guidance for implementers (deprecated) - **[Measure.group](/measure-definitions#Measure.group)** [0..*]: [BackboneElement](/BackboneElement) Population criteria group - **[Measure.group.linkId](/measure-definitions#Measure.group.linkId)** [0..1]: [string](/string) Unique id for group in measure - **[Measure.group.title](/measure-definitions#Measure.group.title)** [0..1]: [string](/string) Title of the group. This title is expected in the corresponding MeasureReport.group.title - **[Measure.group.code](/measure-definitions#Measure.group.code)** [0..1]: [CodeableConcept](/CodeableConcept) example:[measure-group-example](/valueset-measure-group-example) Meaning of the group - **[Measure.group.description](/measure-definitions#Measure.group.description)** [0..1]: [markdown](/markdown) Summary description - **[Measure.group.type](/measure-definitions#Measure.group.type)** [0..*]: [CodeableConcept](/CodeableConcept) extensible:[measure-type](/valueset-measure-type) process | outcome | structure | patient-reported-outcome - **[Measure.group.subject[x]](/measure-definitions#Measure.group.subject%5Bx%5D)** [0..1]: [CodeableConcept](/CodeableConcept), Reference([Group](/Group)) extensible:[participant-resource-types](/valueset-participant-resource-types) E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device - **[Measure.group.basis](/measure-definitions#Measure.group.basis)** [0..1]: [code](/code) required:[fhir-types](/valueset-fhir-types) Population basis - **[Measure.group.basisRequirement](/measure-definitions#Measure.group.basisRequirement)** [0..*]: [DataRequirement](/DataRequirement) Population basis requirements - **[Measure.group.scoring](/measure-definitions#Measure.group.scoring)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[measure-scoring](/valueset-measure-scoring) proportion | ratio | continuous-variable | cohort | composite - **[Measure.group.scoringUnit](/measure-definitions#Measure.group.scoringUnit)** [0..1]: [CodeableConcept](/CodeableConcept) example:[measure-scoring-unit](/valueset-measure-scoring-unit) What units? - **[Measure.group.scoringPrecision](/measure-definitions#Measure.group.scoringPrecision)** [0..1]: [positiveInt](/positiveInt) How many decimals (The number of decimal places to include in the score when the score is a decimal-valued result) - **[Measure.group.compositeScoring](/measure-definitions#Measure.group.compositeScoring)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[composite-measure-scoring](/valueset-composite-measure-scoring) opportunity | all-or-nothing | linear | weighted - **[Measure.group.component](/measure-definitions#Measure.group.component)** [0..*]: [BackboneElement](/BackboneElement) A component of a composite measure - **[Measure.group.component.measure](/measure-definitions#Measure.group.component.measure)** [0..1]: [canonical](/canonical) What measure? - **[Measure.group.component.groupId](/measure-definitions#Measure.group.component.groupId)** [0..1]: [string](/string) What group? - **[Measure.group.component.weight](/measure-definitions#Measure.group.component.weight)** [0..1]: [decimal](/decimal) What weight? - **[Measure.group.rateAggregation](/measure-definitions#Measure.group.rateAggregation)** [0..1]: [markdown](/markdown) How is rate aggregation performed for this measure - **[Measure.group.improvementNotation](/measure-definitions#Measure.group.improvementNotation)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[measure-improvement-notation](/valueset-measure-improvement-notation) increase | decrease - **[Measure.group.improvementNotationGuidance](/measure-definitions#Measure.group.improvementNotationGuidance)** [0..1]: [markdown](/markdown) Explanation of improvement notation - **[Measure.group.library](/measure-definitions#Measure.group.library)** [0..*]: [canonical](/canonical) Logic used by the measure group - **[Measure.group.population](/measure-definitions#Measure.group.population)** [0..*]: [BackboneElement](/BackboneElement) Population criteria - **[Measure.group.population.linkId](/measure-definitions#Measure.group.population.linkId)** [0..1]: [string](/string) Unique id for population in measure - **[Measure.group.population.title](/measure-definitions#Measure.group.population.title)** [0..1]: [string](/string) Title of the group's population. This title is expected in the corresponding MeasureReport.group.population.title - **[Measure.group.population.code](/measure-definitions#Measure.group.population.code)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[measure-population](/valueset-measure-population) initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation - **[Measure.group.population.description](/measure-definitions#Measure.group.population.description)** [0..1]: [markdown](/markdown) The human readable description of this population criteria - **[Measure.group.population.criteria](/measure-definitions#Measure.group.population.criteria)** [0..1]: [Expression](/Expression) The criteria that defines this population - **[Measure.group.population.groupDefinition](/measure-definitions#Measure.group.population.groupDefinition)** [0..1]: Reference([Group](/Group)) A group resource that defines this population - **[Measure.group.population.inputPopulationId](/measure-definitions#Measure.group.population.inputPopulationId)** [0..1]: [string](/string) Which population - **[Measure.group.population.aggregateMethod](/measure-definitions#Measure.group.population.aggregateMethod)** [0..1]: [CodeableConcept](/CodeableConcept) extensible:[measure-aggregate-method](/valueset-measure-aggregate-method) Aggregation method for a measure score (e.g. sum, average, median, minimum, maximum, count) - **[Measure.group.stratifier](/measure-definitions#Measure.group.stratifier)** [0..*]: [BackboneElement](/BackboneElement) Stratifier criteria for the measure - **[Measure.group.stratifier.linkId](/measure-definitions#Measure.group.stratifier.linkId)** [0..1]: [string](/string) Unique id for stratifier in measure - **[Measure.group.stratifier.title](/measure-definitions#Measure.group.stratifier.title)** [0..1]: [string](/string) Title of a group's stratifier. This title is expected in the corresponding MeasureReport.group.title - **[Measure.group.stratifier.code](/measure-definitions#Measure.group.stratifier.code)** [0..1]: [CodeableConcept](/CodeableConcept) example:[measure-stratifier-example](/valueset-measure-stratifier-example) Meaning of the stratifier - **[Measure.group.stratifier.description](/measure-definitions#Measure.group.stratifier.description)** [0..1]: [markdown](/markdown) The human readable description of this stratifier - **[Measure.group.stratifier.criteria](/measure-definitions#Measure.group.stratifier.criteria)** [0..1]: [Expression](/Expression) How the measure should be stratified - **[Measure.group.stratifier.groupDefinition](/measure-definitions#Measure.group.stratifier.groupDefinition)** [0..1]: Reference([Group](/Group)) A group resource that defines this population - **[Measure.group.stratifier.component](/measure-definitions#Measure.group.stratifier.component)** [0..*]: [BackboneElement](/BackboneElement) Stratifier criteria component for the measure - **[Measure.group.stratifier.component.linkId](/measure-definitions#Measure.group.stratifier.component.linkId)** [0..1]: [string](/string) Unique id for stratifier component in measure - **[Measure.group.stratifier.component.code](/measure-definitions#Measure.group.stratifier.component.code)** [0..1]: [CodeableConcept](/CodeableConcept) example:[measure-stratifier-example](/valueset-measure-stratifier-example) Meaning of the stratifier component - **[Measure.group.stratifier.component.description](/measure-definitions#Measure.group.stratifier.component.description)** [0..1]: [markdown](/markdown) The human readable description of this stratifier component - **[Measure.group.stratifier.component.criteria](/measure-definitions#Measure.group.stratifier.component.criteria)** [0..1]: [Expression](/Expression) Component of how the measure should be stratified - **[Measure.group.stratifier.component.groupDefinition](/measure-definitions#Measure.group.stratifier.component.groupDefinition)** [0..1]: Reference([Group](/Group)) A group resource that defines this population - **[Measure.group.stratifier.component.valueSet](/measure-definitions#Measure.group.stratifier.component.valueSet)** [0..1]: [canonical](/canonical) What stratum values? - **[Measure.group.stratifier.component.unit](/measure-definitions#Measure.group.stratifier.component.unit)** [0..1]: [string](/string) What units? - **[Measure.supplementalData](/measure-definitions#Measure.supplementalData)** [0..*]: [BackboneElement](/BackboneElement) What other data should be reported with the measure - **[Measure.supplementalData.linkId](/measure-definitions#Measure.supplementalData.linkId)** [0..1]: [string](/string) Unique id for supplementalData in measure - **[Measure.supplementalData.code](/measure-definitions#Measure.supplementalData.code)** [0..1]: [CodeableConcept](/CodeableConcept) example:[measure-supplemental-data-example](/valueset-measure-supplemental-data-example) Meaning of the supplemental data - **[Measure.supplementalData.usage](/measure-definitions#Measure.supplementalData.usage)** [0..*]: [CodeableConcept](/CodeableConcept) extensible:[measure-data-usage](/valueset-measure-data-usage) supplemental-data | risk-adjustment-factor - **[Measure.supplementalData.description](/measure-definitions#Measure.supplementalData.description)** [0..1]: [markdown](/markdown) The human readable description of this supplemental data - **[Measure.supplementalData.criteria](/measure-definitions#Measure.supplementalData.criteria)** [1..1]: [Expression](/Expression) Expression describing additional data to be reported - **[Measure.supplementalData.valueSet](/measure-definitions#Measure.supplementalData.valueSet)** [0..1]: [canonical](/canonical) What supplemental data values? - **[Measure.supplementalData.unit](/measure-definitions#Measure.supplementalData.unit)** [0..1]: [string](/string) What units? ## Mappings - [Measure Mappings](/measure-mappings) — 123 mapping entries ## Operations - [care-gaps](/measure-operation-care-gaps) — Care Gaps — The care-gaps operation is used to determine gaps-in-care based on the results of quality measures - [collect-data](/measure-operation-collect-data) — Collect Data — The collect-data operation is used to collect the data-of-interest for the given measure. - [data-requirements](/measure-operation-data-requirements) — Data Requirements — The data-requirements operation aggregates and returns the parameters and data requirements for the measure and all its dependencies as a single module definition - [evaluate](/measure-operation-evaluate) — Evaluate — The evaluate operation processes the given Measure(s) to produce the corresponding MeasureReport(s). - [evaluate-measure](/measure-operation-evaluate-measure) — Evaluate Measure — The evaluate-measure operation is used to calculate an eMeasure and obtain the results - [submit-data](/measure-operation-submit-data) — Submit Data — The submit-data operation is used to submit data-of-interest for one or more measures for one or more subjects. [Full Operations](/measure-operations) ## Resource Packs ### list-Measure-packs.xml ```xml ``` ## Search Parameters - [composed-of](/measure-search#composed-of) — **reference** — What resource is being referenced — `Measure.relatedArtifact.where(type='composed-of').resource` - [context](/measure-search#context) — **token** — A use context assigned to the measure — `(Measure.useContext.value.ofType(CodeableConcept))` - [context-quantity](/measure-search#context-quantity) — **quantity** — A quantity- or range-valued use context assigned to the measure — `(Measure.useContext.value.ofType(Quantity)) | (Measure.useContext.value.ofType(Range))` - [context-type](/measure-search#context-type) — **token** — A type of use context assigned to the measure — `Measure.useContext.code` - [context-type-quantity](/measure-search#context-type-quantity) — **composite** — A use context type and quantity- or range-based value assigned to the measure — `Measure.useContext` - [context-type-value](/measure-search#context-type-value) — **composite** — A use context type and value assigned to the measure — `Measure.useContext` - [date](/measure-search#date) — **date** — The measure publication date — `Measure.date` - [depends-on](/measure-search#depends-on) — **reference** — What resource is being referenced — `Measure.relatedArtifact.where(type='depends-on').resource | Measure.library` - [derived-from](/measure-search#derived-from) — **reference** — What resource is being referenced — `Measure.relatedArtifact.where(type='derived-from').resource` - [description](/measure-search#description) — **string** — The description of the measure — `Measure.description` - [effective](/measure-search#effective) — **date** — The time during which the measure is intended to be in use — `Measure.effectivePeriod` - [identifier](/measure-search#identifier) — **token** — External identifier for the measure — `Measure.identifier` - [jurisdiction](/measure-search#jurisdiction) — **token** — Jurisdiction of the authority that maintains the the measure — `Measure.jurisdiction` - [name](/measure-search#name) — **string** — Computationally friendly name of the measure — `Measure.name` - [predecessor](/measure-search#predecessor) — **reference** — What resource is being referenced — `Measure.relatedArtifact.where(type='predecessor').resource` - [publisher](/measure-search#publisher) — **string** — Name of the publisher of the measure — `Measure.publisher` - [status](/measure-search#status) — **token** — The current status of the measure — `Measure.status` - [subject-code](/measure-search#subject-code) — **token** — The subject of the Measure when expressed as a code — `Measure.subject as CodeableConcept` - [subject-reference](/measure-search#subject-reference) — **reference** — The subject of the Measure when expressed as a reference — `Measure.subject as Reference` - [subject-canonical](/measure-search#subject-canonical) — **reference** — The subject of the Measure when expressed as a canonical — `Measure.subject as canonical` - [successor](/measure-search#successor) — **reference** — What resource is being referenced — `Measure.relatedArtifact.where(type='successor').resource` - [title](/measure-search#title) — **string** — The human-friendly name of the measure — `Measure.title` - [topic](/measure-search#topic) — **token** — Topics associated with the measure — `Measure.topic` - [url](/measure-search#url) — **uri** — The uri that identifies the measure — `Measure.url` - [version](/measure-search#version) — **token** — The business version of the measure — `Measure.version` - [experimental](/measure-search#experimental) — **token** — Whether the Measure is experimental — `Measure.experimental` [Full Search Parameters](/measure-search) ## Examples - [component-a-example](/measure-example-component-a-example) — measure-component-a-example — Screening for Alcohol Misuse - Component A of a Composite Measure - [component-b-example](/measure-example-component-b-example) — measure-component-b-example — Screening for Depression - Component B of a Composite Measure Example - [composite-example](/measure-example-composite-example) — measure-composite-example — Behavioral Health Assessment - Composite Measure Example - [hiv-indicators](/measure-example-hiv-indicators) — measure-hiv-indicators — Example of Measure to define public health reporting data elements - [measure-BCSComponent](/measure-example-measure-BCSComponent) — measure-BCSComponent — Example of Proportion Measure - [measure-cms146-example](/measure-example-measure-cms146-example) — measure-cms146-example — Appropriate Testing for Children with Pharyngitis - [measure-example](/measure-example-measure-example) — measure-example - [measure-examples-header](/measure-example-measure-examples-header) — measure-examples-header - [measure-exclusive-breastfeeding](/measure-example-measure-exclusive-breastfeeding) — measure-exclusive-breastfeeding — Exclusive Breastfeeding Measure - [measure-EXM55-FHIR](/measure-example-measure-EXM55-FHIR) — measure-EXM55-FHIR — Example of Continuous Variable Measure - [measure-hybrid-hospital-wide-mortality](/measure-example-measure-hybrid-hospital-wide-mortality) — measure-hybrid-hospital-wide-mortality — Example of Cohort Measure - [measure-predecessor-example](/measure-example-measure-predecessor-example) — measure-predecessor-example — Predecessor example - Exclusive Breastfeeding [Full Examples](/measure-examples) ## Mapping Exceptions ### measure-definition-mapping-exceptions.xml ### Divergent Elements - **Definition.url** → **Measure.url** - shortUnmatched | reason=Unknown | pattern=Canonical identifier for this measure, represented as an absolute URI (globally unique) | resource=Canonical identifier for this measure, represented as a URI (globally unique) - commentsUnmatched | reason=Unknown | pattern=Can be a `urn:uuid:` or a `urn:oid:` but real `http/s:` addresses are preferred. Multiple instances may share the same URL if they have a distinct version. The determination of when to create a new version of a resource (same url, new version) vs. defining a new artifact is up to the author. Considerations for making this decision are found in [Technical and Business Versions](resource.html#versions). In some cases, the resource can no longer be found at the stated url, but the url itself cannot change. Implementations can use the [meta.source](resource.html#meta) element to indicate where the current master source of the resource can be found. | resource=Can be a urn:uuid: or a urn:oid: but real http: addresses are preferred. Multiple instances may share the same URL if they have a distinct version. The determination of when to create a new version of a resource (same url, new version) vs. defining a new artifact is up to the author. Considerations for making this decision are found in [Technical and Business Versions](resource.html#versions). In some cases, the resource can no longer be found at the stated url, but the url itself cannot change. Implementations can use the [meta.source](resource.html#meta) element to indicate where the current master source of the resource can be found. - **Definition.identifier** → **Measure.identifier** - shortUnmatched | reason=Unknown | pattern=Business identifier for measure | resource=Additional identifier for the measure - commentsUnmatched | reason=Unknown | pattern=Typically, this is used for identifiers that can go in an HL7 V3 II (instance identifier) data type, and can then identify this measure outside of FHIR, where it is not possible to use the logical URI. - requirementsUnmatched | reason=Unknown | pattern=Allows externally provided and/or usable business identifiers to be easily associated with the measure. | resource=Allows externally provided and/or usable business identifiers to be easily associated with the module. - **Definition.version** → **Measure.version** - commentsUnmatched | reason=Unknown | pattern=There may be different measures that have the same url but different versions. The version can be appended to the url in a reference to allow a reference to a particular business version of the measure with the format. The version SHOULD NOT contain a '#' - see [Business Version](resource.html#bv-format). | resource=There may be different measure instances that have the same identifier but different versions. The version can be appended to the url in a reference to allow a reference to a particular business version of the measure with the format [url]|[version]. The version SHOULD NOT contain a '#' - see [Business Version](resource.html#bv-format). - **Definition.name** → **Measure.name** - commentsUnmatched | reason=Unknown | pattern=The name is not expected to be globally unique. The name should be a simple alphanumeric type no-whitespace name to ensure that it is machine-processing friendly. | resource=The name is not expected to be globally unique. The name should be a simple alphanumeric type name to ensure that it is machine-processing friendly. - requirementsUnmatched | reason=Unknown | pattern=Supports code generation. | resource=Support human navigation and code generation. - **Definition.status** → **Measure.status** - definitionUnmatched | reason=Unknown | pattern=The current state of this measure. | resource=The status of this measure. Enables tracking the life-cycle of the content. - commentsUnmatched | reason=Unknown | pattern=A nominal state-transition diagram can be found in the] documentation Unknown does not represent 'other' - one of the defined statuses must apply. Unknown is used when the authoring system is not sure what the current status is. | resource=Allows filtering of measures that are appropriate for use versus not. See guidance around (not) making local changes to elements [here](canonicalresource.html#localization). - requirementsUnmatched | reason=Unknown | pattern=Enables tracking the lifecycle of the content and filtering of measures that are appropriate for use versus not. - **Definition.description** → **Measure.description** - commentsUnmatched | reason=Unknown | pattern=This description can be used to capture details such as comments about misuse, instructions for clinical use and interpretation, literature references, examples from the paper world, etc. It is not a rendering of the measure as conveyed in the 'text' field of the resource itself. This item SHOULD be populated unless the information is available from context. | resource=This description can be used to capture details such as comments about misuse, instructions for clinical use and interpretation, literature references, examples from the paper world, etc. It is not a rendering of the measure as conveyed in the 'text' field of the resource itself. This item SHOULD be populated unless the information is available from context (e.g. the language of the measure is presumed to be the predominant language in the place the measure was created). - **Definition.useContext** → **Measure.useContext** - definitionUnmatched | reason=Unknown | pattern=The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate measures. | resource=The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate measure instances. - commentsUnmatched | reason=Unknown | pattern=When multiple useContexts are specified, there is no expectation that all or even any of the contexts apply. | resource=When multiple useContexts are specified, there is no expectation that all or any of the contexts apply. - **Definition.jurisdiction** → **Measure.jurisdiction** - shortUnmatched | reason=Unknown | pattern=Intended jurisdiction for measure (if applicable) | resource=Jurisdiction of the authority that maintains the measure (if applicable) - definitionUnmatched | reason=Unknown | pattern=A legal or geographic region in which the measure is intended to be used. | resource=A legal or geographic region in which the authority that maintains the resource is operating. In general, the jurisdiction is also found in the useContext. The useContext may reference additional jurisdictions because the defining jurisdiction does not necessarily limit the jurisdictions of use. - commentsUnmatched | reason=Unknown | pattern=It may be possible for the measure to be used in jurisdictions other than those for which it was originally designed or intended DEPRECATION NOTE: For consistency, implementations are encouraged to migrate to using the new 'jurisdiction' code in the useContext element. (I.e. useContext.code indicating http://terminology.hl7.org/CodeSystem/usage-context-type#jurisdiction and useContext.valueCodeableConcept indicating the jurisdiction.). | resource=It may be possible for the measure to be used in jurisdictions other than those for which it was originally designed or intended. DEPRECATION NOTE: For consistency, implementations are encouraged to migrate to using the new 'jurisdiction' code in the useContext element. (I.e. useContext.code indicating http://terminology.hl7.org/CodeSystem/usage-context-type#jurisdiction and useContext.valueCodeableConcept indicating the jurisdiction.) - **Definition.copyright** → **Measure.copyright** - requirementsUnmatched | reason=Unknown | pattern=Consumers of the measure must be able to determine any legal restrictions on the use of the artifact and/or its content. | resource=Consumers must be able to determine any legal restrictions on the use of the measure and/or its content. - **Definition.effectivePeriod** → **Measure.effectivePeriod** - commentsUnmatched | reason=Unknown | pattern=The effective period for a measure determines when the content is applicable for usage and is independent of publication and review dates. For example, a measure intended to be used for the year 2016 might be published in 2015. | resource=The effective period for a measure determines when the content is applicable for usage and is independent of publication and review dates. For example, a measure intended to be used for the year 2016 might be published in 2015. See guidance around (not) making local changes to elements [here](canonicalresource.html#localization). ### Unmapped Elements - **Definition.derivedFromCanonical** — Unknown - **Definition.product** — Unknown - **Definition.code** — Unknown - **Definition.subject** — Unknown - **Definition.derivedFromUri** — Unknown - **Definition.performerType** — Unknown - **Definition.partOf** — Unknown - **Definition.topic** — Unknown ### measure-fivews-mapping-exceptions.xml ### Unmapped Elements - **FiveWs.what** — Unknown - **FiveWs.author** — Unknown - **FiveWs.actor** — Unknown - **FiveWs.cause** — Unknown - **FiveWs.where** — Unknown - **FiveWs.context** — Unknown - **FiveWs.init** — Unknown - **FiveWs.source** — Unknown - **FiveWs.who** — Unknown - **FiveWs.grade** — Unknown - **FiveWs.planned** — Unknown - **FiveWs.done** — Unknown - **FiveWs.subject** — Unknown