Structured Data Capture
4.0.0-ballot - STU 4 ballot International flag

Structured Data Capture, published by HL7 International / FHIR Infrastructure. This guide is not an authorized publication; it is the continuous build for version 4.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/sdc/ and changes regularly. See the Directory of published versions

Data Type Profile: SDC Usage Context

Official URL: http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-usagecontext Version: 4.0.0-ballot
Standards status: Trial-use Maturity Level: 4 Computable Name: SDCUsageContext
Other Identifiers: OID:2.16.840.1.113883.4.642.40.17.42.69

Constraints on the codes and values of UsageContext to help ensure consistent usage in SDC Questionnaires

Scope and Usage

The UsageContext data type allows categorizing artifacts in a wide variety of ways, but doesn't provide much guidance one what aspects should be supported, what data types are relevant to which types of context, or what value sets are appropriate for coded contexts. This profile tightens down the data type to reflect expectations for use in Questionnaire registries.

Usage:

Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraintsdoco
.. UsageContext SC 0..* UsageContext Describes the context of use for a conformance or knowledge resource
ele-1: All FHIR elements must have a @value or children
sdc-uc-1: If code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
... code SΣ 1..1 Coding Type of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.


ele-1: All FHIR elements must have a @value or children
... Slices for value[x] SΣ 1..1 Value that defines the context
Slice: Unordered, Open by type:$this
Binding: Context of Use ValueSet (example): A code that defines the specific value for the context being specified.


ele-1: All FHIR elements must have a @value or children
.... valueCodeableConcept CodeableConcept
.... valueQuantity Quantity
.... valueRange Range
.... valueReference Reference(PlanDefinition | ResearchStudy | InsurancePlan | HealthcareService | Group | Location | Organization)
.... value[x]:valueCodeableConcept SΣ 0..1 CodeableConcept Value that defines the context
Binding: Context of Use ValueSet (example): A code that defines the specific value for the context being specified.


ele-1: All FHIR elements must have a @value or children
..... coding SΣ 0..* Coding Code defined by a terminology system
ele-1: All FHIR elements must have a @value or children
...... system SΣ 0..1 uri Identity of the terminology system
ele-1: All FHIR elements must have a @value or children
...... code SΣ 0..1 code Symbol in syntax defined by the system
ele-1: All FHIR elements must have a @value or children
.... value[x]:valueRange SΣ 0..1 Range Value that defines the context
ele-1: All FHIR elements must have a @value or children
..... low SΣ 0..1 SimpleQuantity Low limit
ele-1: All FHIR elements must have a @value or children
..... high SΣ 0..1 SimpleQuantity High limit
ele-1: All FHIR elements must have a @value or children

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
UsageContext.codeextensibleUsageContextType
http://hl7.org/fhir/ValueSet/usage-context-type
from the FHIR Standard
UsageContext.value[x]exampleContext of Use ValueSet
http://hl7.org/fhir/ValueSet/use-context
from the FHIR Standard
UsageContext.value[x]:valueCodeableConceptexampleContext of Use ValueSet
http://hl7.org/fhir/ValueSet/use-context
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
sdc-uc-1errorUsageContextIf code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
: code.system!='http://terminology.hl7.org/CodeSystem/usage-context-type' or (((code.code='gender' or code.code='focus' or code.code='user' or code.code='venue' or code.code='species') implies value.exists() and value is CodeableConcept) and (code.code='age' implies value.exists() and value is Range) and ((code.code='workflow' or code.code='task' or code.code='program') implies (value.exists() and (value is CodeableConcept or value is Reference))))

This structure is derived from UsageContext

NameFlagsCard.TypeDescription & Constraintsdoco
.. UsageContext SC 0..* UsageContext Describes the context of use for a conformance or knowledge resource
sdc-uc-1: If code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
... code S 1..1 Coding Type of context being specified
... Slices for value[x] S 1..1 CodeableConcept, Quantity, Range, Reference(PlanDefinition | ResearchStudy | InsurancePlan | HealthcareService | Group | Location | Organization) Value that defines the context
Slice: Unordered, Open by type:$this
.... value[x]:valueCodeableConcept S 0..1 CodeableConcept Value that defines the context
..... coding S 0..* Coding Code defined by a terminology system
...... system S 0..1 uri Identity of the terminology system
...... code S 0..1 code Symbol in syntax defined by the system
.... value[x]:valueRange S 0..1 Range Value that defines the context
..... low S 0..1 SimpleQuantity Low limit
..... high S 0..1 SimpleQuantity High limit

doco Documentation for this format

Constraints

