Release 5 Draft Ballot

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

Vocabulary Work Group Maturity Level: 0Trial Use Use Context: Any

The official URL for this profile is:

http://hl7.org/fhir/StructureDefinition/vsd-alignedvalueset

This profile defines the necessary extensions and constraints on ValueSet to align with the HL7 Specification: Characteristics of a Value Set Definition, Release 1 (VSD). This normative specification describes elements to create a ValueSet definition, and does not describe elements related to a ValueSet expansion.

This profile was published on Thu, Jan 1, 1970 00:00+1000 as a draft by HL7.

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

This structure is derived from ValueSet.

NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet 1..1ValueSetA set of codes drawn from one or more code systems
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... valueset-otherTitle I0..*(Complex)Alternative titles
URL: http://hl7.org/fhir/StructureDefinition/valueset-otherTitle
vsd-2: Either title or extension-otherTitle must be valued
... valueset-authoritativeSource 0..1uriReference to the current trusted source of the ValueSet resource (metadata and definition)
URL: http://hl7.org/fhir/StructureDefinition/valueset-authoritativeSource
... valueset-sourceReference 0..1uriWhere did this content come from
URL: http://hl7.org/fhir/StructureDefinition/valueset-sourceReference
... valueset-keyWord 0..*stringDescriptors and key terms for search
URL: http://hl7.org/fhir/StructureDefinition/valueset-keyWord
... valueset-workflowStatusDescription S0..1stringIndicates the state of development of the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-workflowStatusDescription
... valueset-steward S0..*ContactDetailEntity responsible for Value Set
URL: http://hl7.org/fhir/StructureDefinition/valueset-steward
... valueset-author S0..*ContactDetailEntity/entities that create and may modify the Value Set
URL: http://hl7.org/fhir/StructureDefinition/valueset-author
... valueset-expression S0..1ExpressionAn alternative computable expression of the value set content
URL: http://hl7.org/fhir/StructureDefinition/valueset-expression
... valueset-supplement S0..*canonical(CodeSystem)Declares dependency on a particular supplment
URL: http://hl7.org/fhir/StructureDefinition/valueset-supplement
... url 1..1uriCanonical identifier for this value set, represented as a URI (globally unique)
... identifier SI0..*IdentifierAdditional identifier for the value set (business identifier)
vsd-1: Identifier.system is restricted to OID, RUID, UUID, URI
... version S1..1stringBusiness version of the value set
... name 1..1stringName for this value set (computer friendly)
... title I0..1stringName for this value set (human friendly)
vsd-2: Either title or extension-otherTitle must be valued
... status S1..1codedraft | active | retired | unknown
.... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... valueset-status-activityStatusDate S0..1dateDate when the activity status is in effect
URL: http://hl7.org/fhir/StructureDefinition/valueset-status-activityStatusDate
... experimental S1..1booleanFor testing purposes, not real usage
... publisher S0..1stringName of the publisher (organization or individual)
... useContext S0..*UsageContextThe context that the content is intended to support
... immutable S1..1booleanIndicates whether or not any change to the content logical definition may occur
... purpose 0..1markdownWhy this value set is defined
... compose S0..1BackboneElementContent logical definition of the value set (CLD)
.... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... valueset-compose-creationDate 0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-creationDate
.... valueset-compose-createdBy 0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-createdBy
.... lockedDate S0..1dateFixed date for references with no specified version (transitive)
.... inactive S0..1booleanWhether inactive codes are in the value set
.... include S1..*BackboneElementInclude one or more codes from a code system or other value set(s)
..... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
..... valueset-compose-include-valueSetTitle 0..1stringCode system name
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-valueSetTitle
..... valueset-systemTitle 0..1stringCode system title
URL: http://hl7.org/fhir/StructureDefinition/valueset-systemTitle
..... valueset-compose-include-minimumMultiplicity S0..1integerthe minimum number of the specified relationships allowed
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-minimumMultiplicity
..... valueset-compose-include-maximumMultiplicity S0..1integerthe maximum number of the specified relationships allowed
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-maximumMultiplicity
..... system S0..1uriThe system the codes come from
..... filter S0..*BackboneElementSelect codes/concepts by their properties (including relationships)
...... property S1..1codeA property/filter defined by the code system
...... op S1..1code= | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | exists
...... value S1..1stringCode from the system, or regex criteria, or boolean value for exists
..... copyright S0..1stringA copyright statement for the specific code system included in the value set
... scope S1..1BackboneElementDescription of the semantic space the Value Set Expansion is intended to cover

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet I1..1ValueSetA set of codes drawn from one or more code systems
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: Common Languages (preferred)
Max Binding: All Languages: IETF language tag

... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... valueset-otherTitle I0..*(Complex)Alternative titles
URL: http://hl7.org/fhir/StructureDefinition/valueset-otherTitle
vsd-2: Either title or extension-otherTitle must be valued
... valueset-authoritativeSource 0..1uriReference to the current trusted source of the ValueSet resource (metadata and definition)
URL: http://hl7.org/fhir/StructureDefinition/valueset-authoritativeSource
... valueset-trusted-expansion 0..*urlReference to a trusted expansion
URL: http://hl7.org/fhir/StructureDefinition/valueset-trusted-expansion
... valueset-sourceReference 0..1uriWhere did this content come from
URL: http://hl7.org/fhir/StructureDefinition/valueset-sourceReference
... valueset-keyWord 0..*stringDescriptors and key terms for search
URL: http://hl7.org/fhir/StructureDefinition/valueset-keyWord
... valueset-workflowStatusDescription S0..1stringIndicates the state of development of the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-workflowStatusDescription
... valueset-steward S0..*ContactDetailEntity responsible for Value Set
URL: http://hl7.org/fhir/StructureDefinition/valueset-steward
... valueset-author S0..*ContactDetailEntity/entities that create and may modify the Value Set
URL: http://hl7.org/fhir/StructureDefinition/valueset-author
... valueset-expression S0..1ExpressionAn alternative computable expression of the value set content
URL: http://hl7.org/fhir/StructureDefinition/valueset-expression
... valueset-supplement S0..*canonical(CodeSystem)Declares dependency on a particular supplment
URL: http://hl7.org/fhir/StructureDefinition/valueset-supplement
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url Σ1..1uriCanonical identifier for this value set, represented as a URI (globally unique)
... identifier SΣI0..*IdentifierAdditional identifier for the value set (business identifier)
vsd-1: Identifier.system is restricted to OID, RUID, UUID, URI
... version SΣ1..1stringBusiness version of the value set
... name ΣI1..1stringName for this value set (computer friendly)
... title ΣI0..1stringName for this value set (human friendly)
vsd-2: Either title or extension-otherTitle must be valued
... status ?!SΣ1..1codedraft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... valueset-status-activityStatusDate S0..1dateDate when the activity status is in effect
URL: http://hl7.org/fhir/StructureDefinition/valueset-status-activityStatusDate
.... value 0..1stringPrimitive value for code
... experimental SΣ1..1booleanFor testing purposes, not real usage
... date Σ0..1dateTimeDate last changed
... publisher SΣ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... description 0..1markdownNatural language description of the value set
... useContext SΣ0..*UsageContextThe context that the content is intended to support
... jurisdiction Σ0..*CodeableConceptIntended jurisdiction for value set (if applicable)
Binding: Jurisdiction (extensible): Countries and regions within which this artifact is targeted for use.


... immutable SΣ1..1booleanIndicates whether or not any change to the content logical definition may occur
... purpose 0..1markdownWhy this value set is defined
... copyright 0..1markdownUse and/or publishing restrictions
... compose S0..1BackboneElementContent logical definition of the value set (CLD)
.... id 0..1idUnique id for inter-element referencing
.... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... valueset-compose-creationDate 0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-creationDate
.... valueset-compose-createdBy 0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-createdBy
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... lockedDate SΣ0..1dateFixed date for references with no specified version (transitive)
.... inactive SΣ0..1booleanWhether inactive codes are in the value set
.... include SΣI1..*BackboneElementInclude one or more codes from a code system or other value set(s)
..... id 0..1idUnique id for inter-element referencing
..... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
..... valueset-compose-include-valueSetTitle 0..1stringCode system name
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-valueSetTitle
..... valueset-systemTitle 0..1stringCode system title
URL: http://hl7.org/fhir/StructureDefinition/valueset-systemTitle
..... valueset-compose-include-minimumMultiplicity S0..1integerthe minimum number of the specified relationships allowed
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-minimumMultiplicity
..... valueset-compose-include-maximumMultiplicity S0..1integerthe maximum number of the specified relationships allowed
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-maximumMultiplicity
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... system SΣI0..1uriThe system the codes come from
..... version Σ0..1stringSpecific version of the code system referred to
..... concept I0..*BackboneElementA concept defined in the system
...... id 0..1idUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code 1..1codeCode or expression from system
...... display 0..1stringText to display for this code for this value set in this valueset
...... designation 0..*BackboneElementAdditional representations for this concept
....... id 0..1idUnique id for inter-element referencing
....... extension 0..*ExtensionAdditional content defined by implementations
....... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
....... language 0..1codeHuman language of the designation
Binding: Common Languages (preferred)
Max Binding: All Languages: IETF language tag

....... use 0..1CodingTypes of uses of designations
Binding: Designation Use (extensible): Details of how a designation would be used.

....... value 1..1stringThe text value for this designation
..... filter SΣI0..*BackboneElementSelect codes/concepts by their properties (including relationships)
...... id 0..1idUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... property SΣ1..1codeA property/filter defined by the code system
...... op SΣ1..1code= | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | exists
Binding: FilterOperator (required): The kind of operation to perform as a part of a property based filter.

...... value SΣ1..1stringCode from the system, or regex criteria, or boolean value for exists
..... valueSet ΣI0..*canonical(ValueSet)Select the contents included in this value set
..... copyright S0..1stringA copyright statement for the specific code system included in the value set
.... exclude I0..*See include (ValueSet)Explicitly exclude codes from a code system or other value sets
.... property 0..*stringProperty to return if client doesn't override
... expansion 0..1BackboneElementUsed when the value set is "expanded"
.... id 0..1idUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... identifier 0..1uriIdentifies the value set expansion (business identifier)
.... timestamp 1..1dateTimeTime ValueSet expansion happened
.... total 0..1integerTotal number of codes in the expansion
.... offset 0..1integerOffset at which this resource starts
.... parameter 0..*BackboneElementParameter that controlled the expansion process
..... id 0..1idUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... name 1..1stringName as assigned by the client or server
..... value[x] 0..1Value of the named parameter
...... valueStringstring
...... valueBooleanboolean
...... valueIntegerinteger
...... valueDecimaldecimal
...... valueUriuri
...... valueCodecode
...... valueDateTimedateTime
.... property 0..*BackboneElementAdditional information supplied about each concept
..... id 0..1idUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code 1..1codeIdentifies the property on the concepts, and when referred to in operations
..... uri 0..1uriFormal identifier for the property
.... contains I0..*BackboneElementCodes in the value set
..... id 0..1idUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... system 0..1uriSystem value for the code
..... abstract 0..1booleanIf user cannot select this entry
..... inactive 0..1booleanIf concept is inactive in the code system
..... version 0..1stringVersion in which this code/display is defined
..... code I0..1codeCode - if blank, this is not a selectable code
..... display I0..1stringUser display for the concept
..... designation 0..*See designation (ValueSet)Additional representations for this item
..... property 0..*BackboneElementProperty value for the concept
...... id 0..1idUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code 1..1codeReference to ValueSet.expansion.property.code
...... value[x] 1..1Value of the property for this concept
....... valueCodecode
....... valueCodingCoding
....... valueStringstring
....... valueIntegerinteger
....... valueBooleanboolean
....... valueDateTimedateTime
....... valueDecimaldecimal
..... contains 0..*See contains (ValueSet)Codes contained under this entry
... scope S1..1BackboneElementDescription of the semantic space the Value Set Expansion is intended to cover
.... id 0..1idUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... focus 0..1stringGeneral focus of the Value Set as it relates to the intended semantic space
.... inclusionCriteria 0..1stringCriteria describing which concepts or codes should be included and why
.... exclusionCriteria 0..1stringCriteria describing which concepts or codes should be excluded and why

