ch-elm-codeableconcept
type: StructureDefinition
node role: treeRoot
id:
  v: ch-elm-codeableconcept
text:
  status:
    v: extensions
  div: Generated Narrative: StructureDefinition ch-elm-codeableconcept Name Flags Card. Type Description & Constraints CodeableConcept CodeableConceptIPS #xD; coding 1..1 ChElmCoding A reference to a code defined by a terminology system #xD; Documentation for this format
url:
  v: http://fhir.ch/ig/ch-elm/StructureDefinition/ch-elm-codeableconcept
version:
  v: 1.11.0
name:
  v: ChElmCodeableConcept
title:
  v: CH ELM CodeableConcept
status:
  v: active
date:
  v: 2025-08-13T07:08:59+00:00
publisher:
  v: Federal Office of Public Health FOPH
contact:
  name:
    v: Federal Office of Public Health FOPH
  telecom:
    system:
      v: url
    value:
      v: https://www.bag.admin.ch/bag/en/home/das-bag/kontakt-standort.html
description:
  v: This profile represents the constraint applied to the CodeableConcept data type by this IG to use the 'CH ELM CodeableConcept' data type profile.
jurisdiction:
  coding:
    system:
      v: urn:iso:std:iso:3166
    code:
      v: CH
copyright:
  v: CC0-1.0
fhir version:
  v: 4.0.1
mapping:
  identity:
    v: v2
  uri:
    v: http://hl7.org/v2
  name:
    v: HL7 v2 Mapping
mapping:
  identity:
    v: rim
  uri:
    v: http://hl7.org/v3
  name:
    v: RIM Mapping
mapping:
  identity:
    v: orim
  uri:
    v: http://hl7.org/orim
  name:
    v: Ontological RIM Mapping
kind:
  v: complex-type
abstract:
  v: false
type:
  v: CodeableConcept
base definition:
  v: http://hl7.org/fhir/uv/ips/StructureDefinition/CodeableConcept-uv-ips
  link: http://hl7.org/fhir/uv/ips/StructureDefinition/CodeableConcept-uv-ips
derivation:
  v: constraint
snapshot:
  extension:
    url:
      v: http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version
    value: string
      v: 1.1.0
  element:
    id:
      v: CodeableConcept
    path:
      v: CodeableConcept
    short:
      v: Concept - reference to a terminology or just text
    definition:
      v: A concept that may be defined by a formal reference to a terminology or ontology or may be provided by text.
    comment:
      v: Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.
    min:
      v: 0
    max:
      v: *
    base:
      path:
        v: CodeableConcept
      min:
        v: 0
      max:
        v: *
    condition:
      v: ele-1
    constraint:
      key:
        v: ele-1
      severity:
        v: error
      human:
        v: All FHIR elements must have a @value or children
      expression:
        v: hasValue() or (children().count() > id.count())
      xpath:
        v: @value|f:*|h:div
      source:
        v: http://hl7.org/fhir/StructureDefinition/Element
        link: http://hl7.org/fhir/StructureDefinition/Element
    is modifier:
      v: false
    mapping:
      identity:
        v: rim
      map:
        v: n/a
    mapping:
      identity:
        v: v2
      map:
        v: CE/CNE/CWE
    mapping:
      identity:
        v: rim
      map:
        v: CD
    mapping:
      identity:
        v: orim
      map:
        v: fhir:CodeableConcept rdfs:subClassOf dt:CD
  element:
    id:
      v: CodeableConcept.id
    path:
      v: CodeableConcept.id
    representation:
      v: xmlAttr
    short:
      v: Unique id for inter-element referencing
    definition:
      v: Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
    min:
      v: 0
    max:
      v: 1
    base:
      path:
        v: Element.id
      min:
        v: 0
      max:
        v: 1
    type:
      extension:
        value: url
      code:
        v: http://hl7.org/fhirpath/System.String
    is modifier:
      v: false
    is summary:
      v: false
    mapping:
      identity:
        v: rim
      map:
        v: n/a
  element:
    id:
      v: CodeableConcept.extension
    path:
      v: CodeableConcept.extension
    slicing:
      description:
        v: Extensions are always sliced by (at least) url
      rules:
        v: open
    short:
      v: Additional content defined by implementations
    definition:
      v: May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
    comment:
      v: There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
    alias:
      v: extensions
    alias:
      v: user content
    min:
      v: 0
    max:
      v: *
    base:
      path:
        v: Element.extension

url
v: string

v: value

v: url

v: 0

v: *

code:
  v: Extension

key:
  v: ele-1
severity:
  v: error
human:
  v: All FHIR elements must have a @value or children
expression:
  v: hasValue() or (children().count() > id.count())
xpath:
  v: @value|f:*|h:div
source:
  v: http://hl7.org/fhir/StructureDefinition/Element
  link: http://hl7.org/fhir/StructureDefinition/Element

key:
  v: ext-1
severity:
  v: error
human:
  v: Must have either extensions or value[x], not both
expression:
  v: extension.exists() != value.exists()
xpath:
  v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
source:
  v: http://hl7.org/fhir/StructureDefinition/Extension
  link: http://hl7.org/fhir/StructureDefinition/Extension

v: false

v: false

identity:
  v: rim
map:
  v: n/a

id:
  v: CodeableConcept.coding
path:
  v: CodeableConcept.coding
short:
  v: A reference to a code defined by a terminology system
definition:
  v: A reference to a code defined by a terminology system.
comment:
  v: Codes may be defined very casually in enumerations or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information.
requirements:
  v: Allows for alternative encodings within a code system, and translations to other code systems.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: CodeableConcept.coding
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Coding
  profile:
    v: http://fhir.ch/ig/ch-elm/StructureDefinition/ch-elm-coding
    link: http://fhir.ch/ig/ch-elm/StructureDefinition/ch-elm-coding
condition:
  v: ele-1
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    link: http://hl7.org/fhir/StructureDefinition/Element
must support:
  v: true
is modifier:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: n/a
mapping:
  identity:
    v: v2
  map:
    v: CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
mapping:
  identity:
    v: rim
  map:
    v: CV
mapping:
  identity:
    v: orim
  map:
    v: fhir:Coding rdfs:subClassOf dt:CDCoding

id:
  v: CodeableConcept.text
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/elementdefinition-translatable
  value: boolean
    v: true
path:
  v: CodeableConcept.text
short:
  v: Plain text representation of the concept
definition:
  v: A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.
comment:
  v: Very often the text is the same as a displayName of one of the codings.
requirements:
  v: The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: CodeableConcept.text
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  xpath:
    v: @value|f:*|h:div
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    link: http://hl7.org/fhir/StructureDefinition/Element
must support:
  v: true
is modifier:
  v: false
is summary:
  v: true
mapping:
  identity:
    v: v2
  map:
    v: C*E.9. But note many systems use C*E.2 for this
mapping:
  identity:
    v: rim
  map:
    v: ./originalText[mediaType/code="text/plain"]/data
mapping:
  identity:
    v: orim
  map:
    v: fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

element:
  id:
    v: CodeableConcept.coding
  path:
    v: CodeableConcept.coding
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: Coding
    profile:
      v: http://fhir.ch/ig/ch-elm/StructureDefinition/ch-elm-coding
      link: http://fhir.ch/ig/ch-elm/StructureDefinition/ch-elm-coding