UK Core Clinical and Technical Assurance Sprint 8 Documentation Pack

UK Core Clinical and Technical Assurance Sprint 8 Documentation Pack

Proposed Changes

This section documents proposed changes to be applied to the UK Core for the next release. These are highlighted to allow reviewers to comment on the proposed changes. Solutions for the issues which lead to these proposed changes may have been discussed on the Clinical and Technical Assurance Sprint 8 calls but can still be challenged by any reviewer.

Number Context Type Source Issue Proposal Scope
Issue 1 UKCore-Observation-Group-Lab (Profile) Profiles UK Core Developement Team Profile has become redundant due to new element (Observation.organizer) in R6. Initial Proposal:

  • Retire UKCore-Observation-Group-Lab.
  • Create guidance on using the new backport.
  • Amend existing Group-Lab examples to use backport.

Main Points Raised in C&TA Calls:

Philip Brennan:
  • Confirms active work uses Observation + hasMember (EU pattern); this topic aligns with earlier grouping need.
  • Not uniform globally (some use DiagnosticReport as grouper), but majority trending to Observation hasMember; debate ongoing.
Ryan May:
  • Clarified distinction: earlier “grouping guidance” was generic; this item specifically retires the lab grouper.
Ian McNicoll:
  • Asked whether international consensus is forming on panel modelling.
Proposed In Scope - Development Done
Issue 2 UKCore-Observation-VitalSigns (Profile) Profiles UK Core Development Team UKCore-VitalSigns has been derived from HL7 VitalSigns. This means we have to use LOINC codes, however:
  • all other vitalsigns not derived from hl7 specific vitalsigns, but from UKCore-VitalSigns, e.g. bmi, bp
  • blood pressure, not derived from http://hl7.org/fhir/bp.html. slicing different to hl7 defined bp profile
  • BodyWeight Internation uses unit = kg (required) , we use "kilogram". US seem to have made LOINC optional
  • bmi base definition incorrect, should be http://hl7.org/fhir/StructureDefinition/bmi
Initial Proposal:

Review why the Profile is derived from HL7 base Observation-VitalSigns. Consider potential options. Options are:
  • Keep to HL7 derived Observation, even if against dm+d (e.g. no `m` in height valueset)
  • Derive from UK Core Observation and ignore HL7 derived Observation. This is possible as we are not deriving from them
  • Derive from UK Core but ensure closely aligned, where practicable, to HL7 profiles

Main Points Raised in C&TA Calls:

Kevin Sprague:
  • Agreed: “too big/complex” for a technical sprint; risk of breaking things.
  • Position this for a roadmap rather than quick fix.

Charlie McCay:
  • Asked for explicit rationale in the pack for why issues are out of scope (not just a list).
  • Suggested also tracking proposed HL7 International changes arising from UK findings.
Proposed Out of Scope
Issue 3 Profiles derived from Observation Implementation Guide UK Core Development Team The predecessor to the UK Core C&TA7 was an NHSD Observations IG. This gave much more information on how to use the Observations, search terms, how they link. Now they are between all other Profiles with not enough guidance on usage, as found with the PDM team. Initial Proposal:

Propose splitting into separate IG to keep together with more specific information on how to use.

Main Points Raised in C&TA Calls:

Kevin Sprague:
  • Process is currently disjointed (gap between tech assurance vs ballot); align road map first.
  • Acknowledged process hiccup; next Sprint should clarify inclusion/exclusion and sequencing.
Ben McAlister:
  • Observed derived profiles appear as active in the guide, causing confusion if they’re out of scope.
Ryan May:
  • Clarified the ballot status was draft, not balloted (corrected himself).
Proposed Out of Scope
Issue 4 Packages Naming convention UK Core Development Team Each STU version of package has a different name. Initial Proposal:

Propose using fhir.r4.ukcore x.0.0 to ensure standard approach and use correct project to separate major versions.

Main Points Raised in C&TA Calls:

