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: CancerConditionAtDiagnosis - Detailed Descriptions

Draft as of 2026-05-13

Definitions for the CancerConditionAtDiagnosis logical model.

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

0. CancerConditionAtDiagnosis
Definition

Logical model representing the cancer condition at first diagnosis, capturing initial tumour characteristics and the diagnostic context that initiates the cancer journey. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerConditionAtDiagnosis).

ShortCancerConditionAtDiagnosis
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
Invariantsccad-1: At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. ((visitDate | biopsyDate | imagingDate | labReportDate).exists())
2. CancerConditionAtDiagnosis.subject
Definition

Reference to the patient (subject) affected by the cancer condition at first diagnosis.

ShortSubject
Control1..1
Typehttp://hl7.eu/fhir/cancer-common/StructureDefinition/CancerPatient
4. CancerConditionAtDiagnosis.histologyBehaviour
Definition

Histology and behaviour of the neoplasm at first diagnosis. Histology describes the tumour cell type (morphology), while behaviour indicates whether the tumour is malignant, benign, carcinoma in situ, or of uncertain/borderline malignancy. This information may be unavailable during early diagnostic workup (e.g., before biopsy results are final) but is expected to be present once the diagnostic workup is completed.

ShortHistologyBehaviour
Comments

WG recommends ICD03, the WG will monitor possible next versions. This attribute becomes mandatory once the cancer has been diagnosed; however, during the diagnostic workup it may still be absent, as the biopsy resulting from the surgery may not yet be available.

Control0..1
TypeCodeableConcept
6. CancerConditionAtDiagnosis.bodySite
Definition

Primary anatomical site where the cancer condition was first detected.

ShortBodySite
Comments

WG recommends ICD03, the WG will monitor possible next versions. It is required to choose the most specific code available, meaning the most detailed code in the hierarchical terminology that precisely identifies the body site.

Control1..1
TypeCodeableConcept
8. CancerConditionAtDiagnosis.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
Comments

It represents the classification system used to define the tumour grade, such as Gleason (a grading system for prostate cancer) or FNCLCC (a grading system for soft tissue sarcomas).

Control0..1
TypeCodeableConcept
10. CancerConditionAtDiagnosis.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
Comments

It represents the measured grade value based on the specific classification defined in the TumourGradeSystem.

Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
12. CancerConditionAtDiagnosis.visitDate
Definition

Date of the clinical visit that established the diagnosis (one of the diagnosis dates).

ShortVisitDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
14. CancerConditionAtDiagnosis.biopsyDate
Definition

Date of the biopsy supporting the diagnosis (one of the diagnosis dates).

ShortBiopsyDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
16. CancerConditionAtDiagnosis.imagingDate
Definition

Date of the diagnostic imaging supporting the diagnosis (one of the diagnosis dates).

ShortImagingDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
18. CancerConditionAtDiagnosis.labReportDate
Definition

Date of the laboratory report supporting the diagnosis, including biomarkers when applicable.

ShortLabReportDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension

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

0. CancerConditionAtDiagnosis
Definition

Logical model representing the cancer condition at first diagnosis, capturing initial tumour characteristics and the diagnostic context that initiates the cancer journey. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerConditionAtDiagnosis).

ShortCancerConditionAtDiagnosis
Logical ModelInstances of this logical model are not marked to be the target of a Reference
Invariantsccad-1: At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. ((visitDate | biopsyDate | imagingDate | labReportDate).exists())
2. CancerConditionAtDiagnosis.subject
Definition

Reference to the patient (subject) affected by the cancer condition at first diagnosis.

ShortSubject
Control1..1
Typehttp://hl7.eu/fhir/cancer-common/StructureDefinition/CancerPatient
4. CancerConditionAtDiagnosis.histologyBehaviour
Definition

Histology and behaviour of the neoplasm at first diagnosis. Histology describes the tumour cell type (morphology), while behaviour indicates whether the tumour is malignant, benign, carcinoma in situ, or of uncertain/borderline malignancy. This information may be unavailable during early diagnostic workup (e.g., before biopsy results are final) but is expected to be present once the diagnostic workup is completed.

ShortHistologyBehaviour
Comments

WG recommends ICD03, the WG will monitor possible next versions. This attribute becomes mandatory once the cancer has been diagnosed; however, during the diagnostic workup it may still be absent, as the biopsy resulting from the surgery may not yet be available.

