MII-Initiative

MII IG Onkologie DE v2024

TNM-Klassifikation: Observation

Dieses Profil ist das Gruppierungsprofil für eine TNM-Klassifikation in der Onkologie.

Das Profil enthält das Referenzdatum und dient als Ankerpunkt für alle weiteren TNM-Einzelbeobachtungen zu diesem Zeitpunkt. Das Element hasMember enthält Referenzen zu allen verbundenen TNM-Einzelbeobachtungen.

Außerdem wird im Element value das UICC-Staging kodiert, dass von den untergeordneten TNM-Beobachtungen abgeleitet ist.

NameStatusVersionCanonicalBasis
MII_PR_Onko_TNM_Klassifikationdraft2024.0.0-ballothttps://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-tnm-klassifikationhttp://hl7.org/fhir/StructureDefinition/Observation

Inhalt

idΣ0..1string
id0..1string
extensionI0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceΣ0..1uri
profileS Σ0..*canonical(StructureDefinition)
securityΣ0..*CodingBinding
tagΣ0..*Coding
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
identifierΣ0..*Identifier
basedOnΣ I0..*Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)
partOfΣ I0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy)
statusS Σ ?!1..1codeBinding
category0..*CodeableConceptBinding
codeS Σ1..1CodeableConceptBinding
subjectS Σ I1..1Reference(Patient)
focusS Σ I0..*Reference(MII_PR_Onko_Diagnose)
encounterS Σ I0..1Reference(Encounter)
effectiveDateTimedateTime
issuedΣ0..1instant
performerΣ I0..*Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uri
versionΣ0..1string
codeS Σ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
dataAbsentReasonI0..1CodeableConceptBinding
interpretation0..*CodeableConceptBinding
note0..*Annotation
bodySite0..1CodeableConcept
methodS0..1CodeableConceptBinding
specimenI0..1Reference(Specimen)
deviceI0..1Reference(Device | DeviceMetric)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
lowI0..1SimpleQuantity
highI0..1SimpleQuantity
type0..1CodeableConceptBinding
appliesTo0..*CodeableConcept
ageI0..1Range
text0..1string
hasMemberS Σ I0..*Reference(Observation | QuestionnaireResponse | MolecularSequence)
derivedFromΣ I0..*Reference(DocumentReference | ImagingStudy | Media | QuestionnaireResponse | Observation | MolecularSequence)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
codeΣ1..1CodeableConcept
valueQuantityQuantity
valueCodeableConceptCodeableConcept
valueStringstring
valueBooleanboolean
valueIntegerinteger
valueRangeRange
valueRatioRatio
valueSampledDataSampledData
valueTimetime
valueDateTimedateTime
valuePeriodPeriod
dataAbsentReasonI0..1CodeableConceptBinding
interpretation0..*CodeableConceptBinding
referenceRange0..*see (referenceRange)

TNM-Klassifikation: Grouper-Profil für Komponenten der TNM-Klassifikation.

