Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Most of the setup process and instructions you can find Third-Party App Setup and Support Guide on Galaxy. This document serves as a supplement - it adds details specific to Way to Health, and points you to specific sections of the Galaxy document as not all portions of that document are necessary.

Table of Contents
minLevel1
maxLevel6
outlinefalse
typelist
printablefalse

The Way to Health platform powers a diverse range of programs with different workflows and integration needs. Our app listings specify the broadest set of APIs and interfaces we use, but each connected health program will only use a subset. In this document we’ll try to specify which features, which setup, and which apps are required for specific setup needed depends on which Way to Health integration features are used, and which method we types of connected health programs.

Much of this setup is applicable to all Way to Health programs - once the Embed is set up for one program, no additional IT setup is required to launch a second (or third, or thirty-third) program. If a future program requires an additional integration point (such as an outbound ADT feed), subsequent programs will be able to use that with no additional IT setup. The only exception is flowsheet rows and inbasket pools, which typically are set up per-program or at least per-care team or per type of data.

Your Way to Health implementation lead will guide your clinical, operational, and IT teams in deciding which features are needed for the specific program(s) you are implementing.

Use Case

Feature

Required Setup

Required apps

Enrolling patients

Messaging them manually

Viewing data

Embed

  • Webservices access (via

Oauth
  • OAuth)

FDI
  • Web App Integration Record (details below)

E2N, E2U, etc.
  • Web App Integration Launch Point (see Galaxy for details)

Way to Health [link]
  • “Way to Health” client ID

Sending patient-entered data to flowsheets

Flowsheet - via webservices

  • Webservices access (via Backend user)

  • Flowsheet FLO, FLT (Details below)

Way
  • “Way to Health -

backend [link]

Flowsheet - via HL7 feed

  • Backend” client ID

Inbound HL7 flowsheet feed

Alerting clinicians or care teams of patients needing attention

InBasket

  • Webservices access (via Backend user)

  • Inbasket pool/HIP (details below)

  • “Way to Health - Backend” client ID

Triggering programs post-discharge

Silencing programs during admissions

Outbound HL7 ADT feed

Triggering pre-procedure programs

Outbound HL7 Optime Scheduling feed

Information to send to Way to Health

...

Webservices access

To access webservices, we need:

  • Install app(s)

  • Backend user (if needed)

  • security, public key, not sure what else

Epic embed

Parameters we need

Devs need to know:

  • Base URLs

    • prod

    • non-prod

    • basic auth (if used)

    • oauth (if used)

  • Which features will be used?

    • embed?

    • flowsheet?

    • inbasket?

Desktop Integration

...

(reference: Send Specific Information to Your App Vendor)

When do we need this?

Example

Patient ID Type

Always

“MRN”, “HUP MRN”, “MR”, etc.

Interconnect Base URLs

  • Prod OAuth

  • Non-prod OAuth

Embed

https://vendorservices.epic.com/interconnect-amcurprd-oauth/

Interconnect Base URLs

  • Prod Basic Auth

  • Non-prod Basic Auth

Backend App (flowsheet, inbasket)

https://vendorservices.epic.com/interconnect-amcurprd-username/

Backend user EMP

  • Username

  • Password

Backend App (flowsheet, inbasket)

waytohealthuser / 15 char random string

Inbasket pool

  • Pool ID (HIP .1)

Each Inbasket where we’ll send escalations

14234

Flowsheet information

  • FLT .1

  • FLO .1

For each data point (e.g. systolic BP) that we’ll send via WebServices

Network configuration

If needed to access Interconnect

VPN info

To be worked out between your networking/security team and our sysadmin team

If we’re using a TCP-based HL7 feed (in either direction)

For inbound HL7 flowsheet, we can use the HL7v2 webservice instead

Root CA

If interconnect uses TLS certificates that are self-signed or signed by a CA not in Mozilla’s trust store

PEM file such as yourhospital_root_ca.pem

Epic embed

Desktop Integration

The Galaxy document Create Integration Records for Active Guidelines describes how to create the embedded view. Here are the details you’ll need to supply as you complete that setup:

Recommended method, using SMART launch

parameters

Client ID

Prod:

3aa086b8-6dfb-4143-9100-b8e003ebe2a2

Non-prod:

3ced6ceb-0741-4cf1-83ba-99f3b34d600a

Integration type

SMART on FHIR

Authentication Method

SMART on FHIR

Launch URL

Prod:

https://app.waytohealth.org/epic/smartLaunch

Non-prod:

https://staging.waytohealth.org/epic/smartLaunch

Launch Context

epicUsername

=

%SYSLOGIN%

mrn=

userFirstName

%USERFNAME%

userLastName

%USERLNAME%

mrn

%EPTID;;; ; ;nnnn;NONE;%

Instead of nnnn, use the ID type that w2h will use. See the launch token library for details.

csn

=

%CSN%

In some contexts this value will be empty, but if the embed is launched in the context of an encounter, having the CSN is useful for some workflows

  • userFirstName=%USERFNAME%

  • userLastName=%USERLNAME%

  • Method

    SMARTframeAncestor

    %CLIENTHOSTSOURCE%

    Legacy launch, using AES encryption

    reference: Configure the Integration Record for HTTP GET

    Launch URL

    https://app.waytohealth.org/epic/embed?encrypted=%CRYPTSTR%

    parameters

    • EPICUSERID=%SYSLOGIN%

    • PATID=%xxxx%

    • USERFNAME=%xxxx%

    • USERLNAME=%xxxx%

    Method

    AES

    Type

    1-PACS

    Model

    10-Web PACS

    Patient ID Type

    A value should be specified here, but will depend on your health system

    CRYPTURL

    Prod:

    https://app.waytohealth.org/epic/embed?encrypted=%CRYPTSTR%

    Non-prod:

    https://staging.waytohealth.org/epic/embed?encrypted=%CRYPTSTR%

    CRYPTALGO

    AES128 (question)

    CRYPTIVLENGTH

    0

    Launch Context

    EPICUSERID

    %SYSLOGIN%

    USERFNAME

    %USERFNAME%

    USERLNAME

    %USERLNAME%

    PATID

    %EPTID;;; ; ;nnnn;NONE;%

    Instead of nnnn, use the ID type that w2h will use. See the launch token library for details.

    CSN

    %CSN%

    In some contexts this value will be empty, but if the embed is launched in the context of an encounter, having the CSN is useful for some workflows

    frameAncestor

    %CLIENTHOSTSOURCE%

    Flowsheet

    via WebServices

    Sending data to flowsheets is part of the Premium Epic Integration package. It requires installing the Way to Health - Backend app from Connection Hub, and incurs an additional cost

    ...