Kevin Sprague:
  • It’s a process change reversing prior agreement; needs broader governance (HL7 UK / FIRE Board).
Proposed Out of Scope
Issue 5 All FHIR assets FHIR asset lifecycle process UK Core Development Team Having 'active' status after C&TA causes confusion. Initial Proposal:

Proposals:

draft - actively worked on ready for ballot. Will show in build only active - balloted retired - not to be used for future work, but needs to be available for historical use. Does this need to be in a package?

Click here for more information.

Main Points Raised in C&TA Calls:

Kevin Sprague:

  • Historically made Active after Clinical & Technical Assurance (vendors reluctant to implement Draft).
  • Proposal now: Active only after ballot; pre ballot content remains Draft but marked “assured” if it has been.
  • Needs careful back shuffling and explanation in next release.
Ben McAlister:
  • Wants clear distinguishability between balloted and non balloted content.
Ann Wrightson:
  • This belongs in the broader process refresh; current profile status options constrain what we can do; ensure consultation/engagement continues in any new model.
Ryan May:
  • HL7 UK working group will address this; must get it right the first time.
Proposed In Scope - Development Done
Issue 6 UKCore-Observation-AverageBloodPressure (Profile), UKCore-BloodPressure-Average (ValueSet) Profile, ValueSet UK Core User Community Require clarification of the word 'average' to mitigate clinical risk. The existence of the profile UKCore-Observation-AverageBloodPressure with its wording mentioning 'average' in unclear and creates a potential clinical risk. There is also a lack of 'parameters'. Initial Proposal:

Need to understand a need for this profile as average has a variation of meaning e.g. 24 hours, 72 hours, 30 days readings etc. Due to the uncertain meaning of average, it is felt clinically to be unsafe to keep this resource. If a resource is required, then keep generic Blood Pressure and then add parameters e.g.: invasive blood pressure, laterality, position etc: By doing this, the ValueSet is more constrained as the VS as-is is too large. Until there is a use case and a requirement, this resource is too risky to pursue as is.

Main Points Raised in C&TA Calls:

Kevin Sprague:
  • If no implementations depend on it, deprecate now; revisit when use case is clear.
Ann Wrightson:
  • Ask for direct, clear proposal sentence (“Retire the resource”) at the top, with rationale below.
Proposed In Scope
Issue 7 Sex Implementation Guide UK Core Development Team There are many different extensions representing the sex of a patient, as well as Patient.gender. There is no clear guidance on which extensions, or the Patient.gender element, should be used for which use case. Initial Proposal:

Propose discussing how and where the patient's sex is described.

Main Points Raised in C&TA Calls:

No main points raised.
Proposed Out of Scope
Issue 8 Observation panel (group) Implementation Guide UK Core Development Team Lack of clarity on how Observations should be grouped, with the most common having unrelated items within a single Observation instance. Initial Proposal:

Propose guidance around how to group observations, similar to the lab one. May include creating an Observation-Group profile.

Main Points Raised in C&TA Calls:

Philip Brennan:
  • Implementation reality (Labs → GP): using Observation as grouper (EU pattern), back adopting R6 Observation.organizer Boolean; progressing in production.
Kevin Sprague:
  • Will align with Phil offline; later slides include related R6 back port work in scope.
  • Agreed: build a roadmap via FIRE Board; this sprint is alignment; process to be revamped.
Heather Wallace:
  • NHS Wales doing observation grouping for child growth charts—flag for future.
Charlie McCay:
  • Capture these real implementations and workarounds in the pack for community benefit.
Andrew Perry:
  • Pressed that imminent implementations should raise priority; advocated a roadmap to address pressing issues.
Proposed Out of Scope
Issue 9 Extension-UKCore-CodingSCTDescDisplay (Extension) Implementation Guide UK Core Development Team The IG guidance states that if the sct-descId is sent, then the UK Core sctdescDisplay SHALL be used. Initial Proposal:

The requirement should be changed from SHALL to MAY.

