StructureDefinition PlanDefinition

FHIR representation for a DGTS Genomic Test Package. This is a definitional resource and available read-only from the DGTS FHIR API.

The below profile is provided to support parsing for clients if returned through a GET request.

Profile url FHIR Module Normative Status
http://hl7.org/fhir/StructureDefinition/PlanDefinition HL7 International trial-use

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionC0..*Extension
modifierExtension?! C0..*Extension
urlΣ0..1uri
identifierΣ0..*Identifier
versionΣ0..1string
nameΣ C0..1string
titleΣ0..1string
subtitle0..1string
typeΣ0..1CodeableConceptBinding
statusΣ ?!1..1codeBinding
experimentalΣ0..1boolean
subjectCodeableConceptCodeableConcept
subjectReferenceReference(Group)
dateΣ0..1dateTime
publisherΣ0..1string
contactΣ0..*ContactDetail
descriptionΣ0..1markdown
useContextΣ0..*UsageContext
jurisdictionΣ0..*CodeableConceptBinding
purpose0..1markdown
usage0..1string
copyright0..1markdown
approvalDate0..1date
lastReviewDate0..1date
effectivePeriodΣ C0..1Period
topic0..*CodeableConcept
author0..*ContactDetail
editor0..*ContactDetail
reviewer0..*ContactDetail
endorser0..*ContactDetail
relatedArtifact0..*RelatedArtifact
library0..*canonical(Library)
id0..1string
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
category0..1CodeableConcept
description1..1CodeableConcept
priority0..1CodeableConceptBinding
start0..1CodeableConcept
addresses0..*CodeableConcept
documentation0..*RelatedArtifact
id0..1string
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
measure0..1CodeableConcept
detailCodeableConceptCodeableConcept
detailQuantityQuantity
detailRangeRange
dueC0..1Duration
id0..1string
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
prefix0..1string
title0..1string
description0..1string
textEquivalent0..1string
priority0..1codeBinding
code0..*CodeableConcept
reason0..*CodeableConcept
documentation0..*RelatedArtifact
goalId0..*id
subjectCodeableConceptCodeableConcept
subjectReferenceReference(Group)
triggerC0..*TriggerDefinition
id0..1string
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
kind1..1codeBinding
expressionC0..1Expression
input0..*DataRequirement
output0..*DataRequirement
id0..1string
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
actionId1..1id
relationship1..1codeBinding
offsetDurationDuration
offsetRangeRange
timingAgeAge
timingDateTimedateTime
timingDurationDuration
timingPeriodPeriod
timingRangeRange
timingTimingTiming
id0..1string
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
type1..1codeBinding
role0..1CodeableConcept
type0..1CodeableConceptBinding
groupingBehavior0..1codeBinding
selectionBehavior0..1codeBinding
requiredBehavior0..1codeBinding
precheckBehavior0..1codeBinding
cardinalityBehavior0..1codeBinding
definitionCanonicalcanonical(ActivityDefinition | PlanDefinition | Questionnaire)
definitionUriuri
transform0..1canonical(StructureMap)
id0..1string
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
path0..1string
expressionC0..1Expression
action0..*see (action)



Additional Guidance

extension-PlanDefinition.actor

Extension used for recording the participants associated with a genomic test. This extension is an HL7 FHIR cross-version extension representing the R5 PlanDefinition.actor element within a FHIR R4 implementation.

The actor extension MAY contain one or more option entries. Each option represents a single participant role within the genomic workflow, for example requester or performer.

Each option SHOULD include a participant role describing the responsibility of that participant within the genomic workflow.

Each option SHOULD reference an appropriate permitted resource type. Permitted target resource types include: HealthcareService, Group, Organization, Location, Practitioner, PractitionerRole, Device,
RelatedPerson and Patient
Note: Where multiple participants are involved in the delivery, requesting, or fulfilment of a genomic test, separate option entries SHOULD be used for each participant-role combination.

Each participant MUST be represented as a distinct option to ensure unambiguous interpretation and reliable search behaviour.

"extension": [
  {
   "url": "http://hl7.org/fhir/5.0/StructureDefinition/extension-PlanDefinition.actor",
   "extension": [
    {
     "url": "option",
     "extension": [
      {
       "url": "role",
       "valueCodeableConcept": {
        "coding": [
         {
          "system": "https://fhir.nhs.uk/CodeSystem/action-participant-role-genomics",
          "code": "performer",
          "display": "Performer"
         }
        ],
        "text": "Performer"
       }
      },
      {
       "url": "typeReference",
       "valueReference": {
        "reference": "Organization/Organization-CSGLHub-Example",
        "identifier": {
         "system": "https://fhir.nhs.uk/Id/ods-organization-code",
         "value": "699P0"
        },
        "display": "Central and South Genomic Laboratory Hub"
       }
      }
     ]
    },
    {
     "url": "option",
     "extension": [
      {
       "url": "role",
       "valueCodeableConcept": {
        "coding": [
         {
          "system": "https://fhir.nhs.uk/CodeSystem/action-participant-role-genomics",
          "code": "requester",
          "display": "Requester"
         }
        ],
        "text": "Requester"
       }
      },
      {
       "url": "typeReference",
       "valueReference": {
        "reference": "Organization/ImperialCollegeHealthcareNHSTrust-Example",
        "identifier": {
         "system": "https://fhir.nhs.uk/Id/ods-organization-code",
         "value": "RYJ"
        },
        "display": "Imperial College Healthcare NHS Trust"
       }
      }
     ]
    }
   ]
  }
 ],

identifier

SHALL be present. The DGTS test package readable ID assigned to the test package.
"identifier": [
        {
            "system": "https://fhir.nhs.uk/Id/England-DigitalGenomicTestServices",
            "value": "TP231"
        },
        {
            "system": "https://fhir.nhs.uk/Id/England-GenomicTestDirectory",
            "value": "R47",
            "use": "old"
        }
    ],

title

SHALL be present. The DGTS test package name.
"title": "Angelman syndrome",

status

SHALL be present. Used to represent the state of a test package. Mapping of statuses which do not match the required HL7 ValueSet, e.g. "Deprecated", are pending investigation.
"status": "active",

experimental

SHALL be present. For representing whether a test/test package is in pre-release.
"experimental": false,

version

SHALL be present. The DGTS Test Package version.
"version": "1.0",

useContext

SHALL be present. Used for capturing the clinical specialty thiS test/test package relevant for.
"useContext": [
        {
            "code": {
                "code": "user",
                "system": "http://terminology.hl7.org/CodeSystem/usage-context-type"
            },
            "valueCodeableConcept": {
                "coding": [
                    {
                        "code": "neurology",
                        "system": "https://fhir.nhs.uk/CodeSystem/DGTS-clinical-specialty-genomics",
						"display": "Neurology"
						
                    }
                ]
            }
        }
    ],

goal

SHALL be present. For representing the modalities applicable for this test request (TBC).
"goal": [
  {
    "description": {
      "coding": [
        {
          "system": "https://fhir.nhs.uk/CodeSystem/DGTS-testpackage-modality",
          "code": "rare-and-inherited-disease",
          "display": "Rare and Inherited Disease"
        }
      ]
    }
  }
]

action

SHALL be present. Links to the tests under this test package.
"action": [
        {
            "definitionCanonical": "http://fhir.nhs.uk/ActivityDefinition/GT1"
        }
    ]