Quality Measure Implementation Guide (STU5)
5.0.0-ballot - ballot United States of America flag

Quality Measure Implementation Guide (STU5), published by HL7 International / Clinical Quality Information. This guide is not an authorized publication; it is the continuous build for version 5.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/cqf-measures/ and changes regularly. See the Directory of published versions

Extension: CQFM Artifact Comment

Official URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-artifactComment Version: 5.0.0-ballot
Active as of 2024-03-28 Computable Name: CQFMArtifactComment

A comment containing additional documentation, a review comment, usage guidance, or other relevant information from a particular user.

Context of Use

This extension may be used on the following element(s):

  • Element ID Measure
  • Element ID Library
  • FHIRPath Measure.descendants().ofType(Element)
  • FHIRPath Library.descendants().ofType(Element)

Usage info

Usage:

Formal Views of Extension Content

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

This structure is derived from Extension

Summary

Complex Extension: A comment containing additional documentation, a review comment, usage guidance, or other relevant information from a particular user.

  • type: code: Indicates whether the comment is providing additional documentation, a review comment that requires resolution, or providing usage guidance to an artifact consumer.
  • text: markdown: The text content of the comment.
  • target: uri: A URI that points to what the comment is about, such as a line of text in the CQL, or a specific element in a resource.
  • reference: uri: Provides additional supporting information relevant to the comment.
  • user: string: Specifies the user that authored the comment.
  • authoredOn: dateTime: Specifies the date and time the comment was authored.

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..*ExtensionAdditional documentation, review, or usage guidance
... extension:type 1..1Extensiondocumentation | review | guidance
.... url 1..1uri"type"
.... value[x] 0..1codeValue of extension
Binding: Artifact Comment Type (required): The type of artifact comment (documentation, review, guidance)

... extension:text 1..1ExtensionThe comment
.... url 1..1uri"text"
.... value[x] 0..1markdownValue of extension
... extension:target 0..*ExtensionWhat the comment is directed to
.... url 1..1uri"target"
.... value[x] 0..1uriValue of extension
.... url 1..1uri"reference"
.... value[x] 0..1uriValue of extension
... extension:user 0..1ExtensionWho commented
.... url 1..1uri"user"
.... value[x] 0..1stringValue of extension
... extension:authoredOn 0..1ExtensionDate and time the comment was made
.... extension 0..0
.... url 1..1uri"authoredOn"
.... value[x] 1..1dateTimeValue of extension
... url 1..1uri"http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-artifactComment"
... value[x] 0..0

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..*ExtensionAdditional documentation, review, or usage guidance
... id 0..1stringUnique id for inter-element referencing
... Slices for extension 2..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
... extension:type 1..1Extensiondocumentation | review | guidance
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... url 1..1uri"type"
.... value[x] 0..1codeValue of extension
Binding: Artifact Comment Type (required): The type of artifact comment (documentation, review, guidance)

.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... url 1..1uri"text"
.... value[x] 0..1markdownValue of extension
... extension:target 0..*ExtensionWhat the comment is directed to
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... url 1..1uri"target"
.... value[x] 0..1uriValue of extension
... extension:reference 0..*ExtensionSupporting reference for the comment
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... url 1..1uri"reference"
.... value[x] 0..1uriValue of extension
... extension:user 0..1ExtensionWho commented
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... url 1..1uri"user"
.... value[x] 0..1stringValue of extension
... extension:authoredOn 0..1ExtensionDate and time the comment was made
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..0
.... url 1..1uri"authoredOn"
.... value[x] 1..1dateTimeValue of extension
... url 1..1uri"http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-artifactComment"

doco Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: A comment containing additional documentation, a review comment, usage guidance, or other relevant information from a particular user.

  • type: code: Indicates whether the comment is providing additional documentation, a review comment that requires resolution, or providing usage guidance to an artifact consumer.
  • text: markdown: The text content of the comment.
  • target: uri: A URI that points to what the comment is about, such as a line of text in the CQL, or a specific element in a resource.
  • reference: uri: Provides additional supporting information relevant to the comment.
  • user: string: Specifies the user that authored the comment.
  • authoredOn: dateTime: Specifies the date and time the comment was authored.

Differential View

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..*ExtensionAdditional documentation, review, or usage guidance
... extension:type 1..1Extensiondocumentation | review | guidance
.... url 1..1uri"type"
.... value[x] 0..1codeValue of extension
Binding: Artifact Comment Type (required): The type of artifact comment (documentation, review, guidance)

... extension:text 1..1ExtensionThe comment
.... url 1..1uri"text"
.... value[x] 0..1markdownValue of extension
... extension:target 0..*ExtensionWhat the comment is directed to
.... url 1..1uri"target"
.... value[x] 0..1uriValue of extension
.... url 1..1uri"reference"
.... value[x] 0..1uriValue of extension
... extension:user 0..1ExtensionWho commented
.... url 1..1uri"user"
.... value[x] 0..1stringValue of extension
... extension:authoredOn 0..1ExtensionDate and time the comment was made
.... extension 0..0
.... url 1..1uri"authoredOn"
.... value[x] 1..1dateTimeValue of extension
... url 1..1uri"http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-artifactComment"
... value[x] 0..0

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..*ExtensionAdditional documentation, review, or usage guidance
... id 0..1stringUnique id for inter-element referencing
... Slices for extension 2..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
... extension:type 1..1Extensiondocumentation | review | guidance
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... url 1..1uri"type"
.... value[x] 0..1codeValue of extension
Binding: Artifact Comment Type (required): The type of artifact comment (documentation, review, guidance)

.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... url 1..1uri"text"
.... value[x] 0..1markdownValue of extension
... extension:target 0..*ExtensionWhat the comment is directed to
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... url 1..1uri"target"
.... value[x] 0..1uriValue of extension
... extension:reference 0..*ExtensionSupporting reference for the comment
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... url 1..1uri"reference"
.... value[x] 0..1uriValue of extension
... extension:user 0..1ExtensionWho commented
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... url 1..1uri"user"
.... value[x] 0..1stringValue of extension
... extension:authoredOn 0..1ExtensionDate and time the comment was made
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..0
.... url 1..1uri"authoredOn"
.... value[x] 1..1dateTimeValue of extension
... url 1..1uri"http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-artifactComment"

doco Documentation for this format

 

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

PathConformanceValueSetURI
Extension.extension:type.value[x]requiredArtifactCommentType (a valid code from Artifact Comment Type Codes)
http://hl7.org/fhir/us/cqfmeasures/ValueSet/artifact-comment-type
from this IG

Constraints

IdGradePath(s)DetailsRequirements
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()