FGM DMS baselined as Version 1 Release Candidate (RC1).
Spine-Practitioner-1-0 profile / XML example
Spine-Organization-1-0 profile/ XML Example
Spine-Request-MessageHeader-1-0 profile/ XML Example
Spine-RIS-Parameters-1-0 Profile
The Risk Indicator and NHS Number parameter value 'open type' element (which is represented by the wildcard symbol '*') has been restricted to the String data type only.
Spine-RIS-Parameters-1-0 XML Example
To support the Spine-RIS-Parameters-1-0 profile change, the Risk Indicator and NHS Number parameter.value XML elements have been amended as follows:
FGM Resource Name and URL Changes
All FGM FHIR resources are now versioned, identified using URLs (instead of URNs) and their names genericised to allow for future re-use within the Spine 2 interface. The changes are as follows:
Structured Definitions (Profile) | URL |
---|---|
Spine-Message-Bundle-1-0 | http://fhir.nhs.net/StructureDefinition/spine-message-bundle-1-0 |
Spine-Request-MessageHeader-1-0 | http://fhir.nhs.net/StructureDefinition/spine-request-messageheader-1-0 |
Spine-Response-MessageHeader-1-0 | http://fhir.nhs.net/StructureDefinition/spine-response-messageheader-1-0 |
Spine-RIS-Flag-1-0 | http://fhir.nhs.net/StructureDefinition/spine-ris-flag-1-0 |
Spine-RIS-Patient-1-0 | http://fhir.nhs.net/StructureDefinition/spine-ris-patient-1-0 |
Spine-RIS-Parameters-1-0 | http://fhir.nhs.net/StructureDefinition/spine-ris-parameters-1-0 |
Spine-Organization-1-0 | http://fhir.nhs.net/StructureDefinition/spine-organization-1-0 |
Spine-Practitioner-1-0 | http://fhir.nhs.net/StructureDefinition/spine-practitioner-1-0 |
Spine-OperationOutcome-1-0 | http://fhir.nhs.net/StructureDefinition/spine-operationoutcome-1-0 |
Value Sets | URL |
---|---|
SDS-Job-Role-Name-1-0 | http://fhir.nhs.net/ValueSet/sds-job-role-name-1-0 |
Message-Event-1-0 | http://fhir.nhs.net/ValueSet/message-event-1-0 |
Risk-Indicator-Type-1-0 | http://fhir.nhs.net/ValueSet/risk-indicator-type-1-0 |
Spine-Response-Code-1-0 | http://fhir.nhs.net/ValueSet/spine-response-code-1-0 |
Identifiers | URL |
---|---|
SDS-User-Id | http://fhir.nhs.net/Id/sds-user-id |
SDS-Role-Profile-Id | http://fhir.nhs.net/Id/sds-role-profile-id |
ODS-Organization-Code | http://fhir.nhs.net/Id/ods-organization-code |
ODS-Site-Code | http://fhir.nhs.net/Id/ods-site-code |
Accredited-System-Id | http://fhir.nhs.net/Id/accredited-system-id |
NHS-Number | http://fhir.nhs.net/Id/nhs-number |
Bundle and MessageHeader Profile Changes
The Bundle and MessageHeader Infrastructure resource profiles have been decoupled from the FGM Query/ Response messages to allow for future re-use within the Spine 2 interface.
The 'Spine-Message-Bundle-1-0' Infrastructure resource should be used in both request and response interactions.
FHIR Messaging Architecture
Updated to include the 'FGM Service' implementation details.
FHIR Messages
There is no Spine interface requirement for the meta.lastUpdated Base Resource metadata element. Element has been removed from all the spine-request-messageheader-1-0/ spine-response-messageheader-1-0 FGM examples.
Includes guidance on resource identity and metadata usage within this DMS.
Where necessary the FGM resource profiles have been aligned with the official release of FHIR DSTU2 1.0.1 (Sept 2015) specification. The profile changes are as follows:
NHS-FGM-MessageHeader-QueryParameters Profile
The MessageHeader.identifier (UUID) element has been removed from the profile, with the MessageHeader.id element (UUID) assuming the same functionality.
The messageHeader.event.code has been changed to: urn:nhs:names:services:clinicals-sync:FGMQuery_1_0
The messageHeader.source.endpoint and messageHeader.destination.endpoint URN format has been changed to: urn:nhs:addressing:asid:047192794544
NHS-FGM-MessageHeader-QueryResponse Profile
The MessageHeader.identifier (UUID) element has been removed from the profile, with the MessageHeader.id element (UUID) assuming the same functionality.
The messageHeader.event.code has been changed to: urn:nhs:names:services:clinicals-sync:FGMQueryResponse_1_0
The query response message now carries the request MessageHeader.id (UUID) in the MessageHeader.response.identifier element so that the source system can pair the response to its request.
The messageHeader.source.endpoint and messageHeader.destination.endpoint URN format has been changed to: urn:nhs:addressing:asid:047192794544
NHS-FGM-Flag Profile
The Patient element has been renamed to 'subject'.
NHS-FGM-OperationOutcome Profile
OperationOutcome.issue.code data type changed to 'code' which is bound to the required FHIR 'issue-type' value-set.
OperationOutcome.issue.details replaces old code/coding elements. It remains bound to the SpineResponseCode value-set.
OperationOutcome.issue.diagnostics replaces the description element.
Value-Set SpineResponseCode (urn:x-fhir:uk:nhs:vs:SpineResponseCode)
SpineResponseCode codes agreed as follows:
Value-Set issue-type (http://hl7.org/fhir/ValueSet/issue-type)
The issue-type codes will be mapped to SpineResponseCode value-set as follows:
Value-Set MessageEvent (urn:x-fhir:uk:nhs:vs:MessageEvent)
The FGM MessageEvent codes have been amended to URN syntax and the codes are now constructed by prepending the Spine 2 service name (urn:nhs:names:services:clinicals-sync) to the original message event code e.g.urn:nhs:names:services:clinicals-sync:FGMQuery_1_0.
FGM Resource URN
The FGM profile URN syntax have been amended as follows:
Inbound Profiles:
Outbound Profiles:
The FGM identifier URN syntax has been amended as follows:
The FGM value-set URN syntax has been amended as follows:
Examples
The XML examples have been amended to support all the above changes.
Changes made to the FGM RIS DMS after initial feedback from Spine 2 development team.
NHS-FGM-QueryParameters Profile
To support Spine 2 identification of the query parameters, the value xml attributes of the Parameters.parameter.name elements are now populated with 'RiskIndicator' and 'NHSNumber' strings respectively.
NHS-FGM-OperationOutcome Profile
OperationOutcome.issue.location element removed from profile as no Spine 2 requirement to return XPath location of the FGM RIS Query 'fatal-error' within the FGM RIS Query Response message.
NHS-FGM-Bundle-QueryResponse (Operation Outcome - No FGM Record Found) Bundle
The OperationOutcome resource is now used to convey a 'No FGM Record Found' response. When a 'No FGM Record Found' bundle is sent, the value xml attributes of the MessageHeader and OperationOutcome resource elements are now populated as follows:
NHS-FGM-Bundle-QueryResponse (Operation Outcome) Bundle
When an 'Operation Outcome' bundle is sent, the value xml attributes of the MessageHeader and OperationOutcome resource elements are now populated as follows:
Examples
The XML examples have been amended to support the resource profile changes.
The JSON (JavaScript Object Notation) examples have been removed from the DMS, as the Spine 2 FGM RIS interface does not support this data format.
First Draft
First draft of FGM RIS DMS (Version 1.0 Draft A) created to support development of the Spine 2 national FGM Query/ Response FHIR Messaging interface.