Configuring the Display of PDF Files - Integration for Epic - Foundation 23.1 - Foundation 23.1 - Ready - OnBase - Essential - Premier - Standard - external - Essential - Standard - Premier

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

The EnableBrowserPdfViewer setting controls whether the OnBase Web Viewer uses the web browser’s PDF viewer or the OnBase Web Viewer’s PDF viewer to display documents. This setting is available with environments using a COM integration or a SMART on FHIR integration.

Note: Password-protected PDF files cannot be viewed with the OnBase Web Viewer’s PDF viewer. Only the web browser’s default PDF viewer is used to display password-protected PDF files.

If you are using the SMART on FHIR integration with Epic Hyperdrive, the EnableBrowserPdfViewer setting in the OnBase Web Server web.config file must be set to false to allow PDF files to be viewed as images in the OnBase Web Viewer.

Note: When this setting is set to true, the ability to render PDF files in the browser’s default PDF viewer is enabled for COM integrations. However, when using the SMART on FHIR integration with Epic Hyperdrive, rendering PDFs in the PDF viewer is currently unsupported and the PDF will not display.

To configure the EnableBrowserPdfViewer setting:

  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. Locate the EnableBrowserPdfViewer setting within the <appsettings> element.
  4. Modify the value attribute using one of the following values:
    Value Description
    True Enables PDF files to render in the browser’s default PDF viewer.
    Note: This option is only supported for environments using a COM integration. If this option is set in an environment using a SMART on FHIR integration, the PDF will not display.
    False Enables PDF files to render as images in the OnBase Web Viewer.
    Note: If you have an environment using a SMART on FHIR integration with Epic Hyperdrive, you must set the value of the EnableBrowserPdfViewer key to false as rendering PDF files in the browser’s default PDF viewer is currently unsupported.
    Note: If the value is left blank for the EnableBrowserPdfViewer setting, the value defaults to false and enables PDF files to render as images in the OnBase Web Viewer.
  5. Save and close the web.config file.
  6. Recycle the application pool of the OnBase Web Viewer for these changes to take effect.