FeldnameKurzbeschreibung
Observation.meta.profile
Observation.status
Observation.code
Observation.subject
Observation.focus
Observation.encounter
Observation.effective[x]
Observation.value[x]UICC Stadium
Observation.value[x].coding.system
Observation.value[x].coding.code
Observation.methodTNM Version
Observation.hasMember
<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="mii-pr-onko-tnm-klassifikation" />
    <url value="https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-tnm-klassifikation" />
    <version value="2024.0.0-ballot" />
    <name value="MII_PR_Onko_TNM_Klassifikation" />
    <title value="MII PR Onkologie TNM-Klassifikation" />
    <status value="draft" />
    <publisher value="Medizininformatik Initiative" />
    <contact>
        <telecom>
            <system value="url" />
            <value value="https://www.medizininformatik-initiative.de" />
        </telecom>
    </contact>
    <description value="TNM-Klassifikation: Grouper-Profil f&#252;r Komponenten der TNM-Klassifikation." />
    <fhirVersion value="4.0.1" />
    <mapping>
        <identity value="oBDS" />
        <name value="Mapping FHIR zu oBDS" />
    </mapping>
    <kind value="resource" />
    <abstract value="false" />
    <type value="Observation" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Observation" />
    <derivation value="constraint" />
    <differential>
        <element id="Observation.meta.profile">
            <path value="Observation.meta.profile" />
            <mustSupport value="true" />
        </element>
        <element id="Observation.status">
            <path value="Observation.status" />
            <mustSupport value="true" />
        </element>
        <element id="Observation.code">
            <path value="Observation.code" />
            <mustSupport value="true" />
            <binding>
                <strength value="required" />
                <valueSet value="https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/ValueSet/mii-vs-onko-tnm-klassifikation-typ" />
            </binding>
        </element>
        <element id="Observation.subject">
            <path value="Observation.subject" />
            <min value="1" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Patient" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="Observation.focus">
            <path value="Observation.focus" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-diagnose" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="Observation.encounter">
            <path value="Observation.encounter" />
            <mustSupport value="true" />
        </element>
        <element id="Observation.effective[x]">
            <path value="Observation.effective[x]" />
            <type>
                <code value="dateTime" />
            </type>
            <constraint>
                <key value="tnm-datum" />
                <severity value="error" />
                <human value="TNM Datum: Ein exaktes (taggenaues) Datum ist anzugeben." />
                <expression value="$this.toString().length() &gt;= 8" />
                <source value="https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-tnm-klassifikation" />
            </constraint>
            <mustSupport value="true" />
            <mapping>
                <identity value="oBDS" />
                <map value="8.1" />
                <comment value="TNM Datum" />
            </mapping>
        </element>
        <element id="Observation.value[x]">
            <path value="Observation.value[x]" />
            <short value="UICC Stadium" />
            <definition value="Stadium nach aktuell g&#252;ltiger TNM-Klassifikation." />
            <type>
                <code value="CodeableConcept" />
            </type>
            <mustSupport value="true" />
            <binding>
                <strength value="required" />
                <valueSet value="https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/ValueSet/mii-vs-onko-tnm-uicc-stadium" />
            </binding>
        </element>
        <element id="Observation.value[x].coding.system">
            <path value="Observation.value[x].coding.system" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="Observation.value[x].coding.code">
            <path value="Observation.value[x].coding.code" />
            <min value="1" />
            <mustSupport value="true" />
            <mapping>
                <identity value="oBDS" />
                <map value="8.17" />
                <comment value="UICC Stadium" />
            </mapping>
        </element>
        <element id="Observation.method">
            <path value="Observation.method" />
            <short value="TNM Version" />
            <definition value="Gibt an, nach welcher Version des TNM klassifiziert wurde." />
            <mustSupport value="true" />
            <binding>
                <strength value="required" />
                <valueSet value="https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/ValueSet/mii-vs-onko-tnm-version" />
            </binding>
            <mapping>
                <identity value="oBDS" />
                <map value="8.2" />
                <comment value="TNM Version" />
            </mapping>
        </element>
        <element id="Observation.hasMember">
            <path value="Observation.hasMember" />
            <mustSupport value="true" />
        </element>
    </differential>
