Enabling OWIN and WOPI on the Application Server - Enabling OWIN and WOPI on the Application Server - OnBase - Integrated Office Viewer - OnBase/Integrated-Office-Viewer/English/Foundation-22.1/Integrated-Office-Viewer/Configuration/Configuring-the-WOPI-Endpoint-Settings/Enabling-OWIN-and-WOPI-on-the-Application-Server - English - Foundation 22.1

Integrated Office Viewer

Platform
OnBase
Product
Integrated Office Viewer
Release
Foundation 22.1
License
ft:lastPublication
2024-03-25T18:33:36.849000
ft:locale
en-US

In order to use the Integrated Office Viewer in OnBase, you must configure certain features and settings on the OnBase Application Server that are not enabled by default and require a value to be entered:

  • Microsoft OWIN (Open Web Interface for .Net)

  • WOPI (Web Application Open Platform Interface)

  • The AppServerOrigin

  • The dmsdatasource

To enable OWIN and WOPI on the Application Server:

  1. Open Internet Information Services (IIS) Manager.
  2. Open the Application Server.
  3. Open Application Settings.
  4. Right-click dmsdatasource and select Edit. The Edit Application Setting dialog box is displayed.
  5. In the Value field, enter a name for your OnBase Application Server connection string.

    The dmsdatasource Value must match the name of the ADO.NET connection string for your Application Server. You can find the Application Server connection string name in IIS Manager in the Connection Strings configuration option.

    If using the Web Client, this same value must be entered for the dmsdatasource value in the Web Client (AppNet) application settings as well.

  6. Click OK.
  7. Right-click AppServerOrigin and select Edit. The Edit Application Setting dialog box is displayed.
  8. In the Value field, enter the Application Server URL.
    • For systems hosting the Microsoft Office Online Server on-premises, enter the on-premises Application Server URL.

    • For users with their server hosted in the Microsoft 365 cloud, enter the public Application Server URL

    • For systems hosting the Microsoft Office Online Server on-premises, enter the on-premises Application Server URL.

    • For systems using the Microsoft 365 cloud:

      • If your OnBase system is on-premises, enter the publicly accessible Application Server URL (or load balancer URL) you provided to Hyland Cloud Platform Engineering (CPE) during Hyland Office Broker Registration.

        For example, dmzserver.customer.com/appserver64

      • If your OnBase system is hosted on the Hyland Cloud, enter the Application Server URL that was provided to you by Hyland Cloud Platform Engineering (CPE) during Hyland Office Broker Registration.

        For example, customer.HylandCloud.com/appserver64

  9. Click OK.
  10. Right-click owin:AutomaticAppStartup and select Edit. The Edit Application Setting dialog box is displayed.
  11. In the Value field, enter true.
  12. Click OK.
  13. Right-click endpoints:Wopi and select Edit. The Edit Application Setting dialog box is displayed.
  14. In the Value field, enter true.
  15. Click OK.
  16. Refresh the Application Server to apply the new settings.
    Note:

    The Application Server needs to be able to receive incoming WOPI calls from the Hyland Office Broker. If your Application Server is in a DMZ, additional configuration is required in order to allow WOPI and OWIN to access the Application Server. For example, you may use a firewall, a load balancer, or a reverse proxy. Consult your network administrator to find a specific option that works for your network.