HL7 Europe Common Cancer Model
0.1.0 - ci-build 150

HL7 Europe Common Cancer Model, published by HL7 Europe. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-eu/cancer-common/ and changes regularly. See the Directory of published versions

Logical Model: ClinicalCancerProgression - Detailed Descriptions

Draft as of 2026-05-13

Definitions for the ClinicalCancerProgression logical model.

Guidance on how to interpret the contents of this table can be foundhere

0. ClinicalCancerProgression
Definition

Logical model representing the longitudinal evolution of the cancer disease, documenting disease status and extent at a specific point in time. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet ClinicalCancerProgression).

ShortClinicalCancerProgression
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
Invariantsccp-1: LocoRegionalSites must be present if ExtentType is Loco-regional (extentType.coding.where(code = 'Loco-regional').exists() implies locoRegionalSites.exists())
ccp-2: MetastaticSites must be present if ExtentType is Metastatic (extentType.coding.where(code = 'Metastatic').exists() implies metastaticSites.exists())
2. ClinicalCancerProgression.cancerConditionAtDiagnosisReference
Definition

Reference to the original cancer condition at diagnosis to which this progression refers.

ShortCancerConditionReference
Control1..1
TypeReference(CancerConditionAtDiagnosis)
4. ClinicalCancerProgression.diseaseStatus
Definition

Disease status at this time point (e.g. progression, stable disease, remission, recurrence).

ShortDiseaseStatus
Comments

Choice: Progression | Stable Disease | Partial Remission | Complete Remission | Recurrence

Control1..1
TypeCodeableConcept
6. ClinicalCancerProgression.tumourGradeSystem
Definition

Classification system used to define tumour grade, describing how abnormal tumour cells and tissue appear under microscopic examination (e.g. Gleason for prostate cancer, FNCLCC for soft tissue sarcomas). The grading system provides an indication of the biological aggressiveness of the tumour.

ShortTumourGradeSystem
Control0..1
TypeCodeableConcept
8. ClinicalCancerProgression.tumourGradeValue
Definition

Grade value assigned according to the selected TumourGradeSystem. The grade reflects the degree of cellular differentiation and biological aggressiveness of the tumour and may evolve over time.

ShortTumourGradeValue
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
10. ClinicalCancerProgression.assertedDate
Definition

Date when this progression/status was asserted/recorded.

ShortAssertedDate
Control1..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
12. ClinicalCancerProgression.extentType
Definition

Extent of disease at this time point (Local, Loco-regional, Metastatic).

ShortExtentType
Comments

Choice: Local | Loco-regional | Metastatic

Control0..1
TypeCodeableConcept
14. ClinicalCancerProgression.locoRegionalSites
Definition

Sites involved when ExtentType is Loco-regional.

ShortLocoRegionalSites
Comments

It must be present if the ExtentType is Loco-regional

Control0..*
TypeCodeableConcept
16. ClinicalCancerProgression.metastaticSites
Definition

Sites involved when ExtentType is Metastatic.

ShortMetastaticSites
Comments

It must be present if the ExtentType is Metastatic

Control0..*
TypeCodeableConcept

Guidance on how to interpret the contents of this table can be foundhere

0. ClinicalCancerProgression
Definition

Logical model representing the longitudinal evolution of the cancer disease, documenting disease status and extent at a specific point in time. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet ClinicalCancerProgression).

ShortClinicalCancerProgression
Logical ModelInstances of this logical model are not marked to be the target of a Reference
Invariantsccp-1: LocoRegionalSites must be present if ExtentType is Loco-regional (extentType.coding.where(code = 'Loco-regional').exists() implies locoRegionalSites.exists())
ccp-2: MetastaticSites must be present if ExtentType is Metastatic (extentType.coding.where(code = 'Metastatic').exists() implies metastaticSites.exists())
2. ClinicalCancerProgression.cancerConditionAtDiagnosisReference
Definition

Reference to the original cancer condition at diagnosis to which this progression refers.

ShortCancerConditionReference
Control1..1
TypeReference(CancerConditionAtDiagnosis)
4. ClinicalCancerProgression.diseaseStatus
Definition

Disease status at this time point (e.g. progression, stable disease, remission, recurrence).

ShortDiseaseStatus
Comments

Choice: Progression | Stable Disease | Partial Remission | Complete Remission | Recurrence

