How to: Integrate with an EHR

Our application is designed to integrate with SMART on FHIR (DSTU2) EHR environments. When integrated, the user can sign into the application using the EHR’s oauth patient authorization flow. When the user returns to the application, their experience is personalized. The app pre-fills their name, age and gender data and uses it to filter the content for the patient.

Check out our Epic Showroom demo or Cerner demo. Contact sales@appcatalyst.com for a demo or EHR sandbox environment user information.

These instructions assume some familiarity with and availability of an EHR Environment and application registration for that environment.

To create an EHR integrated symptom checker app follow these steps:

1. Register a new app in a SMART on FHIR (DSTU2) EHR Environment
   • Redirect URI – Set the Redirect URI to https://af-stage.appcatalyst.com/1/app/:app-id/redirect where :app-id is the id of your application.
   • Scope – Our app requires Patient/Patient.read or an equivalent scope. Any other scope that is required for patient authorization in the EHR environment should be included / enabled. To support the Call Your Doctor feature, Practitioner/Practitioner.read or equivalent scope should also be included.
2. Visit the app factory at https://app-factory.appcatalyst.com and login
3. Select your app and navigate to the EHR tab.
4. Copy the client id from your app in the EHR environment into the EHR form in the App Factory
5. Copy the FHIR server url from your app in the EHR environment into the server field in the EHR form
6. Copy the list of scopes from your app in the EHR environment into a list separated by space characters in the EHR form.
7. Copy or set the Redirect URI to https://af-stage.appcatalyst.com/1/app/:app-id/redirect in the EHR form Redirect URI field.
8. Choose to enable or disable the Call Your Doctor feature which will enable support for calling the patients primary care provider when that record is available.
9. Save the EHR form.
10. Visit the application.
11. Sign in to EHR environment from the application.

If you’ve followed these steps, you should be able to login and use the application to check symptoms for any EHR environment user/patient. Each EHR environment is a little bit different. Double check the environment’s scope conventions or documentation and make sure to provide an accurate server url.