IdGradePath(s)DetailsRequirements
sdc-uc-1errorUsageContextIf code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
: code.system!='http://terminology.hl7.org/CodeSystem/usage-context-type' or (((code.code='gender' or code.code='focus' or code.code='user' or code.code='venue' or code.code='species') implies value.exists() and value is CodeableConcept) and (code.code='age' implies value.exists() and value is Range) and ((code.code='workflow' or code.code='task' or code.code='program') implies (value.exists() and (value is CodeableConcept or value is Reference))))
NameFlagsCard.TypeDescription & Constraintsdoco
.. UsageContext SC 0..* UsageContext Describes the context of use for a conformance or knowledge resource
sdc-uc-1: If code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
... id 0..1 string Unique id for inter-element referencing
... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
... code SΣ 1..1 Coding Type of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.

.... valueCodeableConcept CodeableConcept
.... valueQuantity Quantity
.... valueRange Range
.... valueReference Reference(PlanDefinition | ResearchStudy | InsurancePlan | HealthcareService | Group | Location | Organization)
.... value[x]:valueCodeableConcept SΣ 0..1 CodeableConcept Value that defines the context
Binding: Context of Use ValueSet (example): A code that defines the specific value for the context being specified.

..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... coding SΣ 0..* Coding Code defined by a terminology system
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... system SΣ 0..1 uri Identity of the terminology system
...... version Σ 0..1 string Version of the system - if relevant
...... code SΣ 0..1 code Symbol in syntax defined by the system
...... display Σ 0..1 string Representation defined by the system
...... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
..... text Σ 0..1 string Plain text representation of the concept
.... value[x]:valueRange SΣ 0..1 Range Value that defines the context
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... low SΣ 0..1 SimpleQuantity Low limit
..... high SΣ 0..1 SimpleQuantity High limit

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
UsageContext.codeextensibleUsageContextType
http://hl7.org/fhir/ValueSet/usage-context-type
from the FHIR Standard
UsageContext.value[x]exampleContext of Use ValueSet
http://hl7.org/fhir/ValueSet/use-context
from the FHIR Standard
UsageContext.value[x]:valueCodeableConceptexampleContext of Use ValueSet
http://hl7.org/fhir/ValueSet/use-context
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
sdc-uc-1errorUsageContextIf code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
: code.system!='http://terminology.hl7.org/CodeSystem/usage-context-type' or (((code.code='gender' or code.code='focus' or code.code='user' or code.code='venue' or code.code='species') implies value.exists() and value is CodeableConcept) and (code.code='age' implies value.exists() and value is Range) and ((code.code='workflow' or code.code='task' or code.code='program') implies (value.exists() and (value is CodeableConcept or value is Reference))))

This structure is derived from UsageContext

Summary

Must-Support: 9 elements

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of UsageContext.value[x]

Maturity: 4

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. UsageContext SC 0..* UsageContext Describes the context of use for a conformance or knowledge resource
ele-1: All FHIR elements must have a @value or children
sdc-uc-1: If code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
... code SΣ 1..1 Coding Type of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.


ele-1: All FHIR elements must have a @value or children
... Slices for value[x] SΣ 1..1 Value that defines the context
Slice: Unordered, Open by type:$this
Binding: Context of Use ValueSet (example): A code that defines the specific value for the context being specified.


ele-1: All FHIR elements must have a @value or children
.... valueCodeableConcept CodeableConcept
.... valueQuantity Quantity
.... valueRange Range
.... valueReference Reference(PlanDefinition | ResearchStudy | InsurancePlan | HealthcareService | Group | Location | Organization)
.... value[x]:valueCodeableConcept SΣ 0..1 CodeableConcept Value that defines the context
Binding: Context of Use ValueSet (example): A code that defines the specific value for the context being specified.


ele-1: All FHIR elements must have a @value or children
..... coding SΣ 0..* Coding Code defined by a terminology system
ele-1: All FHIR elements must have a @value or children
...... system SΣ 0..1 uri Identity of the terminology system
ele-1: All FHIR elements must have a @value or children
...... code SΣ 0..1 code Symbol in syntax defined by the system
ele-1: All FHIR elements must have a @value or children
.... value[x]:valueRange SΣ 0..1 Range Value that defines the context
ele-1: All FHIR elements must have a @value or children
..... low SΣ 0..1 SimpleQuantity Low limit
ele-1: All FHIR elements must have a @value or children
..... high SΣ 0..1 SimpleQuantity High limit
ele-1: All FHIR elements must have a @value or children

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
UsageContext.codeextensibleUsageContextType
http://hl7.org/fhir/ValueSet/usage-context-type
from the FHIR Standard
UsageContext.value[x]exampleContext of Use ValueSet
http://hl7.org/fhir/ValueSet/use-context
from the FHIR Standard
UsageContext.value[x]:valueCodeableConceptexampleContext of Use ValueSet
http://hl7.org/fhir/ValueSet/use-context
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
sdc-uc-1errorUsageContextIf code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
: code.system!='http://terminology.hl7.org/CodeSystem/usage-context-type' or (((code.code='gender' or code.code='focus' or code.code='user' or code.code='venue' or code.code='species') implies value.exists() and value is CodeableConcept) and (code.code='age' implies value.exists() and value is Range) and ((code.code='workflow' or code.code='task' or code.code='program') implies (value.exists() and (value is CodeableConcept or value is Reference))))