Control0..1
TypeCodeableConcept
6. CancerConditionAtDiagnosis.bodySite
Definition

Primary anatomical site where the cancer condition was first detected.

ShortBodySite
Comments

WG recommends ICD03, the WG will monitor possible next versions. It is required to choose the most specific code available, meaning the most detailed code in the hierarchical terminology that precisely identifies the body site.

Control1..1
TypeCodeableConcept
8. CancerConditionAtDiagnosis.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
Comments

It represents the classification system used to define the tumour grade, such as Gleason (a grading system for prostate cancer) or FNCLCC (a grading system for soft tissue sarcomas).

Control0..1
TypeCodeableConcept
10. CancerConditionAtDiagnosis.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
Comments

It represents the measured grade value based on the specific classification defined in the TumourGradeSystem.

Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
12. CancerConditionAtDiagnosis.visitDate
Definition

Date of the clinical visit that established the diagnosis (one of the diagnosis dates).

ShortVisitDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
14. CancerConditionAtDiagnosis.biopsyDate
Definition

Date of the biopsy supporting the diagnosis (one of the diagnosis dates).

ShortBiopsyDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
16. CancerConditionAtDiagnosis.imagingDate
Definition

Date of the diagnostic imaging supporting the diagnosis (one of the diagnosis dates).

ShortImagingDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
18. CancerConditionAtDiagnosis.labReportDate
Definition

Date of the laboratory report supporting the diagnosis, including biomarkers when applicable.

ShortLabReportDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension

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

0. CancerConditionAtDiagnosis
Definition

Logical model representing the cancer condition at first diagnosis, capturing initial tumour characteristics and the diagnostic context that initiates the cancer journey. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerConditionAtDiagnosis).

ShortCancerConditionAtDiagnosis
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
Invariantsccad-1: At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. ((visitDate | biopsyDate | imagingDate | labReportDate).exists())
2. CancerConditionAtDiagnosis.subject
Definition

Reference to the patient (subject) affected by the cancer condition at first diagnosis.

ShortSubject
Control1..1
Typehttp://hl7.eu/fhir/cancer-common/StructureDefinition/CancerPatient
4. CancerConditionAtDiagnosis.histologyBehaviour
Definition

Histology and behaviour of the neoplasm at first diagnosis. Histology describes the tumour cell type (morphology), while behaviour indicates whether the tumour is malignant, benign, carcinoma in situ, or of uncertain/borderline malignancy. This information may be unavailable during early diagnostic workup (e.g., before biopsy results are final) but is expected to be present once the diagnostic workup is completed.

ShortHistologyBehaviour
Comments

WG recommends ICD03, the WG will monitor possible next versions. This attribute becomes mandatory once the cancer has been diagnosed; however, during the diagnostic workup it may still be absent, as the biopsy resulting from the surgery may not yet be available.

Control0..1
TypeCodeableConcept
6. CancerConditionAtDiagnosis.bodySite
Definition

Primary anatomical site where the cancer condition was first detected.

ShortBodySite
Comments

WG recommends ICD03, the WG will monitor possible next versions. It is required to choose the most specific code available, meaning the most detailed code in the hierarchical terminology that precisely identifies the body site.

Control1..1
TypeCodeableConcept
8. CancerConditionAtDiagnosis.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
Comments

It represents the classification system used to define the tumour grade, such as Gleason (a grading system for prostate cancer) or FNCLCC (a grading system for soft tissue sarcomas).

Control0..1
TypeCodeableConcept
10. CancerConditionAtDiagnosis.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
Comments

It represents the measured grade value based on the specific classification defined in the TumourGradeSystem.

Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
12. CancerConditionAtDiagnosis.visitDate
Definition

Date of the clinical visit that established the diagnosis (one of the diagnosis dates).

ShortVisitDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
14. CancerConditionAtDiagnosis.biopsyDate
Definition

Date of the biopsy supporting the diagnosis (one of the diagnosis dates).

ShortBiopsyDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
16. CancerConditionAtDiagnosis.imagingDate
Definition

Date of the diagnostic imaging supporting the diagnosis (one of the diagnosis dates).

ShortImagingDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
18. CancerConditionAtDiagnosis.labReportDate
Definition

Date of the laboratory report supporting the diagnosis, including biomarkers when applicable.

ShortLabReportDate
Comments

At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.

Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension