This page is part of the FHIR Specification (v4.6.0: R5 Draft Ballot). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

Extension: artifactComment

FHIR Infrastructure Work Group

Maturity Level: 1

Informative

Use Context: Any

URL for this extension:

http://hl7.org/fhir/StructureDefinition/cqf-artifactComment

Status: draft. Extension maintained by: Health Level Seven, Inc. - CDS WG

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

Context of Use: Use on Element ID Element

Summary

Name	Card.	Type	Description & Constraints
artifactComment	0..*	Extension	URL = http://hl7.org/fhir/StructureDefinition/cqf-artifactComment artifactComment: A comment containing additional documentation, a review comment, usage guidance, or other relevant information from a particular user. Use on Element ID Element
type	1..1	code	Indicates whether the comment is providing additional documentation, a review comment that requires resolution, or providing usage guidance to an artifact consumer.
text	1..1	markdown	The text content of the comment.
target	0..*	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	0..*	uri	Provides additional supporting information relevant to the comment.
user	0..1	string	Specifies the user or organization that authored the comment.
Documentation for this format

Full Structure

Name	Card.	Type	Description & Constraints
extension	0..*	Extension	URL = http://hl7.org/fhir/StructureDefinition/cqf-artifactComment artifactComment: A comment containing additional documentation, a review comment, usage guidance, or other relevant information from a particular user. Use on Element ID Element
extension	0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
extension:type	1..1	Extension	documentation \| review \| guidance
id	0..1	string	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"type"
value[x]	1..1	code	Value of extension Binding: Artifact comment type (required)
extension:text	1..1	Extension	The comment
id	0..1	string	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"text"
value[x]	1..1	markdown	Value of extension
extension:target	0..*	Extension	What the comment is directed to
id	0..1	string	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"target"
value[x]	1..1	uri	Value of extension
extension:reference	0..*	Extension	Supporting reference for the comment
id	0..1	string	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"reference"
value[x]	1..1	uri	Value of extension
extension:user	0..1	Extension	Who commented
id	0..1	string	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"user"
value[x]	1..1	string	Value of extension
url	1..1	uri	"http://hl7.org/fhir/StructureDefinition/cqf-artifactComment"
value[x]	0..0
valueBase64Binary		base64Binary
valueBoolean		boolean
valueCanonical		canonical(Any)
valueCode		code
valueDate		date
valueDateTime		dateTime
valueDecimal		decimal
valueId		id
valueInstant		instant
valueInteger		integer
valueInteger64		integer64
valueMarkdown		markdown
valueOid		oid
valuePositiveInt		positiveInt
valueString		string
valueTime		time
valueUnsignedInt		unsignedInt
valueUri		uri
valueUrl		url
valueUuid		uuid
valueAddress		Address
valueAge		Age
valueAnnotation		Annotation
valueAttachment		Attachment
valueCodeableConcept		CodeableConcept
valueCoding		Coding
valueContactPoint		ContactPoint
valueCount		Count
valueDistance		Distance
valueDuration		Duration
valueHumanName		HumanName
valueIdentifier		Identifier
valueMoney		Money
valuePeriod		Period
valueQuantity		Quantity
valueRange		Range
valueRatio		Ratio
valueReference		Reference(Any)
valueSampledData		SampledData
valueSignature		Signature
valueTiming		Timing
valueContactDetail		ContactDetail
valueContributor		Contributor
valueDataRequirement		DataRequirement
valueExpression		Expression
valueParameterDefinition		ParameterDefinition
valueRelatedArtifact		RelatedArtifact
valueTriggerDefinition		TriggerDefinition
valueUsageContext		UsageContext
valueDosage		Dosage
valueMeta		Meta
Documentation for this format

XML Template

<!-- artifactComment -->

<extension xmlns="http://hl7.org/fhir"
     url="http://hl7.org/fhir/StructureDefinition/cqf-artifactComment" >
 <-- extension sliced by value:url  in the specified orderOpen-->
 <extension url="type">  1..1 Extension  <!--  1..1 documentation | review | guidance -->
  <valueCode value="[code]"/><!--  1..1 Value of extension -->
 </extension>
 <extension url="text">  1..1 Extension  <!--  1..1 The comment -->
  <valueMarkdown value="[markdown]"/><!--  1..1 Value of extension -->
 </extension>
 <extension url="target">  0..* Extension  <!--  0..* What the comment is directed to -->
  <valueUri value="[uri]"/><!--  1..1 Value of extension -->
 </extension>
 <extension url="reference">  0..* Extension  <!--  0..* Supporting reference for the comment -->
  <valueUri value="[uri]"/><!--  1..1 Value of extension -->
 </extension>
 <extension url="user">  0..1 Extension  <!--  0..1 Who commented -->
  <valueString value="[string]"/><!--  1..1 Value of extension -->
 </extension>
