Please note:

This guidance is currently under revision. There will be disruption as the content will be updated daily and with links not working.
The latest published guide can be found here.
Please follow the guidance on the "Contact Us" page if you need any assistance.

Profile Design

The HL7 FHIR® standard

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".

General profiling approach

The checklist below was adhered to when developing a draft UK Core profile suitable for progression to Clinical and Technical Assurance.

Use any corresponding CareConnect profile as a starting point For each profile, where a CareConnect STU3 profile exists, refer to it as a starting point for the UK Core FHIR R4 profiling exercise,
Consider the resource changes between FHIR STU3 and R4 versions Analyse the changes in the FHIR standard between FHIR STU3 version and FHIR R4,for example the addition or deletion of any elements and the introduction of new or updated terminology assets in the R4 version.
Referencing to resources SHOULD be to the base resource rather than a UK Core Profile, unless agreed.

Approach to StructureDefinition elements

Identifiers - Where existing CareConnect STU3 profiles have applied slicing and profiling to identifiers, this will be recreated in the UK Core profiles, then evaluated during Clinical and Technical assurance.
Removal of elements - No elements will be removed from the FHIR assets for the UK Core profiles during initial profiling prior to Clinical and Technical Assurance.
Experimental element - The FHIR specification defines the 'StructureDefinition.experimental' element as the following, when set to ‘true’: 'This structure was authored for testing purposes (or education/evaluation/marketing), and is not intended for genuine usage.' (Source: HL7). Currently there is no requirement in the UK Core to set the experimental element as ‘true’ or ‘false’, so this field should remain in the default view (undefined).

Naming Convention

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:-

Base: (Mandatory) - The base for a profile this will always be UKCore.
FHIRAssetName: (Mandatory) - The name of the base FHIR Resource.
Specialism: (Required) - This is only used where there are multiple / derived UK Core profiles for a given base resource type.

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.

Metadata Usage

The list below contains the element differences between the UKCore and HL7.