</StructureDefinition>
{
    "resourceType": "StructureDefinition",
    "id": "mii-pr-onko-tnm-klassifikation",
    "url": "https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-tnm-klassifikation",
    "version": "2024.0.0-ballot",
    "name": "MII_PR_Onko_TNM_Klassifikation",
    "title": "MII PR Onkologie TNM-Klassifikation",
    "status": "draft",
    "publisher": "Medizininformatik Initiative",
    "contact":  [
        {
            "telecom":  [
                {
                    "system": "url",
                    "value": "https://www.medizininformatik-initiative.de"
                }
            ]
        }
    ],
    "description": "TNM-Klassifikation: Grouper-Profil für Komponenten der TNM-Klassifikation.",
    "fhirVersion": "4.0.1",
    "mapping":  [
        {
            "identity": "oBDS",
            "name": "Mapping FHIR zu oBDS"
        }
    ],
    "kind": "resource",
    "abstract": false,
    "type": "Observation",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Observation",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "Observation.meta.profile",
                "path": "Observation.meta.profile",
                "mustSupport": true
            },
            {
                "id": "Observation.status",
                "path": "Observation.status",
                "mustSupport": true
            },
            {
                "id": "Observation.code",
                "path": "Observation.code",
                "mustSupport": true,
                "binding": {
                    "strength": "required",
                    "valueSet": "https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/ValueSet/mii-vs-onko-tnm-klassifikation-typ"
                }
            },
            {
                "id": "Observation.subject",
                "path": "Observation.subject",
                "min": 1,
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Patient"
                        ]
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "Observation.focus",
                "path": "Observation.focus",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-diagnose"
                        ]
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "Observation.encounter",
                "path": "Observation.encounter",
                "mustSupport": true
            },
            {
                "id": "Observation.effective[x]",
                "path": "Observation.effective[x]",
                "type":  [
                    {
                        "code": "dateTime"
                    }
                ],
                "constraint":  [
                    {
                        "key": "tnm-datum",
                        "severity": "error",
                        "human": "TNM Datum: Ein exaktes (taggenaues) Datum ist anzugeben.",
                        "expression": "$this.toString().length() >= 8",
                        "source": "https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-tnm-klassifikation"
                    }
                ],
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "oBDS",
                        "map": "8.1",
                        "comment": "TNM Datum"
                    }
                ]
            },
            {
                "id": "Observation.value[x]",
                "path": "Observation.value[x]",
                "short": "UICC Stadium",
                "definition": "Stadium nach aktuell gültiger TNM-Klassifikation.",
                "type":  [
                    {
                        "code": "CodeableConcept"
                    }
                ],
                "mustSupport": true,
                "binding": {
                    "strength": "required",
                    "valueSet": "https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/ValueSet/mii-vs-onko-tnm-uicc-stadium"
                }
            },
            {
                "id": "Observation.value[x].coding.system",
                "path": "Observation.value[x].coding.system",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "Observation.value[x].coding.code",
                "path": "Observation.value[x].coding.code",
                "min": 1,
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "oBDS",
                        "map": "8.17",
                        "comment": "UICC Stadium"
                    }
                ]
            },
            {
                "id": "Observation.method",
                "path": "Observation.method",
                "short": "TNM Version",
                "definition": "Gibt an, nach welcher Version des TNM klassifiziert wurde.",
                "mustSupport": true,
                "binding": {
                    "strength": "required",
                    "valueSet": "https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/ValueSet/mii-vs-onko-tnm-version"
                },
                "mapping":  [
                    {
                        "identity": "oBDS",
                        "map": "8.2",
                        "comment": "TNM Version"
                    }
                ]
            },
            {
                "id": "Observation.hasMember",
                "path": "Observation.hasMember",
                "mustSupport": true
            }
        ]
    }
}

Mapping Datensatz zu FHIR

DatensatzErklaerungFHIR
TNM-Klassifikation

TNM-Klassifikation

TNM Datum

Gibt an, auf welches Datum sich die TNM-Klassifikation bezieht.

Observation.effectiveDateTime
TNM Version

Gibt an, nach welcher Version des TNM klassifiziert wurde.

Observation.method
TNM y-Symbol

Gibt an, ob die Klassifikation während oder nach initialer multimodaler Therapie erfolgte.

Observation.valueCodeableConcept.coding.code
TNM r-Symbol

Gibt an, ob die Klassifikation ein Rezidiv beurteilt.

Observation.valueCodeableConcept.coding.code
TNM a-Symbol

Gibt an, ob die Klassifikation aus Anlass einer Autopsie erfolgte.

Observation.valueCodeableConcept.coding.code
TNM c/p-Präfix T

Gibt an, ob die Klassifikation klinisch oder pathologisch erfolgte.

Observation.code.extension.where(url='https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-ex-onko-tnm-cp-praefix').value.coding.code
TNM c/p-Präfix N

Gibt an, ob die Klassifikation klinisch oder pathologisch erfolgte.

Observation.code.extension.where(url='https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-ex-onko-tnm-cp-praefix').value.coding.code
TNM c/p-Präfix M

Gibt an, ob die Klassifikation klinisch oder pathologisch erfolgte.

Observation.code.extension.where(url='https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-ex-onko-tnm-cp-praefix').value.coding.code
TNM T-Kategorie

Ausbreitung des Primärtumors, erfolgt gemäß Tumorentität nach TNM.

Observation.valueCodeableConcept.coding.code
TNM m-Symbol

Kennzeichnet Vorhandensein multipler Primärtumoren in einem anatomischen Bezirk.

Observation.valueCodeableConcept.coding.code
TNM M-Kategorie

Fehlen oder Vorhandensein von Fernmetastasen, gemäß Tumorentität nach TNM.

Observation.valueCodeableConcept.coding.code
TNM N-Kategorie

Ausbreitung von regionären Lymphknotenmetastasen, erfolgt gemäß Tumorentität nach TNM.

Observation.valueCodeableConcept.coding.code
TNM L-Kategorie

Lymphgefäßinvasion.

Observation.valueCodeableConcept.coding.code
TNM V-Kategorie

Veneninvasion.

Observation.valueCodeableConcept.coding.code
TNM Pn-Kategorie

Perineuralinvasion.

Observation.valueCodeableConcept.coding.code
TNM S-Kategorie

Serumtumormarker.

Observation.valueCodeableConcept.coding.code
UICC Stadium

Stadium nach aktuell gültiger TNM-Klassifikation.

Observation.valueCodeableConcept.coding.code

Mapping Einheitlicher onkologischer Basisdatensatz (oBDS) zu FHIR

oBDSDefinitionFHIR
8.1TNM DatumObservation.effective[x]
8.17UICC StadiumObservation.value[x].coding.code
8.2TNM VersionObservation.method

Suchparameter

Folgende Suchparameter sind für das Modul Onkologie relevant, auch in Kombination:

  1. Der Suchparameter _id MUSS unterstützt werden:

    Beispiele:

    GET [base]/Observation?_id=1234

    Anwendungshinweise: Weitere Informationen zur Suche nach "_id" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".

  2. Der Suchparameter "_profile" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Observation?_profile=https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-tnm-klassifikation

    Anwendungshinweise: Weitere Informationen zur Suche nach "_profile" finden sich in der FHIR-Basisspezifikation - Abschnitt "token".

  3. Der Suchparameter "status" MUSS unterstützt werden:

    Beispiele:

    Anwendungshinweise: Weitere Informationen zur Suche nach "status" finden sich in der FHIR-Basisspezifikation - Abschnitt "token".```
  4. Der Suchparameter "code" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Observation?code=http://fhir.de/CodeSystem/sct|184305005

    Anwendungshinweise: Weitere Informationen zur Suche nach "code" finden sich in der FHIR-Basisspezifikation - Abschnitt "token".

  5. Der Suchparameter "subject" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Observation?subject=Patient/example

    Anwendungshinweise: Weitere Informationen zur Suche nach "subject" finden sich in der FHIR-Basisspezifikation - Abschnitt "reference".

  6. Der Suchparameter "focus" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Observation?focus=Condition/example

    Anwendungshinweise: Weitere Informationen zur Suche nach "focus" finden sich in der FHIR-Basisspezifikation - Abschnitt "reference".

  7. Der Suchparameter "encounter" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Observation?encounter=Encounter/example

    Anwendungshinweise: Weitere Informationen zur Suche nach "encounter" finden sich in der FHIR-Basisspezifikation - Abschnitt "reference".

  8. Der Suchparameter "date" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Observation?date=2024-02-08

    Anwendungshinweise: Weitere Informationen zur Suche nach "date" finden sich in der FHIR-Basisspezifikation - Abschnitt "date".

  9. Der Suchparameter "method" MUSS unterstützt werden:

    Beispiele:

    Anwendungshinweise: Weitere Informationen zur Suche nach "method" finden sich in der FHIR-Basisspezifikation - Abschnitt "token".```
  10. Der Suchparameter "has-member" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Observation?has-member=Observation/example

    Anwendungshinweise: Weitere Informationen zur Suche nach "has-member" finden sich in der FHIR-Basisspezifikation - Abschnitt "reference".

  11. Der Suchparameter "derived-from" MUSS unterstützt werden:

    Beispiele:

    GET [base]/Observation?derived-from=Observation/example

    Anwendungshinweise: Weitere Informationen zur Suche nach "derived-from" finden sich in der FHIR-Basisspezifikation - Abschnitt "reference".

