http://hl7.org/fhir/StructureDefinition/ValueSet|4.0.1

description: A ValueSet resource instance specifies a set of codes drawn from one or more code systems, intended for use in a particular context. Value sets link between [[[CodeSystem]]] definitions and their use in [coded elements](terminologies.html).
derivation: specialization
name: ValueSet
type: ValueSet
elements:
  description: {short: Natural language description of the value set, index: 10}
  compose:
    short: Content logical definition of the value set (CLD)
    index: 16
    elements:
      lockedDate: {short: Fixed date for references with no specified version (transitive), isSummary: true, index: 17}
      inactive: {short: Whether inactive codes are in the value set, isSummary: true, index: 18}
      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)
        array: true
        isSummary: true
        index: 19
        elements:
          system: {short: The system the codes come from, isSummary: true, index: 20}
          version: {short: Specific version of the code system referred to, isSummary: true, index: 21}
          concept:
            short: A concept defined in the system
            array: true
            index: 22
            elements:
              code: {short: Code or expression from system, index: 23}
              display: {short: Text to display for this code for this value set in this valueset, index: 24}
              designation:
                short: Additional representations for this concept
                array: true
                index: 25
                elements:
                  language:
                    short: Human language of the designation
                    binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/languages'}
                    index: 26
                  use:
                    short: Types of uses of designations
                    binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/designation-use'}
                    index: 27
                  value: {short: The text value for this designation, index: 28}
                required: [value]
            required: [code]
          filter:
            short: Select codes/concepts by their properties (including relationships)
            array: true
            isSummary: true
            index: 29
            elements:
              property: {short: A property/filter defined by the code system, isSummary: true, index: 30}
              op:
                short: = | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | exists
                binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/filter-operator|4.0.1'}
                isSummary: true
                index: 31
              value: {short: 'Code from the system, or regex criteria, or boolean value for exists', isSummary: true, index: 32}
            required: [value, property, op]
          valueSet: {short: Select the contents included in this value set, array: true, isSummary: true, index: 33}
      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: 34
    required: [include]
  date: {short: Date last changed, isSummary: true, index: 7}
  publisher: {short: Name of the publisher (organization or individual), isSummary: true, index: 8}
  jurisdiction:
    short: Intended jurisdiction for value set (if applicable)
    array: true
    binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/jurisdiction'}
    isSummary: true
    index: 12
  purpose: {short: Why this value set is defined, index: 14}
  name: {short: Name for this value set (computer friendly), isSummary: true, index: 3}
  useContext: {short: The context that the content is intended to support, array: true, isSummary: true, index: 11}
  copyright: {short: Use and/or publishing restrictions, index: 15}
  experimental: {short: 'For testing purposes, not real usage', isSummary: true, index: 6}
  expansion:
    short: Used when the value set is \"expanded\"
    index: 35
    elements:
      identifier: {short: Identifies the value set expansion (business identifier), index: 36}
      timestamp: {short: Time ValueSet expansion happened, index: 37}
      total: {short: Total number of codes in the expansion, index: 38}
      offset: {short: Offset at which this resource starts, meaningWhenMissing: Paging is not being used, index: 39}
      parameter:
        short: Parameter that controlled the expansion process
        array: true
        index: 40
        elements:
          name: {short: Name as assigned by the client or server, index: 41}
          value:
            short: Value of the named parameter
            choices: []
            index: 43
        required: [name]
      contains:
        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()}
        short: Codes in the value set
        array: true
        index: 44
        elements:
          system: {short: System value for the code, index: 45}
          abstract: {short: If user cannot select this entry, meaningWhenMissing: 'If this is not populated, systems can assume that the concept it not abstract. This SHALL always be populated for abstract concepts', index: 46}
          inactive: {short: If concept is inactive in the code system, index: 47}
          version: {short: Version in which this code/display is defined, index: 48}
          code: {short: 'Code - if blank, this is not a selectable code', index: 49}
          display: {short: User display for the concept, index: 50}
          designation:
            elementReference: ['http://hl7.org/fhir/StructureDefinition/ValueSet', elements, compose, elements, include, elements, concept, elements, designation]
            short: Additional representations for this item
            array: true
            index: 51
          contains:
            elementReference: ['http://hl7.org/fhir/StructureDefinition/ValueSet', elements, expansion, elements, contains]
            short: Codes contained under this entry
            array: true
            index: 52
    required: [timestamp]
  title: {short: Name for this value set (human friendly), isSummary: true, index: 4}
  status:
    isModifier: true
    short: draft | active | retired | unknown
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/publication-status|4.0.1'}
    isModifierReason: This is labeled as \"Is Modifier\" because applications should not use a retired {{title}} without due consideration
    isSummary: true
    index: 5
  url: {short: 'Canonical identifier for this value set, represented as a URI (globally unique)', isSummary: true, index: 0}
  identifier: {short: Additional identifier for the value set (business identifier), array: true, isSummary: true, index: 1}
  immutable: {short: Indicates whether or not any change to the content logical definition may occur, isSummary: true, index: 13}
  version: {short: Business version of the value set, isSummary: true, index: 2}
  contact: {short: Contact details for the publisher, array: true, isSummary: true, index: 9}
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/ValueSet
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 4.0.1
required: [status]