doco Documentation for this format
<!-- VSDALignedValueSet -->doco

<ValueSet xmlns="http://hl7.org/fhir"
>
  <!-- from Element: extension -->
 <id value="[id]"/><!-- 0..1 Logical id of this artifact -->
 <meta><!-- ?? 0..1 Meta Metadata about the resource --></meta>
 <implicitRules value="[uri]"/><!-- ?? 0..1 A set of rules under which this content was created -->
 <language value="[code]"/><!-- ?? 0..1 Language of the resource content   -->
 <text><!-- ?? 0..1 Narrative 
     Text summary of the resource, for human interpretation --></text>
 <contained><!-- 0..* Resource Contained, inline Resources --></contained>
 <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored  --></modifierExtension>
 <url value="[uri]"/><!-- ?? 1..1 Canonical identifier for this value set, represented as a URI (globally unique) -->
 <identifier><!-- ?? 0..* Identifier 
     Additional identifier for the value set (business identifier) --></identifier>
 <version value="[string]"/><!-- ?? 1..1 Business version of the value set -->
 <name value="[string]"/><!-- ?? 1..1 Name for this value set (computer friendly) -->
 <title value="[string]"/><!-- ?? 0..1 Name for this value set (human friendly) -->
 <status value="[code]"/> ?? 1..1  <!-- ?? 1..1 draft | active | retired | unknown -->
 
 <experimental value="[boolean]"/><!-- ?? 1..1 For testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- ?? 0..1 Date last changed -->
 <publisher value="[string]"/><!-- ?? 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- ?? 0..* ContactDetail Contact details for the publisher --></contact>
 <description value="[markdown]"/><!-- ?? 0..1 Natural language description of the value set -->
 <useContext><!-- ?? 0..* UsageContext 
     The context that the content is intended to support --></useContext>
 <jurisdiction><!-- ?? 0..* CodeableConcept Intended jurisdiction for value set (if applicable)   --></jurisdiction>
 <immutable value="[boolean]"/><!-- ?? 1..1 Indicates whether or not any change to the content logical definition may occur -->
 <purpose value="[markdown]"/><!-- ?? 0..1 Why this value set is defined -->
 <copyright value="[markdown]"/><!-- ?? 0..1 Use and/or publishing restrictions -->
 <compose> ?? 0..1 BackboneElement  <!-- ?? 0..1 Content logical definition of the value set (CLD) -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <lockedDate value="[date]"/><!-- ?? 0..1 Fixed date for references with no specified version (transitive) -->
  <inactive value="[boolean]"/><!-- ?? 0..1 Whether inactive codes are in the value set -->
  <include> ?? 1..* BackboneElement  <!-- ?? 1..* Include one or more codes from a code system or other value set(s) -->
   <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
   <system value="[uri]"/><!-- ?? 0..1 The system the codes come from -->
   <version value="[string]"/><!-- ?? 0..1 Specific version of the code system referred to -->
   <concept> ?? 0..* BackboneElement  <!-- ?? 0..* A concept defined in the system -->
    <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
    <code value="[code]"/><!-- ?? 1..1 Code or expression from system -->
    <display value="[string]"/><!-- ?? 0..1 
        Text to display for this code for this value set in this valueset -->
    <designation> ?? 0..* BackboneElement  <!-- ?? 0..* Additional representations for this concept -->
     <modifierExtension><!-- ?? 0..* 
       Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
     <language value="[code]"/><!-- ?? 0..1 Human language of the designation   -->
     <use><!-- ?? 0..1 Coding Types of uses of designations   --></use>
     <value value="[string]"/><!-- ?? 1..1 The text value for this designation -->
    </designation>
   </concept>
   <filter> ?? 0..* BackboneElement  <!-- ?? 0..* Select codes/concepts by their properties (including relationships) -->
    <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
    <property value="[code]"/><!-- ?? 1..1 A property/filter defined by the code system -->
    <op value="[code]"/><!-- ?? 1..1 = | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | exists    -->
    <value value="[string]"/><!-- ?? 1..1 
        Code from the system, or regex criteria, or boolean value for exists -->
   </filter>
   <valueSet value="[canonical]"/><!-- ?? 0..* Select the contents included in this value set -->
   <copyright value="[string]"/><!-- ?? 0..1 
       A copyright statement for the specific code system included in the value set -->
  </include>
  <exclude><!-- See http://hl7.org/fhir/StructureDefinition/ValueSet#ValueSet.compose.include  Explicitly exclude codes from a code system or other value sets --></exclude>
  <property value="[string]"/><!-- ?? 0..* Property to return if client doesn't override -->
 </compose>
 <expansion> ?? 0..1 BackboneElement  <!-- ?? 0..1 Used when the value set is "expanded" -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <identifier value="[uri]"/><!-- ?? 0..1 Identifies the value set expansion (business identifier) -->
  <timestamp value="[dateTime]"/><!-- ?? 1..1 Time ValueSet expansion happened -->
  <total value="[integer]"/><!-- ?? 0..1 Total number of codes in the expansion -->
  <offset value="[integer]"/><!-- ?? 0..1 Offset at which this resource starts -->
  <parameter> ?? 0..* BackboneElement  <!-- ?? 0..* Parameter that controlled the expansion process -->
   <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
   <name value="[string]"/><!-- ?? 1..1 Name as assigned by the client or server -->
   <value[x]><!-- ?? 0..1 string|boolean|integer|
     decimal|uri|code|dateTime Value of the named parameter --></value[x]>
  </parameter>
  <property> ?? 0..* BackboneElement  <!-- ?? 0..* Additional information supplied about each concept -->
   <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
   <code value="[code]"/><!-- ?? 1..1 
       Identifies the property on the concepts, and when referred to in operations -->
   <uri value="[uri]"/><!-- ?? 0..1 Formal identifier for the property -->
  </property>
  <contains> ?? 0..* BackboneElement  <!-- ?? 0..* Codes in the value set -->
   <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
   <system value="[uri]"/><!-- ?? 0..1 System value for the code -->
   <abstract value="[boolean]"/><!-- ?? 0..1 If user cannot select this entry -->
   <inactive value="[boolean]"/><!-- ?? 0..1 If concept is inactive in the code system -->
   <version value="[string]"/><!-- ?? 0..1 Version in which this code/display is defined -->
   <code value="[code]"/><!-- ?? 0..1 Code - if blank, this is not a selectable code -->
   <display value="[string]"/><!-- ?? 0..1 User display for the concept -->
   <designation><!-- See http://hl7.org/fhir/StructureDefinition/ValueSet#ValueSet.compose.include.concept.designation  Additional representations for this item --></designation>
   <property> ?? 0..* BackboneElement  <!-- ?? 0..* Property value for the concept -->
    <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
    <code value="[code]"/><!-- ?? 1..1 Reference to ValueSet.expansion.property.code -->
    <value[x]><!-- ?? 1..1 code|Coding|string|
      integer|boolean|dateTime|decimal 
        Value of the property for this concept --></value[x]>
   </property>
   <contains><!-- See http://hl7.org/fhir/StructureDefinition/ValueSet#ValueSet.expansion.contains  Codes contained under this entry --></contains>
  </contains>
 </expansion>
 <scope> ?? 1..1 BackboneElement  <!-- ?? 1..1 Description of the semantic space the Value Set Expansion is intended to cover -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <focus value="[string]"/><!-- ?? 0..1 General focus of the Value Set as it relates to the intended semantic space -->
  <inclusionCriteria value="[string]"/><!-- ?? 0..1 
      Criteria describing which concepts or codes should be included and why -->
  <exclusionCriteria value="[string]"/><!-- ?? 0..1 
      Criteria describing which concepts or codes should be excluded and why -->
 </scope>
