R6 Ballot (1st Draft)

This page is part of the FHIR Specification v6.0.0-ballot1: Release 6 Ballot (1st Draft) (see Ballot Notes). The current version is 5.0.0. For a full list of available versions, see the Directory of published versions

4.9.20.17 StructureDefinition: ExecutableValueSet

Terminology Infrastructure icon Work Group Maturity Level: 0Trial Use Use Context: Any

The canonical URL for this profile is: 

http://hl7.org/fhir/StructureDefinition/executablevalueset

Defines an executable value set as one that SHALL have an expansion included, as well as a usage warning indicating the expansion is a point-in-time snapshot and must be maintained over time for production usage. The value set expansion specifies the timestamp when the expansion was produced, SHOULD contain the parameters used for the expansion, and SHALL contain the codes that are obtained by evaluating the value set definition. If this is ONLY an executable value set, a computable definition of the value set must be obtained to compute the updated expansion.

Note to Implementers: All of the shareable, publishable, computable, and executable profiles will be migrating to the new Canonical Resource Management icon implementation guide as part of the next FHIR release. Implementers are encouraged to look there for updates, corrections and clarifications.

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

4.9.20.17.1 Formal Views of Profile Content

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

This structure is derived from ShareableValueSet.

Summary

mustSupport

When this profile has defined an element as mustSupport, the sender must provide the element value when available, and the receiver must accept the element value, persist the value and when appropriate, provide function as defined in the profile. When mustSupport is defined at a complex element level, all sub-elements inherit mustSupport.

Mandatory: 4 elements (+1 nested mandatory element)
Must-Support: 19 elements
Fixed Value: 1 element

Extensions

This structure refers to these extensions:

This indicates the differences between this profile and the base ShareableValueSet structure.

NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet 1..1ShareableValueSetA set of codes drawn from one or more code systems
... Slices for extension 1..*ExtensionExtension
Slice: Unordered, Open by value:url
... usageWarning S1..1markdownExtra warning about the correct use of the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-warning
.... value[x] S1..1markdownValue of extension
Fixed Value: This value set contains a point-in-time expansion enumerating the codes that meet the value set intent. As new versions of the code systems used by the value set are released, the contents of this expansion will need to be updated to incorporate newly defined codes that meet the value set intent. Before, and periodically during production use, the value set expansion contents SHOULD be updated.
... expansion SC icon1..1BackboneElementUsed when the value set is "expanded"
evs-1: For contains, a version SHALL be provided unless the parameters element has a "system-version" parameter corresponding to the system of the entry and the version matches the system-version parameter.
.... identifier S0..1uriIdentifies the value set expansion (business identifier)
.... timestamp S1..1dateTimeTime ValueSet expansion happened
.... total S0..1integerTotal number of codes in the expansion
.... offset S0..1integerOffset at which this resource starts
.... parameter S0..*BackboneElementParameter that controlled the expansion process
.... contains S0..*BackboneElementCodes in the value set
..... system S0..1uriSystem value for the code
..... abstract S0..1booleanIf user cannot select this entry
..... inactive S0..1booleanIf concept is inactive in the code system
..... version SC icon0..1stringVersion in which this code/display is defined
..... code S1..1codeCode - if blank, this is not a selectable code
..... display S0..1stringUser display for the concept
..... property S0..*BackboneElementProperty value for the concept
...... code S1..1codeReference to ValueSet.expansion.property.code
...... value[x] S1..1code, Coding, string, integer, boolean, dateTime, decimalValue of the property for this concept
..... contains S0..*Codes contained under this entry

doco Documentation for this format icon

This provides the consolidated view (aka snapshot) of the profile after applying the changes in this profile to the base ShareableValueSet structure.

NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet C icon1..1ShareableValueSetA 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: All Languages (required): IETF language tag for a human language