Base Resource Definitions

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]`.

StructureDefinition Content

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. This SHOULD contain the correct usage of the profile, for instance when it is similar to another profile examples of the expected use cases and examples which would be a misuse of the profile. The purpose is not to record the scope if these are subject to change, these SHALL be entered into the IG 'example use cases' section instead.
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.

Profile Illustration

Snapshot View

Schedule	I		Schedule	There are no (further) constraints on this element Element Id Schedule Short description A container for slots of time that may be available for booking appointments Alternate names Availability Definition A container for slots of time that may be available for booking appointments. Data Type Schedule Constraints dom-2:If the resource is contained in another resource, it SHALL NOT contain nested Resources `contained.contained.empty()` dom-4:If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()` dom-3:If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource `contained.where((('#'+id in (%resource.descendants().reference \| %resource.descendants().as(canonical) \| %resource.descendants().as(uri) \| %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()` dom-6:A resource should have narrative for robust management text.`div`.exists() dom-5:If a resource is contained in another resource, it SHALL NOT have a security label `contained.meta.security.empty()` Mappings rim:Entity. Role, or Act rim:n/a ical:BEGIN:VFREEBUSY ??? END:VFREEBUSY (If your fhir server provides this information via calDAV, then you may want to include addressing information in a URL section, and with the search, a DTSTART and DTEND component can be included to indicate the range of time that has been covered in the collection of slots, where these overlap the resources period values. For all slots that reference this resource, include a FREEBUSY row for each slot)
identifier	Σ	0..*	Identifier	There are no (further) constraints on this element Element Id Schedule.identifier Short description External Ids for this item Definition External Ids for this item. Data Type Identifier Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CX / EI (occasionally, more often EI maps to a resource id or a URL) rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT] servd:Identifier w5:FiveWs.identifier ical:UID
active	S Σ ?!	0..1	boolean	Element Id Schedule.active Short description Whether this schedule is in active use. Definition Whether this schedule record is in active use or should not be used (such as was entered in error). Comments This element is labeled as a modifier because it may be used to mark that the resource was created in error. Meaning When Missing This resource is generally assumed to be active if no value is provided for the active element Data Type boolean Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a w5:FiveWs.status
serviceCategory	Σ	0..*	CodeableConcept	There are no (further) constraints on this element Element Id Schedule.serviceCategory Short description High-level category Definition A broad categorization of the service that is to be performed during this appointment. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data Type CodeableConcept Binding ServiceCategory (example) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CE/CNE/CWE rim:CD orim:fhir:CodeableConcept rdfs:subClassOf dt:CD w5:FiveWs.class
serviceType	Σ	0..*	CodeableConcept	There are no (further) constraints on this element Element Id Schedule.serviceType Short description Specific service Definition The specific service that is to be performed during this appointment. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data Type CodeableConcept Binding ServiceType (example) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CE/CNE/CWE rim:CD orim:fhir:CodeableConcept rdfs:subClassOf dt:CD w5:FiveWs.class ical:n/a
specialty	S Σ	0..*	CodeableConceptBinding	Element Id Schedule.specialty Short description Type of specialty needed. Definition The specialty of a practitioner that would be required to perform the service requested in this appointment. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data Type CodeableConcept Binding Additional details about where the content was created (e.g. clinical specialty). UKCorePracticeSettingCode (extensible) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CE/CNE/CWE rim:CD orim:fhir:CodeableConcept rdfs:subClassOf dt:CD w5:FiveWs.class
actor	S Σ I	1..*	Reference(Patient \| Practitioner \| PractitionerRole \| RelatedPerson \| Device \| HealthcareService \| Location)	Element Id Schedule.actor Short description Resource(s) that availability information is being provided for. Definition Slots that reference this schedule resource provide the availability details to these referenced resource(s). Comments The capacity to support multiple referenced resource types should be used in cases where the specific resources themselves cannot be scheduled without the other, and thus only make sense to the system exposing them as a group. Common examples of this are where the combination of a practitioner and a room (Location) are always required by a system. Data Type Reference(Patient \| Practitioner \| PractitionerRole \| RelatedPerson \| Device \| HealthcareService \| Location) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1:SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))` Mappings rim:n/a rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity) w5:FiveWs.subject[x] ical:ATTENDEE:MAILTO:john_public@host2.com This can be populated with a value from the referenced resource w5:FiveWs.subject
planningHorizon	S Σ I	0..1	Period	Element Id Schedule.planningHorizon Short description Period of time covered by schedule. Definition The period of time that the slots that reference this Schedule resource cover (even if none exist). These cover the amount of time that an organization's planning horizon; the interval for which they are currently accepting appointments. This does not define a "template" for planning outside these dates. Comments A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration. Data Type Period Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1:If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)` Mappings rim:n/a v2:DR rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] w5:FiveWs.planned ical:DTSTART:20131201T003000Z DTEND:2014030101T003000Z
comment		0..1	string	There are no (further) constraints on this element Element Id Schedule.comment Short description Comments on availability Definition Comments on the availability to describe any extended information. Such as custom constraints on the slots that may be associated. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data Type string Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a ical:COMMENT:(comment) If there is no comment, then the line can be excluded from the iCalendar entry

Differential View

