Release 4 4B

This page is part of the FHIR Specification (v4.0.1: R4 (v4.3.0: R4B - Mixed Normative and STU ) in it's permanent home (it will always be available at this URL). ). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . Page versions: R4B R4 R4B R4

Extension: expand-group

Vocabulary Work Group   Maturity Level : 1 Informative Use Context : Any

URL for this extension: 


http://hl7.org/fhir/StructureDefinition/valueset-expand-group

Status: draft. Extension maintained by: HL7

This extension declares a group of concepts that is generated into the ValueSet.expansion.contains hierarchy when the expansion is generated for a UI. THere is no inherent assigned meaning to the hierarchy; it is used to help the user navigate the concepts. Each group has a display and/or a code, and a list of members, which are either concepts in the value set, or other groups (by code).

Comment :

Note that there are inter-relationships between concept status/properties and the way the groups are built; these are described and documented in the (value set hierarchical example)[d.html]. Note that this extension should be ignored when the expansion is not generated for UI.

Context of Use: Use on Element ID ValueSet.compose.include

Extension Content

Summary

Name Flags Card. Type Description & Constraints doco
. . expand-group 0..* Extension URL = http://hl7.org/fhir/StructureDefinition/valueset-expand-group
expand-group: This extension declares a group of concepts that is generated into the ValueSet.expansion.contains hierarchy when the expansion is generated for a UI. THere is no inherent assigned meaning to the hierarchy; it is used to help the user navigate the concepts. Each group has a display and/or a code, and a list of members, which are either concepts in the value set, or other groups (by code).


Use on Element ID ValueSet.compose.include
. . . code 0..1 code A reference to a code from the include.system that defines the meaning associated with the group. Note that including the code in this extension does not include the code in the value set; if the code is intended to be in the value set, it must be listed directly as well.

. . . display 0..1 string The description for the group (goes in ValueSet.expansion.contains.dispaly). All groups need a display; this can only be omitted if there is a code that can be used to determine the display.

. . . member 1..* code One of more codes that identify codes in the expansion or other groups.


doco Documentation for this format

Full Structure

I I I I
Name Flags Card. Type Description & Constraints doco
. . extension 0..* Extension URL = http://hl7.org/fhir/StructureDefinition/valueset-expand-group
expand-group: This extension declares a group of concepts that is generated into the ValueSet.expansion.contains hierarchy when the expansion is generated for a UI. THere is no inherent assigned meaning to the hierarchy; it is used to help the user navigate the concepts. Each group has a display and/or a code, and a list of members, which are either concepts in the value set, or other groups (by code).


Use on Element ID ValueSet.compose.include
. . . Slices for extension I 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
. . . extension:code I 0..1 Extension Underlying code from the system
. . . extension . id I 0..0 0..1 id Unique id for inter-element referencing
.... extension 0..0
. . . . url 1..1 uri "code"
. . . . value[x] 1..1 code Value of extension
. . . extension:display 0..1 Extension Display for the group
. . . . id 0..1 id Unique id for inter-element referencing
. . . . extension I 0..0
. . . . url 1..1 uri "display"
. . . . value[x] I 1..1 string Value of extension
. . . extension . id I 0..0 0..1 id Unique id for inter-element referencing
.... extension 0..0
. . . . url 1..1 uri "member"
. . . . value[x] 1..1 code Value of extension
. . . url 1..1 uri "http://hl7.org/fhir/StructureDefinition/valueset-expand-group"
. . . value[x] 0 .. 0
. . . . valueBase64Binary base64Binary
. . . . valueBase64Binary valueBoolean base64Binary boolean
. . . valueBoolean . valueCanonical boolean canonical (Any)
. . . valueCanonical . valueCode canonical code ()
. . . . valueCode valueDate code date
. . . . valueDate valueDateTime date dateTime
. . . . valueDateTime valueDecimal dateTime decimal
. . . . valueDecimal valueId decimal id
. . . . valueId valueInstant id instant
. . . . valueInstant valueInteger instant integer
. . . . valueInteger valueMarkdown integer markdown
. . . . valueMarkdown valueOid markdown oid
. . . . valueOid valuePositiveInt oid positiveInt
. . . . valuePositiveInt valueString positiveInt string
. . . . valueString valueTime string time
. . . . valueTime valueUnsignedInt time unsignedInt
. . . . valueUnsignedInt valueUri unsignedInt uri
. . . . valueUri valueUrl uri url
. . . . valueUrl valueUuid url uuid
. . . valueUuid . valueAddress uuid Address
. . . . valueAddress valueAge Address Age
. . . . valueAge valueAnnotation Age Annotation
. . . . valueAnnotation valueAttachment Annotation Attachment
. . . . valueAttachment valueCodeableConcept Attachment CodeableConcept
. . . . valueCodeableConcept valueCodeableReference CodeableConcept CodeableReference
. . . . 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 . valueRatioRange Reference RatioRange ()
. . . valueSampledData . valueReference SampledData Reference (Any)
. . . . valueSignature valueSampledData Signature SampledData
. . . . valueTiming valueSignature Timing Signature
. . . . valueContactDetail valueTiming ContactDetail Timing
. . . . valueContributor valueContactDetail Contributor ContactDetail
. . . . valueDataRequirement valueContributor DataRequirement Contributor
. . . . valueExpression valueDataRequirement Expression DataRequirement
. . . . valueParameterDefinition valueExpression ParameterDefinition Expression
. . . . valueRelatedArtifact valueParameterDefinition RelatedArtifact ParameterDefinition
. . . . valueTriggerDefinition valueRelatedArtifact TriggerDefinition RelatedArtifact
. . . . valueUsageContext valueTriggerDefinition UsageContext TriggerDefinition
. . . . valueDosage valueUsageContext Dosage UsageContext
. . . . valueMeta valueDosage Meta Dosage

doco Documentation for this format

XML Template 

<!-- expand-group -->doco

<extension xmlns="http://hl7.org/fhir"
     url="http://hl7.org/fhir/StructureDefinition/valueset-expand-group" >
 <-- extension sliced by value:url  in the specified orderOpen-->
 <extension url="code"> ?? 0..1 Extension  <!-- ?? 0..1 Underlying code from the system -->
  <

  <valueCode value="[code]"/><!-- ?? 1..1 Value of extension -->

 </extension>
 <extension url="display"> ?? 0..1 Extension  <!-- ?? 0..1 Display for the group -->
  <

  <valueString value="[string]"/><!-- ?? 1..1 Value of extension -->

 </extension>
 <extension url="member"> ?? 1..* Extension  <!-- ?? 1..* Codes or other groups in this group -->
  <

  <valueCode value="[code]"/><!-- ?? 1..1 Value of extension -->

 </extension>
</extension>

JSON Template 

{ // expand-group
    "extension" : [ //  sliced by value:url  in the specified order, Open 
      { // Underlying code from the system // C?
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "code", // R! 
        "

        "valueCode" : "<code>" // C? R! Value of extension

      },
      { // Display for the group // C?
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "display", // R! 
        "

        "valueString" : "<string>" // C? R! Value of extension

      },
      { // Codes or other groups in this group // C? R! 
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "member", // R! 
        "

        "valueCode" : "<code>" // C? R! Value of extension

      }
    ],
    "url" : "http://hl7.org/fhir/StructureDefinition/valueset-expand-group", // R! 


// value[x]: Value of extension. One of these 51:
  }

Summary

Name Flags Card. Type Description & Constraints doco
. . expand-group 0..* Extension URL = http://hl7.org/fhir/StructureDefinition/valueset-expand-group
expand-group: This extension declares a group of concepts that is generated into the ValueSet.expansion.contains hierarchy when the expansion is generated for a UI. THere is no inherent assigned meaning to the hierarchy; it is used to help the user navigate the concepts. Each group has a display and/or a code, and a list of members, which are either concepts in the value set, or other groups (by code).


Use on Element ID ValueSet.compose.include
. . . code 0..1 code A reference to a code from the include.system that defines the meaning associated with the group. Note that including the code in this extension does not include the code in the value set; if the code is intended to be in the value set, it must be listed directly as well.

. . . display 0..1 string The description for the group (goes in ValueSet.expansion.contains.dispaly). All groups need a display; this can only be omitted if there is a code that can be used to determine the display.

. . . member 1..* code One of more codes that identify codes in the expansion or other groups.


doco Documentation for this format

Full Structure

I I I I
Name Flags Card. Type Description & Constraints doco
. . extension 0..* Extension URL = http://hl7.org/fhir/StructureDefinition/valueset-expand-group
expand-group: This extension declares a group of concepts that is generated into the ValueSet.expansion.contains hierarchy when the expansion is generated for a UI. THere is no inherent assigned meaning to the hierarchy; it is used to help the user navigate the concepts. Each group has a display and/or a code, and a list of members, which are either concepts in the value set, or other groups (by code).


Use on Element ID ValueSet.compose.include
. . . Slices for extension I 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
. . . extension:code I 0..1 Extension Underlying code from the system
. . . extension . id I 0..0 0..1 id Unique id for inter-element referencing
.... extension 0..0
. . . . url 1..1 uri "code"
. . . . value[x] 1..1 code Value of extension
. . . extension:display 0..1 Extension Display for the group
. . . . id 0..1 id Unique id for inter-element referencing
. . . . extension I 0..0
. . . . url 1..1 uri "display"
. . . . value[x] I 1..1 string Value of extension
. . . extension . id I 0..0 0..1 id Unique id for inter-element referencing
.... extension 0..0
. . . . url 1..1 uri "member"
. . . . value[x] 1..1 code Value of extension
. . . url 1..1 uri "http://hl7.org/fhir/StructureDefinition/valueset-expand-group"
. . . value[x] 0 .. 0
. . . . valueBase64Binary base64Binary
. . . . valueBase64Binary valueBoolean base64Binary boolean
. . . valueBoolean . valueCanonical boolean canonical (Any)
. . . valueCanonical . valueCode canonical code ()
. . . . valueCode valueDate code date
. . . . valueDate valueDateTime date dateTime
. . . . valueDateTime valueDecimal dateTime decimal
. . . . valueDecimal valueId decimal id
. . . . valueId valueInstant id instant
. . . . valueInstant valueInteger instant integer
. . . . valueInteger valueMarkdown integer markdown
. . . . valueMarkdown valueOid markdown oid
. . . . valueOid valuePositiveInt oid positiveInt
. . . . valuePositiveInt valueString positiveInt string
. . . . valueString valueTime string time
. . . . valueTime valueUnsignedInt time unsignedInt
. . . . valueUnsignedInt valueUri unsignedInt uri
. . . . valueUri valueUrl uri url
. . . . valueUrl valueUuid url uuid
. . . valueUuid . valueAddress uuid Address
. . . . valueAddress valueAge Address Age
. . . . valueAge valueAnnotation Age Annotation
. . . . valueAnnotation valueAttachment Annotation Attachment
. . . . valueAttachment valueCodeableConcept Attachment CodeableConcept
. . . . valueCodeableConcept valueCodeableReference CodeableConcept CodeableReference
. . . . 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 . valueRatioRange Reference RatioRange ()
. . . valueSampledData . valueReference SampledData Reference (Any)
. . . . valueSignature valueSampledData Signature SampledData
. . . . valueTiming valueSignature Timing Signature
. . . . valueContactDetail valueTiming ContactDetail Timing
. . . . valueContributor valueContactDetail Contributor ContactDetail
. . . . valueDataRequirement valueContributor DataRequirement Contributor
. . . . valueExpression valueDataRequirement Expression DataRequirement
. . . . valueParameterDefinition valueExpression ParameterDefinition Expression
. . . . valueRelatedArtifact valueParameterDefinition RelatedArtifact ParameterDefinition
. . . . valueTriggerDefinition valueRelatedArtifact TriggerDefinition RelatedArtifact
. . . . valueUsageContext valueTriggerDefinition UsageContext TriggerDefinition
. . . . valueDosage valueUsageContext Dosage UsageContext
. . . . valueMeta valueDosage Meta Dosage

doco Documentation for this format

XML Template 

<!-- expand-group -->doco

<extension xmlns="http://hl7.org/fhir"
     url="http://hl7.org/fhir/StructureDefinition/valueset-expand-group" >
 <-- extension sliced by value:url  in the specified orderOpen-->
 <extension url="code"> ?? 0..1 Extension  <!-- ?? 0..1 Underlying code from the system -->
  <

  <valueCode value="[code]"/><!-- ?? 1..1 Value of extension -->

 </extension>
 <extension url="display"> ?? 0..1 Extension  <!-- ?? 0..1 Display for the group -->
  <

  <valueString value="[string]"/><!-- ?? 1..1 Value of extension -->

 </extension>
 <extension url="member"> ?? 1..* Extension  <!-- ?? 1..* Codes or other groups in this group -->
  <

  <valueCode value="[code]"/><!-- ?? 1..1 Value of extension -->

 </extension>
</extension>

JSON Template 

{ // expand-group
    "extension" : [ //  sliced by value:url  in the specified order, Open 
      { // Underlying code from the system // C?
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "code", // R! 
        "

        "valueCode" : "<code>" // C? R! Value of extension

      },
      { // Display for the group // C?
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "display", // R! 
        "

        "valueString" : "<string>" // C? R! Value of extension

      },
      { // Codes or other groups in this group // C? R! 
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "member", // R! 
        "

        "valueCode" : "<code>" // C? R! Value of extension

      }
    ],
    "url" : "http://hl7.org/fhir/StructureDefinition/valueset-expand-group", // R! 


// value[x]: Value of extension. One of these 51:
  }

 

Constraints

  • ele-1 : All FHIR elements must have a @value or children unless an empty Parameters resource (xpath: @value|f:*|h:div @value|f:*|h:div|self::f:Parameters )
  • 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.value[x]: All FHIR elements must have a @value or children (xpath on Extension.value[x]: @value|f:*|h:div )