Enabling Bi-Directional Communication for SMART on FHIR Integrations - Integration for Epic - Foundation 23.1 - Foundation 23.1 - Ready - OnBase - Essential - Premier - Standard - external - Standard - Premier - Essential

Integration for Epic

Platform
OnBase
Product
Integration for Epic
Release
Foundation 23.1
License
Standard
Premier
Essential

If your Epic environment is using the SMART on FHIR integration for Epic Hyperdrive, you must enable bi-directional communication between Epic Hyperdrive and the OnBase Web Viewer. This allows synchronization between both clients by using web messaging standards. For example, web messaging can communicate when a user performs a specific action on a document or when a document is initially loaded.

In addition, when bi-directional communication is enabled, you must define which domains have authorization to establish bi-directional communication. Any domains that are not listed as authorized cannot establish bi-directional communication.

If your environment is using the COM integration, see Enabling Bi-Directional Communication for COM Integrations.

To enable bi-directional communication for SMART on FHIR integrations:

  1. Locate the Web Server web.config file. In a default installation, this is located at C:/inetpub/wwwroot/AppNet.
  2. Open the web.config file in a plain-text editor, such as Notepad.
    Note:

    The *.config file should only be edited in a plain-text editor, such as Notepad, or a utility specifically designed to edit XML files. It should not be edited in a binary editor, such as Microsoft Word. Using a binary editor can introduce invalid characters to the file and make it unreadable by the software.

  3. In the <Hyland.Web.HealthcareWebViewer> block, locate the <epicScanViewerApi> element.
  4. Within the enabled setting, modify the value attribute to true. For example:
    <enabled value="true" />
    CAUTION: When setting the value for epicScanViewerApi to true, the enableEpicWebViewerApi setting must be set to false. The enableEpicWebViewerApi setting is used with environments configured for COM integrations. When both settings are set to true, bi-directional communication for SMART on FHIR integrations will not work as intended.
  5. Locate the <sourceOriginWhitelist> element within the <epicScanViewerApi> element.
  6. Within the add setting, edit the value for the origin attribute to include an authorized domain using the following format, where my.domain is the authorized domain name:
    <add origin="https://my.domain.net" />
  7. To add additional authorized domains, add new add settings directly beneath the one you just configured. For example:
    <add origin="https://my.domain1.net" />
    <add origin="https://my.domain2.net" />
  8. In the new add settings, enter authorized domains as the value of each origin attribute as described in step 6.
  9. When all authorized domains are added, save and close the web.config file.
  10. Recycle the application pool of the OnBase Web Viewer for these changes to take effect.