2. FHIR IG

2.1. Introduction

This IG describes a patient use case in the context of the information standard "Image Availability" (Dutch: Beeldbeschikbaarheid or BBS), version 1.0.0-alpha.2. The information standard Image Availability as published by Nictiz does not yet include a patient use case, this may change in the future. Up until then, the patient use case will be published by MedMij.

This IG is a technical counterpart of the functional design. The FHIR version used for this IG is R4 (4.0.1).

2.2. Actors involved

Actors Systems FHIR CapabilityStatements
Name Description Name Description Name Description
Patient The user of a personal healthcare environment PHR (Document Consumer) Personal health record [TO DO] FHIR client requirements
Healthcare provider The user of a XIS XIS (Document Responder) Healthcare information system [TO DO] FHIR server requirements

2.3. Boundaries and relationships

This FHIR IG includes use cases for the exchange of Images and Reports between health care providers (e.g. hospitals) and patients (e.g. in a PHR setting).

This IG guide assumes that a PHR is able to connect with a XIS. It does not provide information on finding the right source system nor does it provide information about security. These infrastructure and interface specifications are described in the 'MedMij Afsprakenstelsel'.

2.4. Relating FHIR (profiles) to its functional counterpart

The BBS FHIR IG, section 4.3 describes the (intended) mapping between metadata, FHIR (DocumentReference) and the ART-DECOR dataset. In this FHIR IG, we incorporate the aforementioned functional mapping provided by Nictiz BBS. This mapping is not yet available in FHIR profiles.

2.5. Use cases

The use cases in this IG are based as much as possible on the specifications described in the BBS FHIR IG, section 4.3. In short: IHE MHD and WIA.

2.5.1. Use case: Retrieve Image and Report in personal health environment

The Nictiz BBS FHIR IG splits the transactions in different use cases, for reasons of convenience. Seen from the perspective of a patient using a PHR, retrieval of images and reports from a healthcare provider is a related activity performed in one action. Therefore, this IG bundles the BBS use cases as one.

2.5.1.1. Query Timeline Data (MHD ITI-67)

Based on Use case 3: Query Timeline Data (Raadplegen Tijdlijn Data) in the Nictiz BBS FHIR IG, see https://profiles.ihe.net/ITI/MHD/ITI-67.html for further details.

The ITI-67 transaction is used to find available documents for a patient, based on a search on DocumentReference.

2.5.1.1.1. PHR: request message

The PHR (Document Consumer) executes an HTTP search against the DocumentReference endpoint of the XIS.

See https://profiles.ihe.net/ITI/MHD/ITI-67.html#236741-find-document-references-request-message for further details.

2.5.1.1.2. XIS: response message

The XIS (Document Responder) returns an HTTP Status code appropriate to the processing as well as a Bundle of the matching DocumentReference resources.

See https://profiles.ihe.net/ITI/MHD/ITI-67.html#236742-find-document-references-response-message for further details.

2.5.1.2. Retrieve Imaging Report (MHD ITI-68)

Based on Use case 4: Retrieve Imaging Report (Raadplegen Verslag) in the Nictiz BBS FHIR IG, see https://profiles.ihe.net/ITI/MHD/ITI-68.html for further details.

2.5.1.2.1. PHR: request message

The PHR (Document Consumer) sends an HTTP GET request to the server. The Document Consumer request is to retrieve the document content referenced by a DocumentReference.content.attachment.url.

See https://profiles.ihe.net/ITI/MHD/ITI-68.html#236841-retrieve-document-request-message for further details.

2.5.1.2.2. XIS: response message

The returned Imaging Report SHOULD use a correct contentType on DocumentReference.content.attachment.contentType, reflecting the format of the original report. This MAY include CDA, PDF, DICOM Basic Text Structured Report (SR), or other structured or unstructured formats originating from an EHR.

See https://profiles.ihe.net/ITI/MHD/ITI-68.html#236842-retrieve-document-response-message for further details.

2.5.1.3. Retrieve Images (MHD ITI-68)

Based on Use case 5: Retrieve Images (Raadplegen Beeld) in the Nictiz BBS FHIR IG, see https://profiles.ihe.net/ITI/MHD/ITI-68.html for further details.

2.5.1.3.1. PHR: request message

The PHR (Document Consumer) sends an HTTP GET request to the server. The Document Consumer request is to retrieve the document content referenced by a DocumentReference.content.attachment.url.

See https://profiles.ihe.net/ITI/MHD/ITI-68.html#236841-retrieve-document-request-message for further details.

2.5.1.3.2. XIS: response message

The returned content SHOULD follow the DICOM JSON Model, using the correct contentType on DocumentReference.content.attachment.contentType. The DICOM JSON SHOULD contain references to the relevant images following the WADO-RS format.

See https://profiles.ihe.net/ITI/MHD/ITI-68.html#236842-retrieve-document-response-message for further details.