https://simplifier.net/guide/UK-Core-Implementation-Guide-STU3-Sequence/Home/Guidance/CodeableConcept-Guidance?version=current#Sending-a-SNOMED-CT-Description-ID-that-is-not-the-preferred-term

Main Points Raised in C&TA Calls:

Kevin Sprague:

  • There’s a live vendor issue suggesting UK Core diverges from base FHIR behavior; reviewing; may need options (including deprecation).
Ann Wrightson:
  • While under review, relaxing to MAY helps implementers and reduces harm.
Charlie McCay:
  • This should be solved internationally (HL7 + SNOMED), not by a UK only extension; avoid extending extensions; basic FHIR–SNOMED integration must be straightforward.
Ryan May:
  • Context: the need was to send a non preferred term text alongside the conceptId; past misuse included sending descriptionIds as codes.
Proposed In Scope
Issue 10 sct-descid Implementation Guide UK Core Development Team Use of sct-descId for mapping and READ codes. The extension is only for showing a non-preferred term within SCT, linking it with the preferred term. If using other codes systems and mapping to SCT then both would go in seperate .coding elements, with userSelected chosen to represent the original. Initial Proposal:

Remove the word 'SHALL' in the guidance. Guidance here

Remove the extension from this example as not part of explanation and can cause confusion. Guidance here

Main Points Raised in C&TA Calls:

Ryan May:
  • Confirmed: Read code should be its own coding entry; don’t use the SCT descriptionId extension to carry non SNOMED codes; simplify example.
Proposed In Scope
Issue 13 Parameter FHIR Asset UK Core Development Team IG Publishing tool gives the following warning if you haven’t set the Snomed CT edition. Initial Proposal:

Propose to include SNOMED version in Parameter resource.

Main Points Raised in C&TA Calls:

Kevin Sprague:
  • Not hurting anyone now; needs analysis and agreement—put on roadmap.
Proposed Out of Scope
Issue 16 Encounter (Profile), Appointment (Profile), Slot (Profile) Binding Simplifier Issue Appointment/Slot binds to http://terminology.hl7.org/CodeSystem/service-type Initial Proposal:

Propose to bind to https://fhir.hl7.org.uk/ValueSet/UKCore-CareSettingType (Uses SNOMED CT UK Refset with fully specified name 'Services simple reference set’) as it does in Encounter

Main Points Raised in C&TA Calls:

Kevin Sprague:
  • Binding strength likely preferred (advisory, not enforced); this improves guidance without mandating.
Proposed In Scope
Issue 17 UKCore-BloodPressure-Systolic (ValueSet) Terminology Concepts Simplifier Issue Concepts to use when recording central venous pressure. Currently if you are representing a CVP or other invasive blood pressures, which appear to be in scope, there are no appropriate concepts to record the systolic and diasolic pressures. It would not be correct to use 271649006 | Systolic blood pressure (observable entity)as this is not what it is. So to represent correctly you would need to use a concept specifically for invasive blood pressure. Initial Proposal:

Propose to use a concept such as 276776003 |Right atrial pressure - a wave (observable entity) | or 276772001 |Right ventricular systolic pressure (observable entity)|. This would need validating with clinical experts.

Main Points Raised in C&TA Calls:

Kevin Sprague:
  • Short term: disallow non systemic/invasive usages under this profile until clarified; align with prior work.
Ian McNicoll:
  • Distinguish systemic arterial blood pressure (vital signs) versus localised pressures (e.g., right atrial/ventricular).
  • Invasive is OK if it reflects systemic arterial BP; otherwise use different concepts.
  • Trim value sets; can share text/guidance and align with prior archetype work.
Ann Wrightson:
  • Clarify what is “not OK”: don’t use the generic BP profile for localised pressures; use appropriate alternative model.
Andrew Perry:
  • Support: restrict BP profiles to left sided/systemic meanings; document how to record alternatives.
  • Reminded that GP systems store triples (grouper + systolic + diastolic).
Kanthan Theivendran:
  • Clinically: ward/GP “BP” ≠ ICU pressures; e.g., RAP reflects diastolic—mismatch under current systolic value set.
