MedMij:Vprepub-2019.01 FHIR Images

{{#customtitle:MedMij FHIR Implementation Guide: Images}}

Introduction

This page describes the exchange of images within MedMij. In contrary to other described use cases for MedMij no existing information standard fits nor are there specific ZIB models applicable. To achieve exchange of images, MedMij adopts as much as possible from existing standards, such as the DICOM standard and the Mobile access to Health Documents (MHD) profile from Integrating the Healthcare Enterprise (IHE) that defines a RESTful/HTTP interface to an XDS environment using HL7 FHIR STU3 resources.

The specification currently consists of one use case, that covers sending an image by a patient to a healthcare provider. Based on future research, a use case to retrieve images by the patient will be added. Most likely, this will be based on DICOMweb™, which is the DICOM standard for web-based medical imaging based on RESTful services.

Note: this page is part of the MedMij FHIR Implementation Guide and is a technical representation of the functional design published on this wiki page.

IHE MHD specification

Mobile access to Health Documents (MHD) profile defines a simple HTTP interface to an XDS like environment. The four described transactions leverage the document content and format agnostic metadata concepts from XDS but simplify them for access by constrained environments such as mobile devices, or other resource-constrained systems. The MHD profile does not replace XDS. It can be used to allow mobile devices, or other resource-constrained systems, access to an XDS health information exchange.[1]

Wiki: Mobile acces to Health Document (MHD)

Document: MHD Supplement (Rev 2.3 July 24, 2017)

Additional Supplement: Appendix Z on HL7 FHIR

Actors and transactions involved

Table 1 shows the relevant actors, systems and FHIR capability statements in a MedMij context. The capability statements demonstrate the minimum requirements to be conformant to the described use cases.

Persons		Systems		FHIR Capability Statements
Name	Description	Name	Description	Name	Description
Patient	The user of a personal healthcare environment.	PHR	Personal health record	CapabilityStatement: Client	Image FHIR Client requirements
Healthcare Provider	The user of a XIS	XIS	Healthcare information system	CapabilityStatement: Server	Image FHIR Server requirements

Table 1. Actors, systems and FHIR capability statements

Table 2 shows the MHD actors and transactions in perspective of the systems used in a MedMij context.

Person	System	Role	MHD Actors - for XDS	MHD Transactions - for XDS
Patient	PHR	Sends image to the XIS	Document Source	Provide Document Bundle
Healthcare provider	XIS	Receives image from the PHR	Document Recipient

Table 2. MHD actors and transactions in perspective of systems in a MedMij context

Boundaries and Relationships

The use case where an image is sent from a PHR to a XIS is influenced by the IHE MHD profile with regards to the PHR message semantics and mandatory elements. The specifications for this use case mainly deviates in the use of the FHIR Media resource instead of the DocumentReference resource. Although the DocumentResource is in line with the requirements of persisting content in a XDS network and the resource can handle images, the Media resource is more appropriate and specific for the exchange of images. The Media resource has additional, more specific, (medical related) elements compared to the DocumentReference. These are the Media's view, reasonCode, bodySite, device and to a lesser extent the height and width elements. In addition, the Media resource has a reference coming from the DiagnosticReport that may be of value for further development of the MedMij information standard for images.

A XIS can possibly act within a XDS network. The information standards in use by MedMij have the primary objective to enable standardized communication based on FHIR STU3. As a secondary objective, enabling exchange with XDS networks is taken into account. For this objective, the PHR will need to provide additional meta information to the Media resource. The additional meta information allows XIS actors to index an image properly within a XDS network. The XIS is responsible for converting the PHR message into a XDS DocumentEntry. A mapping from the Media resource to the mandatory metadata elements of the IHE MHD DocumentReference resource is provided. The IHE MHD and general IHE XDS profiles will provide the information needed to perform a successful DocumentEntry of an image.

Use case: send image from a PHR to a XIS

Introduction

This use case describes the minimal required technical functionalities in order to exchange an image made by the patient to a healthcare provider. Typical process flow would be:

1. Patients makes, downloads or receives an image and uploads it to his PHR.
2. The PHR sends the image to the chosen XIS system.
   1. Potentially the patient needs to provide sufficient metadata concerning the image.
3. A healthcare provider views the image in his XIS.

This use case presumes made agreements between the patient and healthcare provider. Besides a technical answer by the XIS of the healthcare provider, no answer to the patient is expected.

The following technical specifications will concern the process mentioned at point 2.

Actors

Transaction group	Transaction	Actor	Role
Send Image Bundle (PUSH)	Send image bundle request	Patient (using a PHR)	Sends image to the XIS
	Receive image bundle response	Healthcare professional (using a XIS)	Receives image from PHR

Invocations

This FHIR implementation guide assumes that the PHR system is able to make a connection to the right XIS that contains the patient's information. It does not provide information on finding the right XIS nor does it provide information about security. Moreover, each transaction is performed in the context of a specific authenticated patient, for whose context (token) has been established using the authentication mechanisms described in the 'Afsprakenstelsel'. Each XIS Gateway is required to perform filtering based on the patient associated with the context for the request, so only the records associated with the authenticated patient are returned. For this reason, search parameters should not be included for patient identification.

Client - PHR request

When the patient (PHR) wants to send one or more images, it issues a send image bundle request message.

The PHR initiate a FHIR transaction using a create action by sending an HTTP POST request composed of a FHIR Bundle Resource containing one or more FHIR Media resources, zero or more Binary resources and one patient resource to the XIS Recipient. References to the FHIR specification for the required transaction and POST requests are given in the interactions, operations and search parameters section below.

The PHR executes an HTTP POST against the XIS's base endpoint as shown below.

POST [base] {?_format=[mime-type]}

The PHR shall assure all FHIR resource elements are consistent with the requirements specified in the StructureDefinitions for List, Media, Device, Patient, Practitioner and Organization resources. References to these StructureDefinitions are provided in list of StructureDefinitions.

Textual Requirements

• The Bundle.type shall be transaction.

• The Media.content.attachment.url points at the image content, which shall be in the Bundle as a Binary resource. See FHIR Resolving references in Bundles at the FHIR specification and use within MedMij at the MedMij Use case overarching principles.

• All Media.subject values shall be References to Patient resources and shall be included in the Bundle.

• A List resource shall be used to group the images if a collection of images are sent.

• Accompanying text from the patient for the image and/or collection of images shall be placed in the Media.note and List.note respectively.

Examples

Message components

• Media comprehensive data
• Media minimum data
• Binary of image
• List of Media resources

Transaction Bundle

• Transaction Bundle containing one image
• Transaction Bundle containing multiple images
• Transaction Bundle response - example from the FHIR spec

Server - XIS response

The XIS shall process the bundle atomically. If necessary for processing, the XIS shall retrieve resources referenced by absolute URLs in the FHIR Bundle Resource.

The XIS returns an HTTP Status code appropriate to the processing outcome, conforming to the transaction specification requirements as specified in the FHIR specification.

The XIS response message shall be sent when a success or error condition needs to be communicated. Success is only indicated once the image(s) is/are received and completely processed and persisted as appropriate to the XIS configuration.

To enable the PHR to know the outcome of processing the transaction, and the identities assigned to the resources by the XIS, the XIS shall return a Bundle, with type set to transaction-response, that contains one entry for each entry in the request, in the same order as received, with the Bundle.entry.response.outcome indicating the results of processing the entry. The XIS shall comply with FHIR Bundle transaction-response and the HTTP transaction-response specifications.

Server - XIS & XDS

If the receiving XIS is part of a XDS network, it will need to convert the PHR request message into a proper message for the IHE "Provide and Register Document Set-b [ITI-41]" transaction. The XIS shall create appropriate metadata from the resources in the FHIR Bundle. The PHR shall provide the minimally required metadata. A mapping is shown below to assist in the XDS entry. The FHIR Media resource is mapped to the mandatory elements in the IHE MHD Profile on "DocumentReference with Comprehensive (aka XDS-on-FHIR) Metadata". IHE MHD defined these elements as a minimum for a XDS DocumentEntry. The Media StructureDefinition contains a mapping to this profile and to XDS DocumentEntry, the List StructureDefinition contatins a mapping to the XDS 'Folder Metadata Attributes'. Some FHIR elements do not translate to XDS concepts; the handling of these elements is left to the implementer of the XIS.

Upon successful conversion of the FHIR Bundle to XDS metadata, the XIS shall execute the Provide and Register Document Set-b [ITI-41] transaction. The transaction result and any error or warning messages, shall be reported to the PHR. The XIS is responsible for translating the XDS response to the appropriate HTTP Status Code and FHIR OperationOutcome Resource in the Send Image Bundle Response Message.

Mapping Media to mandatory IHE MHD DocumentReference elements needed for XDS DocumentEntry

IHE MHD Profile on DocumentReference with Comprehensive (aka XDS-on-FHIR) Metadata	Media for images, used by the PHR	Implementation notes for XIS & XDS
DocumentReference.masterIdentifier	Media.identifier
DocumentReference.status		Fixed value "current".
DocumentReference.type	Media.type	Fixed LOINC code: 72170-4 Photographic image Unspecified body region Document.
DocumentReference.class	Media.reasonCode	If no reasonCode is present, a fixed LOINC code 72170-4 Photographic image Unspecified body region Document can be used.
DocumentReference.subject	Media.subject
DocumentReference.indexed	Media.occurrenceDateTime
DocumentReference.securityLabel	Media.meta.security	If no value is present 'normal' should be used as default.
DocumentReference.content	Media.content
DocumentReference.content.attachment	Media.content.attachment
DocumentReference.content.attachment.contentType	Media.content.attachment.contentType	Possible media content types: JPEG, PNG, GIF, JP2.
DocumentReference.content.attachment.url	Media.content.attachment.url
DocumentReference.content.attachment.size	Media.content.attachment.size
DocumentReference.content.attachment.hash	Media.content.attachment.hash
DocumentReference.content.format		Fixed value "mimeType Sufficient".

A number of fixed values can be used in indexing to a XDS network based on an image sent by a patient. These are status, type, security (if no value is given in the Media.meta.security element) and format. Below the technical representation of these fixed values is shown.

<DocumentReference>
  ....
    <status value="current" />
  ....
    <type>
        <coding>
            <system value="http://loinc.org/" />
            <code value="72170-4" />
            <display value="Photographic image Unspecified body region Document" />
        </coding>     	
    </type>
  ....
    <securityLabel>
        <coding>
            <system value="http://hl7.org/fhir/v3/Confidentiality" />
            <code value="N" />
            <display value="normal" />
        </coding>
    </securityLabel>
  ....
    <format>
        <system value="urn:oid:1.3.6.1.4.1.19376.1.2.3"/>
        <code value="urn:ihe:iti:xds:2017:mimeTypeSufficient"/>
        <display value="mimeType Sufficient"/>
    </format>
  ....
</DocumentReference>

Interactions, operations, search parameters

Interactions

The following logical interactions are needed for this use case:

• Create
• Transaction

Operations

There are no defined operations for this use case.

Search parameters

There are no search parameters needed for this use case.

List of StructureDefinitions

MedMij StructureDefinitions

Name NL	Name EN	FHIR Resource	URL profile
Patient	Patient	Patient	http://fhir.nl/fhir/StructureDefinition/nl-core-patient
Zorgverlener	HealthProfessional	Practitioner	http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner
Zorgaanbieder	HealthcareProvider	Organization	http://fhir.nl/fhir/StructureDefinition/nl-core-organization
Beeld	Image	Media	http://nictiz.nl/fhir/StructureDefinition/images-Media
CollectieBeelden	CollectionImages	List	http://nictiz.nl/fhir/StructureDefinition/images-List
MedischHulpmiddel.Product	MedicalDevice.Product	Device	http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceProduct

IHE MHD StructureDefinitions

IHE has defined StructureDefinitions and other Conformance resources applicable to this use case. The FHIR Implementation Guide on the IHE MHD wiki lists these StructureDefinitions.

• IHE MHD profile on Provide Document Bundle (ITI-65) transaction with Comprehensive Metadata
  • Canonical URL: http://ihe.net/fhir/StructureDefinition/IHE.MHD.ProvideDocumentBundle.Comprehensive

• IHE MHD Profile on DocumentReference (DocumentEntry) when used in the Provide Transaction with Comprehensive (aka XDS-on-FHIR) Metadata
  • Canonical URL: http://ihe.net/fhir/StructureDefinition/IHE.MHD.Provide.Comprehensive.DocumentReference

• IHE MHD Profile on List (Folder)
  • Canonical URL: http://ihe.net/fhir/StructureDefinition/IHE.MHD.List

Annex: Document history

Release notes

Release notes can be found on the functional design page.

History

Release	Date	Description
-	24-01-2019	Added FHIR examples and StructureDefinitions (Transaction Bundle and List profile). Textual improvements. Added and improved open issues with issue boxes. Added an open public consultation issue box at the top of the page. Moved release notes to the functional design page.
-	19-12-2018	Added FHIR examples and StructureDefinitions. Textual improvements.
-	13-12-2018	Added Media - DocumentReference mapping.
-	12-12-2018	Added Boundaries and Relationships. Added Client - PHR request. Added Server - XIS response. Added Server - XIS & XDS.
-	11-12-2018	Added introduction text.
-	10-12-2018	Added concept version.