HL7 FHIR® Implementation Guide: Electronic Case Reporting (eCR) - US Realm
2.1.1 - STU 2.1.1 United States of America flag

This page is part of the electronic Case Reporting (eCR) (v2.1.1: STU 2) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in it's permanent location. For a full list of available versions, see the Directory of published versions

Resource Profile: US Public Health Computable ValueSet

Official URL: http://hl7.org/fhir/us/ecr/StructureDefinition/us-ph-computable-valueset Version: 2.1.1
Active as of 2020-10-26 Computable Name: USPublicHealthComputableValueSet

Defines a computable value set as one that SHALL have an expression-based definition (i.e. a value set defined intensionally using expressions of the code systems involved) and MAY have an expansion included. The expression-based definition SHALL be represented in only one of three ways; using the compose element, using the expression extension, or using the rules-text extension to provide a step-by-step process for expanding the value set definition

Usage:

Formal Views of Profile Content

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

This structure is derived from USPublicHealthValueSet

NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet C1..1USPublicHealthValueSetUS Public Health Computable ValueSet
cvs-1: Only one of rulesText, expression, or a compose definition SHALL be provided
... rulesText SC0..1markdownHuman instructions for constructing the valueset
URL: http://hl7.org/fhir/StructureDefinition/valueset-rules-text
... expression SC0..1ExpressionMachine instructions for constructing the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-expression
... compose SC0..1BackboneElementContent logical definition of the value set (CLD)

doco Documentation for this format

Constraints

IdGradePath(s)DetailsRequirements
cvs-1errorValueSetOnly one of rulesText, expression, or a compose definition SHALL be provided
: extension('http://hl7.org/fhir/StructureDefinition/valueset-rules-text').exists() xor extension('http://hl7.org/fhir/StructureDefinition/valueset-expression').exists() xor compose.exists()
NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet C1..1USPublicHealthValueSetUS Public Health Computable ValueSet
cvs-1: Only one of rulesText, expression, or a compose definition SHALL be provided
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension 2..*ExtensionExtension
Slice: Unordered, Open by value:url
... extensionValueSetSteward S1..1ContactDetailValue set steward
URL: http://hl7.org/fhir/StructureDefinition/valueset-steward
... rulesText SC0..1markdownHuman instructions for constructing the valueset
URL: http://hl7.org/fhir/StructureDefinition/valueset-rules-text
... expression SC0..1ExpressionMachine instructions for constructing the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-expression
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url Σ1..1uriCanonical identifier for this value set, represented as a URI (globally unique)
... identifier SΣ0..*IdentifierValue set identifier used by public health (e.g. RCTC OID)
... version Σ1..1stringBusiness version of the value set
... name SΣC1..1stringValue set name
... title SΣ1..1stringValue set title
... status ?!SΣ1..1codeValue set definition version
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental Σ1..1booleanFor testing purposes, not real usage
... publisher SΣ1..1stringThe entity that is responsible for the content of the Value Set Definition
... description S1..1markdownValue set description
... Slices for useContext Σ1..*UsageContextThe context that the content is intended to support
Slice: Unordered, Open by pattern:code
.... useContext:priorityContext Σ1..1UsageContextThe context that the content is intended to support
..... code Σ1..1CodingType of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.


Required Pattern: At least the following
...... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/us/ecr/CodeSystem/us-ph-usage-context-type
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: priority
..... value[x] Σ1..1CodeableConceptRelease priority of the ValueSet
Binding: US Public Health ValueSet Priority (required): US PH ValueSet Release Priority Codes.

.... useContext:focusConditionContext SΣ0..*UsageContextThe context that the content is intended to support
..... code Σ1..1CodingType of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.


Required Pattern: At least the following
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/usage-context-type
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: focus
..... value[x] Σ1..1CodeableConceptClinical condition that is the focus of the codes in this value set
Binding: Condition/Problem/DiagnosisCodes (example): Condition/Problem/Diagnosis Codes.

... compose SC0..1BackboneElementContent logical definition of the value set (CLD)
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... include ΣC1..*BackboneElementInclude one or more codes from a code system or other value set(s)
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... system ΣC0..1uriThe system the codes come from

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
ValueSet.statusrequiredPublicationStatus
ValueSet.useContext:priorityContext.codeextensiblePattern: priority
ValueSet.useContext:priorityContext.value[x]requiredUSPublicHealthValueSetPriority
ValueSet.useContext:focusConditionContext.codeextensiblePattern: focus
ValueSet.useContext:focusConditionContext.value[x]exampleCondition/Problem/DiagnosisCodes