Differential View

This structure is derived from UsageContext

NameFlagsCard.TypeDescription & Constraintsdoco
.. UsageContext SC 0..* UsageContext Describes the context of use for a conformance or knowledge resource
sdc-uc-1: If code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
... code S 1..1 Coding Type of context being specified
... Slices for value[x] S 1..1 CodeableConcept, Quantity, Range, Reference(PlanDefinition | ResearchStudy | InsurancePlan | HealthcareService | Group | Location | Organization) Value that defines the context
Slice: Unordered, Open by type:$this
.... value[x]:valueCodeableConcept S 0..1 CodeableConcept Value that defines the context
..... coding S 0..* Coding Code defined by a terminology system
...... system S 0..1 uri Identity of the terminology system
...... code S 0..1 code Symbol in syntax defined by the system
.... value[x]:valueRange S 0..1 Range Value that defines the context
..... low S 0..1 SimpleQuantity Low limit
..... high S 0..1 SimpleQuantity High limit

doco Documentation for this format

Constraints

IdGradePath(s)DetailsRequirements
sdc-uc-1errorUsageContextIf code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
: code.system!='http://terminology.hl7.org/CodeSystem/usage-context-type' or (((code.code='gender' or code.code='focus' or code.code='user' or code.code='venue' or code.code='species') implies value.exists() and value is CodeableConcept) and (code.code='age' implies value.exists() and value is Range) and ((code.code='workflow' or code.code='task' or code.code='program') implies (value.exists() and (value is CodeableConcept or value is Reference))))

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. UsageContext SC 0..* UsageContext Describes the context of use for a conformance or knowledge resource
sdc-uc-1: If code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
... id 0..1 string Unique id for inter-element referencing
... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
... code SΣ 1..1 Coding Type of context being specified
Binding: UsageContextType (extensible): A code that specifies a type of context being specified by a usage context.

.... valueCodeableConcept CodeableConcept
.... valueQuantity Quantity
.... valueRange Range
.... valueReference Reference(PlanDefinition | ResearchStudy | InsurancePlan | HealthcareService | Group | Location | Organization)
.... value[x]:valueCodeableConcept SΣ 0..1 CodeableConcept Value that defines the context
Binding: Context of Use ValueSet (example): A code that defines the specific value for the context being specified.

..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... coding SΣ 0..* Coding Code defined by a terminology system
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... system SΣ 0..1 uri Identity of the terminology system
...... version Σ 0..1 string Version of the system - if relevant
...... code SΣ 0..1 code Symbol in syntax defined by the system
...... display Σ 0..1 string Representation defined by the system
...... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
..... text Σ 0..1 string Plain text representation of the concept
.... value[x]:valueRange SΣ 0..1 Range Value that defines the context
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... low SΣ 0..1 SimpleQuantity Low limit
..... high SΣ 0..1 SimpleQuantity High limit

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
UsageContext.codeextensibleUsageContextType
http://hl7.org/fhir/ValueSet/usage-context-type
from the FHIR Standard
UsageContext.value[x]exampleContext of Use ValueSet
http://hl7.org/fhir/ValueSet/use-context
from the FHIR Standard
UsageContext.value[x]:valueCodeableConceptexampleContext of Use ValueSet
http://hl7.org/fhir/ValueSet/use-context
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
sdc-uc-1errorUsageContextIf code is gender, focus, user, venue or species, value must be CodeableConcept. If code is age, value must be Range. If code is workflow, task or program, value must be CodeableConcept or Reference
: code.system!='http://terminology.hl7.org/CodeSystem/usage-context-type' or (((code.code='gender' or code.code='focus' or code.code='user' or code.code='venue' or code.code='species') implies value.exists() and value is CodeableConcept) and (code.code='age' implies value.exists() and value is Range) and ((code.code='workflow' or code.code='task' or code.code='program') implies (value.exists() and (value is CodeableConcept or value is Reference))))

This structure is derived from UsageContext

Summary

Must-Support: 9 elements

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of UsageContext.value[x]

Maturity: 4

 

Other representations of profile: CSV, Excel, Schematron