DSTU2 QA Preview
This page is part of the FHIR Specification (v1.0.0: DSTU 2 Ballot 3). 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: R5 R4B R4 R3 R2
The official URL for this profile is:
http://hl7.org/fhir/StructureDefinition/shareablevalueset
Enforces the minimum information set for the value set metadata required by HL7 and other organisations that share and publish value sets
This profile was published on [no date] as a draft by HL7.
Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.
This structure is derived from ValueSet.
This structure is derived from ValueSet.
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
  ValueSet | 1..1 | ValueSet | ||
  url | 1..1 | uri | ||
| version | 1..1 | string | ||
| name | 1..1 | string | ||
| status | 1..1 | code | ||
| experimental | 1..1 | boolean | ||
| publisher | 1..1 | string | ||
| description | 1..1 | string | ||
| immutable | 0..1 | boolean | ||
  codeSystem | 0..1 | BackboneElement | ||
 system | 1..1 | uri | ||
| version | 0..1 | string | ||
| caseSensitive | 1..1 | boolean | ||
| concept | 0..* | BackboneElement | ||
| code | 1..1 | code | ||
| abstract | 0..1 | boolean | ||
| display | 1..1 | string | ||
| definition | 1..1 | string | ||
| concept | 0..* | |||
| Documentation for this format | ||||
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| ValueSet | I | 1..1 | ValueSet | A set of codes drawn from one or more code systems vsd-7: A defined code system (if present) SHALL have a different identifier to the value set itself vsd-5: Value set SHALL contain at least one of a codeSystem, a compose, or an expansion element vsd-2: A value set with only one import SHALL also have an include and/or an exclude unless the value set includes and inline code system |
| meta | ∑ | 0..1 | Meta | Metadata about the resource |
| implicitRules | ?! ∑ | 0..1 | uri | A set of rules under which this content was created |
| language | 0..1 | code | Language of the resource content Binding: IETF BCP-47 (required) | |
| text | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
| contained | 0..* | Resource | Contained, inline Resources | |
 extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| url | ∑ | 1..1 | uri | Globally unique logical id for value set |
 identifier | ∑ | 0..1 | Identifier | Additional identifier for the value set (v2 / CDA) |
| version | ∑ | 1..1 | string | Logical id for this version of the value set |
| name | ∑ | 1..1 | string | Informal name for this value set |
| status | ?! ∑ | 1..1 | code | draft | active | retired Binding: ConformanceResourceStatus (required) |
| experimental | ∑ | 1..1 | boolean | If for testing purposes, not real usage |
| publisher | ∑ | 1..1 | string | Name of the publisher (Organization or individual) |
| contact | ∑ | 0..* | BackboneElement | Contact details of the publisher |
 extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| name | ∑ | 0..1 | string | Name of a individual to contact |
