This page is part of the Structured Data Capture FHIR IG (v1.6: STU 2 Ballot) based on FHIR (HL7® FHIR® Standard) v1.6.0. The current version which supersedes this version is 4.0.0. For a full list of available versions, see the Directory of published versions

This is a pre-release of a future version of SDC (expected to be STU 2). The current version is STU 2.
For a full list of available versions, see the Directory of published versions .

12.1 StructureDefinition: Profile sdc-codesystem

The official URL for this profile is: 

http://hl7.org/fhir/us/sdc/StructureDefinition/sdc-codesystem

12.1.2 Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraintsdoco
.. CodeSystem I0..*A set of codes drawn from one or more code systems
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource
csd-1: Within a code system definition, all the codes SHALL be unique
... 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: Common Languages (extensible)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... rendering-styleSensitive SI0..1booleanExtension
URL: http://hl7.org/fhir/StructureDefinition/rendering-styleSensitive
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url S0..1uriGlobally unique logical identifier for code system (Coding.system)
... identifier ∑0..1IdentifierAdditional identifier for the code system (e.g. HL7 v2 / CDA)
... version ∑0..1stringLogical identifier for this version (Coding.version)
... name S1..1stringInformal name for this code system
... status ?!S1..1codedraft | active | retired
Binding: ConformanceResourceStatus (required)
... experimental S0..1booleanIf for testing purposes, not real usage
... publisher ∑0..1stringName of the publisher (organization or individual)
... contact ∑0..*BackboneElementContact details of the publisher
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... name ∑0..1stringName of an individual to contact
.... telecom ∑0..*ContactPointContact details for individual or publisher
... date S0..1dateTimeDate for given status
... description S1..1markdownHuman language description of the code system
... useContext S0..*CodeableConceptContent intends to support these contexts
Binding: Context of Use ValueSet (extensible)
... requirements 0..1markdownWhy needed
... copyright 0..1stringUse and/or publishing restrictions
... caseSensitive S1..1booleanIf code comparison is case sensitive
... valueSet ∑0..1uriCanonical URL for value set with entire code system
... hierarchyMeaning ∑0..1codegrouped-by | subsumes | part-of | classified-with
Binding: CodeSystemHierarchyMeaning (required)
... content S1..1codenot-present | examplar | fragment | complete
Binding: CodeSystemContentMode (required)
... count ∑0..1unsignedIntTotal concepts in the code system
... filter ∑0..*BackboneElementFilter that can be used in a value set
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... code ∑1..1codeCode that identifies the filter
.... description ∑0..1stringHow or why the filter is used
.... operator ∑1..*codeOperators that can be used with filter
Binding: FilterOperator (required)
.... value ∑1..1stringWhat to use for the value
... property ∑0..*BackboneElementAdditional information supplied about each concept
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... code ∑1..1codeIdentifies the property on the concepts, and when referred to in operations
.... uri ∑0..1uriFormal identifier for the property
.... description ∑0..1stringWhy the property is defined, and/or what it conveys
.... type ∑1..1codecode | Coding | string | integer | boolean | dateTime
Binding: PropertyType (required)
... concept S0..*BackboneElementConcepts in the code system
.... id 0..1stringxml:id (or equivalent in JSON)
.... valueset-label SI0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-label
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... id 0..1stringxml:id (or equivalent in JSON)
..... url 1..1uri"http://hl7.org/fhir/StructureDefinition/valueset-label"
..... valueString S1..1stringValue of extension
...... id 0..1idxml:id (or equivalent in JSON)
...... rendering-style I0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/rendering-style
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... rendering-xhtml I0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/rendering-xhtml
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... value 0..1Primitive value for string
.... valueset-conceptOrder SI0..1integerExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-conceptOrder
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... code S1..1codeCode that identifies concept
.... display S0..1stringText to display to the user
..... id 0..1idxml:id (or equivalent in JSON)
..... rendering-style I0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/rendering-style
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... rendering-xhtml I0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/rendering-xhtml
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... value 0..1Primitive value for string
.... definition S0..1stringFormal definition
.... designation 0..*BackboneElementAdditional representations for the concept
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
..... language 0..1codeHuman language of the designation
Binding: Common Languages (extensible)
..... use 0..1CodingDetails how this designation would be used
Binding: Designation Use (extensible)
..... value 1..1stringThe text value for this designation
.... property 0..*BackboneElementProperty value for the concept
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
..... code 1..1codeReference to CodeSystem.property.code
..... value[x] 1..1code, Coding, string, integer, boolean, dateTimeValue of the property for this concept
.... concept S0..*Unknown reference to #CodeSystem:sdcdecodesystem.concept
Child Concepts (is-a/contains/categorizes)