</ValueSet>
{ // VSDALignedValueSet
  // from Element: extension
    "meta" : { Meta }, // C?Metadata about the resource
    "implicitRules" : "<uri>", // C?A set of rules under which this content was created
    "language" : "<code>", // C?Language of the resource content
    "text" : { Narrative }, // C?Text summary of the resource, for human interpretation
    "contained" : [{ Resource }], //Contained, inline Resources
    "extension" : [ //  sliced by value:url  in the specified order, Open 
      { // Alternative titles // C?
        // from Element: extension
      },
      { // Reference to the current trusted source of the ValueSet resource (metadata and definition) // C?
        // from Element: extension
      },
      { // Reference to a trusted expansion // C?
        // from Element: extension
      },
      { // Where did this content come from // C?
        // from Element: extension
      },
      { // Descriptors and key terms for search // C?
        // from Element: extension
      },
      { // Indicates the state of development of the value set // C?
        // from Element: extension
      },
      { // Entity responsible for Value Set // C?
        // from Element: extension
      },
      { // Entity/entities that create and may modify the Value Set // C?
        // from Element: extension
      },
      { // An alternative computable expression of the value set content // C?
        // from Element: extension
      },
      { // Declares dependency on a particular supplment // C?
        // from Element: extension
      }
    ],
    "modifierExtension" : [{ Extension }], // C?Extensions that cannot be ignored
    "url" : "<uri>", // C? R! Canonical identifier for this value set, represented as a URI (globally unique)
    "identifier" : [{ Identifier }], // C?Additional identifier for the value set (business identifier)
    "version" : "<string>", // C? R! Business version of the value set
    "name" : "<string>", // C? R! Name for this value set (computer friendly)
    "title" : "<string>", // C?Name for this value set (human friendly)
    "status" : "<code>", // C? R! draft | active | retired | unknown 
    "experimental" : <boolean>, // C? R! For testing purposes, not real usage
    "date" : "<dateTime>", // C?Date last changed
    "publisher" : "<string>", // C?Name of the publisher (organization or individual)
    "contact" : [{ ContactDetail }], // C?Contact details for the publisher
    "description" : "<markdown>", // C?Natural language description of the value set
    "useContext" : [{ UsageContext }], // C?The context that the content is intended to support
    "jurisdiction" : [{ CodeableConcept }], // C?Intended jurisdiction for value set (if applicable)
    "immutable" : <boolean>, // C? R! Indicates whether or not any change to the content logical definition may occur
    "purpose" : "<markdown>", // C?Why this value set is defined
    "copyright" : "<markdown>", // C?Use and/or publishing restrictions
    "compose" : { BackboneElement }, // C?Content logical definition of the value set (CLD)
    "expansion" : { BackboneElement }, // C?Used when the value set is "expanded"
    "scope" : { BackboneElement }, // C? R! Description of the semantic space the Value Set Expansion is intended to cover
  }

Differential View

This structure is derived from ValueSet.

NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet 1..1ValueSetA set of codes drawn from one or more code systems
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... valueset-otherTitle I0..*(Complex)Alternative titles
URL: http://hl7.org/fhir/StructureDefinition/valueset-otherTitle
vsd-2: Either title or extension-otherTitle must be valued
... valueset-authoritativeSource 0..1uriReference to the current trusted source of the ValueSet resource (metadata and definition)
URL: http://hl7.org/fhir/StructureDefinition/valueset-authoritativeSource
... valueset-sourceReference 0..1uriWhere did this content come from
URL: http://hl7.org/fhir/StructureDefinition/valueset-sourceReference
... valueset-keyWord 0..*stringDescriptors and key terms for search
URL: http://hl7.org/fhir/StructureDefinition/valueset-keyWord
... valueset-workflowStatusDescription S0..1stringIndicates the state of development of the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-workflowStatusDescription
... valueset-steward S0..*ContactDetailEntity responsible for Value Set
URL: http://hl7.org/fhir/StructureDefinition/valueset-steward
... valueset-author S0..*ContactDetailEntity/entities that create and may modify the Value Set
URL: http://hl7.org/fhir/StructureDefinition/valueset-author
... valueset-expression S0..1ExpressionAn alternative computable expression of the value set content
URL: http://hl7.org/fhir/StructureDefinition/valueset-expression
... valueset-supplement S0..*canonical(CodeSystem)Declares dependency on a particular supplment
URL: http://hl7.org/fhir/StructureDefinition/valueset-supplement
... url 1..1uriCanonical identifier for this value set, represented as a URI (globally unique)
... identifier SI0..*IdentifierAdditional identifier for the value set (business identifier)
vsd-1: Identifier.system is restricted to OID, RUID, UUID, URI
... version S1..1stringBusiness version of the value set
... name 1..1stringName for this value set (computer friendly)
... title I0..1stringName for this value set (human friendly)
vsd-2: Either title or extension-otherTitle must be valued
... status S1..1codedraft | active | retired | unknown
.... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... valueset-status-activityStatusDate S0..1dateDate when the activity status is in effect
URL: http://hl7.org/fhir/StructureDefinition/valueset-status-activityStatusDate
... experimental S1..1booleanFor testing purposes, not real usage
... publisher S0..1stringName of the publisher (organization or individual)
... useContext S0..*UsageContextThe context that the content is intended to support
... immutable S1..1booleanIndicates whether or not any change to the content logical definition may occur
... purpose 0..1markdownWhy this value set is defined
... compose S0..1BackboneElementContent logical definition of the value set (CLD)
.... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... valueset-compose-creationDate 0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-creationDate
.... valueset-compose-createdBy 0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-createdBy
.... lockedDate S0..1dateFixed date for references with no specified version (transitive)
.... inactive S0..1booleanWhether inactive codes are in the value set
.... include S1..*BackboneElementInclude one or more codes from a code system or other value set(s)
..... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
..... valueset-compose-include-valueSetTitle 0..1stringCode system name
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-valueSetTitle
..... valueset-systemTitle 0..1stringCode system title
URL: http://hl7.org/fhir/StructureDefinition/valueset-systemTitle
..... valueset-compose-include-minimumMultiplicity S0..1integerthe minimum number of the specified relationships allowed
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-minimumMultiplicity
..... valueset-compose-include-maximumMultiplicity S0..1integerthe maximum number of the specified relationships allowed
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-maximumMultiplicity
..... system S0..1uriThe system the codes come from
..... filter S0..*BackboneElementSelect codes/concepts by their properties (including relationships)
...... property S1..1codeA property/filter defined by the code system
...... op S1..1code= | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | exists
...... value S1..1stringCode from the system, or regex criteria, or boolean value for exists
..... copyright S0..1stringA copyright statement for the specific code system included in the value set
... scope S1..1BackboneElementDescription of the semantic space the Value Set Expansion is intended to cover

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet I1..1ValueSetA set of codes drawn from one or more code systems
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: Common Languages (preferred)
Max Binding: All Languages: IETF language tag

... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... valueset-otherTitle I0..*(Complex)Alternative titles
URL: http://hl7.org/fhir/StructureDefinition/valueset-otherTitle
vsd-2: Either title or extension-otherTitle must be valued
... valueset-authoritativeSource 0..1uriReference to the current trusted source of the ValueSet resource (metadata and definition)
URL: http://hl7.org/fhir/StructureDefinition/valueset-authoritativeSource
... valueset-trusted-expansion 0..*urlReference to a trusted expansion
URL: http://hl7.org/fhir/StructureDefinition/valueset-trusted-expansion
... valueset-sourceReference 0..1uriWhere did this content come from
URL: http://hl7.org/fhir/StructureDefinition/valueset-sourceReference
... valueset-keyWord 0..*stringDescriptors and key terms for search
URL: http://hl7.org/fhir/StructureDefinition/valueset-keyWord
... valueset-workflowStatusDescription S0..1stringIndicates the state of development of the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-workflowStatusDescription
... valueset-steward S0..*ContactDetailEntity responsible for Value Set
URL: http://hl7.org/fhir/StructureDefinition/valueset-steward
... valueset-author S0..*ContactDetailEntity/entities that create and may modify the Value Set
URL: http://hl7.org/fhir/StructureDefinition/valueset-author
... valueset-expression S0..1ExpressionAn alternative computable expression of the value set content
URL: http://hl7.org/fhir/StructureDefinition/valueset-expression
... valueset-supplement S0..*canonical(CodeSystem)Declares dependency on a particular supplment
URL: http://hl7.org/fhir/StructureDefinition/valueset-supplement
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url Σ1..1uriCanonical identifier for this value set, represented as a URI (globally unique)
... identifier SΣI0..*IdentifierAdditional identifier for the value set (business identifier)
vsd-1: Identifier.system is restricted to OID, RUID, UUID, URI
... version SΣ1..1stringBusiness version of the value set
... name ΣI1..1stringName for this value set (computer friendly)
... title ΣI0..1stringName for this value set (human friendly)
vsd-2: Either title or extension-otherTitle must be valued
... status ?!SΣ1..1codedraft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... valueset-status-activityStatusDate S0..1dateDate when the activity status is in effect
URL: http://hl7.org/fhir/StructureDefinition/valueset-status-activityStatusDate
.... value 0..1stringPrimitive value for code
... experimental SΣ1..1booleanFor testing purposes, not real usage
... date Σ0..1dateTimeDate last changed
... publisher SΣ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... description 0..1markdownNatural language description of the value set
... useContext SΣ0..*UsageContextThe context that the content is intended to support
... jurisdiction Σ0..*CodeableConceptIntended jurisdiction for value set (if applicable)
Binding: Jurisdiction (extensible): Countries and regions within which this artifact is targeted for use.


