StructureDefinition UKCore-Procedure

Used for detailing information on procedures the patient has had performed, to aid interpretation of Genomic test results.

Assertion of an absence of a procedure being performed SHOULD be recorded using an Observation resource, as described in Profile-UKCore-Observation

At a minimum, Procedure resources are expected to contain the status, code, subject and performedDateTime, though additional information conforming to the FHIR profile below MAY be included if relevant.

Genomic Study and Genomic Study Analysis profiles on Procedure may also be used as part of structured reporting. Mandated usage of these profiles is pending data standard discovery work to identify the items required within Genomic Test Reporting. As such, elements called out, and guidance suggested on this page, may be subject to change.

Profile url FHIR Module Normative Status
https://fhir.hl7.org.uk/StructureDefinition/UKCore-Procedure UKCore trial-use

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionC0..*Extension
modifierExtension?! C0..*Extension
identifierΣ0..*Identifier
instantiatesCanonicalΣ0..*canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUriΣ0..*uri
basedOnΣ C0..*Reference(CarePlan | ServiceRequest)
partOfΣ C0..*Reference(MedicationAdministration | Observation | Procedure)
statusS Σ ?!1..1codeBinding
statusReasonΣ0..1CodeableConcept
categoryΣ0..1CodeableConcept
codeS Σ0..1CodeableConceptBinding
subjectS Σ C1..1Reference(Group | Patient)
encounterΣ C0..1Reference(Encounter)
performedAgeAge
performedDateTimedateTime
performedPeriodPeriod
performedRangeRange
performedStringstring
recorderΣ C0..1Reference(Patient | Practitioner | PractitionerRole | RelatedPerson)
asserterΣ C0..1Reference(Patient | Practitioner | PractitionerRole | RelatedPerson)
id0..1string
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
functionΣ0..1CodeableConcept
actorΣ C1..1Reference(Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
onBehalfOfC0..1Reference(Organization)
locationΣ C0..1Reference(Location)
reasonCodeΣ0..*CodeableConcept
reasonReferenceΣ C0..*Reference(Condition | DiagnosticReport | DocumentReference | Observation | Procedure)
bodySiteΣ0..*CodeableConceptBinding
outcomeΣ0..1CodeableConcept
reportC0..*Reference(Composition | DiagnosticReport | DocumentReference)
complication0..*CodeableConceptBinding
complicationDetailC0..*Reference(Condition)
followUp0..*CodeableConcept
note0..*Annotation
id0..1string
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
action0..1CodeableConceptBinding
manipulatedC1..1Reference(Device)
usedReferenceC0..*Reference(Device | Medication | Substance)
usedCode0..*CodeableConcept


FHIRMDSHL7v2
ProcedurePatient - Had transplant, Patient - Had transfusion, Is patient on TKI therapy, Insulin treated within 6 months of diagnosis, Is on Ig replacementPresence of OBR segment with OBR-44 code for transplant/transfusion etc.
Procedure.performedDateTimePatient - Fetal gestation (to determine termination date), Patient - Transplant date, Patient - Transfusion dateOBR-7
Procedure.codePatient - Pregnancy type, Patient - Type of transplant, Patient - Type of transfusion, Neonatal hypoglycemia treatment details, Current exocrine pancreatic treatmentOBR segments with appropriate codes, OBR-44, OBR/RXA segments
Procedure.performedPeriod.startNeonatal hypoglycemia treatment start date, Exocrine pancreatic treatment start dateOBR-7, RXA-3
Procedure.performedPeriod.endNeonatal hypoglycemia treatment end dateOBR-8

Additional Guidance

extension:genomic-study-analysis

From the Genomic Reporting IG Genomic Study profile. Reference to the Genomic Study Analysis resource, detailing the analyses performed as part of genomic test.

"extension" : [
    {
      "url" : "http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/genomic-study-analysis-ext",
      "valueReference" : {
        "reference" : "Procedure/PGXGenomicStudyAnalysis"
      }
    }
  ],

Genomic Study Analysis extensions

From the Genomic Reporting IG Genomic Study Analysis profile. Various extensions covering the metadata related to a genomic test, e.g. regions studied, change types tested for etc. For the full list of extensions, please see the linked profile page.

Specifically the extension:device element SHOULD be used to record the software/device that generated an observation, where applicable.

Use of the profile and its extensions is pending further discovery of the data standards required for Genomic Reporting in the UK.

"extension" : [
    {
      "url" : "http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/genomic-study-analysis-genome-build",
      "valueCodeableConcept" : {
        "coding" : [
          {
            "system" : "http://loinc.org",
            "code" : "LA26806-2",
            "display" : "GRCh38"
          }
        ]
      }
    },
    {
      "extension" : [
        {
          "url" : "sequencing-coverage",
          "valueQuantity" : {
            "value" : 100
          }
        }
      ],
      "url" : "http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/genomic-study-analysis-metrics"
    },
    {
      "extension" : [
        {
          "url" : "description",
          "valueString" : "protein-coding and exon-splicing regions"
        },
        {
          "url" : "studied",
          "valueCodeableConcept" : {
            "coding" : [
              {
                "system" : "http://www.genenames.org",
                "code" : "HGNC:2621",
                "display" : "CYP2C19"
              }
            ]
          }
        },
        {
          "url" : "studied",
          "valueCodeableConcept" : {
            "coding" : [
              {
                "system" : "http://www.genenames.org",
                "code" : "HGNC:2623",
                "display" : "CYP2C9"
              }
            ]
          }
        },
        {
          "url" : "studied",
          "valueCodeableConcept" : {
            "coding" : [
              {
                "system" : "http://www.genenames.org",
                "code" : "HGNC:23663",
                "display" : "VKORC1"
              }
            ]
          }
        }
      ],
      "url" : "http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/genomic-study-analysis-regions"
    }
  ],

status

Status SHALL use the codes recommended in the base Procedure resource, appropriately tagging procedures as having been completed or in-progress etc. depending on the actual status of the procedure.

"status": "completed",

code

SHALL be present. SNOMED CT coding is preferred, though alternative codings MAY be provided subject to review of the Coding system by the NHS England Genomics Unit.

For the Genomic Study profile, expected to be from the Genomic Study Type ValueSet

"code": {
        "coding":  [
            {
                "system": "http://snomed.info/sct",
                "code": "23719005",
                "display": "Transplantation of bone marrow"
            }
        ]
    },

subject

SHALL be present. Reference to the associated Patient. This MAY be through a resource reference if the ID on the central service is known (or provided within the transaction bundle) or through NHS number where this is known and has been traced through PDS.

"subject": {
        "reference": "Patient/Patient-MeirLieberman-Example",
        "identifier": {
            "system": "https://fhir.nhs.uk/Id/nhs-number",
            "value": "9449307873"
        }
    },

performed[x]

performed SHOULD be provided wherever possible, using the appropriate data type, to aid in interpretation of Genomic test results.

"performedDateTime": "2020-01-19"