Da Vinci Value-Based Performance Reporting Implementation Guide
1.1.0 - STU 1.1 United States of America flag

Da Vinci Value-Based Performance Reporting Implementation Guide, published by HL7 International / Clinical Quality Information. This guide is not an authorized publication; it is the continuous build for version 1.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/davinci-vbpr/ and changes regularly. See the Directory of published versions

Resource Profile: Value-Based Performance Measure

Official URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/vbp-measure Version: 1.1.0
Standards status: Trial-use Maturity Level: 1 Computable Name: VbpMeasure
Other Identifiers: OID:2.16.840.1.113883.4.642.40.30.42.13

The measure definition that describes value-based contract level information for a value-based performance report.

The Formal Views below provides the formal summary, definitions, and terminology requirements.

Each Value-Based Performance Measure has the following mandatory elements:

  1. A url - a canonical identifier for this measure (value-based contract)
  2. A version - version of the measure (value-based contract)
  3. A name - a computer friendly name for this measure (value-based contract)
  4. A status - status of this measure
  5. An experimental element - set to true if for testing
  6. A publisher - name of the publisher for this measure (value-based contract)
  7. A description - description of the measure (value-based contract)

Each Value-Based Performance Measure should have the following elements:

  1. Zero to many identifier - business identifier of the measure (value-based contract)
  2. Zero to one title - a human friendly title for this measure (value-based contract)
  3. Zero to one effectivePeriod - effective period of the measure, which is the contract term period for a value-based contract
  4. Zero to one lineOfBusiness - line of business for the measure (value-based contract)
  5. Zero to many paymentStream - list of payment streams covered in the measure (value-based contract)
  6. Zeor to one programModel - program model for the measure (value-based contract) based on the HPCLAN Framework
  7. Zero to many group.code - list of performance metrics that could be reported on the measure (value-based contract)
  8. zero to many relatedArtifact - list of quality measures specified in the value-based contract that ties to the payment stream based on quality measures
  9. zero to one relatedArtifact.weight for each relatedArtifact - the weight of a quality measure that contributes to the scoring

Usages:

Formal Views of Profile Content

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