Constraints

IdGradePath(s)DetailsRequirements
cvs-1errorValueSetOnly one of rulesText, expression, or a compose definition SHALL be provided
: extension('http://hl7.org/fhir/StructureDefinition/valueset-rules-text').exists() xor extension('http://hl7.org/fhir/StructureDefinition/valueset-expression').exists() xor compose.exists()
dom-2errorValueSetIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorValueSetIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorValueSetIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorValueSetIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceValueSetA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
vsd-0warningValueSetName should be usable as an identifier for the module by machine processing applications such as code generation
: name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
vsd-1errorValueSet.compose.includeA value set include/exclude SHALL have a value set or a system
: valueSet.exists() or system.exists()
vsd-2errorValueSet.compose.includeA value set with concepts or filters SHALL include a system
: (concept.exists() or filter.exists()) implies system.exists()
vsd-3errorValueSet.compose.includeCannot have both concept and filter
: concept.empty() or filter.empty()
NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet C1..1USPublicHealthValueSetUS Public Health Computable ValueSet
cvs-1: Only one of rulesText, expression, or a compose definition SHALL be provided
... 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: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 2..*ExtensionExtension
Slice: Unordered, Open by value:url
... extensionValueSetSteward S1..1ContactDetailValue set steward
URL: http://hl7.org/fhir/StructureDefinition/valueset-steward
... extensionValueSetAuthor S1..1ContactDetailValue set author
URL: http://hl7.org/fhir/StructureDefinition/valueset-author
... rulesText SC0..1markdownHuman instructions for constructing the valueset
URL: http://hl7.org/fhir/StructureDefinition/valueset-rules-text
... expression SC0..1ExpressionMachine instructions for constructing the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-expression
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url Σ1..1uriCanonical identifier for this value set, represented as a URI (globally unique)
... identifier SΣ0..*IdentifierValue set identifier used by public health (e.g. RCTC OID)
... version Σ1..1stringBusiness version of the value set
... name SΣC1..1stringValue set name
... title SΣ1..1stringValue set title
... status ?!SΣ1..1codeValue set definition version
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental Σ1..1booleanFor testing purposes, not real usage
... date Σ0..1dateTimeDate last changed
... publisher SΣ1..1stringThe entity that is responsible for the content of the Value Set Definition
... contact Σ0..*ContactDetailContact details for the publisher
... description S1..1markdownValue set description
... Slices for useContext Σ1..*UsageContextThe context that the content is intended to support
Slice: Unordered, Open by pattern:code
.... useContext:priorityContext Σ1..1UsageContextThe context that the content is intended to support
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... code Σ1..1CodingType of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.


Required Pattern: At least the following
...... id0..1stringUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/us/ecr/CodeSystem/us-ph-usage-context-type
...... version0..1stringVersion of the system - if relevant
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: priority
...... display0..1stringRepresentation defined by the system
...... userSelected0..1booleanIf this coding was chosen directly by the user
..... value[x] Σ1..1CodeableConceptRelease priority of the ValueSet
Binding: US Public Health ValueSet Priority (required): US PH ValueSet Release Priority Codes.

.... useContext:focusConditionContext SΣ0..*UsageContextThe context that the content is intended to support
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... code Σ1..1CodingType of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.


Required Pattern: At least the following
...... id0..1stringUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/usage-context-type
...... version0..1stringVersion of the system - if relevant
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: focus
...... display0..1stringRepresentation defined by the system
...... userSelected0..1booleanIf this coding was chosen directly by the user
..... value[x] Σ1..1CodeableConceptClinical condition that is the focus of the codes in this value set
Binding: Condition/Problem/DiagnosisCodes (example): Condition/Problem/Diagnosis Codes.

... 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
... compose SC0..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 ΣC1..*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 ΣC0..1uriThe system the codes come from
..... version Σ0..1stringSpecific version of the code system referred to
..... concept C0..*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 0..*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: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
....... use 0..1CodingTypes of uses of designations
Binding: DesignationUse (extensible): Details of how a designation would be used.

