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
| 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). |
| Short | CancerConditionAtDiagnosis |
| Control | 0..* |
| Is Modifier | false |
| Logical Model | Instances of this logical model are not marked to be the target of a Reference |
| Invariants | ccad-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. |
| Short | Subject |
| Control | 1..1 |
| Type | http://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. |
| Short | HistologyBehaviour |
| 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. |
| Control | 0..1 |
| Type | CodeableConcept |
| 6. CancerConditionAtDiagnosis.bodySite | |
| Definition | Primary anatomical site where the cancer condition was first detected. |
| Short | BodySite |
| 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. |
| Control | 1..1 |
| Type | CodeableConcept |
| 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. |
| Short | TumourGradeSystem |
| 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). |
| Control | 0..1 |
| Type | CodeableConcept |
| 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. |
| Short | TumourGradeValue |
| Comments | It represents the measured grade value based on the specific classification defined in the TumourGradeSystem. |
| Control | 0..1 |
| Type | string |
| Primitive Value | This 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). |
| Short | VisitDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This 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). |
| Short | BiopsyDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This 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). |
| Short | ImagingDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This 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. |
| Short | LabReportDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This 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). |
| Short | CancerConditionAtDiagnosis |
| Logical Model | Instances of this logical model are not marked to be the target of a Reference |
| Invariants | ccad-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. |
| Short | Subject |
| Control | 1..1 |
| Type | http://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. |
| Short | HistologyBehaviour |
| 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. |
| Control | 0..1 |
| Type | CodeableConcept |
| 6. CancerConditionAtDiagnosis.bodySite | |
| Definition | Primary anatomical site where the cancer condition was first detected. |
| Short | BodySite |
| 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. |
| Control | 1..1 |
| Type | CodeableConcept |
| 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. |
| Short | TumourGradeSystem |
| 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). |
| Control | 0..1 |
| Type | CodeableConcept |
| 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. |
| Short | TumourGradeValue |
| Comments | It represents the measured grade value based on the specific classification defined in the TumourGradeSystem. |
| Control | 0..1 |
| Type | string |
| Primitive Value | This 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). |
| Short | VisitDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This 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). |
| Short | BiopsyDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This 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). |
| Short | ImagingDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This 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. |
| Short | LabReportDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This 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). |
| Short | CancerConditionAtDiagnosis |
| Control | 0..* |
| Is Modifier | false |
| Logical Model | Instances of this logical model are not marked to be the target of a Reference |
| Invariants | ccad-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. |
| Short | Subject |
| Control | 1..1 |
| Type | http://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. |
| Short | HistologyBehaviour |
| 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. |
| Control | 0..1 |
| Type | CodeableConcept |
| 6. CancerConditionAtDiagnosis.bodySite | |
| Definition | Primary anatomical site where the cancer condition was first detected. |
| Short | BodySite |
| 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. |
| Control | 1..1 |
| Type | CodeableConcept |
| 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. |
| Short | TumourGradeSystem |
| 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). |
| Control | 0..1 |
| Type | CodeableConcept |
| 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. |
| Short | TumourGradeValue |
| Comments | It represents the measured grade value based on the specific classification defined in the TumourGradeSystem. |
| Control | 0..1 |
| Type | string |
| Primitive Value | This 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). |
| Short | VisitDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This 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). |
| Short | BiopsyDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This 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). |
| Short | ImagingDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This 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. |
| Short | LabReportDate |
| Comments | At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition. |
| Control | 0..1 |
| Type | dateTime |
| Primitive Value | This primitive element may be present, or absent, or replaced by an extension |