| telecom | ∑ | 0..* | ContactPoint | Contact details for individual or publisher |
| date | ∑ | 0..1 | dateTime | Date for given status |
| lockedDate | ∑ | 0..1 | date | Fixed date for all referenced code systems and value sets |
| description | ∑ | 1..1 | string | Human language description of the value set |
| useContext | ∑ | 0..* | CodeableConcept | Content intends to support these contexts Binding: Context of Use ValueSet (extensible) |
| immutable | ∑ | 0..1 | boolean | Indicates whether or not any change to the content logical definition may occur |
| requirements | 0..1 | string | Why is this needed? | |
| copyright | 0..1 | string | Use and/or Publishing restrictions | |
| extensible | ∑ | 0..1 | boolean | Whether this is intended to be used with an extensible binding |
| codeSystem | ∑ I | 0..1 | BackboneElement | An inline code system - part of this value set vsd-8: Codes must be unique vsd-3: Within a code system definition, all the codes SHALL be unique |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| system | ∑ | 1..1 | uri | URI to identify the code system (e.g. in Coding.system) |
| version | ∑ | 0..1 | string | Version (for use in Coding.version) |
| caseSensitive | ∑ | 1..1 | boolean | If code comparison is case sensitive |
| concept | 0..* | BackboneElement | Concepts in the code system | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| code | 1..1 | code | Code that identifies concept | |
| abstract | 0..1 | boolean | If this code is not for use as a real concept | |
| display | 1..1 | string | Text to Display to the user | |
| definition | 1..1 | string | Formal Definition | |
| designation | 0..* | BackboneElement | Additional representations for the concept | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| language | 0..1 | code | Human language of the designation Binding: IETF BCP-47 (required) | |
| use | 0..1 | Coding | Details how this designation would be used Binding: Designation Use (extensible) | |
| value | 1..1 | string | The text value for this designation | |
| concept | 0..* | Child Concepts (is-a / contains / categorises) | ||
| compose | I | 0..1 | BackboneElement | When value set includes codes from elsewhere vsd-1: A value set composition SHALL have an include or an import |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| import | ∑ I | 0..* | uri | Import the contents of another value set |
| include | ∑ I | 0..* | BackboneElement | Include one or more codes from a code system vsd-11: Cannot have both concept and filter |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| system | ∑ | 1..1 | uri | The system the codes come from |
| version | ∑ | 0..1 | string | Specific version of the code system referred to |
| concept | I | 0..* | BackboneElement | A concept defined in the system |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| code | 1..1 | code | Code or expression from system | |
| display | 0..1 | string | Test to display for this code for this value set | |
| designation | 0..* | Additional representations for this valueset | ||
| filter | I | 0..* | BackboneElement | Select codes/concepts by their properties (including relationships) |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| property | 1..1 | code | A property defined by the code system | |
| op | 1..1 | code | = | is-a | is-not-a | regex | in | not-in Binding: FilterOperator (required) | |
| value | 1..1 | code | Code from the system, or regex criteria | |
| exclude | I | 0..* | Explicitly exclude codes | |
| expansion | I | 0..1 | BackboneElement | Used when the value set is "expanded" |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| identifier | 1..1 | uri | Uniquely identifies this expansion | |
| timestamp | 1..1 | dateTime | Time valueset expansion happened | |
| total | 0..1 | integer | Total number of codes in the expansion | |
| offset | 0..1 | integer | Offset at which this resource starts | |
| parameter | 0..* | BackboneElement | Parameter that controlled the expansion process | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| name | 1..1 | string | Name as assigned by server | |
 value[x] | 0..1 | string, boolean, integer, decimal, uri, code | Value of the named parameter | |