... immutable SΣ1..1booleanIndicates whether or not any change to the content logical definition may occur
... purpose 0..1markdownWhy this value set is defined
... copyright 0..1markdownUse and/or publishing restrictions
... compose S0..1BackboneElementContent logical definition of the value set (CLD)
.... id 0..1idUnique id for inter-element referencing
.... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... valueset-compose-creationDate 0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-creationDate
.... valueset-compose-createdBy 0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-createdBy
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... lockedDate SΣ0..1dateFixed date for references with no specified version (transitive)
.... inactive SΣ0..1booleanWhether inactive codes are in the value set
.... include SΣI1..*BackboneElementInclude one or more codes from a code system or other value set(s)
..... id 0..1idUnique id for inter-element referencing
..... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
..... valueset-compose-include-valueSetTitle 0..1stringCode system name
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-valueSetTitle
..... valueset-systemTitle 0..1stringCode system title
URL: http://hl7.org/fhir/StructureDefinition/valueset-systemTitle
..... valueset-compose-include-minimumMultiplicity S0..1integerthe minimum number of the specified relationships allowed
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-minimumMultiplicity
..... valueset-compose-include-maximumMultiplicity S0..1integerthe maximum number of the specified relationships allowed
URL: http://hl7.org/fhir/StructureDefinition/valueset-compose-include-maximumMultiplicity
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... system SΣI0..1uriThe system the codes come from
..... version Σ0..1stringSpecific version of the code system referred to
..... concept I0..*BackboneElementA concept defined in the system
...... id 0..1idUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code 1..1codeCode or expression from system
...... display 0..1stringText to display for this code for this value set in this valueset
...... designation 0..*BackboneElementAdditional representations for this concept
....... id 0..1idUnique id for inter-element referencing
....... extension 0..*ExtensionAdditional content defined by implementations
....... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
....... language 0..1codeHuman language of the designation
Binding: Common Languages (preferred)
Max Binding: All Languages: IETF language tag

....... use 0..1CodingTypes of uses of designations
Binding: Designation Use (extensible): Details of how a designation would be used.

....... value 1..1stringThe text value for this designation
..... filter SΣI0..*BackboneElementSelect codes/concepts by their properties (including relationships)
...... id 0..1idUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... property SΣ1..1codeA property/filter defined by the code system
...... op SΣ1..1code= | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | exists
Binding: FilterOperator (required): The kind of operation to perform as a part of a property based filter.

...... value SΣ1..1stringCode from the system, or regex criteria, or boolean value for exists
..... valueSet ΣI0..*canonical(ValueSet)Select the contents included in this value set
..... copyright S0..1stringA copyright statement for the specific code system included in the value set
.... exclude I0..*See include (ValueSet)Explicitly exclude codes from a code system or other value sets
.... property 0..*stringProperty to return if client doesn't override
... expansion 0..1BackboneElementUsed when the value set is "expanded"
.... id 0..1idUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... identifier 0..1uriIdentifies the value set expansion (business identifier)
.... timestamp 1..1dateTimeTime ValueSet expansion happened
.... total 0..1integerTotal number of codes in the expansion
.... offset 0..1integerOffset at which this resource starts
.... parameter 0..*BackboneElementParameter that controlled the expansion process
..... id 0..1idUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... name 1..1stringName as assigned by the client or server
..... value[x] 0..1Value of the named parameter
...... valueStringstring
...... valueBooleanboolean
...... valueIntegerinteger
...... valueDecimaldecimal
...... valueUriuri
...... valueCodecode
...... valueDateTimedateTime
.... property 0..*BackboneElementAdditional information supplied about each concept
..... id 0..1idUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... code 1..1codeIdentifies the property on the concepts, and when referred to in operations
..... uri 0..1uriFormal identifier for the property
.... contains I0..*BackboneElementCodes in the value set
..... id 0..1idUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... system 0..1uriSystem value for the code
..... abstract 0..1booleanIf user cannot select this entry
..... inactive 0..1booleanIf concept is inactive in the code system
..... version 0..1stringVersion in which this code/display is defined
..... code I0..1codeCode - if blank, this is not a selectable code
..... display I0..1stringUser display for the concept
..... designation 0..*See designation (ValueSet)Additional representations for this item
..... property 0..*BackboneElementProperty value for the concept
...... id 0..1idUnique id for inter-element referencing
...... extension 0..*ExtensionAdditional content defined by implementations
...... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
...... code 1..1codeReference to ValueSet.expansion.property.code
...... value[x] 1..1Value of the property for this concept
....... valueCodecode
....... valueCodingCoding
....... valueStringstring
....... valueIntegerinteger
....... valueBooleanboolean
....... valueDateTimedateTime
....... valueDecimaldecimal
..... contains 0..*See contains (ValueSet)Codes contained under this entry
... scope S1..1BackboneElementDescription of the semantic space the Value Set Expansion is intended to cover
.... id 0..1idUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... focus 0..1stringGeneral focus of the Value Set as it relates to the intended semantic space
.... inclusionCriteria 0..1stringCriteria describing which concepts or codes should be included and why
.... exclusionCriteria 0..1stringCriteria describing which concepts or codes should be excluded and why

doco Documentation for this format

XML Template

<!-- VSDALignedValueSet -->doco

