The HL7 FHIR® standard creates a common foundation on which a variety of different solutions are implemented. The resources contained in the specification usually require further adaptation to particular health or social care use cases; this adaptation is referred to as "profiling" and the resulting artefacts as "profiles".
The checklist below was adhered to when developing a draft UK Core profile suitable for progression to Clinical and Technical Assurance.
The UK Core profile name SHALL follow an agreed format.
The name of a profile consists of a number of name segments, and will be in the form:-
[Base][FHIRAssetName][Specialism]
The segments are defined as follows:-
Note: "Mandatory" means that a segment SHALL be present. "Required" means that a segment SHOULD be present, in this case in the event of there being multiple profiles for one base resource.
The physical file name SHALL be in the format [Base]-[FHIRAssetName]-[Specialism] and SHALL be created in the file XML format.
The list below contains the element differences between the UKCore and HL7.
View further information about FHIR base resource definitions.
Element name | Base Cardinality | UK Core Cardinality | Type | Definition, Constraints and Notes |
---|---|---|---|---|
id | 0..1 | 1..1 | id | In the UK Core the format in the following, with the FHIRAssetName and Specialism in PascalCase:UKCore-[FHIRAssetName][Specialism] . |
View further information about FHIR Resource StructureDefinition - Content.
Element name | Base Cardinality | UK Core Cardinality | Type | Definition, Constraints and Notes |
---|---|---|---|---|
url | 0..1 | 1..1 | uri | In the UK Core the format is the following, with the FHIRAssetName and Specialism in PascalCase:https://fhir.hl7.org.uk/StructureDefinition/UKCore-[FHIRAssetName][Specialism] . |
identifier | 0..* | 0..0 | Identifier | identifier SHALL NOT be used within the UKCore |
version | 0..1 | 1..1 | string | This will follow the Semantic Versioning standard [major.minor.patch] .Further details about internal versioning for UK Core assets are available. |
name | 0..1 | 1..1 | string | In the UK Core the format is PascalCase:UKCore[FHIRAssetName][Specialism] . |
title | 0..1 | 1..1 | string | In the UK Core the format is Proper Case:UK Core [FHIRAssetName] [Specialism] |
status | 1..1 | 1..1 | code | See NamingSystem.status for more information. |
date | 0..1 | 1..1 | dateTime | Only the date, without time, is populated in the UK Core. |
publisher | 0..1 | 1..1 | string | For all UK Core Profiles, where the base URL is https://fhir.hl7.org.uk , the name of the publisher will be HL7 UK . |
contact | 0..* | 1..* | ContactDetail | See Publisher, Contact & Copyright for details of how this SHALL be populated for all UK Core Profiles, where the base URL is https://fhir.hl7.org.uk/ . |
description | 0..1 | 1..1 | markdown | This SHALL be in the following format: This profile defines the UK constraints and extensions on the International FHIR resource [FHIRAssetName]([link to HL7 Resource]). |
purpose | 0..1 | 1..1 | markdown | This provides traceability of ''why'' the resource is either needed or ''why'' it is defined as it is. |
copyright | 0..1 | 1..1 | markdown | All UK Core Profiles SHALL contain the the copyright as listed in Publisher, Contact & Copyright |
fhirVersion | 0..1 | 1..1 | code | The version of the FHIR specification on which this StructureDefinition is based - this is the formal version of the specification, without the revision number, e.g. [publication].[major].[minor]. The UKCore mandates the use of this element. |
baseDefinition | 0..1 | 1..1 | canonical(StructureDefinition) | The baseDefinition SHALL be a complete URI referencing the relevant HL7 FHIR resource for UK Core base profiles, and the relevant UK Core base profile for any UK Core derived profiles. |
snapshot | 0..1 | 0..0 | BackboneElement | Snapshots SHALL NOT be used within the UKCore |
differential .element |
1..* | 1..* | ElementDefinition | When used for extensions, the element ID SHALL be [Profile].extension:[Extension name without the ExtensionUKCore prefix, in camelCase] . E.g, for ExtensionUKCoreBirthSex this will be Patient.extension:birthSex |
differential .element .sliceName |
0..1 | 0..1 | string | When used for extensions, the element ID SHALL be [Extension name without the ExtensionUKCore prefix, in camelCase] . E.g, for ExtensionUKCoreBirthSex this will be birthSex |
differential .element .defaultValue[x] |
0..1 | 0..0 | * | Defining default values creates many difficulties in implementation (e.g. when is a value missing?). For these reasons, default values SHALL NOT be used within the UKCore. |
Schedule | .. | |
Schedule.identifier | .. | |
Schedule.identifier.assigner | Reference(UK Core Organization) | .. |
Schedule.specialty | .. | |
Schedule.actor | Reference(UK Core Device | UK Core HealthcareService | UK Core Location | UK Core Patient | UK Core Practitioner | UK Core PractitionerRole | UK Core RelatedPerson) | .. |
Schedule.actor.identifier | .. | |
Schedule.actor.identifier.assigner | Reference(UK Core Organization) | .. |
<StructureDefinition xmlns="http://hl7.org/fhir"> <id value="UKCore-Schedule" /> <url value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Schedule" /> <version value="1.2.0" /> <name value="UKCoreSchedule" /> <title value="UK Core Schedule" /> <status value="active" /> <date value="2022-12-16" /> <publisher value="HL7 UK" /> <contact> <name value="HL7 UK" /> <telecom> <system value="email" /> <value value="ukcore@hl7.org.uk" /> <use value="work" /> <rank value="1" /> </telecom> </contact> <description value="This profile defines the UK constraints and extensions on the International FHIR resource [Schedule](https://hl7.org/fhir/R4/Schedule.html)." /> <purpose value="Schedule resources provide a container for time-slots that can be booked using an appointment. It provides the window of time (period) that slots are defined for and what type of appointments can be booked.\n\nThe schedule does not provide any information about actual appointments. This separation greatly assists where access to the appointments would not be permitted for security or privacy reasons, while still being able to determine if an appointment might be available." /> <copyright value="Copyright © 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7® FHIR® standard Copyright © 2011+ HL7 The HL7® FHIR® standard is used under the FHIR license. You may obtain a copy of the FHIR license at https://www.hl7.org/fhir/license.html." /> <fhirVersion value="4.0.1" /> <mapping> <identity value="w5" /> <uri value="http://hl7.org/fhir/fivews" /> <name value="FiveWs Pattern Mapping" /> </mapping> <mapping> <identity value="rim" /> <uri value="http://hl7.org/v3" /> <name value="RIM Mapping" /> </mapping> <mapping> <identity value="ical" /> <uri value="http://ietf.org/rfc/2445" /> <name value="iCalendar" /> </mapping> <kind value="resource" /> <abstract value="false" /> <type value="Schedule" /> <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Schedule" /> <derivation value="constraint" /> <differential> <element id="Schedule.identifier.assigner"> <path value="Schedule.identifier.assigner" /> <type> <code value="Reference" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" /> </type> </element> <element id="Schedule.specialty"> <path value="Schedule.specialty" /> <binding> <strength value="extensible" /> <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-PracticeSettingCode" /> </binding> </element> <element id="Schedule.actor"> <path value="Schedule.actor" /> <type> <code value="Reference" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Device" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-HealthcareService" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Location" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Practitioner" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-PractitionerRole" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-RelatedPerson" /> </type> </element> <element id="Schedule.actor.identifier.assigner"> <path value="Schedule.actor.identifier.assigner" /> <type> <code value="Reference" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" /> </type> </element> </differential> </StructureDefinition>
{ "resourceType": "StructureDefinition", "id": "UKCore-Schedule", "url": "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Schedule", "version": "1.2.0", "name": "UKCoreSchedule", "title": "UK Core Schedule", "status": "active", "date": "2022-12-16", "publisher": "HL7 UK", "contact": [ { "name": "HL7 UK", "telecom": [ { "system": "email", "value": "ukcore@hl7.org.uk", "use": "work", "rank": 1 } ] } ], "description": "This profile defines the UK constraints and extensions on the International FHIR resource [Schedule](https://hl7.org/fhir/R4/Schedule.html).", "purpose": "Schedule resources provide a container for time-slots that can be booked using an appointment. It provides the window of time (period) that slots are defined for and what type of appointments can be booked.\n\nThe schedule does not provide any information about actual appointments. This separation greatly assists where access to the appointments would not be permitted for security or privacy reasons, while still being able to determine if an appointment might be available.", "copyright": "Copyright © 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7® FHIR® standard Copyright © 2011+ HL7 The HL7® FHIR® standard is used under the FHIR license. You may obtain a copy of the FHIR license at https://www.hl7.org/fhir/license.html.", "fhirVersion": "4.0.1", "mapping": [ { "identity": "w5", "uri": "http://hl7.org/fhir/fivews", "name": "FiveWs Pattern Mapping" }, { "identity": "rim", "uri": "http://hl7.org/v3", "name": "RIM Mapping" }, { "identity": "ical", "uri": "http://ietf.org/rfc/2445", "name": "iCalendar" } ], "kind": "resource", "abstract": false, "type": "Schedule", "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Schedule", "derivation": "constraint", "differential": { "element": [ { "id": "Schedule.identifier.assigner", "path": "Schedule.identifier.assigner", "type": [ { "code": "Reference", "targetProfile": [ "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" ] } ] }, { "id": "Schedule.specialty", "path": "Schedule.specialty", "binding": { "strength": "extensible", "valueSet": "https://fhir.hl7.org.uk/ValueSet/UKCore-PracticeSettingCode" } }, { "id": "Schedule.actor", "path": "Schedule.actor", "type": [ { "code": "Reference", "targetProfile": [ "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Device", "https://fhir.hl7.org.uk/StructureDefinition/UKCore-HealthcareService", "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Location", "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient", "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Practitioner", "https://fhir.hl7.org.uk/StructureDefinition/UKCore-PractitionerRole", "https://fhir.hl7.org.uk/StructureDefinition/UKCore-RelatedPerson" ] } ] }, { "id": "Schedule.actor.identifier.assigner", "path": "Schedule.actor.identifier.assigner", "type": [ { "code": "Reference", "targetProfile": [ "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" ] } ] } ] } }
baseDefinition
SHALL point to the UK Core base profile it is derived from.DiagnosticReport | .. | |
DiagnosticReport.category | 1.. | |
DiagnosticReport.category | .. | |
DiagnosticReport.category.coding | .. | |
DiagnosticReport.category.coding.system | .. | |
DiagnosticReport.category.coding.code | .. | |
DiagnosticReport.code | .. | |
DiagnosticReport.subject | Reference(UK Core Patient) | 1.. |
DiagnosticReport.result | Reference(UK Core Observation | UK Core Observation Lab Group | UK Core Observation Lab) | .. |
<StructureDefinition xmlns="http://hl7.org/fhir"> <id value="UKCore-DiagnosticReport-Lab" /> <url value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-DiagnosticReport-Lab" /> <version value="1.0.0" /> <name value="UKCoreDiagnosticReportLab" /> <title value="UK Core DiagnosticReport Lab" /> <status value="active" /> <date value="2023-04-28" /> <publisher value="HL7 UK" /> <contact> <name value="HL7 UK" /> <telecom> <system value="email" /> <value value="ukcore@hl7.org.uk" /> <use value="work" /> <rank value="1" /> </telecom> </contact> <description value="Defines the constraints and extensions on the UK Core Profile DiagnosticReport" /> <purpose value="To provide implementers with additional support when implementing test result data and to provide a consistent structure to how the data is presented." /> <copyright value="Copyright © 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7® FHIR® standard Copyright © 2011+ HL7 The HL7® FHIR® standard is used under the FHIR license. You may obtain a copy of the FHIR license at https://www.hl7.org/fhir/license.html." /> <fhirVersion value="4.0.1" /> <kind value="resource" /> <abstract value="false" /> <type value="DiagnosticReport" /> <baseDefinition value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-DiagnosticReport" /> <derivation value="constraint" /> <differential> <element id="DiagnosticReport"> <path value="DiagnosticReport" /> <constraint> <key value="ukcore-diag-lab-001" /> <severity value="warning" /> <human value="An effective time SHOULD be present if status = partial, preliminary, final, amended, corrected or appended" /> <expression value="effective.exists() or (effective.empty() and (status in ('partial' | 'preliminary' | 'final' | 'amended' | 'corrected' | 'appended')).not())" /> </constraint> </element> <element id="DiagnosticReport.category"> <path value="DiagnosticReport.category" /> <slicing> <discriminator> <type value="value" /> <path value="coding.code" /> </discriminator> <rules value="open" /> </slicing> <min value="1" /> </element> <element id="DiagnosticReport.category:sliceLaboratory"> <path value="DiagnosticReport.category" /> <sliceName value="sliceLaboratory" /> </element> <element id="DiagnosticReport.category:sliceLaboratory.coding.system"> <path value="DiagnosticReport.category.coding.system" /> <fixedUri value="http://terminology.hl7.org/CodeSystem/v2-0074" /> </element> <element id="DiagnosticReport.category:sliceLaboratory.coding.code"> <path value="DiagnosticReport.category.coding.code" /> <fixedCode value="LAB" /> </element> <element id="DiagnosticReport.code"> <path value="DiagnosticReport.code" /> <fixedCodeableConcept> <coding> <system value="http://snomed.info/sct" /> <code value="721981007" /> <display value="Diagnostic studies report" /> </coding> </fixedCodeableConcept> </element> <element id="DiagnosticReport.subject"> <path value="DiagnosticReport.subject" /> <min value="1" /> <type> <code value="Reference" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient" /> </type> </element> <element id="DiagnosticReport.result"> <path value="DiagnosticReport.result" /> <type> <code value="Reference" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Observation" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Observation-LabGroup" /> <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Observation-Lab" /> </type> </element> </differential> </StructureDefinition>
{ "resourceType": "StructureDefinition", "id": "UKCore-DiagnosticReport-Lab", "url": "https://fhir.hl7.org.uk/StructureDefinition/UKCore-DiagnosticReport-Lab", "version": "1.0.0", "name": "UKCoreDiagnosticReportLab", "title": "UK Core DiagnosticReport Lab", "status": "active", "date": "2023-04-28", "publisher": "HL7 UK", "contact": [ { "name": "HL7 UK", "telecom": [ { "system": "email", "value": "ukcore@hl7.org.uk", "use": "work", "rank": 1 } ] } ], "description": "Defines the constraints and extensions on the UK Core Profile DiagnosticReport", "purpose": "To provide implementers with additional support when implementing test result data and to provide a consistent structure to how the data is presented.", "copyright": "Copyright © 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7® FHIR® standard Copyright © 2011+ HL7 The HL7® FHIR® standard is used under the FHIR license. You may obtain a copy of the FHIR license at https://www.hl7.org/fhir/license.html.", "fhirVersion": "4.0.1", "kind": "resource", "abstract": false, "type": "DiagnosticReport", "baseDefinition": "https://fhir.hl7.org.uk/StructureDefinition/UKCore-DiagnosticReport", "derivation": "constraint", "differential": { "element": [ { "id": "DiagnosticReport", "path": "DiagnosticReport", "constraint": [ { "key": "ukcore-diag-lab-001", "severity": "warning", "human": "An effective time SHOULD be present if status = partial, preliminary, final, amended, corrected or appended", "expression": "effective.exists() or (effective.empty() and (status in ('partial' | 'preliminary' | 'final' | 'amended' | 'corrected' | 'appended')).not())" } ] }, { "id": "DiagnosticReport.category", "path": "DiagnosticReport.category", "slicing": { "discriminator": [ { "type": "value", "path": "coding.code" } ], "rules": "open" }, "min": 1 }, { "id": "DiagnosticReport.category:sliceLaboratory", "path": "DiagnosticReport.category", "sliceName": "sliceLaboratory" }, { "id": "DiagnosticReport.category:sliceLaboratory.coding.system", "path": "DiagnosticReport.category.coding.system", "fixedUri": "http://terminology.hl7.org/CodeSystem/v2-0074" }, { "id": "DiagnosticReport.category:sliceLaboratory.coding.code", "path": "DiagnosticReport.category.coding.code", "fixedCode": "LAB" }, { "id": "DiagnosticReport.code", "path": "DiagnosticReport.code", "fixedCodeableConcept": { "coding": [ { "system": "http://snomed.info/sct", "code": "721981007", "display": "Diagnostic studies report" } ] } }, { "id": "DiagnosticReport.subject", "path": "DiagnosticReport.subject", "min": 1, "type": [ { "code": "Reference", "targetProfile": [ "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient" ] } ] }, { "id": "DiagnosticReport.result", "path": "DiagnosticReport.result", "type": [ { "code": "Reference", "targetProfile": [ "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Observation", "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Observation-LabGroup", "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Observation-Lab" ] } ] } ] } }