SMART Web Messaging Demo EHR

A simple, mock EHR that can be used to test SMART Web Messaging capable apps.

CLICK HERE to launch it, or visit: https://barabo.github.io/swm-dd-demo/ehr/

User Instructions

Profile Audience

This simple, mock EHR was developed primarily for App developers wishing to test their implementation of SMART Web Messaging capabilities against a simple, demo EHR.

Embed your app into this demo EHR, initiate web messages to the EHR, and even modify the EHR responses before sending them back to your app!

Preparing Your App

Installing the Companion Library

There is a companion library that is distributed through npm. The full documentation is here.

Install it using the following command:

npm install --save swm-client-lib

Using the Library

This library is currently an ES6 module only. Import the module as shown in the example below:

import * as swm from 'swm-client-lib';

Configuration and Setup

Refer to the client library documentation for full instructions, including some of the concepts behind using the library to enable SMART Web Messaging in your app.

Link: https://github.com/barabo/swm-dd-demo/tree/main/lib

User Interface

The mock EHR features two panels. The left panel displays the most recent message received from your app. The right panel is automatically populated with a possible response to the received message, which mostly based on the received messageType. You can edit this response before sending it to your app, or select one of the template responses in the ‘Insert a response…’ dropdown.

EHR Configuration

Click the configure button in the upper right corner to enter your app URL.

Make sure your app is configured to use the value shown in the Session Handle, or messages from your app will be ignored by the Mock EHR!

EHR Scratchpad

Your app can create, read, update, and delete entries in the EHR scratchpad. Click the Scratchpad button to hide and reveal the scratchpad contents.

When an app sends a message that would modify the contents of the scratchpad, these modifications are done automatically by the mock EHR and a suitable response is automatically populated in the response panel.

ui.done

When an app sends a ui.done message to the EHR, the UI displays a 5 second countdown before closing the embedded app. You can click Cancel to keep your app open, or click ‘Close Now’ to close it immediately. Or wait for the timer to reach 0 and the EHR will close the app for you.

ui.launchActivity

When an app sends a ui.launchActivity message to the EHR, a pop-up screen is automatically displayed that is intended to simulate a navigation event in the EHR. When you click Close (or press Esc), the pop-up closes and a suitable response is automatically populated in the response panel.