QI-Core Implementation Guide
7.0.2 - STU 7

QI-Core Implementation Guide, published by HL7 International / Clinical Quality Information. This guide is not an authorized publication; it is the continuous build for version 7.0.2 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-qi-core/ and changes regularly. See the Directory of published versions

## Extension: Code Options

Official URL: http://hl7.org/fhir/StructureDefinition/codeOptions | Version: 7.0.2
Standards status: Trial-use | Maturity Level: 1 | Computable Name: CodeOptions

A logical reference (i.e. a reference to ValueSet.url) to a value set/version that identifies a set of possible coded values used to convey a higher level concept that encompasses a list of candidate specializations when there is no formal code defined for that purpose. For example, the concept of COVID preventative medications can be expressed as a value set because there is no specific code representing that concept.

This extension supports specifying the focus of an activity as a set of possible codes when there is no specific code available that captures the candidate activities.

Context of Use

This extension may be used on the following element(s)

- Element ID: `CodeableConcept`

Usage info

Usages:

- Use this Extension: QICore Communication, QICore DeviceRequest, QICore Immunization, QICore MedicationAdministration... Show 5 more, QICore MedicationDispense, QICore MedicationRequest, QICore Procedure, QICore ServiceRequest and QICore Task
- Examples for this Extension: DeviceRequest/negation-example, Immunization/negation-example, MedicationAdministration/negation-example, MedicationDispense/negation-example... Show 4 more, Procedure/negation-example, ServiceRequest/negation-example, ServiceRequest/proposal-example and Task/negation-example

You can also check for usages in the FHIR IG Statistics

### Formal Views of Extension Content

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

- Differential Table
- Snapshot Table
- Statistics/References
- All

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..1 | Extension | Url of a value set of activities
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://hl7.org/fhir/StructureDefinition/codeOptions"
value[x] |  | 1..1 | canonical(ValueSet) | Value of extension
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..1 | Extension | Url of a value set of activities
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "http://hl7.org/fhir/StructureDefinition/codeOptions"
value[x] |  | 1..1 | canonical(ValueSet) | Value of extension
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type canonical: A logical reference (i.e. a reference to ValueSet.url) to a value set/version that identifies a set of possible coded values used to convey a higher level concept that encompasses a list of candidate specializations when there is no formal code defined for that purpose. For example, the concept of COVID preventative medications can be expressed as a value set because there is no specific code representing that concept.

Maturity: 1

Differential View

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..1 | Extension | Url of a value set of activities
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://hl7.org/fhir/StructureDefinition/codeOptions"
value[x] |  | 1..1 | canonical(ValueSet) | Value of extension
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..1 | Extension | Url of a value set of activities
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "http://hl7.org/fhir/StructureDefinition/codeOptions"
value[x] |  | 1..1 | canonical(ValueSet) | Value of extension
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type canonical: A logical reference (i.e. a reference to ValueSet.url) to a value set/version that identifies a set of possible coded values used to convey a higher level concept that encompasses a list of candidate specializations when there is no formal code defined for that purpose. For example, the concept of COVID preventative medications can be expressed as a value set because there is no specific code representing that concept.

Maturity: 1

Other representations of profile: CSV, Excel, Schematron

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`