description: This Age Observation represents the subject's precise age at onset of an event or observation. The age of a relative in a Family History Observation at the time of that observation could also be inferred by comparing RelatedSubject/subject/birthTime with Observation/effectiveTime. However, a common scenario is that a patient will know the age of a relative when the relative had a certain condition or when the relative died, but will not know the actual year (e.g., \"grandpa died of a heart attack at the age of 50\"). Often times, neither precise dates nor ages are known (e.g., \"cousin died of congenital heart disease as an infant\"). This template can only be used for precise ages.  Imprecise ages should be conveyed via the [Age Range Observation](StructureDefinition-AgeRangeObservation.html).
package_name: rs/hl7.cda.us.ccda
derivation: constraint
name: AgeObservation
type: http://hl7.org/cda/stds/core/StructureDefinition/Observation
elements:
  templateId:
    index: 0
    slicing:
      rules: open
      discriminator:
      - {path: root, type: value}
      min: 1
      slices:
        age-obs:
          match: {root: 2.16.840.1.113883.10.20.22.4.31}
          schema:
            _required: true
            index: 1
            elements:
              root:
                pattern: {type: string, value: 2.16.840.1.113883.10.20.22.4.31}
                type: string
                index: 2
              extension: {index: 3}
            required: [root]
            extensions: {}
  classCode:
    pattern: {type: code, value: OBS}
    type: code
    index: 4
  moodCode:
    pattern: {type: code, value: EVN}
    type: code
    index: 5
  code:
    short: Age at onset of clinical finding
    index: 6
    elements:
      code:
        pattern: {type: code, value: '445518008'}
        type: code
        index: 7
      codeSystem:
        short: SNOMED CT
        pattern: {type: string, value: 2.16.840.1.113883.6.96}
        type: string
        index: 8
    required: [code, codeSystem]
  text:
    short: SHOULD reference the portion of section narrative text corresponding to this entry
    index: 9
    elements:
      reference:
        constraint:
          value-starts-octothorpe: {human: 'If reference/@value is present, it SHALL begin with a ''#'' and SHALL point to its corresponding narrative', source: 'http://hl7.org/cda/us/ccda/StructureDefinition/AgeObservation', severity: error, expression: value.exists() implies value.startsWith('#')}
        index: 10
  statusCode:
    index: 11
    elements:
      code:
        pattern: {type: code, value: completed}
        type: code
        index: 12
    required: [code]
  value:
    type: http://hl7.org/cda/stds/core/StructureDefinition/PQ
    index: 13
    elements:
      unit:
        binding: {strength: required, valueSet: 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.11.20.9.21'}
        index: 14
    required: [unit]
package_version: 4.0.0
class: logical
kind: logical
url: http://hl7.org/cda/us/ccda/StructureDefinition/AgeObservation
base: http://hl7.org/cda/stds/core/StructureDefinition/Observation
version: 4.0.0
required: [statusCode, templateId, value]