STU3 Candidate

This page is part of the FHIR Specification (v1.8.0: STU 3 Draft). 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

(No assigned work group) Maturity Level: 0Context: Any

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.

Summary

Mandatory: 7 elements

NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet I1..1A 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 (extensible)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional Content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url ∑1..1uriLogical uri to reference this value set (globally unique)
... identifier ∑0..*IdentifierAdditional identifier for the value set
... version ∑1..1stringBusiness version of the value set
... name ∑1..1stringName for this value set (Computer friendly)
... title ∑0..1stringName for this value set (Human friendly)
... status ?!∑1..1codedraft | active | retired
Binding: PublicationStatus (required)
... experimental ?!∑1..1booleanIf for testing purposes, not real usage
... publisher ∑1..1stringName of the publisher (Organization or individual)
... contact ∑0..*ContactDetailContact details for the publisher
... date ∑0..1dateTimeDate this was last changed
... description 1..1markdownNatural language description of the value set
... useContext ∑0..*UsageContextContent intends to support these contexts
... jurisdiction ∑0..*CodeableConceptIntended jurisdiction for value set (if applicable)
Binding: Jurisdiction ValueSet (extensible)
... immutable ∑0..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
... extensible ∑0..1booleanWhether this is intended to be used with an extensible binding
... compose I0..1BackboneElementDefinition of the content of the value set (CLD)
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... lockedDate ∑0..1dateFixed date for version-less references (transitive)
.... inactive ∑0..1booleanWhether inactive codes are in the value set
.... include ∑I1..*BackboneElementInclude one or more codes from a code system or other value set(s)
vsd-2: A value set with concepts or filters SHALL include a system
vsd-3: Cannot have both concept and filter
vsd-1: A value set include/exclude SHALL have a value set or a system
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
..... system ∑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..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
...... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
...... code 1..1codeCode or expression from system
...... display 0..1stringText to display for this code for this value set
...... designation I0..*BackboneElementAdditional representations for this concept
....... id 0..1stringxml:id (or equivalent in JSON)
....... extension 0..*ExtensionAdditional Content defined by implementations
....... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
....... language 0..1codeHuman language of the designation
Binding: Common Languages (extensible)
....... use 0..1CodingDetails how this designation would be used
Binding: Designation Use (extensible)
....... value 1..1stringThe text value for this designation
..... filter I0..*BackboneElementSelect codes/concepts by their properties (including relationships)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
...... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
...... property 1..1codeA property defined by the code system
...... op ?!1..1code= | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | exists
Binding: FilterOperator (required)
...... value 1..1codeCode from the system, or regex criteria
..... valueSet ∑I0..*uriSelect only contents included in this value set
.... exclude I0..*Unknown reference to #ValueSet:shareablevalueset.compose.include
Explicitly exclude codes from a code system or other value sets
... expansion I0..1BackboneElementUsed when the value set is "expanded"
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... identifier 1..1uriUniquely identifies this expansion
.... timestamp 1..1dateTimeTime ValueSet expansion happened
.... total 0..1integerTotal number of codes in the expansion
.... offset 0..1integerOffset at which this resource starts
.... parameter I0..*BackboneElementParameter that controlled the expansion process
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
..... name 1..1stringName as assigned by the server
..... value[x] 0..1string, boolean, integer, decimal, uri, codeValue of the named parameter
.... contains I0..*BackboneElementCodes in the value set
vsd-6: SHALL have a code or a display
vsd-9: Must have a code if not abstract
vsd-10: Must have a system if a code is present
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
..... 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..*Unknown reference to #ValueSet:shareablevalueset.compose.include.concept.designation
Additional representations for this item
..... contains 0..*Unknown reference to #ValueSet:shareablevalueset.expansion.contains
Codes contained under this entry

doco Documentation for this format

todo

This structure is derived from ValueSet.

Summary