<ValueSet xmlns="http://hl7.org/fhir"
>
  <!-- from Element: extension -->
 <id value="[id]"/><!-- 0..1 Logical id of this artifact -->
 <meta><!-- ?? 0..1 Meta Metadata about the resource --></meta>
 <implicitRules value="[uri]"/><!-- ?? 0..1 A set of rules under which this content was created -->
 <language value="[code]"/><!-- ?? 0..1 Language of the resource content   -->
 <text><!-- ?? 0..1 Narrative 
     Text summary of the resource, for human interpretation --></text>
 <contained><!-- 0..* Resource Contained, inline Resources --></contained>
 <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored  --></modifierExtension>
 <url value="[uri]"/><!-- ?? 1..1 Canonical identifier for this value set, represented as a URI (globally unique) -->
 <identifier><!-- ?? 0..* Identifier 
     Additional identifier for the value set (business identifier) --></identifier>
 <version value="[string]"/><!-- ?? 1..1 Business version of the value set -->
 <name value="[string]"/><!-- ?? 1..1 Name for this value set (computer friendly) -->
 <title value="[string]"/><!-- ?? 0..1 Name for this value set (human friendly) -->
 <status value="[code]"/> ?? 1..1  <!-- ?? 1..1 draft | active | retired | unknown -->
 
 <experimental value="[boolean]"/><!-- ?? 1..1 For testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- ?? 0..1 Date last changed -->
 <publisher value="[string]"/><!-- ?? 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- ?? 0..* ContactDetail Contact details for the publisher --></contact>
 <description value="[markdown]"/><!-- ?? 0..1 Natural language description of the value set -->
 <useContext><!-- ?? 0..* UsageContext 
     The context that the content is intended to support --></useContext>
 <jurisdiction><!-- ?? 0..* CodeableConcept Intended jurisdiction for value set (if applicable)   --></jurisdiction>
 <immutable value="[boolean]"/><!-- ?? 1..1 Indicates whether or not any change to the content logical definition may occur -->
 <purpose value="[markdown]"/><!-- ?? 0..1 Why this value set is defined -->
 <copyright value="[markdown]"/><!-- ?? 0..1 Use and/or publishing restrictions -->
 <compose> ?? 0..1 BackboneElement  <!-- ?? 0..1 Content logical definition of the value set (CLD) -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <lockedDate value="[date]"/><!-- ?? 0..1 Fixed date for references with no specified version (transitive) -->
  <inactive value="[boolean]"/><!-- ?? 0..1 Whether inactive codes are in the value set -->
  <include> ?? 1..* BackboneElement  <!-- ?? 1..* Include one or more codes from a code system or other value set(s) -->
   <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
   <system value="[uri]"/><!-- ?? 0..1 The system the codes come from -->
   <version value="[string]"/><!-- ?? 0..1 Specific version of the code system referred to -->
   <concept> ?? 0..* BackboneElement  <!-- ?? 0..* A concept defined in the system -->
    <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
    <code value="[code]"/><!-- ?? 1..1 Code or expression from system -->
    <display value="[string]"/><!-- ?? 0..1 
        Text to display for this code for this value set in this valueset -->
    <designation> ?? 0..* BackboneElement  <!-- ?? 0..* Additional representations for this concept -->
     <modifierExtension><!-- ?? 0..* 
       Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
     <language value="[code]"/><!-- ?? 0..1 Human language of the designation   -->
     <use><!-- ?? 0..1 Coding Types of uses of designations   --></use>
     <value value="[string]"/><!-- ?? 1..1 The text value for this designation -->
    </designation>
   </concept>
   <filter> ?? 0..* BackboneElement  <!-- ?? 0..* Select codes/concepts by their properties (including relationships) -->
    <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
    <property value="[code]"/><!-- ?? 1..1 A property/filter defined by the code system -->
    <op value="[code]"/><!-- ?? 1..1 = | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | exists    -->
    <value value="[string]"/><!-- ?? 1..1 
        Code from the system, or regex criteria, or boolean value for exists -->
   </filter>
   <valueSet value="[canonical]"/><!-- ?? 0..* Select the contents included in this value set -->
   <copyright value="[string]"/><!-- ?? 0..1 
       A copyright statement for the specific code system included in the value set -->
  </include>
  <exclude><!-- See http://hl7.org/fhir/StructureDefinition/ValueSet#ValueSet.compose.include  Explicitly exclude codes from a code system or other value sets --></exclude>
  <property value="[string]"/><!-- ?? 0..* Property to return if client doesn't override -->
 </compose>
 <expansion> ?? 0..1 BackboneElement  <!-- ?? 0..1 Used when the value set is "expanded" -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <identifier value="[uri]"/><!-- ?? 0..1 Identifies the value set expansion (business identifier) -->
  <timestamp value="[dateTime]"/><!-- ?? 1..1 Time ValueSet expansion happened -->
  <total value="[integer]"/><!-- ?? 0..1 Total number of codes in the expansion -->
  <offset value="[integer]"/><!-- ?? 0..1 Offset at which this resource starts -->
  <parameter> ?? 0..* BackboneElement  <!-- ?? 0..* Parameter that controlled the expansion process -->
   <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
   <name value="[string]"/><!-- ?? 1..1 Name as assigned by the client or server -->
   <value[x]><!-- ?? 0..1 string|boolean|integer|
     decimal|uri|code|dateTime Value of the named parameter --></value[x]>
  </parameter>
  <property> ?? 0..* BackboneElement  <!-- ?? 0..* Additional information supplied about each concept -->
   <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
   <code value="[code]"/><!-- ?? 1..1 
       Identifies the property on the concepts, and when referred to in operations -->
   <uri value="[uri]"/><!-- ?? 0..1 Formal identifier for the property -->
  </property>
  <contains> ?? 0..* BackboneElement  <!-- ?? 0..* Codes in the value set -->
   <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
   <system value="[uri]"/><!-- ?? 0..1 System value for the code -->
   <abstract value="[boolean]"/><!-- ?? 0..1 If user cannot select this entry -->
   <inactive value="[boolean]"/><!-- ?? 0..1 If concept is inactive in the code system -->
   <version value="[string]"/><!-- ?? 0..1 Version in which this code/display is defined -->
   <code value="[code]"/><!-- ?? 0..1 Code - if blank, this is not a selectable code -->
   <display value="[string]"/><!-- ?? 0..1 User display for the concept -->
   <designation><!-- See http://hl7.org/fhir/StructureDefinition/ValueSet#ValueSet.compose.include.concept.designation  Additional representations for this item --></designation>
   <property> ?? 0..* BackboneElement  <!-- ?? 0..* Property value for the concept -->
    <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
    <code value="[code]"/><!-- ?? 1..1 Reference to ValueSet.expansion.property.code -->
    <value[x]><!-- ?? 1..1 code|Coding|string|
      integer|boolean|dateTime|decimal 
        Value of the property for this concept --></value[x]>
   </property>
   <contains><!-- See http://hl7.org/fhir/StructureDefinition/ValueSet#ValueSet.expansion.contains  Codes contained under this entry --></contains>
  </contains>
 </expansion>
 <scope> ?? 1..1 BackboneElement  <!-- ?? 1..1 Description of the semantic space the Value Set Expansion is intended to cover -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <focus value="[string]"/><!-- ?? 0..1 General focus of the Value Set as it relates to the intended semantic space -->
  <inclusionCriteria value="[string]"/><!-- ?? 0..1 
      Criteria describing which concepts or codes should be included and why -->
  <exclusionCriteria value="[string]"/><!-- ?? 0..1 
      Criteria describing which concepts or codes should be excluded and why -->
 </scope>
