Onconova Implementation Guide
0.2.0 - ci-build

Onconova Implementation Guide - Local Development build (v0.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

Onconova FHIR REST Capability Statement

Supports the retrieval of the mCODE Patient Bundle containing all relevant mCODE resources (provided by Onconova) for a given patient. It also supports CRUD interactions on all Onconova profiles defined in this Implementation Guide.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

Adverse Event Profile

A profile representing an adverse event experienced by a cancer patient as a result of an antineoplastic treatment, structured according to the Common Terminology Criteria for Adverse Events (CTCAE). This resource is used to capture and standardize the documentation of adverse events occurring during cancer care, including the type of event, its CTCAE grade, and any mitigation actions taken.

The profile constrains the base FHIR AdverseEvent resource to ensure consistent use of CTCAE codes and grades, and supports linkage to related treatments such as medications, radiotherapy, or surgical procedures documented in Onconova. The profile also provides extensions for recording mitigation strategies, supporting detailed tracking and management of adverse events in cancer patients.

Aneuploid Score Profile

A profile representing aneuploid score for a cancer patient.

This profile extends the GenomicsReporting IG GenomicsBase profile to include specific constraints and extensions relevant to Onconova.

Cancer Family Member History

A profile recording of a family member's history of cancer.

This profile is based on the core FHIR FamilyMemberHistory resource rather than the mCODE HistoryOfMetastaticCancer profile to allow for a broader range of cancer history documentation (not limited to metastatic cancer). It includes constraints to ensure that at least one cancer condition is recorded, along with optional extensions for cancer morphology and topography.

Cancer Patient Profile

A profile representing a cancer patient with specific extensions and constraints for the Onconova use case.

It constrains the mCODE CancerPatient profile to ensure anonymity of the patient information and to introduce additional Onconova-specific case information. Any Patient resource complying with the US Core Patient or mCODE CancerPatient profiles will also comply with this profile.

Cancer Risk Assessment Profile

A profile representing a risk assessment performed for a cancer patient, including the method used, the resulting risk level, and an optional numerical score.

It constraints the mCODE CancerRiskAssessment profile and expands the valuesets for cancer risk assessment methods and values.

Cancer Stage

A profile representing the cancer stage for a cancer patient.

It constrains the mCODE CancerStage profile to include specific constraints and extensions relevant to Onconova.

Comorbidities Profile

A profile representing comorbidities for a cancer patient, i.e. other health conditions that exist alongside the primary cancer diagnosis. Supports existing comorbidity panels such as the Charlson Comorbidity Index (CCI) and Elixhauser Comorbidity Index (ECI) with comorbidity indexes.

The profile constrains the mCODE Comorbidities profile to ensure consistent use of ICD-10 codes for documenting comorbid conditions, and to link the comorbidity information to the Onconova primary cancer condition profile.

ECOG Performance Status Profile

A profile representing ECOG performance status score for a cancer patient.

Adds minimal constraints to the mCODE ECOGPerformanceStatus profile to account for Onconova specifics.

Genomic Variant Profile

A profile representing a genomic variant identified for a cancer patient.

This profile extends the base mCODE GenomicVariant profile (which in turn profiles the Genomics Reporting Variant profile) to include specific constraints and extensions relevant to Onconova.

Homologous Recombination Deficiency Profile

A profile representing homologous recombination deficiency for a cancer patient.

This profile extends the GenomicsReporting IG GenomicsBase profile to include specific constraints and extensions relevant to Onconova.

Imaging Disease Status Profile

A profile representing the imaging-based disease status of a cancer patient.

It constrains the mCODE CancerDiseaseStatus profile to restrict it to imaging-based monitoring evaluated based on RECIST criteria.

Karnofsky Performance Status Profile

A profile representing the Karnofsky performance status score for a cancer patient.

Adds minimal constraints to the mCODE KarnofskyPerformanceStatus profile to account for Onconova specifics.

Lifestyle Profile

A profile representing a (reported) observation on certain lifestyle characteristics of a cancer patient (e.g. smoking, drinking, and sleeping habits, environmental exposures, etc.).

It directly profiles the base FHIR Observation resource as this resource is not represented in mCODE, to add relevant observation components for the different lifestyle characteristics.

Loss of Heterozygosity Profile

A profile representing loss of heterozygosity for a cancer patient.

This profile extends the GenomicsReporting IG GenomicsBase profile to include specific constraints and extensions relevant to Onconova.

Medication Administration Profile

A profile representing a medication administered to a cancer patient during a systemic therapy (e.g., chemotherapy, immunotherapy), including details about the medication and dosage.

This profile extends the base mCODE CancerRelatedMedicationAdministration profile to introduce additional information about the systemic therapy (e.g. number of cycles, therapeutic role, etc.) and to introduce references to other medication administration given simultaneously to represent combination therapies.

Microsatellite Instability Profile

A profile representing microsatellite instability for a cancer patient.

This profile extends the GenomicsReporting IG MicrosatelliteInstability profile to include specific constraints and extensions relevant to Onconova.

Molecular Tumor Board Review

A profile representing a specialized molecular tumor board review for a cancer patient. This profile extends the OnconovaTumorBoardReview profile to specify that the review is focused on molecular diagnostics and recommendations.

Primary Cancer Condition Profile

A profile that records the primary cancer condition, the original or first neoplasm in the body (Definition from: NCI Dictionary of Cancer Terms). Cancers that are not clearly secondary (i.e., of uncertain origin or behavior) should be documented as primary.

It constrains the mCODE PrimaryCancerCondition profile to constrain the terminologies of the cancer topography and morphology extensions to use exclusively ICD-O-3 codes.

This profile can be used to represent the Onconova neoplastic entities of relationship primary, local_recurrence, and regional_recurrence. Local and regional recurrences are indicated using extensions to denote that the condition is a recurrence of a previous condition, and to specify the type of recurrence (local or regional). For example, a local recurrence would be represented as a PrimaryCancerCondition with:

{
    clinicalStatus: {
        coding: [
            {
                system: "http://snomed.info/sct",
                code: "recurrence",
                display: "Recurrence"
            }
        ],
    },
    _clinicalStatus {
        extension: [
            {
                url: "http://onconova.github.io/fhir/StructureDefinition/onconova-ext-recurrence-type",
                valueCodeableConcept: {
                    coding: [
                        {
                            system: "http://snomed.info/sct",
                            code: "255470001",
                            display: "Local (qualifier value)"
                        }
                    ]
                }
            }
        ]
    },
}
Radiotherapy Summary Profile

A profile representing a summary of a course of radiotherapy delivered to a patient. It records the treatment intent, termination reason, modalities, techniques, number of sessions, and doses delivered to one or more body volumes. Whether the course has been fully delivered or stopped is indicated in the status element.

This profile extends the base mCODE RadiotherapyCourseSummary profile to include specific constraints and requirements for Onconova.

Secondary Cancer Condition Profile

A profile recording the a secondary neoplasm, including location and the date of onset of metastases. A secondary cancer results from the spread (metastasization) of cancer from its original site (Definition from: NCI Dictionary of Cancer Terms).

It constrains the mCODE SecondaryCancerCCondition profile to constrain the terminologies of the cancer topography and morphology extensions to use exclusively ICD-O-3 codes.

Serum Tumor Marker Level Category

A profile representing the serum tumor marker level category for a cancer patient.

This profile extends the base mCODE TNMCategory profile to specify the new TNM category.

Surgical Procedure Profile

A profile representing a surgical procedure performed on a cancer patient, including details about the procedure, its intent, and relevant dates.

It extends the base mCODE CancerRelatedSurgicalProcedure profile to include specific constraints and requirements for Onconova.

TNM Distant Metastases Category

A profile representing the TNM distant metastases category for a cancer patient.

This profile extends the base mCODE TNMDistantMetastasesCategory profile to include specific constraints and extensions relevant to Onconova.

TNM Grade Category

A profile representing the TNM grade category for a cancer patient.

This profile extends the base mCODE TNMCategory profile to specify the new TNM category.

TNM Lymphatic Invasion Category

A profile representing the TNM lymphatic invasion category for a cancer patient.

This profile extends the base mCODE TNMCategory profile to specify the new TNM category.

TNM Perineural Invasion Category

A profile representing the TNM perineural invasion category for a cancer patient.

This profile extends the base mCODE TNMCategory profile to specify the new TNM category.

TNM Primary Tumor Category

A profile representing the TNM primary tumor category for a cancer patient.

This profile extends the base mCODE TNMPrimaryTumorCategory profile to include specific constraints and extensions relevant to Onconova.

TNM Regional Nodes Category

A profile representing the TNM regional nodes category for a cancer patient.

This profile extends the base mCODE TNMRegionalNodesCategory profile to include specific constraints and extensions relevant to Onconova.

TNM Residual Tumor Category

A profile representing the TNM residual tumor category for a cancer patient.

This profile extends the base mCODE TNMCategory profile to specify the new TNM category.

TNM Stage Group

A profile representing the TNM stage group for a cancer patient.

It extends the base mCODE TNMStageGroup profile to expand the TNM subcategories and include specific constraints and extensions relevant to Onconova.

Therapy Line Profile

A profile representing a line of therapy in a cancer treatment regimen, including details about the therapy line number, associated treatments, and relevant dates.

Due to its abstract conceptual nature, it is based on a FHIR List to capture the specific resources involved in the therapy line. Therapy lines in Onconova are assigned automatically based on existing Procedure and MedicationAdministration resources and are not created manually.

Tumor Board Review

A profile representing a tumor board review for a cancer patient.

This profile extends the base FHIR Procedure resource since there is no equivalent mCODE profile that covers the use case.

Tumor Marker Profile

A profile representing a tumor marker observation for a cancer patient, including the type of tumor marker and its value.

This profile extends the base mCODE TumorMarkerTest profile to include specific constraints and requirements for Onconova.

If relied on the same use context as mCODE, namely for substances found in tissue or blood or other body fluids that may be a sign of cancer or certain benign (non-cancer) conditions measured at the levels of the protein and substance post-RNA protein synthesis (not at genomic level).

Tumor Mutational Burden Profile

A profile representing tumor mutational burden for a cancer patient.

This profile extends the GenomicsReporting IG TumorMutationalBurden profile to include specific constraints and extensions relevant to Onconova.

Tumor Neoantigen Burden Profile

A profile representing tumor neoantigen burden for a cancer patient.

This profile extends the GenomicsReporting IG GenomicsBase profile to include specific constraints and extensions relevant to Onconova.

Venous Invasion Category

A profile representing the venous invasion category for a cancer patient.

This profile extends the base mCODE TNMCategory profile to specify the new TNM category.

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

Adjunctive Role

Indicates the role of this medication administration in the context of the overall treatment plan.

Adverse Event Mitigation

Details about an action taken to mitigate or manage the adverse event.

Age

The approximate age of the patient.

Age at Diagnosis

The approximate age of the patient at the time of diagnosis of the disease.

Anonymized Entry

Value not provided to maintain the anonymization of the patient's data and conform to data protection regulations for research data.

CTCAE Grade

The grade of the adverse event as defined by the Common Terminology Criteria for Adverse Events (CTCAE).

Cancer Morphology

The morphology of the cancer, represented by a ICD-O-3 code.

Cancer Topography

The topography of the cancer, represented by a ICD-O-3 code.

Cause of Death

The cause of death for the patient.

Combined With

Indicates that this medication administration was given in combination with another medication administration.

Contributors

The individuals or organizations that contributed to the patient's care.

Cycles

Indicates the total number of cycles for this medication administration.

Data Completion Rate

The percentage of data elements categories that have been completed for a patient.

End of Records

Indicates the last known record date of a patient.

Gene Panel

Name of the commercial or registered gene panel used for genomic testing.

HGVS Version

The version of the HGVS nomenclature used for representing the variant.

Is Primary Therapy

Indicates whether this medication administration is the primary therapy within a therapy line.

Molecular Tumor Board CUP Characterization

A characterization of the tumor board review focused on cancer of unknown primary (CUP) origin.

Molecular Tumor Board Molecular Comparison

A comparison of molecular findings discussed during the molecular tumor board review.

Molecular Tumor Board Therapeutic Recommendation

A therapeutic recommendation or follow-up action resulting from a molecular tumor board review.

Overall Survival

The duration of time from either the date of diagnosis or the start of treatment for a disease, such as cancer, that patients diagnosed with the disease are still alive. In a clinical trial, measuring the overall survival is one way to see how well a new treatment works.

Recist Is Interpreted

Indicates that whether the RECIST was interpreted from a radiology report rather than extracted.

Recurrence Of

Indicates that the condition is a recurrence of a previous condition, and provides a reference to that previous condition.

Recurrence Type

Indicates the type of recurrence for the condition (local or regional).

Risk Assessment Score

The numerical score of the risk assessment.

Therapy Line Intent

The intent of the therapy line, such as curative or palliative.

Therapy Line Number

The number representing the sequence of the therapy line in the overall treatment regimen.

Therapy Line Period

The period during which the therapy line was performed.

Therapy Line Progression Date

The date when disease progression was observed during or after the therapy line.

Therapy Line Progression-Free Survival

The progression-free survival duration for the therapy line.

Therapy Line Reference

A reference to the therapy line associated with this treatment.

Tumor Board Specialization

The specialization or focus area of the tumor board conducting the review, such as hematologic malignancies or solid tumors.

Tumor Marker Analyte

The specific analyte or substance being measured as a tumor marker, such as PSA, CA-125, or CEA.

Unknown Entry

Value is not collected and cannot be provided by Onconova.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

Adjunctive Therapy Roles

Codes representing roles for adjunctive therapy in oncology.

Adverse Event Mitigation - Drugs

Drugs or medication categories used in the mitigation process of an adverse event.

Adverse Event Mitigation - Management

Classification of actions to mitigate adverse events affecting a patient's health.

Adverse Event Mitigation - Procedures

Procedures undertaken to mitigate the impact of an adverse event on a patient's health.

Adverse Event Mitigation - Treatment Adjustment

Adjustments made to a patient's treatment plan in response to an adverse event.

Adverse Event Mitigation Categories

Categories of actions taken to mitigate or manage adverse events in oncology.

Antineoplastic Agents

A value set of antineoplastic agents.

CTC Adverse Events

Common Terminology Criteria for Adverse Events (CTCAE) is a standard classification and severity grading scale for adverse events in clinical trials and oncology practice.

Cancer Imaging Methods

Codes representing various imaging methods used in cancer diagnosis and monitoring.

Cancer Risk Assessment Methods

A value set containing codes for various cancer risk assessment methods.

Cause of Death Value Set

The causes of death that are relevant for a cancer patient.

Comorbidity Panels

A collection of comorbidity panels relevant to cancer patients.

Expected Drug Effects

A value set of expected drug effects.

Exposure Agents

Agents to which a patient may have been exposed.

ICD-10 Codes

This value set includes sample ICD-10 codes.

ICD-O-3 Morphology Behavior

A value set of ICD-O-3 morphology behavior codes.

ICD-O-3 Topography

A value set of ICD-O-3 topography codes.

Observation Body Sites Value Set

Bodysites related to an observation

Recreational Drugs

Substances that people use to alter their mental state, often for pleasure or leisure, with effects ranging from relaxation and euphoria to hallucinations and altered perceptions.

Recurrence Type Value Set

A value set representing the types of cancer recurrence, specifically local and regional recurrences.

Risk Assessment Values

A non-exhaustive value set containing codes that result from risk assessments, i.e., the risk level of the cancer.

Smoking status

Smoking status of a patient

TNM Distant Metastasis Categories Value Set

TNM Distant Metastasis Categories Value Set

TNM Grade Categories Value Set

TNM Grade Categories Value Set

TNM Grade Category Methods Value Set

TNM Grade Category Methods Value Set

TNM Lymphatic Invasion Categories Value Set

TNM Lymphatic Invasion Categories Value Set

TNM Perineural Invasion Categories Value Set

TNM Perineural Invasion Categories Value Set

TNM Primary Tumor Categories

TNM Primary Tumor Categories Value Set

TNM Regional Nodes Categories Value Set

TNM Regional Nodes Categories Value Set

TNM Residual Tumor Categories Value Set

TNM Residual Tumor Categories Value Set

TNM Serum Tumor Marker Level Categories Value Set

TNM Serum Tumor Marker Level Categories Value Set

TNM Venous Invasion Categories Value Set

TNM Venous Invasion Categories Value Set

Treatment Termination Reasons

Codes representing reasons for terminating a treatment in oncology.

Tumor Board Recommendations

A value set of recommendations that may be made by a tumor board for a cancer patient.

Tumor Marker Analytes

Codes representing analytes for tumor markers.

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

Comorbidity Panels Code System

A code system for comorbidity panels relevant to cancer patients.

To Be Determined Codes

A code system for codes that are yet to be determined.