</extension>

JSON Template

{ // artifactComment
    "extension" : [ //  sliced by value:url  in the specified order, Open 
      { // documentation | review | guidance // C? R! 
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "type", // R! 
        "valueCode" : "<code>" // C? R! Value of extension
      },
      { // The comment // C? R! 
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "text", // R! 
        "valueMarkdown" : "<markdown>" // C? R! Value of extension
      },
      { // What the comment is directed to // C?
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "target", // R! 
        "valueUri" : "<uri>" // C? R! Value of extension
      },
      { // Supporting reference for the comment // C?
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "reference", // R! 
        "valueUri" : "<uri>" // C? R! Value of extension
      },
      { // Who commented // C?
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "user", // R! 
        "valueString" : "<string>" // C? R! Value of extension
      }
    ],
    "url" : "http://hl7.org/fhir/StructureDefinition/cqf-artifactComment", // R! 
// value[x]: Value of extension. One of these 51:
  }

Summary

Name	Card.	Type	Description & Constraints
artifactComment	0..*	Extension	URL = http://hl7.org/fhir/StructureDefinition/cqf-artifactComment artifactComment: A comment containing additional documentation, a review comment, usage guidance, or other relevant information from a particular user. Use on Element ID Element
type	1..1	code	Indicates whether the comment is providing additional documentation, a review comment that requires resolution, or providing usage guidance to an artifact consumer.
text	1..1	markdown	The text content of the comment.
target	0..*	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	0..*	uri	Provides additional supporting information relevant to the comment.
user	0..1	string	Specifies the user or organization that authored the comment.
Documentation for this format

Full Structure

Name	Card.	Type	Description & Constraints
extension	0..*	Extension	URL = http://hl7.org/fhir/StructureDefinition/cqf-artifactComment artifactComment: A comment containing additional documentation, a review comment, usage guidance, or other relevant information from a particular user. Use on Element ID Element
extension	0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
extension:type	1..1	Extension	documentation \| review \| guidance
id	0..1	string	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"type"
value[x]	1..1	code	Value of extension Binding: Artifact comment type (required)
extension:text	1..1	Extension	The comment
id	0..1	string	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"text"
value[x]	1..1	markdown	Value of extension
extension:target	0..*	Extension	What the comment is directed to
id	0..1	string	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"target"
value[x]	1..1	uri	Value of extension
extension:reference	0..*	Extension	Supporting reference for the comment
id	0..1	string	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"reference"
value[x]	1..1	uri	Value of extension
extension:user	0..1	Extension	Who commented
id	0..1	string	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"user"
value[x]	1..1	string	Value of extension
url	1..1	uri	"http://hl7.org/fhir/StructureDefinition/cqf-artifactComment"
value[x]	0..0
valueBase64Binary		base64Binary
valueBoolean		boolean
valueCanonical		canonical(Any)
valueCode		code
valueDate		date
valueDateTime		dateTime
valueDecimal		decimal
valueId		id
valueInstant		instant
valueInteger		integer
valueInteger64		integer64
valueMarkdown		markdown
valueOid		oid
valuePositiveInt		positiveInt
valueString		string
valueTime		time
valueUnsignedInt		unsignedInt
valueUri		uri
valueUrl		url
valueUuid		uuid
valueAddress		Address
valueAge		Age
valueAnnotation		Annotation
valueAttachment		Attachment
valueCodeableConcept		CodeableConcept
valueCoding		Coding
valueContactPoint		ContactPoint
valueCount		Count
valueDistance		Distance
valueDuration		Duration
valueHumanName		HumanName
valueIdentifier		Identifier
valueMoney		Money
valuePeriod		Period
valueQuantity		Quantity
valueRange		Range
valueRatio		Ratio
valueReference		Reference(Any)
valueSampledData		SampledData
valueSignature		Signature
valueTiming		Timing
valueContactDetail		ContactDetail
valueContributor		Contributor
valueDataRequirement		DataRequirement
valueExpression		Expression
valueParameterDefinition		ParameterDefinition
valueRelatedArtifact		RelatedArtifact
valueTriggerDefinition		TriggerDefinition
valueUsageContext		UsageContext
valueDosage		Dosage
valueMeta		Meta
Documentation for this format

XML Template

<!-- artifactComment -->

<extension xmlns="http://hl7.org/fhir"
     url="http://hl7.org/fhir/StructureDefinition/cqf-artifactComment" >
 <-- extension sliced by value:url  in the specified orderOpen-->
 <extension url="type">  1..1 Extension  <!--  1..1 documentation | review | guidance -->
  <valueCode value="[code]"/><!--  1..1 Value of extension -->
 </extension>
 <extension url="text">  1..1 Extension  <!--  1..1 The comment -->
  <valueMarkdown value="[markdown]"/><!--  1..1 Value of extension -->
 </extension>
 <extension url="target">  0..* Extension  <!--  0..* What the comment is directed to -->
  <valueUri value="[uri]"/><!--  1..1 Value of extension -->
 </extension>
 <extension url="reference">  0..* Extension  <!--  0..* Supporting reference for the comment -->
  <valueUri value="[uri]"/><!--  1..1 Value of extension -->
 </extension>
 <extension url="user">  0..1 Extension  <!--  0..1 Who commented -->
  <valueString value="[string]"/><!--  1..1 Value of extension -->
 </extension>
</extension>

JSON Template

{ // artifactComment
    "extension" : [ //  sliced by value:url  in the specified order, Open 
      { // documentation | review | guidance // C? R! 
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "type", // R! 
        "valueCode" : "<code>" // C? R! Value of extension
      },
      { // The comment // C? R! 
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "text", // R! 
        "valueMarkdown" : "<markdown>" // C? R! Value of extension
      },
      { // What the comment is directed to // C?
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "target", // R! 
        "valueUri" : "<uri>" // C? R! Value of extension
      },
      { // Supporting reference for the comment // C?
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "reference", // R! 
        "valueUri" : "<uri>" // C? R! Value of extension
      },
      { // Who commented // C?
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "user", // R! 
        "valueString" : "<string>" // C? R! Value of extension
      }
    ],
    "url" : "http://hl7.org/fhir/StructureDefinition/cqf-artifactComment", // R! 
// value[x]: Value of extension. One of these 51:
  }

Constraints

ele-1: All FHIR elements must have a @value or children (xpath: @value|f:*|h:div)
ext-1: Must have either extensions or value[x], not both (xpath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')]))
ele-1: On Extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension: @value|f:*|h:div)
ext-1: On Extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]))
ele-1: On Extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension: @value|f:*|h:div)
ext-1: On Extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]))
ele-1: On Extension.extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension.extension: @value|f:*|h:div)
ext-1: On Extension.extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]))
ele-1: On Extension.extension.value[x]: All FHIR elements must have a @value or children (xpath on Extension.extension.value[x]: @value|f:*|h:div)
ele-1: On Extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension: @value|f:*|h:div)
ext-1: On Extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]))
ele-1: On Extension.extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension.extension: @value|f:*|h:div)
ext-1: On Extension.extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]))
ele-1: On Extension.extension.value[x]: All FHIR elements must have a @value or children (xpath on Extension.extension.value[x]: @value|f:*|h:div)
ele-1: On Extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension: @value|f:*|h:div)
ext-1: On Extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]))
ele-1: On Extension.extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension.extension: @value|f:*|h:div)
ext-1: On Extension.extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]))
ele-1: On Extension.extension.value[x]: All FHIR elements must have a @value or children (xpath on Extension.extension.value[x]: @value|f:*|h:div)
ele-1: On Extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension: @value|f:*|h:div)
ext-1: On Extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]))
ele-1: On Extension.extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension.extension: @value|f:*|h:div)
ext-1: On Extension.extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]))
ele-1: On Extension.extension.value[x]: All FHIR elements must have a @value or children (xpath on Extension.extension.value[x]: @value|f:*|h:div)
ele-1: On Extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension: @value|f:*|h:div)
ext-1: On Extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]))
ele-1: On Extension.extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension.extension: @value|f:*|h:div)
ext-1: On Extension.extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]))
ele-1: On Extension.extension.value[x]: All FHIR elements must have a @value or children (xpath on Extension.extension.value[x]: @value|f:*|h:div)
ele-1: On Extension.value[x]: All FHIR elements must have a @value or children (xpath on Extension.value[x]: @value|f:*|h:div)