Patient Portal

Summary

This enhancement to the Patient Portal adds support for downloading DICOM images from the Patient Exam Detail Page.

Background

Previously, the ability to download images from the Patient Portal was unavailable.

Feature Description                                                  

With this change, patients can now download images as DICOM for their selected exam from the Patient Portal.

To initiate a download:

1.       From the Images tab, click the Download button to expand the download panel:

2.       Select the type of download file (.ZIP, .ISO):

a.       PortalDicomFileTypeZip

b.       PortalDicomFileTypeISO

3.       The first request to download images (or clicking the Need Help? link) presents a dialog describing how to use the download feature:

4.       Check the consent to download PHI checkbox.

5.       Click Download to initiate the request:

·         The Portal presents a progress icon while a background process sends a request to PACS to query, retrieve, and package the DICOM in the selected file format.

A processing icon will display next to the exam list while the request is pending.

Users have the option to cancel the request or to be notified when the download is available.

6.       Once the request is processed and the download is available.

A download icon will display once the file is available.

this icon will allow the user to click on them to load that study and auto focus the images tab, and expand the download button.

7.       Upon clicking, the user will receive a notification guiding them back to the downloaded exam.

a.       PPPACSDownloadIsAvailableNotification

When clicked the user will be directed back to the downloaded exam.

8.       A download dialog box will be presented allowing patient to specify location for download.

·         The File name field be will auto populated as Accession-ExamFriendlyDescription

·         If PACS cannot locate the ExamFriendlyDescription, the File name with auto populate with the Accession only.

9.       The last downloaded date and expiry date will be displayed when study is selected.

10.    All download request will be stored in the database and a history is available via the Patient's Account Page in the Image Download tab.

a.       A similar grid is available to the Portal Admin to View/Cancel/Remove image request that are pending/downloading.

this will allow the user to see when the request was created and when the download was completed.

Download Limiting

To prevent abuse, users are limited to the frequency and number of downloads. This criteria will be controlled via new system configuration settings. If the user does exceed one of these restrictions, they will be prompted to delete an active request and the download form will be disabled.

The Image Download tab can be accessed to remove any pending downloads to help alleviate the queue.

·         The PortalPACSMediaRequestQueueLimit System Config setting limits the number of requests a user can be downloading concurrently. No additional requests can be started (queued) until an active request completes.

·         The PortalPACSMediaRequestDownloadLimit System Config setting limits the number of study files a user can have downloaded at any given time. No additional files will be downloaded until a previous file has been removed via the PortalPACSMediaDownloadAutoDeleteHours setting or manually by the user.

Additionally, if the URL for the current active session is modified to a different media session ID, which is not associated to the active user, a message from PortalDicomFileDoNotHaveAccess will present and notify the user that they do not have access to download the file.

Known Limitations

The following limitations have been identified and should be communicated to affected users:

·         Known behavior (from #34653)

The notification message that indicates when downloads are ready is not being displayed. However, this does not impact the overall functionality of Feature #27190.

There is additional functionality planned for a future release that will change the implementation approach, and is expected to impact how this feature will be configured:

·         A related future enhancement will add support for downloading DICOM images from the Provider Portal:

Feature #30949 - Image DICOM Download in Provider Portal

Service Team Upgrade Instructions

The Service Team must complete the following actions to deploy this feature: 

Portals

See also Changes to ParagraphConfig Lookup Table.

Changes to applicationsettings.config

·         Enable this feature by setting PACSImageDownloading to True and;

·         Setting the DICOM_Download appconfig option to True for any PACS servers that are associated with the desired images.

Changes to ParagraphConfig Lookup Table

Changes to web.config

Configuration Instructions

System Administrators must complete the following actions to enable this feature and Service Team assistance is required for some actions:

RIS Client

Changes to SystemConfig Lookup Table

·         Configure PPPACSMediaDownloadLocation for your installation.

The following related settings were added or updated: