Radiology (Sandbox)
0.0.1-current - ci-build International flag

Requirement Specification

This is for collaboration and discussion purposes and is subject to change.

This is not an Implementation Guide

Radiology (Sandbox) - Local Development build (v0.0.1-current) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Requirements: Actor Definitions

The following artifacts define the types of individuals and/or systems that will interact as part of the use cases covered by this implementation guide.

Clinical Data Repository

The Clinical Data Repository is responsible for the persistent storage of clinical data items (observations, conditions, immunisations, etc). E.g. PHR, EHR and EPR

Directory Service

Provides lookup or query services for master Organisation, Facility, Location, Practitioner, Healthcare Service, OrganisationAffiliation, and Endpoint records which meet specific criteria.

Document Consumer

The Document Consumer Actor queries for documents meeting certain criteria, and may retrieve selected documents.

Document Registry

The Document Registry Actor maintains maintains a index of records held in Document Repositories and Form Repositories, the index metadata is called a Document Entry (or DocumentReference in FHIR) metadata about each registered document in a document entry. This includes a link to the Document in the Repository where it is stored. The Document Registry responds to queries from Document Consumer actors about documents meeting specific criteria. E.g. XDS System, NRL and is also often found Clinical Data Repositories.

Document Repository

The Document Repository is responsible for both the persistent storage of these documents (and compositions). E.g. XDS System, EPR and EDMS

Event Consumer

The Event Consumer Actor receives events.

Event Source

The Event Source Actor produces events based event triggers which occur during clinical activity (e.g. patient discharged).

Imaging Repository

The Imaging Repository is responsible for both the persistent storage of DICOM Images and Imaging Studies, these may also contain Imaging Reports. E.g. PACS.

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

Find and Retrieve Imaging Reports

This is a capture of requirements coming from this project.

Although this is classed here as a Document Repository, it may often be implemented as a Clinical Data Repository and so the actual API may be more expressive e.g. IHE Query for Existing Data for Mobile (QEDm).

Finding and Retrieving Document Entries IHE ITI-67

Finding and Retrieving Document Entries

This is IHE Mobile access to Health Documents (MHD) - Find Document References ITI-67 linked to UK/NHS England specific Document Metadata

Finding and Retrieving Document Entries NRL

This is a local version of

for documentation purposes.

Retrieve Image Instances

This is a capture of requirements coming from this project.

The actual API is:

Retrieve Imaging Study

This is a capture of requirements coming from this project.

The actual API is:

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

Document

Is a logical representation of a variety of structured data entities which are normally made available by a repository. For unstructured data items this is classed as a Binary and will be in traditional document formats such as pdf or jpeg. Within NHS England this is also known as a Health Record and this is what a pointer points to.

Structured Data Items (documents) in this project include:

Document Entry

Based on

At present this is not based on UK Core DocumentReference as this is analysis of enterprise entity models but will be at a later date.

DocumentReference Minimal Document Metadata

See IHE MHD Minimal DocumentReference

Documentation only at present - is not currently required in the project.

Image

Notes on (DICOM) Image.

Imaging Report (FHIR DiagnosticReport)

DiagnosticReport based on

Users should also review this analysis in conjunction with IHE Interactive Multimedia Report (IMR) - IMR DiagnosticReport

Imaging Study

Ignore, just a collection of notes.

NRL DocumentReference

This is based on National Record Locator - FHIR API v3 - Producer - Create new, or Supersede existing, document pointers and is for documentation purposes only.

Radiology ServiceRequest

Ignore, just a collection of notes.

Structures: Data Type Profiles

These define constraints on FHIR data types for systems conforming to this implementation guide.

Accredited System Identifiers

From eRS ASID Description

Accredited System Identifier is an identifier used in Spine Directory Service (SDS) to reference an IT system which has been accredited for use in a specific health or care organisation.

The application created within API Management will be bound to an ASID. This is a one-to-one mapping and the ASID is representative of the end-user organisation. If you’re working with many end-user organisations you will need multiple ASIDs.

General Medical Council Reference Number

GENERAL MEDICAL COUNCIL REFERENCE NUMBER which is a CONSULTANT CODE

Format CNNNNNNN

  • HL7 v3/OID: 2.16.840.1.113883.2.1.3.2.4.16.63
  • HL7 v2: GMC
  • HL7 FHIR https://fhir.hl7.org.uk/Id/gmc-number
General Medical Practitioner PPD Code

GENERAL MEDICAL PRACTITIONER PPD CODE. Formerly called GP General National Code (GNC).

Format G[1234589]NNNNNN

  • HL7 v3/OID: 2.16.840.1.113883.2.1.3.2.4.16.62
  • HL7 v2: GMP
  • HL7 FHIR: https://fhir.hl7.org.uk/Id/gmp-number
Medical Record Number

Only use in References if the NHS Number is not known or unverified.

Standard Data Type Value
NHS Data Dictionary   -
OID/HL7 v3    
HL7 v2 CX.4  
HL7 FHIR Identifier.system  
HL7 v2 CX.5 MR
HL7 FHIR Identifier.type http://terminology.hl7.org/CodeSystem/v2-0203#MR
HL7 v2 CX.6 ODS Code
HL7 FHIR Identifier.assigner.identifier https://fhir.nhs.uk/Id/ods-organization-code#{ODS Code}
NHS Number