Beispiele

{
    "resourceType": "Observation",
    "id": "mii-exa-onko-tnm-klassifikation-TisN0M0",
    "meta": {
        "profile":  [
            "https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-tnm-klassifikation"
        ]
    },
    "status": "final",
    "code": {
        "coding":  [
            {
                "code": "399537006",
                "system": "http://snomed.info/sct",
                "display": "Clinical TNM stage grouping"
            }
        ]
    },
    "subject": {
        "reference": "Patient/example"
    },
    "effectiveDateTime": "2024-01-11",
    "method": {
        "coding":  [
            {
                "code": "8",
                "system": "https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/CodeSystem/mii-cs-onko-tnm-version",
                "display": "8. Auflage"
            }
        ]
    },
    "hasMember":  [
        {
            "reference": "Observation/mii-exa-onko-tnm-t-kategorie-Tis"
        },
        {
            "reference": "Observation/mii-exa-onko-tnm-n-kategorie-N0"
        },
        {
            "reference": "Observation/mii-exa-onko-tnm-m-kategorie-M0"
        }
    ],
    "valueCodeableConcept": {
        "coding":  [
            {
                "code": "0",
                "system": "https://www.uicc.org/resources/tnm",
                "display": "Stadium 0"
            }
        ]
    }
}

{
    "resourceType": "Observation",
    "id": "mii-exa-onko-tnm-klassifikation-uT2a2pN0023i-sncM1",
    "meta": {
        "profile":  [
            "https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-tnm-klassifikation"
        ]
    },
    "status": "final",
    "code": {
        "coding":  [
            {
                "code": "399588009",
                "system": "http://snomed.info/sct",
                "display": "Pathologic TNM stage grouping"
            }
        ]
    },
    "subject": {
        "reference": "Patient/example"
    },
    "effectiveDateTime": "2024-01-11",
    "method": {
        "coding":  [
            {
                "code": "8",
                "system": "https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/CodeSystem/mii-cs-onko-tnm-version",
                "display": "8. Auflage"
            }
        ]
    },
    "hasMember":  [
        {
            "reference": "Observation/mii-exa-onko-tnm-t-kategorie-uT2a2"
        },
        {
            "reference": "Observation/mii-exa-onko-tnm-n-kategorie-pN0i-sn"
        },
        {
            "reference": "Observation/mii-exa-onko-anzahl-befallene-lymphknoten-0"
        },
        {
            "reference": "Observation/mii-exa-onko-anzahl-untersuchte-lymphknoten-23"
        },
        {
            "reference": "Observation/mii-exa-onko-tnm-n-kategorie-pN0i-sn"
        },
        {
            "reference": "Observation/mii-exa-onko-tnm-m-kategorie-cM1"
        }
    ],
    "valueCodeableConcept": {
        "coding":  [
            {
                "code": "IVC",
                "system": "https://www.uicc.org/resources/tnm",
                "display": "Stage IVC"
            }
        ]
    }
}