</ValueSet>

JSON Template

{ // VSDALignedValueSet
  // from Element: extension
    "meta" : { Meta }, // C?Metadata about the resource
    "implicitRules" : "<uri>", // C?A set of rules under which this content was created
    "language" : "<code>", // C?Language of the resource content
    "text" : { Narrative }, // C?Text summary of the resource, for human interpretation
    "contained" : [{ Resource }], //Contained, inline Resources
    "extension" : [ //  sliced by value:url  in the specified order, Open 
      { // Alternative titles // C?
        // from Element: extension
      },
      { // Reference to the current trusted source of the ValueSet resource (metadata and definition) // C?
        // from Element: extension
      },
      { // Reference to a trusted expansion // C?
        // from Element: extension
      },
      { // Where did this content come from // C?
        // from Element: extension
      },
      { // Descriptors and key terms for search // C?
        // from Element: extension
      },
      { // Indicates the state of development of the value set // C?
        // from Element: extension
      },
      { // Entity responsible for Value Set // C?
        // from Element: extension
      },
      { // Entity/entities that create and may modify the Value Set // C?
        // from Element: extension
      },
      { // An alternative computable expression of the value set content // C?
        // from Element: extension
      },
      { // Declares dependency on a particular supplment // C?
        // from Element: extension
      }
    ],
    "modifierExtension" : [{ Extension }], // C?Extensions that cannot be ignored
    "url" : "<uri>", // C? R! Canonical identifier for this value set, represented as a URI (globally unique)
    "identifier" : [{ Identifier }], // C?Additional identifier for the value set (business identifier)
    "version" : "<string>", // C? R! Business version of the value set
    "name" : "<string>", // C? R! Name for this value set (computer friendly)
    "title" : "<string>", // C?Name for this value set (human friendly)
    "status" : "<code>", // C? R! draft | active | retired | unknown 
    "experimental" : <boolean>, // C? R! For testing purposes, not real usage
    "date" : "<dateTime>", // C?Date last changed
    "publisher" : "<string>", // C?Name of the publisher (organization or individual)
    "contact" : [{ ContactDetail }], // C?Contact details for the publisher
    "description" : "<markdown>", // C?Natural language description of the value set
    "useContext" : [{ UsageContext }], // C?The context that the content is intended to support
    "jurisdiction" : [{ CodeableConcept }], // C?Intended jurisdiction for value set (if applicable)
    "immutable" : <boolean>, // C? R! Indicates whether or not any change to the content logical definition may occur
    "purpose" : "<markdown>", // C?Why this value set is defined
    "copyright" : "<markdown>", // C?Use and/or publishing restrictions
    "compose" : { BackboneElement }, // C?Content logical definition of the value set (CLD)
    "expansion" : { BackboneElement }, // C?Used when the value set is "expanded"
    "scope" : { BackboneElement }, // C? R! Description of the semantic space the Value Set Expansion is intended to cover
  }

 

Alternate definitions: Master Definition (XML, JSON), Schematron

PathNameConformanceValueSet
ValueSet.languageCommon LanguagespreferredCommon Languages
ValueSet.statusPublicationStatusrequiredPublicationStatus
ValueSet.jurisdictionJurisdictionextensibleJurisdiction
ValueSet.compose.include.concept.designation.languageCommon LanguagespreferredCommon Languages
ValueSet.compose.include.concept.designation.useDesignation UseextensibleDesignation Use
ValueSet.compose.include.filter.opFilterOperatorrequiredFilterOperator
RuleRuleRule
IdPathDetailsRequirements
vsd-2ValueSet.extensionEither title or extension-otherTitle must be valued
Expression : ValueSet.title.exists() or ValueSet.extension:valueset-other-title.exists()
vsd-1ValueSet.identifierIdentifier.system is restricted to OID, RUID, UUID, URI
Expression : identifier.exists(system in ('OID' or 'RUID' or 'UUID' or 'URI'))
vsd-2ValueSet.titleEither title or extension-otherTitle must be valued
Expression : ValueSet.title.exists() or ValueSet.extension:valueset-other-title.exists()
.