| contains | I | 0..* | BackboneElement | Codes in the value set vsd-9: Must have a code if not abstract vsd-6: SHALL have a code or a display vsd-10: Must have a system if a code is present |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| system | 0..1 | uri | System value for the code | |
| abstract | 0..1 | boolean | If user cannot select this entry | |
| version | 0..1 | string | Version in which this code / display is defined | |
| code | I | 0..1 | code | Code - if blank, this is not a choosable code |
| display | I | 0..1 | string | User display for the concept |
| contains | 0..* | Codes contained under this entry | ||
| Documentation for this format | ||||
todo
This structure is derived from ValueSet.
Differential View
This structure is derived from ValueSet.
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| ValueSet | 1..1 | ValueSet | ||
| url | 1..1 | uri | ||
| version | 1..1 | string | ||
| name | 1..1 | string | ||
| status | 1..1 | code | ||
| experimental | 1..1 | boolean | ||
| publisher | 1..1 | string | ||
| description | 1..1 | string | ||
| immutable | 0..1 | boolean | ||
| codeSystem | 0..1 | BackboneElement | ||
| system | 1..1 | uri | ||
| version | 0..1 | string | ||
| caseSensitive | 1..1 | boolean | ||
| concept | 0..* | BackboneElement | ||
| code | 1..1 | code | ||
| abstract | 0..1 | boolean | ||
| display | 1..1 | string | ||
| definition | 1..1 | string | ||
| concept | 0..* | |||
| Documentation for this format | ||||
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| ValueSet | I | 1..1 | ValueSet | A set of codes drawn from one or more code systems vsd-7: A defined code system (if present) SHALL have a different identifier to the value set itself vsd-5: Value set SHALL contain at least one of a codeSystem, a compose, or an expansion element vsd-2: A value set with only one import SHALL also have an include and/or an exclude unless the value set includes and inline code system |
| meta | ∑ | 0..1 | Meta | Metadata about the resource |
| implicitRules | ?! ∑ | 0..1 | uri | A set of rules under which this content was created |
| language | 0..1 | code | Language of the resource content Binding: IETF BCP-47 (required) | |
| text | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
| contained | 0..* | Resource | Contained, inline Resources | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| url | ∑ | 1..1 | uri | Globally unique logical id for value set |
| identifier | ∑ | 0..1 | Identifier | Additional identifier for the value set (v2 / CDA) |
| version | ∑ | 1..1 | string | Logical id for this version of the value set |
| name | ∑ | 1..1 | string | Informal name for this value set |
| status | ?! ∑ | 1..1 | code | draft | active | retired Binding: ConformanceResourceStatus (required) |
| experimental | ∑ | 1..1 | boolean | If for testing purposes, not real usage |
| publisher | ∑ | 1..1 | string | Name of the publisher (Organization or individual) |
| contact | ∑ | 0..* | BackboneElement | Contact details of the publisher |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| name | ∑ | 0..1 | string | Name of a individual to contact |
| telecom | ∑ | 0..* | ContactPoint | Contact details for individual or publisher |
| date | ∑ | 0..1 | dateTime | Date for given status |
| lockedDate | ∑ | 0..1 | date | Fixed date for all referenced code systems and value sets |
| description | ∑ | 1..1 | string | Human language description of the value set |
| useContext | ∑ | 0..* | CodeableConcept | Content intends to support these contexts Binding: Context of Use ValueSet (extensible) |
| immutable | ∑ | 0..1 | boolean | Indicates whether or not any change to the content logical definition may occur |
| requirements | 0..1 | string | Why is this needed? | |
| copyright | 0..1 | string | Use and/or Publishing restrictions | |
| extensible | ∑ | 0..1 | boolean | Whether this is intended to be used with an extensible binding |
| codeSystem | ∑ I | 0..1 | BackboneElement | An inline code system - part of this value set vsd-8: Codes must be unique vsd-3: Within a code system definition, all the codes SHALL be unique |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| system | ∑ | 1..1 | uri | URI to identify the code system (e.g. in Coding.system) |
| version | ∑ | 0..1 | string | Version (for use in Coding.version) |
| caseSensitive | ∑ | 1..1 | boolean | If code comparison is case sensitive |
| concept | 0..* | BackboneElement | Concepts in the code system | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| code | 1..1 | code | Code that identifies concept | |
| abstract | 0..1 | boolean | If this code is not for use as a real concept | |
| display | 1..1 | string | Text to Display to the user | |
| definition | 1..1 | string | Formal Definition | |
| designation | 0..* | BackboneElement | Additional representations for the concept | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| language | 0..1 | code | Human language of the designation Binding: IETF BCP-47 (required) | |
| use | 0..1 | Coding | Details how this designation would be used Binding: Designation Use (extensible) | |
| value | 1..1 | string | The text value for this designation | |
| concept | 0..* | Child Concepts (is-a / contains / categorises) | ||
| compose | I | 0..1 | BackboneElement | When value set includes codes from elsewhere vsd-1: A value set composition SHALL have an include or an import |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| import | ∑ I | 0..* | uri | Import the contents of another value set |
| include | ∑ I | 0..* | BackboneElement | Include one or more codes from a code system vsd-11: Cannot have both concept and filter |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| system | ∑ | 1..1 | uri | The system the codes come from |
| version | ∑ | 0..1 | string | Specific version of the code system referred to |
| concept | I | 0..* | BackboneElement | A concept defined in the system |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| code | 1..1 | code | Code or expression from system | |
| display | 0..1 | string | Test to display for this code for this value set | |
| designation | 0..* | Additional representations for this valueset | ||
| filter | I | 0..* | BackboneElement | Select codes/concepts by their properties (including relationships) |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| property | 1..1 | code | A property defined by the code system | |
| op | 1..1 | code | = | is-a | is-not-a | regex | in | not-in Binding: FilterOperator (required) | |
| value | 1..1 | code | Code from the system, or regex criteria | |
| exclude | I | 0..* | Explicitly exclude codes | |
| expansion | I | 0..1 | BackboneElement | Used when the value set is "expanded" |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| identifier | 1..1 | uri | Uniquely identifies this expansion | |
| timestamp | 1..1 | dateTime | Time valueset expansion happened | |
| total | 0..1 | integer | Total number of codes in the expansion | |
| offset | 0..1 | integer | Offset at which this resource starts | |
| parameter | 0..* | BackboneElement | Parameter that controlled the expansion process | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| name | 1..1 | string | Name as assigned by server | |
| value[x] | 0..1 | string, boolean, integer, decimal, uri, code | Value of the named parameter | |
| contains | I | 0..* | BackboneElement | Codes in the value set vsd-9: Must have a code if not abstract vsd-6: SHALL have a code or a display vsd-10: Must have a system if a code is present |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
| system | 0..1 | uri | System value for the code | |
| abstract | 0..1 | boolean | If user cannot select this entry | |
| version | 0..1 | string | Version in which this code / display is defined | |
| code | I | 0..1 | code | Code - if blank, this is not a choosable code |
| display | I | 0..1 | string | User display for the concept |
| contains | 0..* | Codes contained under this entry | ||
| Documentation for this format | ||||
XML Template
JSON Template
todo
Other representations of profile: Schematron
| Path | Name | Conformance | ValueSet |
| ValueSet.language | ?ext | required | http://tools.ietf.org/html/bcp47 |
| ValueSet.status | ConformanceResourceStatus | required | ConformanceResourceStatus |
| ValueSet.useContext | Context of Use ValueSet | extensible | Context of Use ValueSet |
| ValueSet.codeSystem.concept.designation.language | ?ext | required | http://tools.ietf.org/html/bcp47 |
| ValueSet.codeSystem.concept.designation.use | Designation Use | extensible | Designation Use |
| ValueSet.compose.include.filter.op | FilterOperator | required | FilterOperator |
| Id | Path | Details | Requirements |
| vsd-7 | ValueSet | A defined code system (if present) SHALL have a different identifier to the value set itself XPath: not(f:codeSystem/f:system/@value = f:identifier/@value) | |
| vsd-5 | ValueSet | Value set SHALL contain at least one of a codeSystem, a compose, or an expansion element XPath: exists(f:codeSystem) or exists(f:compose) or exists(f:expansion) | |
| vsd-2 | ValueSet | A value set with only one import SHALL also have an include and/or an exclude unless the value set includes and inline code system XPath: not(exists(f:compose)) or (count(f:compose/f:import)!=1 or exists(f:compose/f:include) or exists(f:compose/f:exclude) or exists(f:codeSystem)) | |
| vsd-8 | ValueSet.codeSystem | Codes must be unique XPath: count(descendant::f:concept)=count(distinct-values(descendant::f:concept/f:code/@value)) | |
| vsd-3 | ValueSet.codeSystem | Within a code system definition, all the codes SHALL be unique XPath: count(distinct-values(descendant::f:concept/f:code/@value))=count(descendant::f:concept) | |
| vsd-1 | ValueSet.compose | A value set composition SHALL have an include or an import XPath: exists(f:include) or exists(f:import) | |
| vsd-11 | ValueSet.compose.include | Cannot have both concept and filter XPath: not(exists(f:concept)) or not(exists(f:filter)) | |
| vsd-9 | ValueSet.expansion.contains | Must have a code if not abstract XPath: exists(f:code) or (f:abstract/@value = 'true') | |
| vsd-6 | ValueSet.expansion.contains | SHALL have a code or a display XPath: exists(f:code) or exists(f:display) | |
| vsd-10 | ValueSet.expansion.contains | Must have a system if a code is present XPath: exists(f:system) or not(exists(f:code)) |
© HL7.org 2011+. FHIR DSTU2 (v1.0.0-6850) generated on Tue, Sep 1, 2015 14:40+1000.
Links: What's a DSTU? |
Version History |
Table of Contents |
Compare to DSTU1 |
|
Propose a change