Proposed In Scope
Issue 18 UKCore-Observation-VitalSigns-BloodPressure (Profile) Terminology Concepts Simplifer Issue There are 3 SNOMED CT codes used in this model top level to record the type of BP - then 2 codes to record the systolic and diastolic results/values. Initial Proposal:

For each top code it needs to be validated that there are clinically validated systolic concepts defined. Or even if the concept of systolic and diastolic is valid for CVP and invasive blood pressures. This need work with an expert in intensive care to validate.

Main Points Raised in C&TA Calls:

Ian McNicoll:
  • Keep the top level “BP” code generic (as a grouper); actual semantics live in systolic/diastolic children; trim the top level value set.
Ann Wrightson:
  • Document intended use as vital signs (ward/GP) to avoid scope creep.
Kevin Sprague:
  • Treat 17 & 18 together; align with existing work (Ian’s).
Proposed In Scope
Issue 19 UKCore-Observation-AverageBloodPressure (Profile) Terminology Concepts Simplifier Issue The SNOMED CT concepts identified include invasive blood pressures but believe this should not be in scope. If they are then as for #3297 the concepts need validation with intensive care experts to validate that the concepts for the values and the units are all available. Initial Proposal:

If they are then as for #3297 the concepts need validation with intensive care experts to validate that the concepts for the values and the units are all available.

Main Points Raised in C&TA Calls:

Kevin Sprague:
  • Will fall out naturally once BP scoping is corrected.
Proposed In Scope
Issue 21 UKCore-AllergyManifestation (ValueSet) Terminology Simplifier Issue Health issues simple reference set (1127581000000103) is retired. Initial Proposal:

No proposal stated.

Main Points Raised in C&TA Calls:

Ann Wrightson:
  • Asked to replace “seems retired” with firm evidence; document how retirement is confirmed.
Andrew Perry:
  • Confirmed retirements; explained background (large, hard to maintain refsets; alternatives exist).
  • Can suggest an alternative refset/binding if needed.
  • IPS sets are too small/coarse for manifestations like rash subtypes; not ideal for UK clinical detail.
Ian McNicoll:
  • Suggested considering IPS value sets for alignment.
Kevin Sprague:
  • Illustrates why out of scope: needs proper multi party terminology session; add to roadmap.
Proposed Out of Scope
Issue 22 UKCore-Observation-TobaccoConsumption (Profile), UKCore-TobaccoConsumption (ValueSet) Modelling UK Core Development Team tobaccoConsuption profile only allows valueQuantity, but SNOMED CT UK has codes such as 160603005 | Light cigarette smoker (1-9 cigs/day) (finding)| Initial Proposal:

Propose loosening up to allow valueCodeableConcepts, with a valueset to include all types of tobacco use.

Main Points Raised in C&TA Calls:

Ann Wrightson:
  • Revisit purpose and usage contexts (what needs comparability?); minimise UX burden.
Sian Musto:
  • If quantities are captured, categories can be derived—understand why categorical terms are needed vs raw measures.
Andrew Perry:
  • Origin may be PRSB; will analyse GP usage stats for pre coordinated smoking concepts; note QoF complexity and that status ≠ single recording.
Ian McNicoll:
  • Clinical priority is smoking status (current/ex/never) as the key risk factor; allowing coded consumption is fine, but ensure status is addressed (e.g., separate profile/element).
Kanthan Theivendran:
  • Points to openEHR Tobacco Smoking Summary as a good reference for clinical data elements; AU FHIR uses archetypes to guide shapes.
Charlie McCay:
  • Primary fix now: correct the value set description (it wrongly says “level of consciousness”).
  • Don’t over generalise—keep this profile focused on consumption; create separate value sets/profiles for smoking status and other perspectives; document intended use and misuse explicitly.
Kevin Sprague:
  • Agreed: update description; consider additional artefacts but avoid burdening implementers.
Proposed In Scope
back to top