Epic Integration

Userful’s Epic Integration allows customers in Healthcare to be able to visualize key operational data by connecting their Userful system with their Epic EHR system. Userful integration leverages Epic’s APIs to pull data and create visualizations. Currently the integration allows customers to pull data for hospital wait times and wait times by department, enabling customers to visualize this in operations centers or even distribute to screens throughout the healthcare facility, to inform staff on this key performance indicator.

Pre-set up - Request Userful Application

Before setting up the Epic integration on the Userful server. The organization must have added the Userful application to their Epic Environment. Per Epic, if they are unsure who has the required security to purchase apps or need to update a user’s security , they can ask their Epic representative or email vendorServicesTS@epic.com.

Epic has established a checklist procedures recommended that both our Userful (referred to as the Vendor) and the customer (referred to as an Epic Community Member) must follow. This checklist should be reviewed for successful planning and deployment, steps include:

  • App Implementation Kickoff Call

  • The App Request Process (customer request Userful App from Epic)

  • Implementation, Build, Setup and End-to-End Testing

  • Go live

  • Wrap-up and Ongoing Maintenance

Setup Epic Passport

In order to create a secure authentication between the Userful system and the customers Epic system, the customer must create a authentication passport. Multiple passports can be created as needed.

  • Navigate to Sources and Destinations

  • Select Integrations on the left hand menu

  • Select Epic

  • Enter server name.

  • Enter the Epic server URL

    1. The system validates the environment, retrieves essential information, and obtains and maintains an authentication token, periodically refreshing it

    2. This method uses Epic’s Backend Services authentication method, which is Epic’s recommended method

  • Optionally: The user can enable authentication based on username and password. This uses Epic’s Non OAuth2 authentication method, also referred to as HTTP basic authentication. This method is not usually recommended.

  • Select environment type

  • If the details are valid, the status should reflect as Connected.

Creating an Epic wait times chart source

The wait times charting source will display the rolling average waiting time from the present to as far back as the last 24 hours. The chart can display average waiting times by department or hospital as a whole. Furthermore, the chart can display the longest current wait time and the number of patients in the waiting queue.

To create a wait times chart source

  • Go to the Epic Integration menu

Sources and Destinations > Integrations > Epic

  • Select Integrations Sources

  • Fill

  1. Title

  2. Graph title

  3. Select a passport to use

  • Select how far back to look back on, in minutes (maximum is 24 hours, meaning 1440 minutes)

  • Enter data refresh rate (in seconds)

  • Enter the ‘Department ID’ and ‘Department Type’ for the department wait times you wish to display

  • Optionally, enter any permissions restrictions.

  • Save - Once the source is created, it will be mappable to displays from either the Decisions or Trends applications

Epic source visualization

When this source is mapped to a destination or a source inside of Decisions, the configured data is visualized through a bar chart at the destination.

Example visualization:

Last updated

Copyright © 2024 Userful Corporation. All rights reserved.