....... value 1..1stringThe text value for this designation
..... filter ΣC0..*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 | exists
Binding: FilterOperator (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 ΣC0..*canonical(ValueSet)Select the contents included in this value set
.... exclude C0..*See include (ValueSet)Explicitly exclude codes from a code system or other value sets
... expansion 0..1BackboneElementUsed when the value set is "expanded"
.... 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 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..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
...... valueUriuri
...... valueCodecode
...... valueDateTimedateTime
.... contains C0..*BackboneElementCodes in the value set
..... 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 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 C0..1codeCode - if blank, this is not a selectable code
..... display C0..1stringUser display for the concept
..... designation 0..*See designation (ValueSet)Additional representations for this item
..... contains 0..*See contains (ValueSet)Codes contained under this entry

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
ValueSet.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
ValueSet.statusrequiredPublicationStatus
ValueSet.useContext:priorityContext.codeextensiblePattern: priority
ValueSet.useContext:priorityContext.value[x]requiredUSPublicHealthValueSetPriority
ValueSet.useContext:focusConditionContext.codeextensiblePattern: focus
ValueSet.useContext:focusConditionContext.value[x]exampleCondition/Problem/DiagnosisCodes
ValueSet.jurisdictionextensibleJurisdiction ValueSet
ValueSet.compose.include.concept.designation.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
ValueSet.compose.include.concept.designation.useextensibleDesignationUse
ValueSet.compose.include.filter.oprequiredFilterOperator

Constraints

IdGradePath(s)DetailsRequirements
cvs-1errorValueSetOnly one of rulesText, expression, or a compose definition SHALL be provided
: extension('http://hl7.org/fhir/StructureDefinition/valueset-rules-text').exists() xor extension('http://hl7.org/fhir/StructureDefinition/valueset-expression').exists() xor compose.exists()
dom-2errorValueSetIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorValueSetIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorValueSetIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorValueSetIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceValueSetA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
vsd-0warningValueSetName should be usable as an identifier for the module by machine processing applications such as code generation
: name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
vsd-1errorValueSet.compose.includeA value set include/exclude SHALL have a value set or a system
: valueSet.exists() or system.exists()
vsd-2errorValueSet.compose.includeA value set with concepts or filters SHALL include a system
: (concept.exists() or filter.exists()) implies system.exists()
vsd-3errorValueSet.compose.includeCannot have both concept and filter
: concept.empty() or filter.empty()
vsd-6errorValueSet.expansion.containsSHALL have a code or a display
: code.exists() or display.exists()
vsd-9errorValueSet.expansion.containsMust have a code if not abstract
: code.exists() or abstract = true
vsd-10errorValueSet.expansion.containsMust have a system if a code is present
: code.empty() or system.exists()

This structure is derived from USPublicHealthValueSet

Summary

Must-Support: 3 elements

Extensions

This structure refers to these extensions:

Differential View

This structure is derived from USPublicHealthValueSet

NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet C1..1USPublicHealthValueSetUS Public Health Computable ValueSet
cvs-1: Only one of rulesText, expression, or a compose definition SHALL be provided
... rulesText SC0..1markdownHuman instructions for constructing the valueset
URL: http://hl7.org/fhir/StructureDefinition/valueset-rules-text
... expression SC0..1ExpressionMachine instructions for constructing the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-expression
... compose SC0..1BackboneElementContent logical definition of the value set (CLD)

doco Documentation for this format

Constraints

IdGradePath(s)DetailsRequirements
cvs-1errorValueSetOnly one of rulesText, expression, or a compose definition SHALL be provided
: extension('http://hl7.org/fhir/StructureDefinition/valueset-rules-text').exists() xor extension('http://hl7.org/fhir/StructureDefinition/valueset-expression').exists() xor compose.exists()

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet C1..1USPublicHealthValueSetUS Public Health Computable ValueSet
cvs-1: Only one of rulesText, expression, or a compose definition SHALL be provided
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension 2..*ExtensionExtension
Slice: Unordered, Open by value:url
... extensionValueSetSteward S1..1ContactDetailValue set steward
URL: http://hl7.org/fhir/StructureDefinition/valueset-steward
... rulesText SC0..1markdownHuman instructions for constructing the valueset
URL: http://hl7.org/fhir/StructureDefinition/valueset-rules-text
... expression SC0..1ExpressionMachine instructions for constructing the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-expression
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url Σ1..1uriCanonical identifier for this value set, represented as a URI (globally unique)
... identifier SΣ0..*IdentifierValue set identifier used by public health (e.g. RCTC OID)
... version Σ1..1stringBusiness version of the value set
... name SΣC1..1stringValue set name
... title SΣ1..1stringValue set title
... status ?!SΣ1..1codeValue set definition version
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental Σ1..1booleanFor testing purposes, not real usage
... publisher SΣ1..1stringThe entity that is responsible for the content of the Value Set Definition
... description S1..1markdownValue set description
... Slices for useContext Σ1..*UsageContextThe context that the content is intended to support
Slice: Unordered, Open by pattern:code
.... useContext:priorityContext Σ1..1UsageContextThe context that the content is intended to support
..... code Σ1..1CodingType of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.


Required Pattern: At least the following
...... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/us/ecr/CodeSystem/us-ph-usage-context-type
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: priority
..... value[x] Σ1..1CodeableConceptRelease priority of the ValueSet
Binding: US Public Health ValueSet Priority (required): US PH ValueSet Release Priority Codes.

.... useContext:focusConditionContext SΣ0..*UsageContextThe context that the content is intended to support
..... code Σ1..1CodingType of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.


Required Pattern: At least the following
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/usage-context-type
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: focus
..... value[x] Σ1..1CodeableConceptClinical condition that is the focus of the codes in this value set
Binding: Condition/Problem/DiagnosisCodes (example): Condition/Problem/Diagnosis Codes.

... compose SC0..1BackboneElementContent logical definition of the value set (CLD)
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... include ΣC1..*BackboneElementInclude one or more codes from a code system or other value set(s)
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
..... system ΣC0..1uriThe system the codes come from

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
ValueSet.statusrequiredPublicationStatus
ValueSet.useContext:priorityContext.codeextensiblePattern: priority
ValueSet.useContext:priorityContext.value[x]requiredUSPublicHealthValueSetPriority
ValueSet.useContext:focusConditionContext.codeextensiblePattern: focus
ValueSet.useContext:focusConditionContext.value[x]exampleCondition/Problem/DiagnosisCodes

Constraints

IdGradePath(s)DetailsRequirements
cvs-1errorValueSetOnly one of rulesText, expression, or a compose definition SHALL be provided
: extension('http://hl7.org/fhir/StructureDefinition/valueset-rules-text').exists() xor extension('http://hl7.org/fhir/StructureDefinition/valueset-expression').exists() xor compose.exists()
dom-2errorValueSetIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorValueSetIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorValueSetIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorValueSetIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceValueSetA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
vsd-0warningValueSetName should be usable as an identifier for the module by machine processing applications such as code generation
: name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
vsd-1errorValueSet.compose.includeA value set include/exclude SHALL have a value set or a system
: valueSet.exists() or system.exists()
vsd-2errorValueSet.compose.includeA value set with concepts or filters SHALL include a system
: (concept.exists() or filter.exists()) implies system.exists()
vsd-3errorValueSet.compose.includeCannot have both concept and filter
: concept.empty() or filter.empty()

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. ValueSet C1..1USPublicHealthValueSetUS Public Health Computable ValueSet
cvs-1: Only one of rulesText, expression, or a compose definition SHALL be provided
... 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: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 2..*ExtensionExtension
Slice: Unordered, Open by value:url
... extensionValueSetSteward S1..1ContactDetailValue set steward
URL: http://hl7.org/fhir/StructureDefinition/valueset-steward
... extensionValueSetAuthor S1..1ContactDetailValue set author
URL: http://hl7.org/fhir/StructureDefinition/valueset-author
... rulesText SC0..1markdownHuman instructions for constructing the valueset
URL: http://hl7.org/fhir/StructureDefinition/valueset-rules-text
... expression SC0..1ExpressionMachine instructions for constructing the value set
URL: http://hl7.org/fhir/StructureDefinition/valueset-expression
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url Σ1..1uriCanonical identifier for this value set, represented as a URI (globally unique)
... identifier SΣ0..*IdentifierValue set identifier used by public health (e.g. RCTC OID)
... version Σ1..1stringBusiness version of the value set
... name SΣC1..1stringValue set name
... title SΣ1..1stringValue set title
... status ?!SΣ1..1codeValue set definition version
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental Σ1..1booleanFor testing purposes, not real usage
... date Σ0..1dateTimeDate last changed
... publisher SΣ1..1stringThe entity that is responsible for the content of the Value Set Definition
... contact Σ0..*ContactDetailContact details for the publisher
... description S1..1markdownValue set description
... Slices for useContext Σ1..*UsageContextThe context that the content is intended to support
Slice: Unordered, Open by pattern:code
.... useContext:priorityContext Σ1..1UsageContextThe context that the content is intended to support
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... code Σ1..1CodingType of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.


Required Pattern: At least the following
...... id0..1stringUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/us/ecr/CodeSystem/us-ph-usage-context-type
...... version0..1stringVersion of the system - if relevant
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: priority
...... display0..1stringRepresentation defined by the system
...... userSelected0..1booleanIf this coding was chosen directly by the user
..... value[x] Σ1..1CodeableConceptRelease priority of the ValueSet
Binding: US Public Health ValueSet Priority (required): US PH ValueSet Release Priority Codes.

.... useContext:focusConditionContext SΣ0..*UsageContextThe context that the content is intended to support
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... code Σ1..1CodingType of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.


Required Pattern: At least the following
...... id0..1stringUnique id for inter-element referencing
...... extension0..*ExtensionAdditional content defined by implementations
...... system1..1uriIdentity of the terminology system
Fixed Value: http://terminology.hl7.org/CodeSystem/usage-context-type
...... version0..1stringVersion of the system - if relevant
...... code1..1codeSymbol in syntax defined by the system
Fixed Value: focus
...... display0..1stringRepresentation defined by the system
...... userSelected0..1booleanIf this coding was chosen directly by the user
..... value[x] Σ1..1CodeableConceptClinical condition that is the focus of the codes in this value set
Binding: Condition/Problem/DiagnosisCodes (example): Condition/Problem/Diagnosis Codes.

... 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
... compose SC0..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 ΣC1..*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 ΣC0..1uriThe system the codes come from
..... version Σ0..1stringSpecific version of the code system referred to
..... concept C0..*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 0..*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: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
....... use 0..1CodingTypes of uses of designations
Binding: DesignationUse (extensible): Details of how a designation would be used.

....... value 1..1stringThe text value for this designation
..... filter ΣC0..*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 | exists
Binding: FilterOperator (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 ΣC0..*canonical(ValueSet)Select the contents included in this value set
.... exclude C0..*See include (ValueSet)Explicitly exclude codes from a code system or other value sets
... expansion 0..1BackboneElementUsed when the value set is "expanded"
.... 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 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..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
...... valueUriuri
...... valueCodecode
...... valueDateTimedateTime
.... contains C0..*BackboneElementCodes in the value set
..... 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 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 C0..1codeCode - if blank, this is not a selectable code
..... display C0..1stringUser display for the concept
..... designation 0..*See designation (ValueSet)Additional representations for this item
..... contains 0..*See contains (ValueSet)Codes contained under this entry

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
ValueSet.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
ValueSet.statusrequiredPublicationStatus
ValueSet.useContext:priorityContext.codeextensiblePattern: priority
ValueSet.useContext:priorityContext.value[x]requiredUSPublicHealthValueSetPriority
ValueSet.useContext:focusConditionContext.codeextensiblePattern: focus
ValueSet.useContext:focusConditionContext.value[x]exampleCondition/Problem/DiagnosisCodes
ValueSet.jurisdictionextensibleJurisdiction ValueSet
ValueSet.compose.include.concept.designation.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
ValueSet.compose.include.concept.designation.useextensibleDesignationUse
ValueSet.compose.include.filter.oprequiredFilterOperator

Constraints

IdGradePath(s)DetailsRequirements
cvs-1errorValueSetOnly one of rulesText, expression, or a compose definition SHALL be provided
: extension('http://hl7.org/fhir/StructureDefinition/valueset-rules-text').exists() xor extension('http://hl7.org/fhir/StructureDefinition/valueset-expression').exists() xor compose.exists()
dom-2errorValueSetIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorValueSetIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorValueSetIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorValueSetIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceValueSetA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
vsd-0warningValueSetName should be usable as an identifier for the module by machine processing applications such as code generation
: name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
vsd-1errorValueSet.compose.includeA value set include/exclude SHALL have a value set or a system
: valueSet.exists() or system.exists()
vsd-2errorValueSet.compose.includeA value set with concepts or filters SHALL include a system
: (concept.exists() or filter.exists()) implies system.exists()
vsd-3errorValueSet.compose.includeCannot have both concept and filter
: concept.empty() or filter.empty()
vsd-6errorValueSet.expansion.containsSHALL have a code or a display
: code.exists() or display.exists()
vsd-9errorValueSet.expansion.containsMust have a code if not abstract
: code.exists() or abstract = true
vsd-10errorValueSet.expansion.containsMust have a system if a code is present
: code.empty() or system.exists()

This structure is derived from USPublicHealthValueSet

Summary

Must-Support: 3 elements

Extensions

This structure refers to these extensions:

 

Other representations of profile: CSV, Excel, Schematron