Mandatory: 7 elements

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet I1..1A 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 (extensible)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional Content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url ∑1..1uriLogical uri to reference this value set (globally unique)
... identifier ∑0..*IdentifierAdditional identifier for the value set
... version ∑1..1stringBusiness version of the value set
... name ∑1..1stringName for this value set (Computer friendly)
... title ∑0..1stringName for this value set (Human friendly)
... status ?!∑1..1codedraft | active | retired
Binding: PublicationStatus (required)
... experimental ?!∑1..1booleanIf for testing purposes, not real usage
... publisher ∑1..1stringName of the publisher (Organization or individual)
... contact ∑0..*ContactDetailContact details for the publisher
... date ∑0..1dateTimeDate this was last changed
... description 1..1markdownNatural language description of the value set
... useContext ∑0..*UsageContextContent intends to support these contexts
... jurisdiction ∑0..*CodeableConceptIntended jurisdiction for value set (if applicable)
Binding: Jurisdiction ValueSet (extensible)
... immutable ∑0..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
... extensible ∑0..1booleanWhether this is intended to be used with an extensible binding
... compose I0..1BackboneElementDefinition of the content of the value set (CLD)
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... lockedDate ∑0..1dateFixed date for version-less references (transitive)
.... inactive ∑0..1booleanWhether inactive codes are in the value set
.... include ∑I1..*BackboneElementInclude one or more codes from a code system or other value set(s)
vsd-2: A value set with concepts or filters SHALL include a system
vsd-3: Cannot have both concept and filter
vsd-1: A value set include/exclude SHALL have a value set or a system
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
..... system ∑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..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
...... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
...... code 1..1codeCode or expression from system
...... display 0..1stringText to display for this code for this value set
...... designation I0..*BackboneElementAdditional representations for this concept
....... id 0..1stringxml:id (or equivalent in JSON)
....... extension 0..*ExtensionAdditional Content defined by implementations
....... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
....... language 0..1codeHuman language of the designation
Binding: Common Languages (extensible)
....... use 0..1CodingDetails how this designation would be used
Binding: Designation Use (extensible)
....... value 1..1stringThe text value for this designation
..... filter I0..*BackboneElementSelect codes/concepts by their properties (including relationships)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
...... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
...... property 1..1codeA property defined by the code system
...... op ?!1..1code= | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | exists
Binding: FilterOperator (required)
...... value 1..1codeCode from the system, or regex criteria
..... valueSet ∑I0..*uriSelect only contents included in this value set
.... exclude I0..*Unknown reference to #ValueSet:shareablevalueset.compose.include
Explicitly exclude codes from a code system or other value sets
... expansion I0..1BackboneElementUsed when the value set is "expanded"
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... identifier 1..1uriUniquely identifies this expansion
.... timestamp 1..1dateTimeTime ValueSet expansion happened
.... total 0..1integerTotal number of codes in the expansion
.... offset 0..1integerOffset at which this resource starts
.... parameter I0..*BackboneElementParameter that controlled the expansion process
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
..... name 1..1stringName as assigned by the server
..... value[x] 0..1string, boolean, integer, decimal, uri, codeValue of the named parameter
.... contains I0..*BackboneElementCodes in the value set
vsd-6: SHALL have a code or a display
vsd-9: Must have a code if not abstract
vsd-10: Must have a system if a code is present
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
..... 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..*Unknown reference to #ValueSet:shareablevalueset.compose.include.concept.designation
Additional representations for this item
..... contains 0..*Unknown reference to #ValueSet:shareablevalueset.expansion.contains
Codes contained under this entry

doco Documentation for this format

XML Template

JSON Template

todo

 

Other representations of profile: Schematron

PathNameConformanceValueSet
ValueSet.languageCommon LanguagesextensibleCommon Languages
ValueSet.statusPublicationStatusrequiredPublicationStatus
ValueSet.jurisdictionJurisdiction ValueSetextensibleJurisdiction ValueSet
ValueSet.compose.include.concept.designation.languageCommon LanguagesextensibleCommon Languages
ValueSet.compose.include.concept.designation.useDesignation UseextensibleDesignation Use
ValueSet.compose.include.filter.opFilterOperatorrequiredFilterOperator
IdPathDetailsRequirements
vsd-2ValueSet.compose.includeA value set with concepts or filters SHALL include a system
XPath: not(exists(f:concept) or exists(f:filter)) or exists(f:system)
vsd-3ValueSet.compose.includeCannot have both concept and filter
XPath: not(exists(f:concept)) or not(exists(f:filter))
vsd-1ValueSet.compose.includeA value set include/exclude SHALL have a value set or a system
XPath: exists(f:valueSet) or exists(f:system)
vsd-6ValueSet.expansion.containsSHALL have a code or a display
XPath: exists(f:code) or exists(f:display)
vsd-9ValueSet.expansion.containsMust have a code if not abstract
XPath: exists(f:code) or (f:abstract/@value = true())
vsd-10ValueSet.expansion.containsMust have a system if a code is present
XPath: exists(f:system) or not(exists(f:code))
.