Schedule	I		Schedule	There are no (further) constraints on this element Element Id Schedule Short description A container for slots of time that may be available for booking appointments Alternate names Availability Definition A container for slots of time that may be available for booking appointments. Data Type Schedule Constraints dom-2:If the resource is contained in another resource, it SHALL NOT contain nested Resources `contained.contained.empty()` dom-4:If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()` dom-3:If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource `contained.where((('#'+id in (%resource.descendants().reference \| %resource.descendants().as(canonical) \| %resource.descendants().as(uri) \| %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()` dom-6:A resource should have narrative for robust management text.`div`.exists() dom-5:If a resource is contained in another resource, it SHALL NOT have a security label `contained.meta.security.empty()` Mappings rim:Entity. Role, or Act rim:n/a ical:BEGIN:VFREEBUSY ??? END:VFREEBUSY (If your fhir server provides this information via calDAV, then you may want to include addressing information in a URL section, and with the search, a DTSTART and DTEND component can be included to indicate the range of time that has been covered in the collection of slots, where these overlap the resources period values. For all slots that reference this resource, include a FREEBUSY row for each slot)
identifier	Σ	0..*	Identifier	There are no (further) constraints on this element Element Id Schedule.identifier Short description External Ids for this item Definition External Ids for this item. Data Type Identifier Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CX / EI (occasionally, more often EI maps to a resource id or a URL) rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT] servd:Identifier w5:FiveWs.identifier ical:UID
active	S Σ ?!	0..1	boolean	Element Id Schedule.active Short description Whether this schedule is in active use. Definition Whether this schedule record is in active use or should not be used (such as was entered in error). Comments This element is labeled as a modifier because it may be used to mark that the resource was created in error. Meaning When Missing This resource is generally assumed to be active if no value is provided for the active element Data Type boolean Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a w5:FiveWs.status
serviceCategory	Σ	0..*	CodeableConcept	There are no (further) constraints on this element Element Id Schedule.serviceCategory Short description High-level category Definition A broad categorization of the service that is to be performed during this appointment. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data Type CodeableConcept Binding ServiceCategory (example) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CE/CNE/CWE rim:CD orim:fhir:CodeableConcept rdfs:subClassOf dt:CD w5:FiveWs.class
serviceType	Σ	0..*	CodeableConcept	There are no (further) constraints on this element Element Id Schedule.serviceType Short description Specific service Definition The specific service that is to be performed during this appointment. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data Type CodeableConcept Binding ServiceType (example) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CE/CNE/CWE rim:CD orim:fhir:CodeableConcept rdfs:subClassOf dt:CD w5:FiveWs.class ical:n/a
specialty	S Σ	0..*	CodeableConceptBinding	Element Id Schedule.specialty Short description Type of specialty needed. Definition The specialty of a practitioner that would be required to perform the service requested in this appointment. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data Type CodeableConcept Binding Additional details about where the content was created (e.g. clinical specialty). UKCorePracticeSettingCode (extensible) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CE/CNE/CWE rim:CD orim:fhir:CodeableConcept rdfs:subClassOf dt:CD w5:FiveWs.class
actor	S Σ I	1..*	Reference(Patient \| Practitioner \| PractitionerRole \| RelatedPerson \| Device \| HealthcareService \| Location)	Element Id Schedule.actor Short description Resource(s) that availability information is being provided for. Definition Slots that reference this schedule resource provide the availability details to these referenced resource(s). Comments The capacity to support multiple referenced resource types should be used in cases where the specific resources themselves cannot be scheduled without the other, and thus only make sense to the system exposing them as a group. Common examples of this are where the combination of a practitioner and a room (Location) are always required by a system. Data Type Reference(Patient \| Practitioner \| PractitionerRole \| RelatedPerson \| Device \| HealthcareService \| Location) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1:SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))` Mappings rim:n/a rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity) w5:FiveWs.subject[x] ical:ATTENDEE:MAILTO:john_public@host2.com This can be populated with a value from the referenced resource w5:FiveWs.subject
planningHorizon	S Σ I	0..1	Period	Element Id Schedule.planningHorizon Short description Period of time covered by schedule. Definition The period of time that the slots that reference this Schedule resource cover (even if none exist). These cover the amount of time that an organization's planning horizon; the interval for which they are currently accepting appointments. This does not define a "template" for planning outside these dates. Comments A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration. Data Type Period Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1:If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)` Mappings rim:n/a v2:DR rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] w5:FiveWs.planned ical:DTSTART:20131201T003000Z DTEND:2014030101T003000Z
comment		0..1	string	There are no (further) constraints on this element Element Id Schedule.comment Short description Comments on availability Definition Comments on the availability to describe any extended information. Such as custom constraints on the slots that may be associated. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data Type string Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a ical:COMMENT:(comment) If there is no comment, then the line can be excluded from the iCalendar entry

Hybrid View

Schedule	I		Schedule	There are no (further) constraints on this element Element Id Schedule Short description A container for slots of time that may be available for booking appointments Alternate names Availability Definition A container for slots of time that may be available for booking appointments. Data Type Schedule Constraints dom-2:If the resource is contained in another resource, it SHALL NOT contain nested Resources `contained.contained.empty()` dom-4:If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()` dom-3:If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource `contained.where((('#'+id in (%resource.descendants().reference \| %resource.descendants().as(canonical) \| %resource.descendants().as(uri) \| %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()` dom-6:A resource should have narrative for robust management text.`div`.exists() dom-5:If a resource is contained in another resource, it SHALL NOT have a security label `contained.meta.security.empty()` Mappings rim:Entity. Role, or Act rim:n/a ical:BEGIN:VFREEBUSY ??? END:VFREEBUSY (If your fhir server provides this information via calDAV, then you may want to include addressing information in a URL section, and with the search, a DTSTART and DTEND component can be included to indicate the range of time that has been covered in the collection of slots, where these overlap the resources period values. For all slots that reference this resource, include a FREEBUSY row for each slot)
identifier	Σ	0..*	Identifier	There are no (further) constraints on this element Element Id Schedule.identifier Short description External Ids for this item Definition External Ids for this item. Data Type Identifier Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CX / EI (occasionally, more often EI maps to a resource id or a URL) rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT] servd:Identifier w5:FiveWs.identifier ical:UID
active	S Σ ?!	0..1	boolean	Element Id Schedule.active Short description Whether this schedule is in active use. Definition Whether this schedule record is in active use or should not be used (such as was entered in error). Comments This element is labeled as a modifier because it may be used to mark that the resource was created in error. Meaning When Missing This resource is generally assumed to be active if no value is provided for the active element Data Type boolean Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a w5:FiveWs.status
serviceCategory	Σ	0..*	CodeableConcept	There are no (further) constraints on this element Element Id Schedule.serviceCategory Short description High-level category Definition A broad categorization of the service that is to be performed during this appointment. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data Type CodeableConcept Binding ServiceCategory (example) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CE/CNE/CWE rim:CD orim:fhir:CodeableConcept rdfs:subClassOf dt:CD w5:FiveWs.class
serviceType	Σ	0..*	CodeableConcept	There are no (further) constraints on this element Element Id Schedule.serviceType Short description Specific service Definition The specific service that is to be performed during this appointment. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data Type CodeableConcept Binding ServiceType (example) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CE/CNE/CWE rim:CD orim:fhir:CodeableConcept rdfs:subClassOf dt:CD w5:FiveWs.class ical:n/a
specialty	S Σ	0..*	CodeableConceptBinding	Element Id Schedule.specialty Short description Type of specialty needed. Definition The specialty of a practitioner that would be required to perform the service requested in this appointment. Comments Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Data Type CodeableConcept Binding Additional details about where the content was created (e.g. clinical specialty). UKCorePracticeSettingCode (extensible) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a v2:CE/CNE/CWE rim:CD orim:fhir:CodeableConcept rdfs:subClassOf dt:CD w5:FiveWs.class
actor	S Σ I	1..*	Reference(Patient \| Practitioner \| PractitionerRole \| RelatedPerson \| Device \| HealthcareService \| Location)	Element Id Schedule.actor Short description Resource(s) that availability information is being provided for. Definition Slots that reference this schedule resource provide the availability details to these referenced resource(s). Comments The capacity to support multiple referenced resource types should be used in cases where the specific resources themselves cannot be scheduled without the other, and thus only make sense to the system exposing them as a group. Common examples of this are where the combination of a practitioner and a room (Location) are always required by a system. Data Type Reference(Patient \| Practitioner \| PractitionerRole \| RelatedPerson \| Device \| HealthcareService \| Location) Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ref-1:SHALL have a contained resource if a local reference is provided `reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))` Mappings rim:n/a rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity) w5:FiveWs.subject[x] ical:ATTENDEE:MAILTO:john_public@host2.com This can be populated with a value from the referenced resource w5:FiveWs.subject
planningHorizon	S Σ I	0..1	Period	Element Id Schedule.planningHorizon Short description Period of time covered by schedule. Definition The period of time that the slots that reference this Schedule resource cover (even if none exist). These cover the amount of time that an organization's planning horizon; the interval for which they are currently accepting appointments. This does not define a "template" for planning outside these dates. Comments A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). Period is not used for a duration (a measure of elapsed time). See Duration. Data Type Period Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` per-1:If present, start SHALL have a lower value than end `start.hasValue().not() or end.hasValue().not() or (start <= end)` Mappings rim:n/a v2:DR rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] w5:FiveWs.planned ical:DTSTART:20131201T003000Z DTEND:2014030101T003000Z
comment		0..1	string	There are no (further) constraints on this element Element Id Schedule.comment Short description Comments on availability Definition Comments on the availability to describe any extended information. Such as custom constraints on the slots that may be associated. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data Type string Constraints ele-1:All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim:n/a ical:COMMENT:(comment) If there is no comment, then the line can be excluded from the iCalendar entry

Table View

Schedule		..
Schedule.active		..
Schedule.specialty		..
Schedule.actor		..
Schedule.planningHorizon		..

XML View

<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="UKCore-Schedule" />
    <url value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Schedule" />
    <version value="1.3.0" />
    <name value="UKCoreSchedule" />
    <title value="UK Core Schedule" />
    <status value="active" />
    <date value="2023-12-12" />
    <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 &#169; 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the &quot;License&quot;); 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 &quot;AS IS&quot; 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&#174; FHIR&#174; standard Copyright &#169; 2011+ HL7 The HL7&#174; FHIR&#174; 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="Schedule" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Schedule" />
    <derivation value="constraint" />
    <differential>
        <element id="Schedule.active">
            <path value="Schedule.active" />
            <short value="Whether this schedule is in active use." />
            <mustSupport value="true" />
        </element>
        <element id="Schedule.specialty">
            <path value="Schedule.specialty" />
            <short value="Type of specialty needed." />
            <mustSupport value="true" />
            <binding>
                <strength value="extensible" />
                <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-PracticeSettingCode" />
            </binding>
        </element>
        <element id="Schedule.actor">
            <path value="Schedule.actor" />
            <short value="Resource(s) that availability information is being provided for." />
            <mustSupport value="true" />
        </element>
        <element id="Schedule.planningHorizon">
            <path value="Schedule.planningHorizon" />
            <short value="Period of time covered by schedule." />
            <mustSupport value="true" />
        </element>
    </differential>
</StructureDefinition>

JSON View

{
    "resourceType": "StructureDefinition",
    "id": "UKCore-Schedule",
    "url": "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Schedule",
    "version": "1.3.0",
    "name": "UKCoreSchedule",
    "title": "UK Core Schedule",
    "status": "active",
    "date": "2023-12-12",
    "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",
    "kind": "resource",
    "abstract": false,
    "type": "Schedule",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Schedule",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "Schedule.active",
                "path": "Schedule.active",
                "short": "Whether this schedule is in active use.",
                "mustSupport": true
            },
            {
                "id": "Schedule.specialty",
                "path": "Schedule.specialty",
                "short": "Type of specialty needed.",
                "mustSupport": true,
                "binding": {
                    "strength": "extensible",
                    "valueSet": "https://fhir.hl7.org.uk/ValueSet/UKCore-PracticeSettingCode"
                }
            },
            {
                "id": "Schedule.actor",
                "path": "Schedule.actor",
                "short": "Resource(s) that availability information is being provided for.",
                "mustSupport": true
            },
            {
                "id": "Schedule.planningHorizon",
                "path": "Schedule.planningHorizon",
                "short": "Period of time covered by schedule.",
                "mustSupport": true
            }
        ]
    }
}

Derived Profile

A derived profile SHALL follow the same conventions as above.
The element baseDefinition SHALL point to the UK Core base profile it is derived from.
Any derived profile SHALL also be a valid base profile.

Derived Profile Illustration