Only traced NHS Number SHOULD be used, un-traced NHS Numbers MUST be clearly indicated.

Format: NNNNNNNNNN (400 000 000 to 499 999 999, and 600 000 000 to 799 999)

Standard Data Type Value
NHS Data Dictionary   NHS NUMBER
OID/HL7 v3   2.16.840.1.113883.2.1.4.1
HL7 v2 CX.4 NHS
HL7 FHIR Identifier.system https://fhir.nhs.uk/Id/nhs-number
HL7 v2 CX.5 NH
HL7 FHIR Identifier.type http://terminology.hl7.org/CodeSystem/v2-0203#NH
Organisation Code

NHS Data Dictionary ORGANISATION_CODE

Organisation Site Identifier

NHS Data Dictionary ORGANISATION SITE IDENTIFIER

Use ODS Site code relevant for organisation. E.g. Use Mid Yorkshire Hospitals NHS Trust (RXF) version of Pinderfields Hospital (RXF05) when referring to Mid Yorks, not others in the director

Radiological Accession Number
Data Item Standard Data Type Value
RADIOLOGICAL ACCESSION NUMBER NHS Data Dictionary    
  DICOM (0008,0050) {value}
  HL7 FHIR Identifier.value {value}
  IHE XDS DocumentEntry.referenceIdList {value} using HL7 v2 CX format?
  HL7 v2 CX.1 {value}
Identifier type HL7 v2 CX.5 ACSN
  HL7 FHIR Identifier.type http://terminology.hl7.org/CodeSystem/v2-0203#ACSN
Assigning Facility HL7 v2 CX.6 ODS Code
  HL7 FHIR Identifier.assigner.identifier https://fhir.nhs.uk/Id/ods-organization-code#{ODS Code}
Reference - RESTful

A Reference data type where the referenced resource is expected to be resolvable RESTfully.

Reference - RESTful or Logical

A Reference data type where the referenced resource could be resolvable RESTfully or pointed to logically.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

Document Entry Class
Document Entry Type
Document Entry Type Imaging Report

Experimental

Facility Type

ACTIVITY LOCATION TYPE CODE

ImagingCodeNICIP

IMAGING CODE (NICIP)

Concept Map between NHS England UK SNOMED CT and NICIP Mapping spreadsheet

Modality

Modality

Service
ServiceProvision Code

E.g. NICIP?

Not specified in eRS and BARS

Specialty

Example: Example Scenarios

These define groups of interrelated examples that demonstrate one or more of the workflows supported by this implementation guide.

Finding Imaging Reports and Images - Central Registry (NRL)

New method of populating NRL from IHE XDS or like systems

Finding Imaging Reports and Images - Federated (IHE)

New method of populating NRL from IHE XDS or like systems

Update National Record Locator

New method of populating NRL from IHE XDS or like systems

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

Bundle - DiagnosticReport Search Results NRL

Example search results for Imaging Report with an id of ABCD

GET https://example.nhs.uk/FHIR/R4/DiagnosticReport?_id=ABCD

Bundle - Document Reference Search Results MHD

Example search results for patient with a NHS Number: 9912003888 who has Diagnostic studies reports and Imaging report

GET https://example.nhs.uk/FHIR/R4/DocumentReference?patient:identifier=https://fhir.nhs.uk/Id/nhs-number|9912003888&category=http://snomed.info/sct|721981007,http://snomed.info/sct|4201000179104

Bundle - Document Reference Search Results NRL

Example search results for patient with a NHS Number: 9912003888

GET https://example.nhs.uk/FHIR/R4/DocumentReference?patient:identifier=https://fhir.nhs.uk/Id/nhs-number|9912003888

IHE MHD Provide Document Bundle Example

Example of IHE MHD Provide Document Bundle [ITI-65] minimal metadata. This is a FHIR Transaction Bundle containing a DocumentReference for an Imaging Stufy (which is referenced via a url/pointer) to the study) and a Document SubmissionSet (FHIR List) POST https://example.nhs.uk/FHIR/R4/

ListExample
NRL Version of the transaction Bundle

Example sending of a FHIR Transaction Bundle containing a DocumentReference for an Imaging Report

POST https://example.nhs.uk/FHIR/R4/

Example: IHE Radiology Context

Examples associated with IHE Radiology to support National Imaging Registry

DocumentReference IHE ITI-65 Minimal Metadata for a Imaging Study

This is the same DocumentReference IHE for a Imaging Study with an embedded document to meet ITI-65 requirements.

DocumentReference IHE for a Imaging Report - can be also be in IHE XDS Document Entry format

DocumentReference IHE for a Imaging Report

DocumentReference IHE for a Imaging Study

DocumentReference IHE for a Imaging Study - can be also be in IHE XDS Document Entry format

Imaging Report based on Royal College of Radiologists HL7 v2 ORU converted to HL7 FHIR

Example: NIR/NRL Context

Examples associated with the extension of National Record Locator to support National Imaging Registry

DocumentReference NRL for a Imaging Report

Document Reference NRL

DocumentReference NRL for a Imaging Study

DocumentReference NRL for a Imaging Study

Radiology DiagnosticReport based on National Imaging Registry Alpha Specification