Configuring Environment IDs - Integration for Epic - Foundation 23.1 - Foundation 23.1 - Ready - OnBase - Premier - external - Standard - Essential - Premier - Standard - Essential - OnBase/Integration-for-Epic/Foundation-23.1/Integration-for-Epic/Installation/Installing-the-Web-Viewer/Modifying-the-Web-Viewer-Configuration-File/Configuring-Environment-IDs - 2025-04-01 - An Epic environment ID is used to map specific OnBase Application Servers and data sources to an Epic environment. To have an environment ID to map, you must first configure an environment ID in the OBEpicWebViewer.dll.config file. Multiple environment IDs can be configured depending on your Epic configuration.

Integration for Epic

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

An Epic environment ID is used to map specific OnBase Application Servers and data sources to an Epic environment. To have an environment ID to map, you must first configure an environment ID in the OBEpicWebViewer.dll.config file. Multiple environment IDs can be configured depending on your Epic configuration.

To configure an environment ID:

  1. Locate the OBEpicWebViewer.dll.config file. In a default installation, this is located at C:\Program Files (x86)\Hyland\Integration for Epic\Web Viewer .
  2. Open theOBEpicWebViewer.dll.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 <environment> element under <OBEpicWebViewer> .
  4. Within the <environment> element, modify the following attributes to map the Epic environment ID to the corresponding OnBase Application Server.
    Note: All attribute values are case-sensitive and must be entered exactly as documented.

    Attribute

    Description

    id

    The Epic environment ID you want to map.

    url

    The Application Server URL to connect to for the specified environment ID. The URL should follow the format of https://hostname/AppServer/Service.asmx where hostname is replaced with the name or IP address of the server hosting the Application Server, and AppServer is replaced with the application name of the Application Server in the Internet Information Services (IIS) Manager. Both HTTP and HTTPS are allowed.

    dataSource

    The name of the connection string configured for the OnBase database you want to connect to.

    For example, if the environment ID is PRD, the section might look like this:

    <OBEpicWebViewer>
        <environments>
            <environment id="PRD" url="https://srv-DMApp/AppServer/Service.asmx" dataSource="OnBase_Epic_DB" />
        </environments>
    </OBEpicWebViewer>
    Note:

    The environment id, url, and dataSource attributes must be provided in the order shown. Make sure environment id is first, url is second, and dataSource is third.

  5. Repeat mapping attributes to the Application Server for each additional environment ID.
    Note:

    Ensure all <environment> elements are under the <environments> parent element.

  6. Save theOBEpicWebViewer.dll.config file.
  7. Continue to Configuring the Page Event Timeout.