Additional BindingsPurpose
Common LanguagesStarter Set
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 1..*ExtensionExtension
Slice: Unordered, Open by value:url
... knowledgeRepresentationLevel S0..*codenarrative | semi-structured | structured | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeRepresentationLevel
Binding: Knowledge Representation Level (required)
... authoritativeSource S0..1uriReference to the current trusted source of the ValueSet resource (metadata and definition)
URL: http://hl7.org/fhir/StructureDefinition/valueset-authoritativeSource
... usageWarning S1..1markdownExtra warning about the correct use of the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-warning
.... id 0..1idUnique id for inter-element referencing
.... extension 0..0
.... url 1..1uri"http://hl7.org/fhir/StructureDefinition/valueset-warning"
.... value[x] S1..1markdownValue of extension
Fixed Value: This value set contains a point-in-time expansion enumerating the codes that meet the value set intent. As new versions of the code systems used by the value set are released, the contents of this expansion will need to be updated to incorporate newly defined codes that meet the value set intent. Before, and periodically during production use, the value set expansion contents SHOULD be updated.
... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
... url SΣC icon1..1uriCanonical identifier for this value set, represented as a URI (globally unique)
... identifier Σ0..*IdentifierAdditional identifier for the value set (business identifier)
... version SΣ1..1stringBusiness version of the value set
... versionAlgorithm[x] SΣ0..1How to compare versions
Binding: Version Algorithm (extensible)
.... versionAlgorithmStringstring
.... versionAlgorithmCodingCoding
... name SΣC icon0..1stringName for this value set (computer friendly)
... title SΣ1..1stringName for this value set (human friendly)
... status ?!SΣ1..1codedraft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental SΣ1..1booleanFor testing purposes, not real usage
... date Σ0..1dateTimeDate last changed
... publisher SΣ0..1stringName of the publisher/steward (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... description S1..1markdownNatural language description of the value set
... useContext Σ0..*UsageContextThe context that the content is intended to support
... jurisdiction Σ0..*CodeableConceptIntended jurisdiction for value set (if applicable)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.


... 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
... copyrightLabel 0..1stringCopyright holder and year(s)
... approvalDate 0..1dateWhen the ValueSet was approved by publisher
... lastReviewDate 0..1dateWhen the ValueSet was last reviewed by the publisher
... effectivePeriod Σ0..1PeriodWhen the ValueSet is expected to be used
... topic 0..*CodeableConceptE.g. Education, Treatment, Assessment, etc
Binding: Definition Topic (example)
... author 0..*ContactDetailWho authored the ValueSet
... editor 0..*ContactDetailWho edited the ValueSet
... reviewer 0..*ContactDetailWho reviewed the ValueSet
... endorser 0..*ContactDetailWho endorsed the ValueSet
... relatedArtifact 0..*RelatedArtifactAdditional documentation, citations, etc
... compose 0..1BackboneElementContent logical definition of the value set (CLD)
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... lockedDate Σ0..1dateFixed date for references with no specified version (transitive)
.... inactive Σ0..1booleanWhether inactive codes are in the value set
.... include ΣC icon1..*BackboneElementInclude one or more codes from a code system or other value set(s)
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... system ΣC icon0..1uriThe system the codes come from
..... version Σ0..1stringSpecific version of the code system referred to
..... concept C icon0..*BackboneElementA concept defined in the system
...... id 0..1stringUnique 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 C icon0..*BackboneElementAdditional representations for this concept
....... id 0..1stringUnique 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: All Languages (required): IETF language tag for a human language

Additional BindingsPurpose
Common LanguagesStarter Set
....... use C icon0..1CodingTypes of uses of designations
Binding: Designation Use (extensible): Details of how a designation would be used.

....... additionalUse C icon0..*CodingAdditional ways how this designation would be used
Binding: Designation Use (extensible): Details of how a designation would be used.


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

...... value Σ1..1stringCode from the system, or regex criteria, or boolean value for exists
..... valueSet ΣC icon0..*canonical(ValueSet)Select the contents included in this value set
..... copyright 0..1stringA copyright statement for the specific code system included in the value set
.... exclude 0..*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 SC icon1..1BackboneElementUsed when the value set is "expanded"
evs-1: For contains, a version SHALL be provided unless the parameters element has a "system-version" parameter corresponding to the system of the entry and the version matches the system-version parameter.
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... identifier S0..1uriIdentifies the value set expansion (business identifier)
.... next 0..1uriOpaque urls for paging through expansion results
.... timestamp S1..1dateTimeTime ValueSet expansion happened
.... total S0..1integerTotal number of codes in the expansion
.... offset S0..1integerOffset at which this resource starts
.... parameter S0..*BackboneElementParameter that controlled the expansion process
..... id 0..1stringUnique 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