HOWTO Activate a Patient's portal access - v6.0

From OpenEMR Project Wiki

Introduction

OpenEMR's patient portal capability has come in several configurations and been called many things over the years (and in older documentation). Currently, it is called 'The Patient Portal', or possibly the 'Native Patient Portal' to differentiate it from the 3d party portals that one might find added to OpenEMR.


The Patient Portal has received significant updates since the main v4.2 documentation and the supplemental 5.0 features. It seems about time to issue a complete re-write of the basic instructions of how to activate the portal and sign up a patient from inside OpenEMR, showing the v6.0 interface.


This doc borrows heavily from the 'Native Patient Portal' section of Patient Portal (all hail SherwinGaddis !) with some new features added.


Procedure

High-Level View - the main steps of this process:

1. Activate portal in OpenEMR Globals: Upon logging into OpenEMR, top menu tab: Administration>Globals>Portal: add a checkmark to "Enable patient portal" field.
2. Authorize patient in OpenEMR: This is patient-specific.
3. Create patient login credentials
4. Patient initial login


Activate portal in OpenEMR Globals

The portal is part of the OpenEMR codebase which merely needs to be activated for it to be accessed on the same server as the EMR itself. As seen in the Globals portal setting, the portal is a sub-page of the EMR.



Activation and selections of options occurs in (main menu:) Administration/ Globals/ Portal


Pv6-01.png



The individual settings:


  • Enable Patient Portal - turn it on
  • Patient Portal Site Address - This is the base URL of the practice's OpenEMR; the portal is a sub-site in it. Surf to this URL to log in.
  • Portal Uses Server Base Path (internal) - this setting is not completely obvious. Per the OpenEMR forum, if you get a 'URL not found' when attempting to access the portal, switch the checkbox to whatever it is not.
  • Enforce E-Mail in Portal Log On Dialog - require that the patient enter an email in addition to their login credentials
  • Allow New Patient Registration Widget - activate the capability of patients to register themselves as patients in the practice's OpenEMR, by using the portal.
  • Allow Online Appointments - let patients make appointments from the portal
  • Allow Online Secure Chat - let patients communicate with clinic staff from the portal
  • Allow Patient Ledger - let patients view their ledger in the portal
  • Allow Online Payments - let patients make payments on account from the portal
  • Allow Patients to Reset Credentials - let patients make new login credentials from the portal
  • Enable Patient Portal Document Download - let patients download portal documents

2. Authorize patient in OpenEMR

Multiple Demographics settings must be correct for a patient to use the patient portal. Note, the starting state of patient unauthorized for the portal:


Pv6-03a.png



tab: Contact

  • Contact email and Trusted email - depending on the EMR's patch version both of these need to be provided. They may be the same.
  • Home Phone
  • Click 'Save' if changes were made


Pv6-03.png


tab: Choices

  • Allow email - YES
  • Allow Patient Portal - YES
  • Note: In order for the patient to be emailed their portal login credentials an email address needs to be set in Administration->Globals->Notifications->'Patient Reminder Sender Email' (not pictured) and the SMTP server needs to be set up. See instructions for that elsewhere.
  • Click 'Save' if changes were made


Pv6-04.png

3. Create patient login credentials

In dashboard screen:

  • The portal button has changed to 'Create Onsite Portal Credentials' (oval below)
  • Click it


Pv6-05.png



  • Note the login is a numbered variant of the trusted email username.


Pv6-06.png



  • A print dialog opens to print the credentials-- not pictured since its appearance varies by computer system.
  • Print it, or close the print dialog to see the credentials:


Pv6-07.png



At this point, you may surf to the portal URL as shown in the globals setting for 'Patient Portal Site Address ', the first image in this document.


NOTE: If using the same browser to log into the portal as you are using to create the portal account,

it would be prudent to close the EMR before trying to log into the portal.


4. Patient Initial Login

This document is only intended to show how to activate a patient's portal account. But let's just briefly run over the screens that will be seen in the default portal.


Each screen pulls its information from the related (often named the same) section of the patient's record in the EMR.


See each screen's name in the top blue bar and in the menu down the left edge of the display (arrow in next image)


Profile

  • home screen showing demographics information
  • patient communications widget, the round rectangle at the top right (image below)
  • note green button at top right to 'Revise' demographics


Ppv6-01.png



Patient Communications widget

  • shows messages from clinic staff
  • gives access to other functions
Ppv6-02.png



Lists

  • of patient's clinical information

Ppv6-03.png


Document Center

  • documents for the patient to maintain in the portal
  • is a separate collection from documents in the EMR
  • click 'Home' button (oval at top right below) to return to the home screen


Ppv6-04.png



Appointments

  • requests for appointments made here will be passed to clinic staff for approval


Ppv6-05.png


Ledger

  • see their current account


Ppv6-06.png



Reports

  • see reports
  • download lab reports

Ppv6-07.png



Patient Secure Email

  • send/ receive secure emails
  • click 'Exit' (oval below) to return to the home screen

Ppv6-08.png



Secure Chat

  • secure messaging system with clinic staff

Ppv6-09.png



Signature On File

  • patient can leave a hand-written signature on file with which to sign documents in that section above.
  • click 'Cancel' or 'Save' (colored buttons at the bottom) to return to the home page

Ppv6-10.png

Related documentation

The Patient Portal has some associated functionality documented elsewhere for OpenEMR v5 but still applicable to v6.