This structure is derived from CRMIShareableMeasure

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure 1..1 CRMIShareableMeasure A quality measure definition
... Slices for extension Content/Rules for all slices
.... extension:lineOfBusiness S 0..1 CodeableConcept Line of Business
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/lob
Binding: Line of Business Value Set (extensible)
.... extension:programModel S 0..* (Complex) Program Model
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/program-model
.... extension:paymentStream S 0..* (Complex) Payment Stream
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/payment-stream
... identifier S 0..* Identifier Business identifier of this measure, e.g., value-based contract identifier
... effectivePeriod S 0..1 Period Value-based contract term period
.... relatedArtifact:component S 0..* RelatedArtifact Additional documentation, citations, etc.
..... extension 1..* Extension Extension
..... Slices for extension Content/Rules for all slices
...... extension:weight S 0..1 decimal Weight
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/weight
...... extension:contractualStatus S 1..1 CodeableConcept contractual | contractual-alternate | reporting-only
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/contractual-status
Binding: Measure Contractual Status (extensible)
..... type S 1..1 code Component measure
Fixed Value: composed-of
..... display S 0..1 string Brief description of the related artifact
..... resource S 1..1 canonical(Measure) What resource is being referenced
... scoring 0..0
... compositeScoring 0..0
... improvementNotation 0..0
... group S 0..* BackboneElement Population criteria group
.... code S 0..1 CodeableConcept Performance metric
Binding: Performance Metric (extensible)

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSetURI
Measure.group.codeextensibleVbpPerformanceMetricsVS(a valid code from Performance Metric Codes)
http://hl7.org/fhir/us/davinci-vbpr/ValueSet/vbp-performance-metric
From this IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure C 1..1 CRMIShareableMeasure A quality measure definition
Constraints: mea-0, mea-1
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension Content/Rules for all slices
.... extension:knowledgeCapability S 0..* code shareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapability (required)
.... extension:artifactComment S 0..* (Complex) Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
.... extension:versionAlgorithm S 0..1 Coding How to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: version-algorithm (??) (extensible)
.... extension:versionPolicy S 0..1 CodeableConcept metadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
.... extension:lineOfBusiness S 0..1 CodeableConcept Line of Business
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/lob
Binding: Line of Business Value Set (extensible)
.... extension:programModel S 0..* (Complex) Program Model
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/program-model
.... extension:paymentStream S 0..* (Complex) Payment Stream
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/payment-stream
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier Business identifier of this measure, e.g., value-based contract identifier
... version SΣ 1..1 string Business version of the measure
... name SΣC 0..1 string Name for this measure (computer friendly)
... title SΣ 1..1 string Name for this measure (human friendly)
... status ?!SΣ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... experimental SΣ 0..1 boolean For testing purposes, not real usage
... publisher SΣ 0..1 string Name of the publisher (organization or individual)
... description SΣ 1..1 markdown Natural language description of the measure
... effectivePeriod SΣ 0..1 Period Value-based contract term period
... Slices for relatedArtifact S 0..* RelatedArtifact Additional documentation, citations, etc.
Slice: Unordered, Open by value:type
.... relatedArtifact:component S 0..* RelatedArtifact Additional documentation, citations, etc.
..... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
...... extension:weight S 0..1 decimal Weight
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/weight
...... extension:contractualStatus S 1..1 CodeableConcept contractual | contractual-alternate | reporting-only
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/contractual-status
Binding: Measure Contractual Status (extensible)
..... type SΣ 1..1 code Component measure
Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
Fixed Value: composed-of
..... display SΣ 0..1 string Brief description of the related artifact
..... resource SΣ 1..1 canonical(Measure) What resource is being referenced
... group S 0..* BackboneElement Population criteria group
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code S 0..1 CodeableConcept Performance metric
Binding: Performance Metric (extensible)

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Measure.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
From the FHIR Standard
Measure.relatedArtifact:component.typerequiredFixed Value: composed-of
http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1
From the FHIR Standard
Measure.group.codeextensibleVbpPerformanceMetricsVS(a valid code from Performance Metric Codes)
http://hl7.org/fhir/us/davinci-vbpr/ValueSet/vbp-performance-metric
From this IG

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorMeasureIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMeasureIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorMeasureIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorMeasureIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMeasureA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
mea-0warningMeasureName should be usable as an identifier for the module by machine processing applications such as code generation
: name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
mea-1errorMeasureStratifier SHALL be either a single criteria or a set of criteria components
: group.stratifier.all((code | description | criteria).exists() xor component.exists())
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure C 1..1 CRMIShareableMeasure A quality measure definition
Constraints: mea-0, mea-1
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:knowledgeCapability S 0..* code shareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapability (required)
.... extension:artifactComment S 0..* (Complex) Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
.... extension:versionAlgorithm S 0..1 Coding How to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: version-algorithm (??) (extensible)
.... extension:versionPolicy S 0..1 CodeableConcept metadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
.... extension:lineOfBusiness S 0..1 CodeableConcept Line of Business
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/lob
Binding: Line of Business Value Set (extensible)
.... extension:programModel S 0..* (Complex) Program Model
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/program-model
.... extension:paymentStream S 0..* (Complex) Payment Stream
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/payment-stream
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url SΣ 1..1 uri Canonical identifier for this measure, represented as a URI (globally unique)
... identifier SΣ 0..* Identifier Business identifier of this measure, e.g., value-based contract identifier
... version SΣ 1..1 string Business version of the measure
... name SΣC 0..1 string Name for this measure (computer friendly)
... title SΣ 1..1 string Name for this measure (human friendly)
... subtitle 0..1 string Subordinate title of the measure
... status ?!SΣ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... experimental SΣ 0..1 boolean For testing purposes, not real usage
... subject[x] 0..1 E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
.... subjectCodeableConcept CodeableConcept
.... subjectReference Reference(Group)
... date Σ 0..1 dateTime Date last changed
... publisher SΣ 0..1 string Name of the publisher (organization or individual)
... contact Σ 0..* ContactDetail Contact details for the publisher
... description SΣ 1..1 markdown Natural language description of the measure
... useContext Σ 0..* UsageContext The context that the content is intended to support
... jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for measure (if applicable)
Binding: Jurisdiction ValueSet (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 SΣ 0..1 Period Value-based contract term period
... 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
... Slices for relatedArtifact S 0..* RelatedArtifact Additional documentation, citations, etc.
Slice: Unordered, Open by value:type
.... relatedArtifact:component S 0..* RelatedArtifact Additional documentation, citations, etc.
..... id 0..1 string Unique id for inter-element referencing
..... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
...... extension:weight S 0..1 decimal Weight
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/weight
...... extension:contractualStatus S 1..1 CodeableConcept contractual | contractual-alternate | reporting-only
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/contractual-status
Binding: Measure Contractual Status (extensible)
..... type SΣ 1..1 code Component measure
Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
Fixed Value: composed-of
..... label Σ 0..1 string Short label
..... display SΣ 0..1 string Brief description of the related artifact
..... citation Σ 0..1 markdown Bibliographic citation for the artifact
..... url Σ 0..1 url Where the artifact can be accessed
..... document Σ 0..1 Attachment What document is being referenced
..... resource SΣ 1..1 canonical(Measure) What resource is being referenced
... library 0..* canonical(Library) Logic used by the measure
... disclaimer Σ 0..1 markdown Disclaimer for use of the measure or its referenced content
... 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
... definition Σ 0..* markdown Defined terms used in the measure documentation
... guidance Σ 0..1 markdown Additional guidance for implementers
... group S 0..* BackboneElement Population criteria group
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code S 0..1 CodeableConcept Performance metric
Binding: Performance Metric (extensible)
.... description 0..1 string Summary description
.... population 0..* BackboneElement Population criteria
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
Binding: MeasurePopulationType (extensible): The type of population.
..... description 0..1 string The human readable description of this population criteria
..... criteria 1..1 Expression The criteria that defines this population
.... stratifier 0..* BackboneElement Stratifier criteria for the measure
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 0..1 CodeableConcept Meaning of the stratifier
..... description 0..1 string The human readable description of this stratifier
..... criteria 0..1 Expression How the measure should be stratified
..... component 0..* BackboneElement Stratifier criteria component for the measure
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... code 0..1 CodeableConcept Meaning of the stratifier component
...... description 0..1 string The human readable description of this stratifier component
...... criteria 1..1 Expression Component of how the measure should be stratified
... supplementalData 0..* BackboneElement What other data should be reported with the measure
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code 0..1 CodeableConcept Meaning of the supplemental data
.... usage 0..* CodeableConcept supplemental-data | risk-adjustment-factor
Binding: MeasureDataUsage (extensible): The intended usage for supplemental data elements in the measure.
.... description 0..1 string The human readable description of this supplemental data
.... criteria 1..1 Expression Expression describing additional data to be reported

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Measure.languagepreferredCommonLanguages
http://hl7.org/fhir/ValueSet/languages
From the FHIR Standard
Additional Bindings Purpose
AllLanguages Max Binding
Measure.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
From the FHIR Standard
Measure.subject[x]extensibleSubjectType
http://hl7.org/fhir/ValueSet/subject-type
From the FHIR Standard
Measure.jurisdictionextensibleJurisdiction ValueSet
http://hl7.org/fhir/ValueSet/jurisdiction
From the FHIR Standard
Measure.topicexampleDefinitionTopic
http://hl7.org/fhir/ValueSet/definition-topic
From the FHIR Standard
Measure.relatedArtifact:component.typerequiredFixed Value: composed-of
http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1
From the FHIR Standard
Measure.typeextensibleMeasureType
http://hl7.org/fhir/ValueSet/measure-type
From the FHIR Standard
Measure.group.codeextensibleVbpPerformanceMetricsVS(a valid code from Performance Metric Codes)
http://hl7.org/fhir/us/davinci-vbpr/ValueSet/vbp-performance-metric
From this IG
Measure.group.population.codeextensibleMeasurePopulationType
http://hl7.org/fhir/ValueSet/measure-population
From the FHIR Standard
Measure.supplementalData.usageextensibleMeasureDataUsage
http://hl7.org/fhir/ValueSet/measure-data-usage
From the FHIR Standard

Constraints

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

This structure is derived from CRMIShareableMeasure

Summary

Mandatory: 0 element(3 nested mandatory elements)
Must-Support: 14 elements
Fixed: 1 element
Prohibited: 3 elements

Extensions

This structure refers to these extensions:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of Measure.relatedArtifact

Maturity: 1

Differential View

This structure is derived from CRMIShareableMeasure

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure 1..1 CRMIShareableMeasure A quality measure definition
... Slices for extension Content/Rules for all slices
.... extension:lineOfBusiness S 0..1 CodeableConcept Line of Business
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/lob
Binding: Line of Business Value Set (extensible)
.... extension:programModel S 0..* (Complex) Program Model
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/program-model
.... extension:paymentStream S 0..* (Complex) Payment Stream
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/payment-stream
... identifier S 0..* Identifier Business identifier of this measure, e.g., value-based contract identifier
... effectivePeriod S 0..1 Period Value-based contract term period
.... relatedArtifact:component S 0..* RelatedArtifact Additional documentation, citations, etc.
..... extension 1..* Extension Extension
..... Slices for extension Content/Rules for all slices
...... extension:weight S 0..1 decimal Weight
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/weight
...... extension:contractualStatus S 1..1 CodeableConcept contractual | contractual-alternate | reporting-only
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/contractual-status
Binding: Measure Contractual Status (extensible)
..... type S 1..1 code Component measure
Fixed Value: composed-of
..... display S 0..1 string Brief description of the related artifact
..... resource S 1..1 canonical(Measure) What resource is being referenced
... scoring 0..0
... compositeScoring 0..0
... improvementNotation 0..0
... group S 0..* BackboneElement Population criteria group
.... code S 0..1 CodeableConcept Performance metric
Binding: Performance Metric (extensible)

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSetURI
Measure.group.codeextensibleVbpPerformanceMetricsVS(a valid code from Performance Metric Codes)
http://hl7.org/fhir/us/davinci-vbpr/ValueSet/vbp-performance-metric
From this IG

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure C 1..1 CRMIShareableMeasure A quality measure definition
Constraints: mea-0, mea-1
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension Content/Rules for all slices
.... extension:knowledgeCapability S 0..* code shareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapability (required)
.... extension:artifactComment S 0..* (Complex) Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
.... extension:versionAlgorithm S 0..1 Coding How to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: version-algorithm (??) (extensible)
.... extension:versionPolicy S 0..1 CodeableConcept metadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
.... extension:lineOfBusiness S 0..1 CodeableConcept Line of Business
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/lob
Binding: Line of Business Value Set (extensible)
.... extension:programModel S 0..* (Complex) Program Model
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/program-model
.... extension:paymentStream S 0..* (Complex) Payment Stream
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/payment-stream
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier Business identifier of this measure, e.g., value-based contract identifier
... version SΣ 1..1 string Business version of the measure
... name SΣC 0..1 string Name for this measure (computer friendly)
... title SΣ 1..1 string Name for this measure (human friendly)
... status ?!SΣ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... experimental SΣ 0..1 boolean For testing purposes, not real usage
... publisher SΣ 0..1 string Name of the publisher (organization or individual)
... description SΣ 1..1 markdown Natural language description of the measure
... effectivePeriod SΣ 0..1 Period Value-based contract term period
... Slices for relatedArtifact S 0..* RelatedArtifact Additional documentation, citations, etc.
Slice: Unordered, Open by value:type
.... relatedArtifact:component S 0..* RelatedArtifact Additional documentation, citations, etc.
..... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
...... extension:weight S 0..1 decimal Weight
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/weight
...... extension:contractualStatus S 1..1 CodeableConcept contractual | contractual-alternate | reporting-only
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/contractual-status
Binding: Measure Contractual Status (extensible)
..... type SΣ 1..1 code Component measure
Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
Fixed Value: composed-of
..... display SΣ 0..1 string Brief description of the related artifact
..... resource SΣ 1..1 canonical(Measure) What resource is being referenced
... group S 0..* BackboneElement Population criteria group
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code S 0..1 CodeableConcept Performance metric
Binding: Performance Metric (extensible)

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Measure.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
From the FHIR Standard
Measure.relatedArtifact:component.typerequiredFixed Value: composed-of
http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1
From the FHIR Standard
Measure.group.codeextensibleVbpPerformanceMetricsVS(a valid code from Performance Metric Codes)
http://hl7.org/fhir/us/davinci-vbpr/ValueSet/vbp-performance-metric
From this IG

Constraints

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

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Measure C 1..1 CRMIShareableMeasure A quality measure definition
Constraints: mea-0, mea-1
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:knowledgeCapability S 0..* code shareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapability (required)
.... extension:artifactComment S 0..* (Complex) Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
.... extension:versionAlgorithm S 0..1 Coding How to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: version-algorithm (??) (extensible)
.... extension:versionPolicy S 0..1 CodeableConcept metadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
.... extension:lineOfBusiness S 0..1 CodeableConcept Line of Business
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/lob
Binding: Line of Business Value Set (extensible)
.... extension:programModel S 0..* (Complex) Program Model
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/program-model
.... extension:paymentStream S 0..* (Complex) Payment Stream
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/payment-stream
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url SΣ 1..1 uri Canonical identifier for this measure, represented as a URI (globally unique)
... identifier SΣ 0..* Identifier Business identifier of this measure, e.g., value-based contract identifier
... version SΣ 1..1 string Business version of the measure
... name SΣC 0..1 string Name for this measure (computer friendly)
... title SΣ 1..1 string Name for this measure (human friendly)
... subtitle 0..1 string Subordinate title of the measure
... status ?!SΣ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... experimental SΣ 0..1 boolean For testing purposes, not real usage
... subject[x] 0..1 E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Binding: SubjectType (extensible): The possible types of subjects for a measure (E.g. Patient, Practitioner, Organization, Location, etc.).
.... subjectCodeableConcept CodeableConcept
.... subjectReference Reference(Group)
... date Σ 0..1 dateTime Date last changed
... publisher SΣ 0..1 string Name of the publisher (organization or individual)
... contact Σ 0..* ContactDetail Contact details for the publisher
... description SΣ 1..1 markdown Natural language description of the measure
... useContext Σ 0..* UsageContext The context that the content is intended to support
... jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for measure (if applicable)
Binding: Jurisdiction ValueSet (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 SΣ 0..1 Period Value-based contract term period
... 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
... Slices for relatedArtifact S 0..* RelatedArtifact Additional documentation, citations, etc.
Slice: Unordered, Open by value:type
.... relatedArtifact:component S 0..* RelatedArtifact Additional documentation, citations, etc.
..... id 0..1 string Unique id for inter-element referencing
..... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
...... extension:weight S 0..1 decimal Weight
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/weight
...... extension:contractualStatus S 1..1 CodeableConcept contractual | contractual-alternate | reporting-only
URL: http://hl7.org/fhir/us/davinci-vbpr/StructureDefinition/contractual-status
Binding: Measure Contractual Status (extensible)
..... type SΣ 1..1 code Component measure
Binding: RelatedArtifactType (required): The type of relationship to the related artifact.
Fixed Value: composed-of
..... label Σ 0..1 string Short label
..... display SΣ 0..1 string Brief description of the related artifact
..... citation Σ 0..1 markdown Bibliographic citation for the artifact
..... url Σ 0..1 url Where the artifact can be accessed
..... document Σ 0..1 Attachment What document is being referenced
..... resource SΣ 1..1 canonical(Measure) What resource is being referenced
... library 0..* canonical(Library) Logic used by the measure
... disclaimer Σ 0..1 markdown Disclaimer for use of the measure or its referenced content
... 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
... definition Σ 0..* markdown Defined terms used in the measure documentation
... guidance Σ 0..1 markdown Additional guidance for implementers
... group S 0..* BackboneElement Population criteria group
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code S 0..1 CodeableConcept Performance metric
Binding: Performance Metric (extensible)
.... description 0..1 string Summary description
.... population 0..* BackboneElement Population criteria
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 0..1 CodeableConcept initial-population | numerator | numerator-exclusion | denominator | denominator-exclusion | denominator-exception | measure-population | measure-population-exclusion | measure-observation
Binding: MeasurePopulationType (extensible): The type of population.
..... description 0..1 string The human readable description of this population criteria
..... criteria 1..1 Expression The criteria that defines this population
.... stratifier 0..* BackboneElement Stratifier criteria for the measure
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 0..1 CodeableConcept Meaning of the stratifier
..... description 0..1 string The human readable description of this stratifier
..... criteria 0..1 Expression How the measure should be stratified
..... component 0..* BackboneElement Stratifier criteria component for the measure
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... code 0..1 CodeableConcept Meaning of the stratifier component
...... description 0..1 string The human readable description of this stratifier component
...... criteria 1..1 Expression Component of how the measure should be stratified
... supplementalData 0..* BackboneElement What other data should be reported with the measure
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code 0..1 CodeableConcept Meaning of the supplemental data
.... usage 0..* CodeableConcept supplemental-data | risk-adjustment-factor
Binding: MeasureDataUsage (extensible): The intended usage for supplemental data elements in the measure.
.... description 0..1 string The human readable description of this supplemental data
.... criteria 1..1 Expression Expression describing additional data to be reported

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Measure.languagepreferredCommonLanguages
http://hl7.org/fhir/ValueSet/languages
From the FHIR Standard
Additional Bindings Purpose
AllLanguages Max Binding
Measure.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
From the FHIR Standard
Measure.subject[x]extensibleSubjectType
http://hl7.org/fhir/ValueSet/subject-type
From the FHIR Standard
Measure.jurisdictionextensibleJurisdiction ValueSet
http://hl7.org/fhir/ValueSet/jurisdiction
From the FHIR Standard
Measure.topicexampleDefinitionTopic
http://hl7.org/fhir/ValueSet/definition-topic
From the FHIR Standard
Measure.relatedArtifact:component.typerequiredFixed Value: composed-of
http://hl7.org/fhir/ValueSet/related-artifact-type|4.0.1
From the FHIR Standard
Measure.typeextensibleMeasureType
http://hl7.org/fhir/ValueSet/measure-type
From the FHIR Standard
Measure.group.codeextensibleVbpPerformanceMetricsVS(a valid code from Performance Metric Codes)
http://hl7.org/fhir/us/davinci-vbpr/ValueSet/vbp-performance-metric
From this IG
Measure.group.population.codeextensibleMeasurePopulationType
http://hl7.org/fhir/ValueSet/measure-population
From the FHIR Standard
Measure.supplementalData.usageextensibleMeasureDataUsage
http://hl7.org/fhir/ValueSet/measure-data-usage
From the FHIR Standard

Constraints

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

This structure is derived from CRMIShareableMeasure

Summary

Mandatory: 0 element(3 nested mandatory elements)
Must-Support: 14 elements
Fixed: 1 element
Prohibited: 3 elements

Extensions

This structure refers to these extensions:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of Measure.relatedArtifact

Maturity: 1

 

Other representations of profile: CSV, Excel, Schematron