Breast Cancer Message HL7 FHIR Guide
1. Introduction
This guide aims to explain the process to follow in order to read and understand the xml message “HL7FHIRMessageBreast.xml” based on breast Excel template.
2. Message description
In this chapter describes the message content in a table containing these columns.
2.1. Table Columns description
| Column Name | Description |
|---|---|
| Tab Template | Tab name included in excel file of Breast Cancer |
| Variable | Variable name included in Excel file |
| ID resource | ID identification inside the assigned resource |
| FHIR message location | Attribute used to inform the variable inside the bundle |
| Example value | Example value used to inform the variable assigned |
| Required by FHIR specification | Inform the variable is mandatory/optional in XML, based on compliance with the FHIR specification |
| INCISIVE profile | URL of profiles created by INCISIVE |
| Condition | Description term condition |
2.2. Table with Message description
2.2.1. Tab template General Info
| Term | ID resource | FHIR message location | Example Value | Required by FHIR specification | INCISVE Profile | Condition |
|---|---|---|---|---|---|---|
| Patient Number | patient01 | Patient.identifier.value | 004-000001 | Optional | ||
| Gender | patient01 | Patient.gender | female | Optional | ||
| Ethnicity | patient01 | Patient.extension.valueCodeableConcept.coding.code | 1 | Optional | Extension | |
| Patient.extension.valueCodeableConcept.coding.display | White | Optional | ||||
| Number of births | observation01 | Observation.component.valueInteger | 2 | Optional | ||
| Age at diagnosis | diagnosticReport01 | DiagnosticReport.extension.valueAge.value | 56 | Mandatory | Extension | |
| Pre/post menopause | observation01 | Observation.component.valueCodeableConcept.coding.code | 0 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Pre | Optional | ||||
| Medical History | condition01 | Condition.code.text | N39.8 | Optional | ||
| Familial Cancer History Father | observation01 | Observation.component.valueBoolean | true | Optional | ||
| Familial Cancer History Mother | observation01 | Observation.component.valueBoolean | true | Optional | ||
| Medication general info | medication01 | Medication.code.text | Medication therapy | Optional | ||
| Symptoms general info | condition02 | Condition.evidence.code.coding.code | 1 | Optional | CodeSystem | If Symptoms general info=null delete all condition02 |
| Condition.evidence.code.coding.display | Nothing | Optional | ||||
| CEA | observation01 | Observation.component.valueQuantity.value | 11.9 | Optional | ||
| CA 15-3 | observation01 | Observation.component.valueQuantity.value | 37 | Optional | ||
| Current state | patient01 | Patient.extension.valueCode | 0 | Optional | Extension | |
| Clinical findings general info | condition03 | Condition.note.text | Dysuria | Mandatory | If Clinical findings general info=null delete all condition03 | |
| Notes general info | observation01 | Observation.note.text | Observation note | Mandatory | ||
| Provider | organization01 | Organization.identifier.type.coding.code | 001 | Optional | CodeSystem | |
| Organization.identifier.type.coding.display | AUTH | Optional | ||||
| Case | - | MessageHeader.eventCoding.display | Malignant neoplasm of breast (disorder) | Mandatory | ||
| Delivery Time general info | - | Bundle.timestamp | 2023-07-21T12:29:17.239+02:00 | Optional |
2.2.2. Tab template Baseline
| Variable | ID resource | FHIR message location | Example Value | Required by FHIR specification | INCISVE Profile | Condition |
|---|---|---|---|---|---|---|
| Mammography baseline | observation02 | Observation.component.valueBoolean | true | Optional | ||
| Annotated Mammography baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Ultrasound baseline | observation02 | Observation.component.valueBoolean | true | Optional | ||
| Annotated Ultrasound baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Existence of Laboratory data baseline | observation02 | Observation.component.valueBoolean | true | Optional | ||
| Computerized axial tomography (CT) baseline | observation03 | Observation.component.valueBoolean | true | Optional | ||
| Annotated CT baseline | observation03 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Magnetic resonance imaging (MRI) baseline | observation03 | Observation.component.valueBoolean | true | Optional | ||
| Annotated MRI baseline | observation03 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Positron emission tomography (PET/CT) baseline | observation03 | Observation.component.valueBoolean | true | Optional | ||
| Annotated PET/CT baseline | observation03 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Histopathology Image baseline | observation03 | Observation.component.valueBoolean | true | Optional | ||
| Annotated Histopathology Image baseline | observation03 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Xray baseline | observation03 | Observation.component.valueBoolean | true | Optional | ||
| Annotated Xray baseline | observation03 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Baseline location | observation03 | Observation.bodySite.coding.code | AN | Optional | CodeSystem | |
| Observation.bodySite.coding.display | Nipple and Areola | Optional | ||||
| Max tumor diameter | observation02 | Observation.component.valueQuantity.value | 4.8 | Optional | ||
| Breast laterality | observation02 | Observation.component.valueCodeableConcept.coding.code | 0 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Right breast | Optional | ||||
| Mass Shape baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Oval | Optional | ||||
| Mass Margin baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 2 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Angular | Optional | ||||
| Mass orientation baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Parallel | Optional | ||||
| Mass echo pattern baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Anechoic | Optional | ||||
| Posterior features baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 3 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Shadowing | Optional | ||||
| Calcifications baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | In mass | Optional | ||||
| Associated Features baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Skin thickness | Optional | ||||
| Breast composition baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Fatty | Optional | ||||
| Parenchymal enhancement level baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Minimal | Optional | ||||
| Parenchymal enhancement symmetry baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Symmetric | Optional | ||||
| Presence of foci baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Unifocal | Optional | ||||
| Pathological lymph-nodes baseline | observation02 | Observation.component.valueBoolean | true | Optional | ||
| Other breast lesions baseline | observation02 | Observation.component.valueBoolean | true | Optional | ||
| Distant metastasis baseline | observation02 | Observation.component.valueBoolean | true | Optional | ||
| Distant metastasis location baseline | observation02 | Observation.bodySite.coding.code | 1 | Optional | CodeSystem | |
| Observation.bodySite.coding.display | Bone | Optional | ||||
| Left Breast BIRADS classification baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | BI-RADS 0 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Incomplete need additional imaging evaluation | Optional | ||||
| Right Breast BIRADS classification baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | BI-RADS 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Negative symmetrical and no masses, architectural distortion, or suspicious calcifications | Optional | ||||
| Ti baseline | observation02 | Observation.component.valueString | T0 | Optional | ||
| Ni baseline | observation02 | Observation.component.valueString | N0 | Optional | ||
| Mi baseline | observation02 | Observation.component.valueString | M0 | Optional |
2.2.3. Tab template Timepoints
| Variable | ID resource | FHIR message location | Example Value | Required by FHIR specification | INCISVE Profile | Condition |
|---|---|---|---|---|---|---|
| Label timepoints | observation04 | Observation.code.coding.code | 1 | Mandatory | CodeSystem | |
| Observation.code.coding.display | After 1st Treatment | Mandatory | ||||
| Define other if selected timepoints | observation04 | Observation.category.text | Between 1st and 2nd dose of CT | Optional | ||
| Date timepoints | observation04 | Observation.valueInteger | 2 | Optional | ||
| Mammography timepoints | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Annotated Mammography timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Ultrasound timepoints | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Annotated Ultrasound timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Symptoms timepoints | condition04 | Condition.evidence.code.coding.code | 1 | Optional | CodeSystem | If Symptoms timepoints=null delete all condition04 |
| Condition.evidence.code.coding.display | Breast pain | Optional | ||||
| Existence of Laboratory data timepoints | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Computerized axial tomography (CT) timepoints | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Annotated CT timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Magnetic resonance imaging (MRI) timepoints | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Annotated MRI timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Positron emission tomography (PET/CT) timepoints | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Annotated PET/CT timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Histopathology Image timepoints | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Annotated Histopathology Image timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Xray timepoints | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Annotated Xray timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional | ||||
| Clinical findings timepoints | condition05 | Condition.note.text | Dysuria | Mandatory | If Clinical findings timepoints=null delete all condition05 | |
| Tumor size | observation04 | Observation.component.valueQuantity.value | 4.8 | Optional | ||
| Pathological Lymph-nodes timepoints | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Other breast lesions timepoints | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Biopsy after follow-up | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Surgery after follow-up | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Changes in tumor profile | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Mass Shape timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Oval | Optional | ||||
| Mass Margin timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 2 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Angular | Optional | ||||
| Mass orientation timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | parallel | Optional | ||||
| Mass echo pattern timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Anechoic | Optional | ||||
| Posterior features timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 3 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Shadowing | Optional | ||||
| Calcifications timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | In mass | Optional | ||||
| Associated Features timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Skin thickness | Optional | ||||
| Breast composition timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Fatty | Optional | ||||
| Parenchymal enhancement level timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Minimal | Optional | ||||
| Parenchymal enhancement symmetry timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Symmetric | Optional | ||||
| Presence of foci timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Unifocal | Optional | ||||
| Changes in treatment | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Treatment after follow-up | If true | |||||
| Type of treatment after follow-up | procedure01 | Procedure.code.text | Surgery | Optional | If Treatment after follow-up=true, else delete all procedure01 | |
| Distant metastasis timepoints | observation04 | Observation.component.valueBoolean | true | Optional | ||
| Distant metastasis location timepoints | observation04 | Observation.bodySite.coding.code | 1 | Optional | CodeSystem | |
| Observation.bodySite.coding.display | Bone | Optional | ||||
| Response to treatment | observation04 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | CR | Optional | ||||
| Ti timeponts | observation04 | Observation.component.valueString | T0 | Optional | ||
| Ni timepoints | observation04 | Observation.component.valueString | N0 | Optional | ||
| Mi timepoints | observation04 | Observation.component.valueString | M0 | Optional | ||
| Left Breast BIRADS classification timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | BI-RADS 0 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Incomplete need additional imaging evaluation | Optional | ||||
| Right Breast BIRADS classification timepoints | observation04 | Observation.component.valueCodeableConcept.coding.code | BI-RADS 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Negative symmetrical and no masses, architectural distortion, or suspicious calcifications | Optional | ||||
| Notes timepoints | observation04 | Observation.note.text | Observation note | Mandatory |
2.2.4. Tab template Treatment
| Variable | ID resource | FHIR message location | Example Value | Required by FHIR specification | INCISVE Profile | Condition |
|---|---|---|---|---|---|---|
| Label treatment | observation07 | Observation.code.coding.code | 1 | Mandatory | CodeSystem | |
| Observation.code.coding.display | After 1st Treatment-1st FollowUp | Mandatory | ||||
| Define other if selected treatment | observation07 | Observation.category.text | Between 1st and 2nd dose of CT | Optional | ||
| Other treatment details | observation07 | Observation.valueString | Other treatment details | Optional | ||
| Performance status | observation07 | Observation.component.valueInteger | 5 | Optional | ||
| Surgery treatment | If = true | |||||
| Type of surgery | procedure02 | Procedure.category.coding.code | 2 | Optional | CodeSystem | If Surgery treatment=true, else delete all procedure02 |
| Procedure.category.coding.display | Mastectomy | Optional | ||||
| Date of Surgery | procedure02 | Procedure.performedString | 2 | Optional | ||
| Lymph-node surgery | observation08 | Observation.valueCodeableConcept.coding.code | 0 | Optional | CodeSystem | If Surgery treatment=true, else delete all observation08 |
| Observation.valueCodeableConcept.coding.display | No | Optional | ||||
| Chemotherapy (CTX) | If = true | |||||
| Type of CTX | procedure03 | Procedure.code.text | Capecitabine | Optional | If CTX=true, else delete all procedure03 | |
| Date of CTX | procedure03 | Procedure.performedString | 2 | Optional | ||
| Chemoradiotherapy (CRT) | If = true | |||||
| Type of CRT | procedure04 | Procedure.code.text | Nitrosoureas | Optional | If CRT=true, else delete all procedure04 | |
| Date of CRT | procedure04 | Procedure.performedString | 2 | Optional | ||
| Chemoimmunotherapy (CIT) | If = true | |||||
| Type of CIT | procedure05 | Procedure.code.text | Tamoxifen | Optional | If CIT=true, else delete all procedure05 | |
| Date of last CIT | procedure05 | Procedure.performedString | 2 | Optional | ||
| Radiation therapy (RT) | If = true | |||||
| Type of RT | procedure06 | Procedure.code.text | Tamoxifen | Optional | If RT=true, else delete all procedure06 | |
| Date of RT | procedure06 | Procedure.performedString | 2 | Optional | ||
| Delivered dose of RT - Whole Breast [Gy] | medicationAdministration01 | MedicationAdministration.dosage.dose.value | 40.4 | Optional | ||
| Number of fractions of RT - Whole Breast | medicationAdministration01 | MedicationAdministration.dosage.rateQuantity.value | 28 | Optional | ||
| Boost | If true | |||||
| Delivered dose - Boost region [Gy] | medicationAdministration02 | MedicationAdministration.dosage.dose.value | 50.4 | Optional | If boost=true, else delete medicationAdministration02 and partOf reference medicationAdministration02 in observation05 and observetion06 | |
| Number of fractions - Boost | medicationAdministration02 | MedicationAdministration.dosage.rateQuantity.value | 7 | Optional | ||
| Hormone therapy (HT) | If = true | |||||
| Type of HT | procedure07 | Procedure.code.text | Tamoxifen | Optional | If HT=true, else delete all procedure07 | |
| Date of HT | procedure07 | Procedure.performedString | 2 | Optional | ||
| Targeted therapy (TT) | If = true | |||||
| Type of TT | procedure08 | Procedure.code.text | Trastuzumab | Optional | If TT=true, else delete all procedure08 | |
| Date of TT | procedure08 | Procedure.performedString | 3 | Optional | ||
| Immune therapy (IT) | If = true | |||||
| Type of IT | procedure09 | Procedure.code.text | Pembrolizumab | Optional | If IT=true, else delete all procedure09 | |
| Date of IT | procedure09 | Procedure.performedString | 2 | Optional | ||
| Adjuvant treatment | observation06 | Observation.valueBoolean | true | Optional | If Adjuvant treatment=true delete all observation05 | |
| Neoadjuvant treatment | observation05 | Observation.valueBoolean | true | Optional | If Neoadjuvant treatment=true delete all observation06 |
2.2.5. Tab template Histology - Mutations
| Variable | ID resource | FHIR message location | Example Value | Required by FHIR specification | INCISVE Profile | Condition |
|---|---|---|---|---|---|---|
| Biopsy | If = true | |||||
| Biopsy label | procedure10 | Procedure.statusReason.coding.code | 1 | Optional | CodeSystem | If Biopsy=true, else delete all procedure10 |
| Procedure.statusReason.coding.display | After 1st Treatment | Optional | ||||
| Type of Biopsy | procedure10 | Procedure.category.coding.code | 1 | Optional | CodeSystem | |
| Procedure.category.coding.display | FNAC | Optional | ||||
| Define other if selected histology-mutations | procedure10 | Procedure.category.text | Between 1st and 2nd dose of CT | Optional | ||
| Date of Biopsy | procedure10 | Procedure.performedString | 3 | Optional | ||
| Surgery histology-mutations | If = true | |||||
| Surgery date | procedure11 | Procedure.performedString | 2 | Optional | If Surgery histology-mutations=true, else delete all procedure11 | |
| Breast Cancer Type | observation11 | Observation.category.coding.code | IBC | Optional | CodeSystem | |
| observation11 | Observation.category.coding.display | Inflamatory Breast Carcinoma | Optional | |||
| Molecular Subtype | observation11 | Observation.category.coding.code | 1 | Optional | CodeSystem | |
| Observation.category.coding.display | Luminal A | Optional | ||||
| Breast Cancer Grade | observation11 | Observation.component.valueInteger | 1 | Optional | ||
| HER2 (c-erB2) | observation09 | Observation.component.valueBoolean | true | Optional | ||
| ER | observation09 | Observation.component.valueBoolean | true | Optional | ||
| PR | observation09 | Observation.component.valueBoolean | true | Optional | ||
| Ki67 | observation09 | Observation.component.valueQuantity.value | 10 | Optional | ||
| BRCA 1 mutation | observation09 | Observation.component.valueBoolean | true | Optional | ||
| BRCA 2 mutation | observation09 | Observation.component.valueBoolean | true | Optional | ||
| VI / LVI | observation09 | Observation.component.valueBoolean | true | Optional | ||
| Sampling | observation10 | Observation.component.valueString | Light microscopy | Optional | ||
| Staining/type of assay performed | observation10 | Observation.component.valueString | Hematoxylin | Optional | ||
| Magnification | observation10 | Observation.component.valueString | x10 | Optional | ||
| Other sample-related information | observation10 | Observation.component.valueString | example | Optional |
2.2.6. Tab template Lab Results
| Variable | ID resource | FHIR message location | Example Value | Required by FHIR specification | INCISVE Profile | Condition |
|---|---|---|---|---|---|---|
| Exam label | observation12 | Observation.code.coding.code | 1 | Mandatory | CodeSystem | |
| Observation.code.coding.display | After 1st Treatment | Mandatory | ||||
| Define other if selected lab results | observation12 | Observation.category.text | Between 1st and 2nd dose of CT | Optional | ||
| Date Laboratory | observation12 | Observation.valueInteger | 2 | Optional | ||
| Leukocytes | observation12 | Observation.component.valueQuantity.value | 15.8 | Optional | ||
| Hemoglobin (Hb) | observation12 | Observation.component.valueQuantity.value | 16.7 | Optional | ||
| Hematocrit (HCT) | observation12 | Observation.component.valueQuantity.value | 47.4 | Optional | ||
| Platelets (PLT) | observation12 | Observation.component.valueQuantity.value | 287 | Optional | ||
| Blood sugar levels | observation12 | Observation.component.valueQuantity.value | 87 | Optional | ||
| Insulin | observation12 | Observation.component.valueQuantity.value | 4 | Optional | ||
| Urea | observation12 | Observation.component.valueQuantity.value | 36 | Optional | ||
| Creatinine | observation12 | Observation.component.valueQuantity.value | 0.72 | Optional | ||
| Uric acid | observation12 | Observation.component.valueQuantity.value | 3.5 | Optional | ||
| Potassium | observation12 | Observation.component.valueQuantity.value | 4.8 | Optional | ||
| Sodium | observation12 | Observation.component.valueQuantity.value | 142 | Optional | ||
| Calcium | observation12 | Observation.component.valueQuantity.value | 9.31 | Optional | ||
| Cholesterol | observation12 | Observation.component.valueQuantity.value | 197 | Optional | ||
| Triglycerides | observation12 | Observation.component.valueQuantity.value | 59 | Optional | ||
| HDL | observation12 | Observation.component.valueQuantity.value | 60 | Optional | ||
| Low density lipoprotein (LDL) | observation12 | Observation.component.valueQuantity.value | 120 | Optional | ||
| SGOT | observation12 | Observation.component.valueQuantity.value | 19 | Optional | ||
| SGPT | observation12 | Observation.component.valueQuantity.value | 33 | Optional | ||
| y-GT | observation12 | Observation.component.valueQuantity.value | 14 | Optional | ||
| ALP | observation12 | Observation.component.valueQuantity.value | 227 | Optional | ||
| LDH | observation12 | Observation.component.valueQuantity.value | 270 | Optional | ||
| TSH | observation12 | Observation.component.valueQuantity.value | 0.73 | Optional | ||
| Cortisol | observation12 | Observation.component.valueQuantity.value | 22 | Optional | ||
| CRP | observation12 | Observation.component.valueQuantity.value | 0.5 | Optional | ||
| BNP | observation12 | Observation.component.valueQuantity.value | 120 | Optional | ||
| HbA1c | observation12 | Observation.component.valueQuantity.value | 5.1 | Optional | ||
| Total protein in urine | observation12 | Observation.component.valueQuantity.value | 80 | Optional | ||
| Creatinine urine | observation12 | Observation.component.valueQuantity.value | 100 | Optional |
In order to build the message for each patient, and to report the variables in the table above, the following steps must be followed:
- Search inside the message text with the same word that appears in the "Variable" column.
- Check that the resource to which it redirects us has the same id as in the “ID resource” column.
- Enter the desired value in the double quoted space of the attribute indicated in the "Fhirmessage location" column.
- Do not delete any part of the message, the whole structure must be the same, just change the example value, for the value you want to report. Do not change the order.
- If you don’t have the information of the element, you can delete the node, but validate XML to ensure the structure of the XML FHIR is still correct and has no errors (you can omit the warnings in the validation).
The entire message structure is static except for the values given for the attributes in the "Fhir message location" column and the timestamp which is the current datatime.
2.3. Description mandatory/optional of term
There will be mandatory/optional for different scenarios, according to different scenarios corresponding to different rules. These scenarios are described separately below.
- If the attribute is mandatory, all attribute structure information for this column must be reported. It cannot be deleted.
| Notes general info | observation01 | Observation.note.text | Observation note | Mandatory |
- If the attribute is mandatory with a comment reporting the condition of this variable, all attribute structure information for this column must be reported, unless the variable has not value for report, all resources must be deleted.
| Clinical findings general info | condition03 | Condition.note.text | Dysuria | Mandatory | If Clinical findings general info=null delete all condition03 |
- If an optional attribute needs to be deleted, all attribute structures except for the primary resource (e.g., observation, procedure, condition, etc.) must be deleted if that primary resource has another variable. For example, for the variable Gender, you can delete the attribute gender from the resource Patient, while other attributes such as identifier have values and do not have to be deleted.
| Gender | patient01 | Patient.gender | female | Optional |
- If the attribute is optional, this happens in observation.component because Observation.component has two parts inside, Observation.component.code and Observation.component.value (this value can be valueCodeableConcept, ValueBoolean, ValueSrting, valueInteger, valueQuantity, etc.). If the variable has a value that needs to be informed, then code is mandatory, that code is mostly the SNOMED CT code or LOINC code for that variable. This means that if you need to delete variable, then you need to delete all Observation.component and cannot delete the whole Observation resource, unless there are no other elements in the same Observation, then you can delete the whole Observation resource.
| Annotated Mammography baseline | observation02 | Observation.component.valueCodeableConcept.coding.code | 1 | Optional | CodeSystem | |
| Observation.component.valueCodeableConcept.coding.display | Positive annotation | Optional |
- If the attribute is optional with a comment reporting the condition of this variable, you can delete all resource if the variable has not value for report.
| Symptoms general info | condition02 | Condition.evidence.code.coding.code | 1 | Optional | CodeSystem | If Symptoms general info=null delete all condition02 |