description: A value set specifies a set of codes drawn from one or more code systems.
package_name: hl7.fhir.core
derivation: specialization
name: ValueSet
type: ValueSet
elements:
  description: {short: Natural language description of the value set, type: markdown, index: 10}
  compose:
    short: Definition of the content of the value set (CLD)
    type: BackboneElement
    index: 17
    elements:
      lockedDate: {short: Fixed date for version-less references (transitive), type: date, isSummary: true, index: 18}
      inactive: {short: Whether inactive codes are in the value set, type: boolean, isSummary: true, index: 19}
      include:
        constraint:
          vsd-2: {human: A value set with concepts or filters SHALL include a system, severity: error, expression: (concept.exists() or filter.exists()) implies system.exists()}
          vsd-3: {human: Cannot have both concept and filter, severity: error, expression: concept.empty() or filter.empty()}
          vsd-1: {human: A value set include/exclude SHALL have a value set or a system, severity: error, expression: valueSet.exists() or system.exists()}
        min: 1
        short: Include one or more codes from a code system or other value set(s)
        index: 20
        type: BackboneElement
        array: true
        elements:
          system: {short: The system the codes come from, type: uri, isSummary: true, index: 21}
          version: {short: Specific version of the code system referred to, type: string, isSummary: true, index: 22}
          concept:
            short: A concept defined in the system
            type: BackboneElement
            array: true
            index: 23
            elements:
              code: {short: Code or expression from system, type: code, index: 24}
              display: {short: Text to display for this code for this value set in this valueset, type: string, index: 25}
              designation:
                type: BackboneElement
                short: Additional representations for this concept
                array: true
                index: 26
                elements:
                  language: {short: Human language of the designation, type: code, index: 27}
                  use: {short: Details how this designation would be used, type: Coding, index: 28}
                  value: {type: string, short: The text value for this designation, index: 29}
                required: [value]
            required: [code]
          filter:
            isModifier: true
            short: Select codes/concepts by their properties (including relationships)
            type: BackboneElement
            array: true
            isSummary: true
            index: 30
            elements:
              property: {short: A property defined by the code system, type: code, isSummary: true, index: 31}
              op: {short: = | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | exists, type: code, isSummary: true, index: 32}
              value: {short: 'Code from the system, or regex criteria, or boolean value for exists', type: code, isSummary: true, index: 33}
            required: [value, property, op]
          valueSet: {short: Select only contents included in this value set, type: uri, array: true, isSummary: true, index: 34}
        isSummary: true
      exclude:
        elementReference: ['http://hl7.org/fhir/StructureDefinition/ValueSet', elements, compose, elements, include]
        short: Explicitly exclude codes from a code system or other value sets
        array: true
        index: 35
    required: [include]
  date: {short: Date this was last changed, type: dateTime, isSummary: true, index: 7}
  publisher: {short: Name of the publisher (organization or individual), type: string, isSummary: true, index: 8}
  extensible: {short: Whether this is intended to be used with an extensible binding, type: boolean, isSummary: true, index: 16}
  jurisdiction: {short: Intended jurisdiction for value set (if applicable), type: CodeableConcept, array: true, isSummary: true, index: 12}
  purpose: {short: Why this value set is defined, type: markdown, index: 14}
  name: {short: Name for this value set (computer friendly), type: string, isSummary: true, index: 3}
  useContext: {short: Context the content is intended to support, type: UsageContext, array: true, isSummary: true, index: 11}
  copyright: {short: Use and/or publishing restrictions, type: markdown, index: 15}
  experimental: {isModifier: true, short: 'For testing purposes, not real usage', type: boolean, isSummary: true, index: 6}
  expansion:
    short: Used when the value set is "expanded"
    type: BackboneElement
    index: 36
    elements:
      identifier: {type: uri, short: Uniquely identifies this expansion, index: 37}
      timestamp: {type: dateTime, short: Time ValueSet expansion happened, index: 38}
      total: {type: integer, short: Total number of codes in the expansion, index: 39}
      offset: {short: Offset at which this resource starts, type: integer, meaningWhenMissing: Paging is not being used, index: 40}
      parameter:
        type: BackboneElement
        short: Parameter that controlled the expansion process
        array: true
        index: 41
        elements:
          name: {type: string, short: Name as assigned by the server, index: 42}
          value:
            short: Value of the named parameter
            choices: [valueString, valueBoolean, valueInteger, valueDecimal, valueUri, valueCode]
            index: 44
          valueString: {type: string, short: Value of the named parameter, choiceOf: value, index: 45}
          valueBoolean: {type: boolean, short: Value of the named parameter, choiceOf: value, index: 46}
          valueInteger: {type: integer, short: Value of the named parameter, choiceOf: value, index: 47}
          valueDecimal: {type: decimal, short: Value of the named parameter, choiceOf: value, index: 48}
          valueUri: {type: uri, short: Value of the named parameter, choiceOf: value, index: 49}
          valueCode: {type: code, short: Value of the named parameter, choiceOf: value, index: 50}
        required: [name]
      contains:
        type: BackboneElement
        short: Codes in the value set
        constraint:
          vsd-6: {human: SHALL have a code or a display, severity: error, expression: code.exists() or display.exists()}
          vsd-9: {human: Must have a code if not abstract, severity: error, expression: code.exists() or abstract = true}
          vsd-10: {human: Must have a system if a code is present, severity: error, expression: code.empty() or system.exists()}
        array: true
        index: 51
        elements:
          system: {type: uri, short: System value for the code, index: 52}
          abstract: {short: If user cannot select this entry, type: boolean, defaultValueBoolean: false, index: 53}
          inactive: {short: If concept is inactive in the code system, type: boolean, defaultValueBoolean: false, index: 54}
          version: {type: string, short: Version in which this code/display is defined, index: 55}
          code: {type: code, short: 'Code - if blank, this is not a selectable code', index: 56}
          display: {type: string, short: User display for the concept, index: 57}
          designation:
            short: Additional representations for this item
            elementReference: ['http://hl7.org/fhir/StructureDefinition/ValueSet', elements, compose, elements, include, elements, concept, elements, designation]
            array: true
            index: 58
          contains:
            short: Codes contained under this entry
            elementReference: ['http://hl7.org/fhir/StructureDefinition/ValueSet', elements, expansion, elements, contains]
            array: true
            index: 59
    required: [timestamp, identifier]
  title: {short: Name for this value set (human friendly), type: string, isSummary: true, index: 4}
  status: {isModifier: true, short: draft | active | retired | unknown, type: code, isSummary: true, index: 5}
  url: {short: Logical URI to reference this value set (globally unique), type: uri, isSummary: true, index: 0}
  identifier: {short: Additional identifier for the value set, type: Identifier, array: true, isSummary: true, index: 1}
  immutable: {short: Indicates whether or not any change to the content logical definition may occur, type: boolean, isSummary: true, index: 13}
  version: {short: Business version of the value set, type: string, isSummary: true, index: 2}
  contact: {short: Contact details for the publisher, type: ContactDetail, array: true, isSummary: true, index: 9}
package_version: 3.2.0
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/ValueSet
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: null
required: [status]