doco Documentation for this format

yet to be done: Xml template

yet to be done: Json template

yet to be done: Turtle template

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. CodeSystem I0..*A set of codes drawn from one or more code systems
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource
csd-1: Within a code system definition, all the codes SHALL be unique
... 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: Common Languages (extensible)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... rendering-styleSensitive SI0..1booleanExtension
URL: http://hl7.org/fhir/StructureDefinition/rendering-styleSensitive
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url S0..1uriGlobally unique logical identifier for code system (Coding.system)
... identifier ∑0..1IdentifierAdditional identifier for the code system (e.g. HL7 v2 / CDA)
... version ∑0..1stringLogical identifier for this version (Coding.version)
... name S1..1stringInformal name for this code system
... status ?!S1..1codedraft | active | retired
Binding: ConformanceResourceStatus (required)
... experimental S0..1booleanIf for testing purposes, not real usage
... publisher ∑0..1stringName of the publisher (organization or individual)
... contact ∑0..*BackboneElementContact details of the publisher
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... name ∑0..1stringName of an individual to contact
.... telecom ∑0..*ContactPointContact details for individual or publisher
... date S0..1dateTimeDate for given status
... description S1..1markdownHuman language description of the code system
... useContext S0..*CodeableConceptContent intends to support these contexts
Binding: Context of Use ValueSet (extensible)
... requirements 0..1markdownWhy needed
... copyright 0..1stringUse and/or publishing restrictions
... caseSensitive S1..1booleanIf code comparison is case sensitive
... valueSet ∑0..1uriCanonical URL for value set with entire code system
... hierarchyMeaning ∑0..1codegrouped-by | subsumes | part-of | classified-with
Binding: CodeSystemHierarchyMeaning (required)
... content S1..1codenot-present | examplar | fragment | complete
Binding: CodeSystemContentMode (required)
... count ∑0..1unsignedIntTotal concepts in the code system
... filter ∑0..*BackboneElementFilter that can be used in a value set
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... code ∑1..1codeCode that identifies the filter
.... description ∑0..1stringHow or why the filter is used
.... operator ∑1..*codeOperators that can be used with filter
Binding: FilterOperator (required)
.... value ∑1..1stringWhat to use for the value
... property ∑0..*BackboneElementAdditional information supplied about each concept
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... code ∑1..1codeIdentifies the property on the concepts, and when referred to in operations
.... uri ∑0..1uriFormal identifier for the property
.... description ∑0..1stringWhy the property is defined, and/or what it conveys
.... type ∑1..1codecode | Coding | string | integer | boolean | dateTime
Binding: PropertyType (required)
... concept S0..*BackboneElementConcepts in the code system
.... id 0..1stringxml:id (or equivalent in JSON)
.... valueset-label SI0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-label
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... id 0..1stringxml:id (or equivalent in JSON)
..... url 1..1uri"http://hl7.org/fhir/StructureDefinition/valueset-label"
..... valueString S1..1stringValue of extension
...... id 0..1idxml:id (or equivalent in JSON)
...... rendering-style I0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/rendering-style
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... rendering-xhtml I0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/rendering-xhtml
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... value 0..1Primitive value for string
.... valueset-conceptOrder SI0..1integerExtension
URL: http://hl7.org/fhir/StructureDefinition/valueset-conceptOrder
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
.... code S1..1codeCode that identifies concept
.... display S0..1stringText to display to the user
..... id 0..1idxml:id (or equivalent in JSON)
..... rendering-style I0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/rendering-style
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... rendering-xhtml I0..1stringExtension
URL: http://hl7.org/fhir/StructureDefinition/rendering-xhtml
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... value 0..1Primitive value for string
.... definition S0..1stringFormal definition
.... designation 0..*BackboneElementAdditional representations for the concept
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
..... language 0..1codeHuman language of the designation
Binding: Common Languages (extensible)
..... use 0..1CodingDetails how this designation would be used
Binding: Designation Use (extensible)
..... value 1..1stringThe text value for this designation
.... property 0..*BackboneElementProperty value for the concept
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!∑0..*ExtensionExtensions that cannot be ignored
..... code 1..1codeReference to CodeSystem.property.code
..... value[x] 1..1code, Coding, string, integer, boolean, dateTimeValue of the property for this concept
.... concept S0..*Unknown reference to #CodeSystem:sdcdecodesystem.concept
Child Concepts (is-a/contains/categorizes)

