BREAKING CHANGE: Healthcare Web Viewer - ignoreSessionOverride Key No Longer Allowed in Web.config

[CurtisFox]

Summary

With the release of the OnBase EP5 21.1.34.1000 and OnBase 22.1.11.1000 builds, we wanted to make you aware of an important change. There is a potentially breaking configuration change for the Healthcare Web Viewer, in the Web Server web.config file.

Background & Context

We are aware that multiple OnBase solutions have had the following key added to the <Hyland.Web.HealthcareWebViewer> section of their EP5/22.1 HWV Web Server web.config:

<ignoreSessionOverride value="true"/>

As of 21.1.34.1000/22.1.11.1000 and later builds, the presence of this key in the HWV Web Server web.config will cause the HWV to fail to load. This is true for both the COM (Hyperspace Classic and Hyperdrive) and SMART on FHIR (Hyperdrive only) integrations.

For some (potentially many) OnBase solutions, the ignoreSessionOverride key was added to the web.config and set to true in order to allow multiple Web Viewer windows to open in Epic Resolute. This key is not in the Web Server web.config by default and, if it exists, would have been manually added. Hyland determined that it was better to hard code this parameter to be true.

What This Means for You

If/when upgrading the Healthcare Web Viewer to 21.1.34.1000/22.1.11.1000+ from an earlier build of OnBase EP5/22.1:

• Do not use an older version of the web.config for the Web Server being used for the HWV.

  • It is considered best practice not to use the same web.config from an older build when upgrading.

• The layout of the <Hyland.Web.HealthcareWebViewer> section of the EP5 HWV Web Server web.config has changed.

  • The settings are spread out with XML comments explaining what each setting is for, along with the default value.

• When comparing an older EP5/22.1 Web Server web.config with one from 21.1.34.1000/22.1.11.1000, do not copy over the ignoreSessionOverride key, if it exists in the older web.config.

  • Copying this key will, in addition to causing the HWV not to load, cause the following error to be logged in the HealthcareWebViewer tab in Diagnostics Console:

System.NullReferenceException: Object reference not set to an instance of an object.   at Hyland.Applications.Web.Client.HealthcareWebViewer.HealthcareViewerLoginCtrl..ctor(IConfigSettings configSettings, String loginPage, String targetPage)   at Hyland.Applications.Web.Client.HealthcareWebViewer.Login.Page_Load(Object sender, EventArgs e)

[CurtisFox]

Hello everyone - this change has been made in 22.1.11.1000 as well and the blog post has been updated to reflect this new build. 22.1.11.1000 should be published and available for download on Community later this week. Link: OnBase Software - Download OnBase