Control1..1
TypeCodeableConcept
6. ClinicalCancerProgression.tumourGradeSystem
Definition

Classification system used to define tumour grade, describing how abnormal tumour cells and tissue appear under microscopic examination (e.g. Gleason for prostate cancer, FNCLCC for soft tissue sarcomas). The grading system provides an indication of the biological aggressiveness of the tumour.

ShortTumourGradeSystem
Control0..1
TypeCodeableConcept
8. ClinicalCancerProgression.tumourGradeValue
Definition

Grade value assigned according to the selected TumourGradeSystem. The grade reflects the degree of cellular differentiation and biological aggressiveness of the tumour and may evolve over time.

ShortTumourGradeValue
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
10. ClinicalCancerProgression.assertedDate
Definition

Date when this progression/status was asserted/recorded.

ShortAssertedDate
Control1..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
12. ClinicalCancerProgression.extentType
Definition

Extent of disease at this time point (Local, Loco-regional, Metastatic).

ShortExtentType
Comments

Choice: Local | Loco-regional | Metastatic

Control0..1
TypeCodeableConcept
14. ClinicalCancerProgression.locoRegionalSites
Definition

Sites involved when ExtentType is Loco-regional.

ShortLocoRegionalSites
Comments

It must be present if the ExtentType is Loco-regional

Control0..*
TypeCodeableConcept
16. ClinicalCancerProgression.metastaticSites
Definition

Sites involved when ExtentType is Metastatic.

ShortMetastaticSites
Comments

It must be present if the ExtentType is Metastatic

Control0..*
TypeCodeableConcept

Guidance on how to interpret the contents of this table can be foundhere

0. ClinicalCancerProgression
Definition

Logical model representing the longitudinal evolution of the cancer disease, documenting disease status and extent at a specific point in time. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet ClinicalCancerProgression).

ShortClinicalCancerProgression
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
Invariantsccp-1: LocoRegionalSites must be present if ExtentType is Loco-regional (extentType.coding.where(code = 'Loco-regional').exists() implies locoRegionalSites.exists())
ccp-2: MetastaticSites must be present if ExtentType is Metastatic (extentType.coding.where(code = 'Metastatic').exists() implies metastaticSites.exists())
2. ClinicalCancerProgression.cancerConditionAtDiagnosisReference
Definition

Reference to the original cancer condition at diagnosis to which this progression refers.

ShortCancerConditionReference
Control1..1
TypeReference(CancerConditionAtDiagnosis)
4. ClinicalCancerProgression.diseaseStatus
Definition

Disease status at this time point (e.g. progression, stable disease, remission, recurrence).

ShortDiseaseStatus
Comments

Choice: Progression | Stable Disease | Partial Remission | Complete Remission | Recurrence

Control1..1
TypeCodeableConcept
6. ClinicalCancerProgression.tumourGradeSystem
Definition

Classification system used to define tumour grade, describing how abnormal tumour cells and tissue appear under microscopic examination (e.g. Gleason for prostate cancer, FNCLCC for soft tissue sarcomas). The grading system provides an indication of the biological aggressiveness of the tumour.

ShortTumourGradeSystem
Control0..1
TypeCodeableConcept
8. ClinicalCancerProgression.tumourGradeValue
Definition

Grade value assigned according to the selected TumourGradeSystem. The grade reflects the degree of cellular differentiation and biological aggressiveness of the tumour and may evolve over time.

ShortTumourGradeValue
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
10. ClinicalCancerProgression.assertedDate
Definition

Date when this progression/status was asserted/recorded.

ShortAssertedDate
Control1..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
12. ClinicalCancerProgression.extentType
Definition

Extent of disease at this time point (Local, Loco-regional, Metastatic).

ShortExtentType
Comments

Choice: Local | Loco-regional | Metastatic

Control0..1
TypeCodeableConcept
14. ClinicalCancerProgression.locoRegionalSites
Definition

Sites involved when ExtentType is Loco-regional.

ShortLocoRegionalSites
Comments

It must be present if the ExtentType is Loco-regional

Control0..*
TypeCodeableConcept
16. ClinicalCancerProgression.metastaticSites
Definition

Sites involved when ExtentType is Metastatic.

ShortMetastaticSites
Comments

It must be present if the ExtentType is Metastatic

Control0..*
TypeCodeableConcept