doco Documentation for this format

XML Template

yet to be done: Xml template

JSON Template

yet to be done: Json template

TTL Template

yet to be done: Turtle template

 

Other representations of profile: Schematron

12.1.3 Terminology Bindings

Terminology Bindings

PathNameConformanceValueSet
CodeSystem.languageCommon LanguagesextensibleCommon Languages
CodeSystem.statusConformanceResourceStatusrequiredConformanceResourceStatus
CodeSystem.useContextContext of Use ValueSetextensibleContext of Use ValueSet
CodeSystem.hierarchyMeaningCodeSystemHierarchyMeaningrequiredCodeSystemHierarchyMeaning
CodeSystem.contentCodeSystemContentModerequiredCodeSystemContentMode
CodeSystem.filter.operatorFilterOperatorrequiredFilterOperator
CodeSystem.property.typePropertyTyperequiredPropertyType
CodeSystem.concept.designation.languageCommon LanguagesextensibleCommon Languages
CodeSystem.concept.designation.useDesignation UseextensibleDesignation Use

12.1.4 Constraints

Constraints

IdPathDetailsRequirements
dom-2CodeSystemIf the resource is contained in another resource, it SHALL NOT contain nested Resources
XPath: not(parent::f:contained and f:contained)
dom-1CodeSystemIf the resource is contained in another resource, it SHALL NOT contain any narrative
XPath: not(parent::f:contained and f:text)
dom-4CodeSystemIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
XPath: not(exists(f:contained/*/f:meta/f:versionId)) and not(exists(f:contained/*/f:meta/f:lastUpdated))
dom-3CodeSystemIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource
XPath: not(exists(for $id in f:contained/*/@id return $id[not(ancestor::f:contained/parent::*/descendant::f:reference/@value=concat('#', $id))]))
csd-1CodeSystemWithin a code system definition, all the codes SHALL be unique
XPath: count(distinct-values(descendant::f:concept/f:code/@value))=count(descendant::f:concept)
ele-1CodeSystem.extensionAll FHIR elements must have a @value or children
XPath: @value|f:*|h:div
ext-1CodeSystem.extensionMust have either extensions or value[x], not both
XPath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
ele-1CodeSystem.concept.extensionAll FHIR elements must have a @value or children
XPath: @value|f:*|h:div
ext-1CodeSystem.concept.extensionMust have either extensions or value[x], not both
XPath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
ele-1CodeSystem.concept.extensionAll FHIR elements must have a @value or children
XPath: @value|f:*|h:div
ext-1CodeSystem.concept.extensionMust have either extensions or value[x], not both
XPath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
ele-1CodeSystem.concept.extension.valueString.extensionAll FHIR elements must have a @value or children
XPath: @value|f:*|h:div
ext-1CodeSystem.concept.extension.valueString.extensionMust have either extensions or value[x], not both
XPath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
ele-1CodeSystem.concept.extension.valueString.extensionAll FHIR elements must have a @value or children
XPath: @value|f:*|h:div
ext-1CodeSystem.concept.extension.valueString.extensionMust have either extensions or value[x], not both
XPath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
ele-1CodeSystem.concept.extension.valueString.extensionAll FHIR elements must have a @value or children
XPath: @value|f:*|h:div
ext-1CodeSystem.concept.extension.valueString.extensionMust have either extensions or value[x], not both
XPath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
ele-1CodeSystem.concept.extensionAll FHIR elements must have a @value or children
XPath: @value|f:*|h:div
ext-1CodeSystem.concept.extensionMust have either extensions or value[x], not both
XPath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
ele-1CodeSystem.concept.display.extensionAll FHIR elements must have a @value or children
XPath: @value|f:*|h:div
ext-1CodeSystem.concept.display.extensionMust have either extensions or value[x], not both
XPath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
ele-1CodeSystem.concept.display.extensionAll FHIR elements must have a @value or children
XPath: @value|f:*|h:div
ext-1CodeSystem.concept.display.extensionMust have either extensions or value[x], not both
XPath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
ele-1CodeSystem.concept.display.extensionAll FHIR elements must have a @value or children
XPath: @value|f:*|h:div
ext-1CodeSystem.concept.display.extensionMust have either extensions or value[x], not both
XPath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])