Release 5 Ballot

This page is part of the FHIR Specification (v5.0.0-ballot: FHIR R5 Ballot Preview). 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

Vocabulary Work GroupMaturity Level: N/AStandards Status: Informative
Core profiles and extensions defined for the ValueSet resource
Profiles:
ShareableValueSetEnforces the minimum information set for the value set metadata required by HL7 and other organizations that share and publish value sets
PublishableValueSetDefines and enforces the minimum expectations for publication and distribution of a value set, typically as part of an artifact repository or implementation guide publication
ComputableValueSetDefines 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
ExecutableValueSetDefines 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.
Extensions:
valueset-concept-definitionconcept-definition :

A definition that describes the meaning of this code when used as part of this value set.

valueset-concept-commentsconcept-comments :

A comment that explains how this code is used in this context (where the value set is expected to be used).

valueset-otherNameotherName :

Natural language names identifying the value set. These names should be usable as an identifier for the module by machine processing applications such as code generation.

valueset-sourceReferencesourceReference :

This text is intended to act as a citation to work done elsewhere that is not part of the current stewarding process where the referenced source is in some way a basis of the current value set definition.

valueset-keyWordkeyWord :

Word or words used in an information retrieval system to indicate the content of the value set. (deprecated)

valueset-usageusage :

Consumers of the value set and the implementations, projects or standards that the author has utilized the value set in.

valueset-workflowStatusDescriptionworkflowStatusDescription :

Workflow Status is used to represent details of the value set development process while in a single Activity Status.

valueset-effectiveDateeffectiveDate :

This is the first date-time when the value set version becomes active, so this value is present on Inactive value set versions as well. The start Date_time is expected to be as of 0001 UTC of the Effective Date. (deprecated)

valueset-expirationDateexpirationDate :

The date when the value set version is no longer expected to be used to create new content. This is the first date-time when the value set version becomes Inactive, so this value SHALL present on all Inactive value set versions. The start Date_time is expected to be as of 0001 UTC of the Expiration Date. (deprecated)

valueset-authorauthor :

The entity or set of entities that create and may modify the Value Set Definition content. The name of a group or an individual, along with contact details. (deprecated)

valueset-stewardsteward :

The entity that is responsible for the content of the Value Set Definition. This is a textual description of the organizational entity responsible for the content and maintenance. (deprecated)

valueset-trusted-expansiontrusted-expansion :

Indicates an authoritative source for performing value set expansions.

valueset-labellabel :

The label to list in front of a code when presenting a list of possible values in a questionnaire-like fashion.

valueset-conceptOrderconceptOrder :

Identifies the relative order in which concepts within the value set should be presented to a user.

valueset-systemRefsystemRef :

The formal URI for the code system. I.e. ValueSet.codeSystem.system (or its equivalent).

valueset-caseSensitivecaseSensitive :

If this a case sensitive code.

valueset-referencereference :

A logical reference (e.g. a reference to ValueSet.url) that identifies the value set/version that identifies the set of possible coded values this coding was chosen from or constrained by.

valueset-expansionSourceexpansionSource :

The logical URL of the ValueSet definition that was used to generate this expansion.

valueset-unclosedunclosed :

Marks that the expansion is incomplete, and values other than those listed may be valid. This may be used because post-coordinated codes are allowed, and no practical expansion can be produced.

valueset-toocostlytoocostly :

Marks that the expansion is incomplete, because the full value set is too large to represent, and the client asked for an incomplete fragment.

valueset-mapmap :

A reference to a concept map that is relevant for the interpretation of this value set.

valueset-warningwarning :

An extra warning about the correct use of the value set.

valueset-systemsystem :

Allows a direct reference to the code system for FHIR query.

valueset-supplementsupplement :

This extension declares that a value set depends on a particular supplement and should not be used in its absence.

valueset-parameterSourceparameterSource :

Declares what the source of this parameter is.

valueset-deprecateddeprecated :

if ture, indicates that the concept is deprecated from the value set - that is, it should not be used, and is planned to be withdrawn.

valueset-special-statusspecial-status :

A special note for implementers about the status of the resource.

valueset-extensibleextensible :

Whether this is intended to be used with an extensible binding or not.

valueset-authoritativeSourceauthoritativeSource :

A reference to the authoritative accessible, persisted source of truth of the entire Value Set Definition, including textual information and available versions.

valueset-expressionexpression :

An expression that provides an alternative definition of the content of the value set (compose). There are two different ways to use this expression extension: If both an expression (this extension) and a compose element is present, the compose is understood to the make the same statement as the expression. If there is no compose, the expression is the only definition of the value set, and the value set can only be processed by a server that understands the expression syntax, the expression is computable.

valueset-rules-textrules-text :

An expression that provides an alternative definition of the content of the value set in some form that is not computable - e.g instructions that could only be followed by a human.

valueset-otherTitleotherTitle :

Human readable titles for the valueset.

valueset-systemTitlesystemTitle :

The human-readable name for the code system.

valueset-systemNamesystemName :

The human-readable name for the code system.

valueset-compose-createdBycreatedBy :

User who created the compose for the ValueSet.

valueset-compose-creationDatecreationDate :

Date the compose was created.

valueset-compose-include-valueSetTitlevalueset-compose-include-valueSetTitle :

Human readable name for the included Value Set.

Search parameters defined by this package. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionPathsSource
authorstringOptional Extensions ElementCodeSystem.extension('http://hl7.org/fhir/StructureDefinition/valueset-author').valueXML / JSON
effectivedateOptional Extensions ElementCodeSystem.extension('http://hl7.org/fhir/StructureDefinition/valueset-effectiveDate').valueXML / JSON
enddateOptional Extensions ElementCodeSystem.extension('http://hl7.org/fhir/StructureDefinition/valueset-expirationDate').valueXML / JSON
keywordstringOptional Extensions ElementCodeSystem.extension('http://hl7.org/fhir/StructureDefinition/valueset-keyWord').valueXML / JSON
workflowtokenOptional Extensions ElementCodeSystem.extension('http://hl7.org/fhir/StructureDefinition/valueset-workflowStatus').valueXML / JSON